下载相关事宜

1.

下载相关事宜
Zhonghua.Gui
2020.09.29

2.

.
Contents
1
FactoryDownload/UpgradeDownload/ResearchDow
nload区别
2
FAQ整理
3
上下游主要联系人列表以及负责的模块
4
各种相关文档路径
5
版本发布流程
6
遗留问题
7
项目耦合点整理

3.

FactoryDownload/UpgradeDownload/ResearchDownload区别
windows版本
ResearchDownload 研发使用 功能最全
FactoryDownload
UpgradeDownload 产线升级或者售后使用 严格检查PAC合法性 备份NV等重要数据、
产线初次烧录使用 严格检查PAC合法性 不会备份
Linux版本
Dloader 目前支持最基本的下载功能 没有其他额外的功能。
http://shexsvn01/svn/Tools/trunk/Debug/Source/Download
客制化版本库
FlashToolDll 封装了下载库 客户二次开发可以直接调用 Simba也是用得此库。
http://shexsvn01/svn/Tools/trunk/Debug/Release/Dloader_Customization/MSFT/FlashToolDll
3

4.

FAQ整理
1. 客户问题主要关注两个版本 如不是下面版本 请升级后再支持
R24.0.0002 R24.0.0001合入log优化 支持raw格式下载速率提升。
R24.0.0003 支持sparse格式下载速率提升 基本达到和raw格式一致。
2. 遇到CQ/CR defect类型如何处理
1) 先看下载版本 如未更新 转谢飞 (Fei_f Xie)让客户更新版本复测 如有问题 提供工具log。
2) 查看下工具log 基本都是软件问题 让客户抓Uboot log 转BSP_DOWNLOAD_SZ即可。
3) 不是下面常见问题 查下工具 有信心没什么bug.
3. 常见问题 基本找Uboot都能解决
1) User cancel 下载口消失
2) Write fail: USB 挂死
3) wait input time out 手机侧命令回复超时
4) operate fail: 手机回复操作错误
4. 遇到CQ/CR 问题类型如何处理
1) 如是下载工具一些小功能 找下文档 对照代码理解一下。
2) 如是和打包相关的 转BM处理一下。 打包脚本是polo写的 之后交接给倪诚 (Cheng Ni) 我们这没有交
接过。

5.

FAQ整理
5. 如客户需要二次开发 让客户自行开发即可 源码开放。如客户有实力直接在源码上修改最好好 如没有实
力 可以提供FlashToolDll给客户调用。
CQ/CR太多就不列了 基本都是前面列的问题 有问题找赖圳雄 (Zhenxiong Lai)咨询下。

6.

上下游主要联系人列表以及负责的模块
模块
联系人
NPI
单向东 (Xiangdong Shan)
版本发布验收
Uboot
赖圳雄 (Zhenxiong Lai)
1. 新功能开发
2. 平台问题
Uboot
BSP_DOWNLOAD_SZ
客户CQ

7.

各种相关文档路径
http://shexsvn01/svn/Tools/trunk/Debug/Doc
http://shexsvn01/svn/Tools/trunk/Debug/Doc/PPT
重点先看下如下两篇文档 其他文档都是一些小功能 遇到问题再看
1. UNISOC Download Mode Protocol V1.0(CN).docx
2. 下载工具使用进阶.pptx

8.

版本发布流程
1. 修改版本号 编译 自测试OK
2. commit to Trunk http://shexsvn01/svn/Tools/trunk/Debug/Source/Download
3. 打tag
http://shexsvn01/svn/Tools/tags/2020/FACTORYDOWNLOAD
http://shexsvn01/svn/Tools/tags/2020/RESEARCHDOWNLOAD
http://shexsvn01/svn/Tools/tags/2020/UPGRADEDOWNLOAD
4. 拷贝工具到FTP:
\\shnas01\PublicShared\ShareData\Debug_Tools\Test\2020\Download
\\shnas01\PublicShared\ShareData\Debug_Tools\HistoryVersion\2020\Download
5. 邮件通知 单向东 (Xiangdong Shan)测试
6. 待单向东 (Xiangdong Shan)测试OK Copy版本至如下路径
\\shnas01\PublicShared\ShareData\Debug_Tools\LatestVersion\Download
7. 更新内网SVN
A Trunk
http://shsvn02/svn/tools/trunk/Release/FactoryDownload
http://shsvn02/svn/tools/trunk/Release/ResearchDownload
http://shsvn02/svn/tools/trunk/Release/UpgradeDownload
B TAG:
http://shsvn02/svn/tools/tag/2020/Tool/Download/RESEARCHDOWNLOAD
http://shsvn02/svn/tools/tag/2020/Tool/Download/FACTORYDOWNLOAD
http://shsvn02/svn/tools/tag/2020/Tool/Download/UPGRADEDOWNLOAD
8. 修改如下文件夹属性 svn:externals , 即ResearchDownload链接
http://shsvn02/svn/tools/trunk/Tools
http://shsvn02/svn/tools/trunk/ToolsV1

9.

遗留问题 1 软件版本号校验功能
背景
此功能原为单一客户所提需求 但是Sheng.Zhu那边评估下来有一定的通用性 所以在火凤凰二期里按通用性需求做。
SRS / HLD路径
Bug 1175305 - 【FirePhoenixII 】【ARID: DT_2020】下载模式也能读取软件版本号
http://shexsvn01/svn/HW/00 HW_DEPT/07 HW_DT/01. 项目管理/1.2_项目交付/1.2.14._火凤凰二期
/Documents/HLD/Tools/ 火凤凰_下载模式读取软件版本_软件概要设计.docx
http://shexsvn01/svn/HW/00 HW_DEPT/07 HW_DT/01. 项目管理/1.2_项目交付/1.2.14._火凤凰二期
/Documents/SRS/Tools/ 火凤凰_下载模式读取软件版本_软件需求规格说明书.docx
现状
之前按照HLD完成代码编写准备联调以后 BM侧 需要制作带Vpac文件的pac包 告知未获悉此需求 重新进行评估以后 以工作量大为缘由
进行了需求变更 提出以复用pac文件头中的szPrdVersion信息取代新增Vpac文件的方式来实现。
此变更方案评估的时候 未考虑到老平台兼容的问题 导致目前此方案在T117等不支持新BSL命令 0x2F 的平台 _WriteVpac_流程设备侧不
响应0x2F命令 并且后续正常命令也不响应的问题 正常测试通过的平台 UMS512在FDL2未支持的场合 会返回0xFE(Software has not
supported this feature)。
需求变更方案待确定
方案一 PAC包头新增字段 用于在存储产品版本号。
方案二 还是使用设计文档里使用的方法 即使用Vpac文件存储产品版本号。
方案三 复用Pac头信息中的dwReserved字段来存储产品版本号。

10.

遗留问题 2 双PAC下载功能
双pac下载功能目前在如下分支上实现
http://shexsvn01/svn/Tools/branches/NPI/2020/Download/Download_DualPac 本地已无未更新代码。
说明
1. 目前客户侧/Uboot侧(接口 Wenchao.Chen)双pac下载流程已经跑通
2. 目前只实现了9863的基本下载功能
2.1. 不支持NV备份。预期9863的NV会裁剪掉 所以没有实现
2.2. Miscdata备份通过配置文件配置(ResearchDownload.ini => [Options] => SecPacBackupSetting => 0:No backup; 1:Backup Miscdata)
2.3. 9863文件选择功能未实现。这个仅是界面操作 如果需要 可以参照MainPage实现
2.4. 通过界面配置或者配置文件配置来支持的功能 目前绝大部分没有进行主副系统的区分 除了NV相关功能 即某些特定功能在9863
上会有问题 最主要的问题形式为 调用的一些为了区分主副系统传入了主副系统标志位的方法 没有进行区分标志位的有效传入。比如
m_sheetSettings.GetFileInfo / m_sheetSettings.HasPartitionInfo等方法 加入了BOOL bSecondary参数 但是很多场合目前并未传入实际
的值 后续如果特定功能有问题 可以优先从这个方向入手。
3. 双pac下载功能目前通过配置文件 ResearchDownload.ini => [Selection] => DualPac => 0:关闭; 1:打开 支持
4. 工具与Uboot交互点主要为 MainPac下载完以后 发送0x41(BSL_CMD_START_AGENT) 通知Uboot切换9863。下载完9863以后 发送
0x42(BSL_CMD_END_AGENT)切换回主系统。
5. Reset/PowerOff两个流程需要在9863下载完并且通过0x42切换回主系统以后发送。
6. 主系统切到副系统场合(0x41命令) 需要预留切换时间 目前通过增加副系统7E命令Timeout值实现 BMTimeout.ini => [Timeout] =>
CheckSecondaryBaudRom
7. 副系统切到主系统场合(0x42命令) 需要预留切换时间 目前通过配置文件 BMTimeout.ini => [OperationPostInterval] => EndAgent 实现

11.

项目耦合点整理
1.
2.
所有项目共用 不存在和项目耦合..
如有耦合 一般通过执行FDL2命令 通过返回数据包0x96来获取一些信息解耦

12.

THANKS
All data and information contained in or disclosed by this document is confidential
and proprietary information of UNISOC and all rights therein are expressly
reserved. By accepting this material, the recipient agrees that this material and the
information contained therein is to be held in confidence and in trust and will not be
used, copied, reproduced in whole or in part, nor its contents revealed in any
manner to others without the express written permission of UNISOC. T h e
contents are subject to change without prior notice. Although every reasonable
effort is made to present current and accurate information, UNISOC makes no
guarantees of any kind with respect to the matters addressed in this document. In
no event shall UNISOC be responsible or liable, directly or indirectly, for any
damage or loss caused or alleged to be caused by or in connection with the use of
or reliance on any such content.