HiLoader

工具使用指南

 

 

文档版本

12

发布日期

2019-08-16

 

 

 


 





版权所有 © 上海海思技术有限公司2019。保留一切权利。

非经本公司书面许可,任何单位和个人不得擅自摘抄、复制本文档内容的部分或全部,并不得以任何形式传播。

 

商标声明

、海思和其他海思商标均为上海海思技术有限公司的商标。

本文档提及的其他所有商标或注册商标,由各自的所有人拥有。

 

注意

您购买的产品、服务或特性等应受海思公司商业合同和条款的约束,本文档中描述的全部或部分产品、服务或特性可能不在您的购买或使用范围之内。除非合同另有约定,海思公司对本文档内容不做任何明示或默示的声明或保证。

由于产品版本升级或其他原因,本文档内容会不定期进行更新。除非另有约定,本文档仅作为使用指导,本文档中的所有陈述、信息和建议不构成任何明示或暗示的担保。

 

 

 

 

 

 

 

 

 

 

 

 

上海海思技术有限公司

地址:

深圳市龙岗区坂田华为基地华为总部     邮编:518129

网址:

http://www.hisilicon.com

客户服务邮箱:

support@hisilicon.com

 

 


 

概述

本文档主要介绍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

新增支持Hi3796CV200Hi3716MV420/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

新增支持Hi3798MV310Hi3798MV300HHi3798MV200HHi3716MV430芯片

2019-08-16

12

新增支持Hi3561MV100芯片。


 

  ... iii

1   ... 1-1

1.1 工具概述... 1-1

1.2 环境准备说明... 1-1

2 界面及功能说明... 2-1

2.1 打包海思协议的升级文件... 2-1

2.2 打包SSU协议的升级文件... 2-3

2.2.1 插入SSU协议... 2-3

2.2.2 插入资源链接描述符... 2-5

2.2.3 插入空数据包... 2-7

3 注意事项... 3-1

A 缩略语... A-1

 


插图目录

1-1 选择HiLoader主界面... 1-1

2-1 HISI协议打包界面... 2-1

2-2 升级文件列表... 2-2

2-3 参数配置... 2-2

2-4 参数配置... 2-3

2-5 SSU协议打包界面... 2-4

2-6 升级文件列表... 2-4

2-7 参数配置... 2-5

2-8 生成目标升级文件... 2-5

2-9 有线传输选择... 2-6

2-10 地面传输选择... 2-6

2-11 生成目标升级文件... 2-6

2-12 文件参数配置... 2-7

2-13 生成目标升级文件... 2-7

 


1  

1.1 工具概述

HiLoader工具是海思提供的一种Loader打包工具,用于将原始镜像文件按照升级协议打包成目标升级文件。提供了以下两种协议的打包

l   海思协议(包括HISI OTA协议和HISI FILE协议)

l   SSU协议

1.2 环境准备说明

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-1 选择HiLoader主界面

 

----结束

 


 

 


2 界面及功能说明

2.1 打包海思协议的升级文件

打包海思协议的升级文件步骤如下:

                                步骤 1      打开HiLoader工具,在主界面上选择HISI协议,可看到HISI协议界面,2-1所示。

图2-1 HISI协议打包界面

 

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

图2-2 升级文件列表

 

l   文件名:通过浏览添加分区对应的镜像文件。

l   器件类型:分区所在器件的类型。包含的器件有:nand(对应NAND flash),spi(对应SPI flash),emmc(对应eMMC flash)。

l   文件系统:分区的文件系统类型。NAND/SPI flash支持的文件系统类型有:noneyaffsubieMMC flash支持的文件系统类型有:noneext3/4;其中none用于boot分区和kernel分区的打包。器件片选:同一种芯片下第几块芯片。

l   开始地址:分区在器件上的起始位置。

l   分区长度:分区在器件上占用的长度

                                步骤 3      重复步骤 2添加其他的升级文件。

                                步骤 4      在升级文件参数配置区域,对文件参数进行配置,如2-3所示。

图2-3 参数配置

 

 

l   下载PID升级流PID16位宽度(0x20~0x1FFE)。

l   下载Table ID:指示下载序列的table ID8位宽度(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所示。

图2-4 参数配置

 

----结束

2.2 打包SSU协议的升级文件

2.2.1 插入SSU协议

插入SSU协议的升级文件步骤如下:

                                步骤 1      打开HiLoader工具,在主界面上选择SSU协议,可看到SSU协议打包的界面,如2-5所示。

图2-5 SSU协议打包界面

 

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

图2-6 升级文件列表

 

l   文件名:通过浏览添加分区对应的镜像文件。

l   器件类型:分区所在器件的类型。包含的器件有:NAND(对应NAND Flash),SPI(对应SPI Flash),eMMC(对应eMMC Flash)。

l   文件系统:分区的文件系统类型。NAND/SPI Flash支持的文件系统类型有:noneyaffsubieMMC flash支持的文件系统类型有:noneext3/4其中none用于boot分区和kernel分区的打包。

l   器件片选:同一种芯片下第几块芯片。

l   开始地址:分区在器件上的起始位置。

l   分区长度:分区在器件上占用的长度。

                                步骤 3      重复步骤 2添加其他的升级文件

                                步骤 4      在升级文件参数配置区域,对文件参数进行配置,如2-7所示。

图2-7 参数配置

l   下载Group ID16位宽度(0x2~0xFFFF)。

l   下载PID:指示升级流PID16位宽度(0x200x1FFE)。

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所示。

图2-8 生成目标升级文件

 

----结束

2.2.2 插入资源链接描述符

插入资源链接描述符步骤如下:

                                步骤 1      执行2.2.1的步骤1到步骤4

                                步骤 2      选择“插入链接描述符”

                                步骤 3      选择一种传输方式。

l   若选择有线传输,在打包选择参数配置区域,对以下文件参数进行配置,如2-9所示。

       升级方式:未定义,强制升级,非强制升级

       升级流符号率:1000~99999KS/s

       调制方式:未定义,16 QAM32 QAM64 QAM128 QAM256 QAM

       频率:19999MHz,可输入小数,小数点前4位和后4位。

图2-9 有线传输选择

 

l   若传输方式选择地面传输,在打包选择参数配置区域,对文件参数进行配置,如2-10所示。

       带宽:6MHz7MHz8MHz

       中心频率:32位宽度,10Hz(0x00000001)~42,949,672,950Hz(0xFFFFFFFF),输入的值必须是10的倍数。

       星座:QPSK16-QAM64-QAM

图2-10 地面传输选择

 

                                步骤 4      最后在目标升级文件生成区域,单击按钮可以选择生成的目标升级文件的名字及路径、然后点击对应的打包按钮进行打包。

SSU协议包含一种打包方式:TS流打包,点击打包生成SSU协议的目标升级文件。如2-11所示。

图2-11 生成目标升级文件

 

----结束

2.2.3 插入空数据包

插入空数据包的步骤如下:

                                步骤 1      执行2.2.1的步骤1到步骤4

                                步骤 2      在打包选择参数配置区域,对文件参数进行配置,如2-12所示。

图2-12 文件参数配置

 

l   升级流符号率,28位宽度(1000~99999) KS/s

l   有效数据符号率,28位宽度(1000~99999) KS/s

                                步骤 3      最后在目标升级文件生成区域,单击按钮可以选择生成的目标升级文件的名字及路径、然后点击对应的打包按钮进行打包。

SSU协议包含一种打包方式:TS流打包,点击打包生成SSU协议的目标升级文件。如2-8所示。

图2-13 生成目标升级文件

 

用户网络丢包率高的环境下,插入空数据包减少有效数据丢失。

----结束


3 注意事项

HiLoader工具使用时需要注意的事项有:

l   添加分区时,输入的分区长度注意要带单位k或者m(不区分大小写)。

l   添加分区时,输入的分区长度要应该大于实际选择文件的长度。

l   添加分区时,注意分区与分区占用的地址不能存在重叠。

l   使用HiLoader工具出现问题时,注意把当时的现象截图,反馈问题时一并反馈,将有助于问题的定位及解决。

l   TS流打包时间过长的原因可能是分区较多或者分区文件过大导致打包时花费的时间过长,属正常现象,请耐心等待即可。

l   当分区的文件超过一定大小时(HISI协议480MBSSU协议240MB),工具会自动将该分区拆分成小分区文件。这主要是由于协议相关字段长度的限制造成的。

l   对于eMMC器件的ext4文件系统,工具支持非稀疏和稀疏两种格式的文件,工具自动根据文件头进行判断。

l   关于HISI协议的器件片选,NAND器件可以从boot的打印看出器件片选,例Nand(Hardware)

       Block128KB

       Page2KB

       OOB64B

       ECC4bit

       Chip128MB*1”

其中*1表示其片选0。其他器件请咨询单板的硬件开发人员。

 


A 缩略语

E

 

 

eMMC

Embedded MultiMediaCard

内嵌式存储器标准规格,带有MMC(多媒体卡)接口、快闪存储器设备及主控制器——所有在一个小型的BGA封装。eMMC具有快速、可升级的性能。

H

 

 

HISI OTA

HISI OTA

海思制定的适用于OTA升级的协议。

HISI FILE

HISI FILE

海思制定的适用用于USBIP升级的协议,亦称USB/IP协议。

N

 

 

NAND

NAND

NAND闪存是一种比硬盘驱动器更好的存储方案。

S

 

 

SPI

Serial Peripheral Interface

同步串行通讯方式。

SSU

System Software Updates

欧洲数字视频广播(DVB)标准制定的适用于OTA升级的系统软件升级服务技术协议