SigmaStar Ota打包和升级

1. 概述¶

本文介绍的是Sigmastar的IPC、NVR平台在OTA升级流程中私有的打包、解包、升级的流程。本系统仅支持分区打包、分区升级，个别文件升级，不支持差分升级。

升级包后台服务器维护、终端下载及管理，请结合第三方服务。

2. 分区打包流程¶

2.1. 打包工具介绍¶

打包工具只会根据当前要升级的文件生成所需的文件头，文件数据请用’cat’命令追加到文件尾部。目前打包文件最大个数不得超过32，后续可根据情况增加。

打包工具的bin所在目录：

project/image/makefiletools/bin/otabinheader

打包工具的代码所在目录：

project/image/makefiletools/src/otabinheader/otabindeader.c

编译方法：

使用服务器x86编译 gcc otabindeader.c –o otabindeader

otabindeader工具命令参数介绍：

-c:

创建一个空的升级包文件头，此命令不可与其他命令共同使用。
-a:

在已经创建的升级包中追加新的头信息，追加新的信息中，必须使用以下参数告知升级的相关讯息。
-s:

需要更新的源文件路径。
-d:

需要更新的目标文件或者分区节点的路径。
-t:

需要更新的目标文件或者分区的大小，单位为byte，可以用16/10进制表示。
-p:

数据更新的方式，0表示分区更新，1表示ubi分区，2表示文件更新，后续可能会扩展。

2.2. OTA打包脚本介绍¶

2.2.1. 一般的打包流程举例：¶

创建一个空的header：
```
otabindeader -c SStarOta.bin
```

根据需要打包的文件更新header数据：

otabindeader -s ./ipl_s.bin -d /dev/mtdblock0 -t 0xA0000 -p 0 -a
SStarOta.bin

使用’cat’命令把数据追加到升级包后面
```
cat ./ipl_s.bin >>SStarOta.bin
```
循环执行2、3步骤，所有的文件进行打包。
压缩升级包：
```
gzip SStarOta.bin
```

2.2.2. 在ALKAID中打包介绍:¶

OTA打包流程目前已经整合到了Makefile中。

当程序编译和打包完成后，在project下输入指令：

make image-ota

会出现如下交互界面，选择需要打包的分区数据:

Make ipl ?(yes/no)

做出相关的选择后，会在project/image/output/images/下产生SStarOta.bin.gz

在配置partition的config文件中会配置分区进行打包。

举例：

文件 spinand.ubifs.p2.partition.config中有变量：OTA_IMAGE_LIST

在此变量后面追加需要打包的分区名称，并在分区的配置中添加字段xxx$(OTABLK)，配置该分区需要升级的目标节点路径。

只有在OTA_IMAGE_LIST添加了分区名，才会在make image-ota的时候会询问该分区是否要进行ota升级。

分区打包脚本的所有逻辑在image/ota.mk中实现，有兴趣的可以自行研究。

2.3. 不带文件系统的RAW DATA打包¶

分区升级步骤是大同小异的，会把需要升级的文件填到对应的mtdblock中，因此打包的流程也大体上是一样的。稍有不同的是在RAW DATA分区打包的要自行实现升级包头的创建和数据填充，这里以spinand的IPL分区打包举例：

define makeota

@read -p "Make $(1) ?(yes/no)" select;

if [ "$${select}" == "yes" -o "$${select}" == "y" ]; then

$(foreach n,$(3),$(PROJ_ROOT)/image/makefiletools/bin/otabinheader -s $(2)
-d $(n) -t $(4) -p $(5) -a $(IMAGEDIR)/SStarOta.bin;cat $(2) >>
$(IMAGEDIR)/SStarOta.bin;)

fi;

endef

ipl_spinand_mkota_:

$(call makeota,$(patsubst
%_spinand_mkota_,%,$@),$(IMAGEDIR)/ipl_s.bin,$($(patsubst
%_spinand_mkota_,%,$@)$(OTABLK)),$($(patsubst
%_spinand_mkota_,%,$@)$(PATSIZE)),0)

2.4. UBIFS/Squashfs/Jiffs2打包¶

如果新创建了这些分区，并且把它们加到OTA_IMAGE_LIST中，则无需再ota.mk中添加特殊处理，这一类的分区升级文件会统一处理。

UBIFS的分区升级方式与其它两种格式稍有差异，因此在打包的时候UBIFS打包的-p参数是1，其他是0。

2.5. 个别文件打包¶

个别文件打包的-p参数是2，目前ALKAID中还没有专门针对文件更新的打包，因此使用者需要自己手动添加。

3. 分区更新流程¶

3.1. 分区升级前注意¶

在分区升级之前请保证分区umount成功。若需更新文件，请保证文件所在可读写的文件系统中，并且有写权限。

压缩包解包工具请找FAE获取。

3.2. 压缩的升级包更新¶

otaupack -x SStarOta.bin.gz

3.3. 非压缩的升级包更新¶

otaupack -r SStarOta.bin