|
|
||
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
HiLoader 工具使用指南
|
||
|
文档版本 |
12 |
|
|
发布日期 |
2019-08-16 |
|
|
|
||
版权所有 © 上海海思技术有限公司2019。保留一切权利。 非经本公司书面许可,任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部,并不得以任何形式传播。
商标声明
本文档提及的其他所有商标或注册商标,由各自的所有人拥有。
注意 您购买的产品、服务或特性等应受海思公司商业合同和条款的约束,本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定,海思公司对本文档内容不做任何明示或默示的声明或保证。 由于产品版本升级或其他原因,本文档内容会不定期进行更新。除非另有约定,本文档仅作为使用指导,本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。 |
|
|
|
|
上海海思技术有限公司 |
|
|
地址: |
深圳市龙岗区坂田华为基地华为总部 邮编:518129 |
|
网址: |
|
|
客户服务邮箱: |
|
前 言
概述
本文档主要介绍Loader打包工具HiLoader的使用方法。
产品版本
与本文档相对应的产品版本如下。
|
产品名称 |
产品版本 |
|
Hi3716M |
V4XX |
|
Hi3716M |
V31X |
|
Hi3798M |
V100 |
|
Hi3796M |
V100 |
|
Hi3110E |
V5XX |
|
Hi3798C |
V2XX |
|
Hi3798M |
V2XX(H) |
|
Hi3796M |
V2XX |
|
Hi3798M |
V3XX(H) |
读者对象
文档(本指南)主要适用于以下工程师:
l 技术支持工程师
l 软件开发工程师
作者信息
|
章节号 |
章节名称 |
作者信息 |
|
全文 |
全文 |
F00107764 |
修订记录
修订记录累积了每次文档更新的说明。最新版本的文档包含以前所有文档版本的更新内容。
|
修订日期 |
版本 |
修订说明 |
|
2013-12-6 |
00B01 |
第1次临时发布。 |
|
2014-09-22 |
01 |
新增支持Hi3716MV310芯片。 |
|
2014-10-31 |
02 |
新增支持Hi3796M/Hi3798M V100芯片。 |
|
2014-12-26 |
03 |
新增插入资源链接描述符、空数据包。 |
|
2015-03-10 |
04 |
新增支持Hi3110E V500芯片。 |
|
2015-04-23 |
05 |
新增支持Hi3796CV200、Hi3716MV420/V410芯片。 |
|
2016-11-02 |
06 |
新增支持Hi3798MV200芯片。 |
|
2017-02-09 |
07 |
修改1.1章节,新增1.2章节,新增支持Hi3796MV200。 |
|
2017-03-14 |
08 |
更新1.2章节步骤1。 |
|
2017-05-27 |
09 |
更新2.1章节步骤4,更新2.2.1章节步骤4,更新2.2.2章节步骤3。 |
|
2017-08-31 |
10 |
新增支持Hi3798MV300芯片。 |
|
2018-09-30 |
11 |
新增支持Hi3798MV310、Hi3798MV300H、Hi3798MV200H、Hi3716MV430芯片。 |
|
2019-08-16 |
12 |
新增支持Hi3561MV100芯片。 |
目 录
插图目录
HiLoader工具是海思提供的一种Loader打包工具,用于将原始镜像文件按照升级协议打包成目标升级文件。提供了以下两种协议的打包:
l 海思协议(包括HISI OTA协议和HISI FILE协议)
l SSU协议
HiLoader工具使用的环境准备如下:
步骤 1 把位于SDK发布包同级目录下的HiTool-XXX-X.X.X.zip(路径:$SDK_DIR _HiTool\HiTool\windows),拷贝到PC上(PC要求安装Win7 、XP操作系统)的某个本地硬盘。
在HiTool-XXX-4.0.15及以后的版本已经集成了jre,无需单独安装JRE。
如果是老版本工具,请预先安装的32位的jre1.6(如jre-6u1-windows-i586-p),否则HiTool可能无法运行。链接如下:http://www.oracle.com/technetwork/java/javase/downloads/java-archive-downloads-javase6-419409.html
步骤 2 解压HiTool-XXX-X.X.X.zip,点击HiTool.exe。
步骤 3 选择芯片,例如Hi3798MV100为例,点击HiLoader,如图1-1。

----结束
打包海思协议的升级文件步骤如下:
步骤 1 打开HiLoader工具,在主界面上选择HISI协议,可看到HISI协议界面,如图2-1所示。
图2-1 HISI协议打包界面
步骤 2
在升级文件选项组里,单击
按钮,增加一行分区。可以在这一行选择器件类型、器件片选(支持4种器件片选)以及是否需要文件系统以及文件系统的类型,还可以修改分区的起始地址、分区长度以及分区的镜像文件。也可通过加载配置文件进行批量添加。另外,也可通过单击
按钮,删除一行分区。如图2-2所示。

l 器件类型:分区所在器件的类型。包含的器件有:nand(对应NAND flash),spi(对应SPI flash),emmc(对应eMMC flash)。
l 文件系统:分区的文件系统类型。NAND/SPI flash支持的文件系统类型有:none,yaffs,ubi;eMMC flash支持的文件系统类型有:none,ext3/4;其中none用于boot分区和kernel分区的打包。器件片选:同一种芯片下第几块芯片。
l 分区长度:分区在器件上占用的长度。
步骤 3 重复步骤 2添加其他的升级文件。
步骤 4 在升级文件参数配置区域,对文件参数进行配置,如图2-3所示。

l 下载PID:升级流PID,16位宽度(0x20~0x1FFE)。
l 下载Table ID:指示下载序列的table ID,8位宽度(0x40~0xFF)。
l 厂商ID号:表示厂家代号,16位宽度(0x0000~0xFFFF)。
l 硬件版本号:表示下载软件适用的硬件版本号,32位宽度(0x00000000~0xFFFFFFFF)。
l 软件版本号:表示下载软件的版本号,32位宽度(0x00000000~0xFFFFFFFF)。
l 起始序列号:表示需要更新软件的机顶盒的起始序列号,32位宽度(0x00000000~0xFFFFFFFF)。
l 结束序列号:表示需要更新软件的机顶盒的终止序列号,32位宽度(0x00000000~0xFFFFFFFF)。
步骤 5
在目标升级文件生成区域,单击
按钮可以选择生成的目标升级文件的名字及路径、然后点击对应的打包按钮进行打包。
海思协议支持两种打包方式:
l
TS流打包:或者点击
打包生成HISI OTA协议的目标升级文件。
l
USB打包:点击
打包生成HISI FILE协议的目标升级文件。
![]()
USB升级只能使用Hisi协议,Loader中使用的 USB升级协议强制使用了Hisi协议。
如图2-4所示。

----结束
插入SSU协议的升级文件步骤如下:
步骤 1 打开HiLoader工具,在主界面上选择SSU协议,可看到SSU协议打包的界面,如图2-5所示。
图2-5 SSU协议打包界面

步骤 2
在升级文件选项组里,单击
按钮,增加一行分区。可以在这一行选择器件类型、器件片选(支持1种器件片选)以及是否需要文件系统以及文件系统的类型,还可以修改分区的起始地址、分区长度以及分区对应的镜像文件。也可通过加载配置文件进行批量添加。另外,也可通过单击
按钮,删除一行分区。如图2-6所示。

l 文件名:通过浏览添加分区对应的镜像文件。
l 器件类型:分区所在器件的类型。包含的器件有:NAND(对应NAND Flash),SPI(对应SPI Flash),eMMC(对应eMMC Flash)。
l 文件系统:分区的文件系统类型。NAND/SPI Flash支持的文件系统类型有:none,yaffs,ubi;eMMC flash支持的文件系统类型有:none,ext3/4;其中none用于boot分区和kernel分区的打包。
l 器件片选:同一种芯片下第几块芯片。
l 开始地址:分区在器件上的起始位置。
l 分区长度:分区在器件上占用的长度。
步骤 3 重复步骤 2添加其他的升级文件。
步骤 4 在升级文件参数配置区域,对文件参数进行配置,如图2-7所示。

l 下载Group ID,16位宽度(0x2~0xFFFF)。
l 下载PID:指示升级流PID,16位宽度(0x20~0x1FFE)。
l 厂商ID号:表示厂家代号,16位宽度(0x0000~0xFFFF)。
l 硬件版本号:表示下载软件适用的硬件版本号,32位宽度(0x00000000~0xFFFFFFFF)。
l 软件版本号:表示下载软件的版本号,32位宽度(0x00000000~0xFFFFFFFF)。
l 起始序列号:表示需要更新软件的机顶盒的起始序列号,32位宽度(0x00000000~0xFFFFFFFF)。
l 结束序列号:表示需要更新软件的机顶盒的终止序列号,32位宽度(0x00000000~0xFFFFFFFF)。
步骤 5
在目标升级文件生成区域,单击
按钮可以选择生成的目标升级文件的名字及路径、然后点击对应的打包按钮进行打包。
SSU协议包含一种打包方式:TS流打包,点击
打包生成SSU协议的目标升级文件。如图2-8所示。

----结束
插入资源链接描述符步骤如下:
步骤 1 执行2.2.1的步骤1到步骤4。
步骤 2 选择“插入链接描述符”。
l 若选择有线传输,在打包选择参数配置区域,对以下文件参数进行配置,如图2-9所示。
− 升级流符号率:1000~99999KS/s。
− 调制方式:未定义,16 QAM,32 QAM,64 QAM,128 QAM,256 QAM
− 频率:1—9999MHz,可输入小数,小数点前4位和后4位。
l 若传输方式选择地面传输,在打包选择参数配置区域,对文件参数进行配置,如图2-10所示。
− 带宽:6MHz,7MHz,8MHz
− 中心频率:32位宽度,10Hz(0x00000001)~42,949,672,950Hz(0xFFFFFFFF),输入的值必须是10的倍数。
− 星座:QPSK,16-QAM,64-QAM

步骤 4
最后在目标升级文件生成区域,单击
按钮可以选择生成的目标升级文件的名字及路径、然后点击对应的打包按钮进行打包。
SSU协议包含一种打包方式:TS流打包,点击
打包生成SSU协议的目标升级文件。如图2-11所示。

----结束
插入空数据包的步骤如下:
步骤 1 执行2.2.1的步骤1到步骤4。
步骤 2 在打包选择参数配置区域,对文件参数进行配置,如图2-12所示。

l 升级流符号率,28位宽度(1000~99999) KS/s。
l 有效数据符号率,28位宽度(1000~99999) KS/s。
步骤 3
最后在目标升级文件生成区域,单击
按钮可以选择生成的目标升级文件的名字及路径、然后点击对应的打包按钮进行打包。
SSU协议包含一种打包方式:TS流打包,点击
打包生成SSU协议的目标升级文件。如图2-8所示。

![]()
用户网络丢包率高的环境下,插入空数据包减少有效数据丢失。
----结束
HiLoader工具使用时需要注意的事项有:
l 添加分区时,输入的分区长度注意要带单位k或者m(不区分大小写)。
l 添加分区时,输入的分区长度要应该大于实际选择文件的长度。
l 添加分区时,注意分区与分区占用的地址不能存在重叠。
l 使用HiLoader工具出现问题时,注意把当时的现象截图,反馈问题时一并反馈,将有助于问题的定位及解决。
l TS流打包时间过长的原因可能是分区较多或者分区文件过大导致打包时花费的时间过长,属正常现象,请耐心等待即可。
l 当分区的文件超过一定大小时(HISI协议480MB,SSU协议240MB),工具会自动将该分区拆分成小分区文件。这主要是由于协议相关字段长度的限制造成的。
l 对于eMMC器件的ext4文件系统,工具支持非稀疏和稀疏两种格式的文件,工具自动根据文件头进行判断。
l 关于HISI协议的器件片选,NAND器件可以从boot的打印看出器件片选,例如Nand(Hardware):
− Block:128KB
− Page:2KB
− OOB:64B
− ECC:4bit
− Chip:128MB*1”
其中*1表示其片选0。其他器件请咨询单板的硬件开发人员。
|
E |
|
|
|
eMMC |
Embedded MultiMediaCard |
内嵌式存储器标准规格,带有MMC(多媒体卡)接口、快闪存储器设备及主控制器——所有在一个小型的BGA封装。eMMC具有快速、可升级的性能。 |
|
H |
|
|
|
HISI OTA |
HISI OTA |
海思制定的适用于OTA升级的协议。 |
|
HISI FILE |
HISI FILE |
海思制定的适用用于USB和IP升级的协议,亦称USB/IP协议。 |
|
N |
|
|
|
NAND |
NAND |
NAND闪存是一种比硬盘驱动器更好的存储方案。 |
|
S |
|
|
|
SPI |
Serial Peripheral Interface |
同步串行通讯方式。 |
|
SSU |
System Software Updates |
欧洲数字视频广播(DVB)标准制定的适用于OTA升级的系统软件升级服务技术协议 |
|
|
|
|