Apollo升级系统 --- 使用说明

.自动生成升级包
sh ./host/package_generate.sh ~/apollo/sw/ga300/target/output/flash_bin/systems/huangpu-summit-dualhd-gnu-4.4.0-linux-debug/
该命令生成一个文件和一个目录，依赖于当前时间，比如：
apollo-sw-2010-11-10-15-04_dir\： 拷贝到u盘根目录即可被升级程序识别
apollo-sw-2010-11-10-15-04:  上述目录的squashfs包，应用于网络下载升级

升级程序启动后，将读取网络分区和u盘，查找apollo-sw开头的目录或者升级包，如果文件或目录名比当前版本字串更大，则运行升级包里的autorun.sh执行升级。
更全面的信息建议阅读：<<Apollo 升级系统——需求分析＋概要设计>>

.升级包结构
升级包包括一个autorun.sh和需要引用的文件。升级的实现即通过运行autorun.sh来实现。
比如下面一个简单的autorun.sh：
image_update -d /dev/mtd5 -m linux-2.6.28.10/vmlinux.bin -c 2963891368 -l  4685120
image_update -d /dev/mtd7 -m appfs.jffs2.nand -c 1085098658 -l  22550628
image_update -d /dev/mtd6 -m rootfs.arm.jffs2.nand -c 664852602 -l  3521352

那么升级包还应该包括linux-2.6.28.10/vmlinux.bin，appfs.jffs2.nand，rootfs.arm.jffs2.nand。
升级的结果即把这些文件写道相应的分区中。

升级程序启动后读取升级包里的autorun.sh并且运行，这种设计可以实现各种灵活的应用，用户可以在升级包里包含自己的程序。
比如运行不同的升级界面，或者执行网络升级。

.生成升级映像
Step 1: 生成rootfs
#cd upgrade/target
#sh build_upgrade_image.sh

Step 2: 生成image
make -C $KSRC O=$KERNEL_OBJ_DIR menuconfig
使得
CONFIG_BLK_DEV_INITRD=y
CONFIG_INITRAMFS_SOURCE="/home/qianjiang/tmp/qjbackup/upgrade/target/outputn/rootfs.tmplt"  ＃绝对路径
CONFIG_APOLLO_SPLASH is not set              ＃关闭splash
CONFIG_LOGO is not set                       #不需要开机logo
CONFIG_NTFS_FS=y                             #打开ntfs读支持
生成的config可以保留，将来直接替换即可。
生成的vmlinux.bin即升级映像

需要考虑的另外一个映像是uboot env映像，生成工具见：
./host/generate_env_image


.移植
不同的项目分区不一样，所以移植主要的任务是确定mtdparts. 比如：
mtdparts=nx_2017:1m@0k(uldr),512k@1m(uboot),512k@1536k(env),10m@2m(update),6m@12m(kernel),12m@18m(root),200m@30m(appfs),200m@230m(net),30m@430m(user1),30m@430m(user2),22m@490m(reserve)
注意：必须有env分区。


.理解升级系统的实现方法
文件target/src/etc/S50update.sh，即实现的概要，下面简述之：
-------------------------------------------------------
insmod /usr/fb_device.ko                        ＃安装framebuffer驱动
upgrade_osd &                                   ＃运行显示程序
automount > /tmp/upgrade_msg                    ＃挂载U盘的分区，并且把运行结果输出到管道文件upgrade_msg,该管道的读取方是upgrade_osd，显示内容到屏幕
perform_mount=$(find_update_package /tmp/media) ＃/tmp/media下面挂载了U盘的分区，find_update_package到该分区下面查找可以升级的软件包

＃下面切换到升级包目录
if [ ${perform_mount:0:2} = "cd" ]; then
    $perform_mount
elif [ ${perform_mount:0:5} = "mount" ]; then
    $perform_mount
else
    echo "No upgrade package" > /tmp/upgrade_msg
    echo $fail_msg > /tmp/upgrade_msg
    exit
fi

＃如果升级目录下面存在autorun.sh，则运行autorun.sh
if [ ! -x autorun.sh ]; then
    echo Invalid upgrade package: $sw_package_version_str > /tmp/upgrade_msg
    echo $fail_msg > /tmp/upgrade_msg
    exit
fi

./autorun.sh



.目录结构，文件功能描述
1. host
该目录存放相关运行于PC端的一些工具
env.txt：uboot环境变量组织模板，不同客户有不同定制
package_generate.sh：升级包生成工具，不同客户有不同定制
set_uboot_env：expect脚本，可以和uboot交互自动更新环境变量

./host/generate_env_image:
    generate_env_image.sh：读取env.txt生成env image
    uboot_env: PC端env读写工具

2. target
build_upgrade_image.sh：编译升级系统

./target/overlay-elgakingdom
    linuxkernel.config.patch：编译内核时需要使用的配置
    nand.c：适应于elgakingdom的nand驱动

./target/overlay-skyworth:
    patch/：针对sky板子的配置
    build_skyworth：记录编译sky工程的方法
    env.txt：适应于sky项目的环境设置
    images/：里面的映像文件联系起来烧录到nand，启动后就支持升级
    linuxkernel.config.patch：编译内核时，需要使用的配置

2.1 target/src
  automount.c： 自动挂载U盘分区到文件系统
  fbdevice/ ： framebuffer驱动
  find_update_package.c： 查找升级包
  image_update/：更新mtd分区的程序
  uboot_env/： 支持对env分区的读写等
  upgrade_osd/：显示升级相关信息
  etc/：升级系统启动脚本


.TODO:
1. 开发一个升级包，里面的工具可以读取nand里面的映像，包括ecc信息。这样可以应用于烧录器（如果没有找到ecc生成算法）。
2. 支持热拔插。比如升级失败，用户可以修改升级包然后重新插入，将自动升级
3. 减少升级映像size，比如通过内核的压缩，或者内核映像的定制（比如去掉网络）。
4. 支持通过uldr装入升级映像，运行。这样可以执行升级。
5. image_update对坏块的管理是skip bad block，没有使用bbt。是否有问题，需要验证？
6. uboot默认的分区大小是512k，对于large page的nand,一个block即256K。所以uboot分区应该加大，允许出现坏块。
7. 实现kernel console，程序执行的输出显示到屏幕。定制console driver，以便支持进度条和状态显示。
   可以参考：
   <<Essential Linux Divice Drivers>>, http://en.gentoo-wiki.com/wiki/Initramfs
8. 大文件，比如30M，如果制作在squashfs中，可能带来问题，原因未名。估计和内存有关（因为mount到loop0），如果写道mtd中可能没问题。所以这个时候建议用目录的方式拷贝到U盘。
9. fbdevice，mmap还没搞定。现在通过write系统调用实现。