文档说明： 本文档简述了openwrt sdk的升级功能流程，从页面传入升级文件到升级文件检测，再到调用升级脚本进行升级，升级完成后，进行系统重启。最后简述了如何添加升级文件标识，标识包括自己定义的字段，以及升级软件的md5值。达到防止用户用其他openwrt sdk编译出来的固件刷新我们的系统，以及防止升级软件被破坏。
文档需要用到的文件及在sdk中的路径（某些文件路径可能随项目的不同而改动）： ./package/ralink/ui/luci-mtk/src/modules/admin-full/luasrc/controller/admin/system.lua ./target/linux/ramips/image/ Makefile
./package/base-files/files/lib/upgrade/common.sh ./package/base-files/files/lib/functions.sh ./package/base-files/files/sbin/sysupgrade ./target/linux/ramips/base-files/lib/ramips.sh
./target/linux/ramips/base-files/lib/upgrade/platform.sh
文档正文：
1.从页面接受传过来的升级文件
作为整个流程的开始，功能实现在文件system.lua中。
这是一个lua文件，很容易在function index函数中找到系统升级功能的入口函数：action_flashops。在这个函数中首先通过fp = io.open(image_tmp, \打开升级临时文件：/tmp/firmware.img，打开后通过fp:write(chunk)写入页面传进来的升级文件。到这里，接受升级文件完成 。
2.检测升级文件的合法性
实现同样在文件system.lua中。
在函数image_supported()中进行检测，这个函数通过image magic number来检测升级文件是否合法。函数image_supported()会调用platform.sh脚本中的platform_check_image函数， platform_check_image函数调用ramips.sh脚本中的ramips_board_name函数，获取board name，ramips_board_name函数从文件 /tmp/sysinfo/board_name 中获取board name，若没有则为unknown，并返回给调用者，我用的板是ralink-soc。platform_check_image函数继续调用common.sh脚本中的get_magic_long函数，用以获取升级文件magic，就是升级文件前4位。get_magic_long函数调用common.sh脚本中的get_image函数用以获取文件/tmp/firmware.img内容，其实就是cat /tmp/firmware.img. 获取到的内容，通过dd bs=4 count=1，来获取前4位，最后通过hexdump -v -n 4 -e '1/1 \处理以十六进制编码返回调用者。获取到的升级文件magic，在platform_check_image函数中与27051956做对比，这个值是在固件编译的时候已经定好了的。如果相等，就是合法的升级文件，继续升级动作；不相等则为非法升级文件，做一些后续处理并终止升级动作。到这里检测升级文件合法性完成。
3.检测升级文件不合法后的处理 实现同样在文件system.lua中。 检测到不合法后，通过nixio.fs.unlink(image_tmp)来删除临时文件/tmp/firmware.img，并通过image_invalid = true，设置检测失败，用以通知页面显示提示信息。终止升级。处理完成。
4.检测升级文件合法后的处理 实现同样在文件system.lua中。
检测到升级文件合法后，会获取一些升级文件相关的信息，用以在页面显示：调用image_checksum()，获取checksum；调用storage_size()，获取可用空间大小；调用nixio.fs.stat(image_tmp).size，获取升级文件大小；以及页面传过来的是否保存配置的值；其中，image_checksum()函数用的是md5sum命令，storage_size()函数是在系统文件/proc/mtd中找到firmware分区大小。
接下来如果用户选择进行升级文件，则会现在页面上打印一些提示信息，用于提示用户：正在升级，不要断开电源等等。
文件system.lua最后的处理就是调用升级脚本：fork_exec(\dropbear uhttpd; sleep 1; /sbin/sysupgrade %s %q\。
这条语句，先清除dropbear 和uhttpd进程，再等待1秒，最后调用升级脚本sysupgrade，传过去的参数就是keep：是否要保存配置；image_tmp：升级文件/tmp/firmware.img。 OK，到这里system.lua文件中关于升级前的准备工作都完成了，视线请转到升级脚本sysupgrade上。
5.运行升级脚本
实现在文件sysupgrade中。
脚本开始，像所有的主体处理程序一样，会对传进来的参数进行处理。下面对这些参数的介绍：
-i 开启交互模式
-d 重启前延迟，延迟秒数是传进来的
-v 会打印sysupgrade脚本中的一些信息，脚本中默认打印 -q 与-v相反
-n 升级后不保存配置，默认保存配置 -c 保存所有的改动配置文件到/etc/
-b 用sysupgrade.conf中指定的文件，创建.tar.gz格式备份文件 -r 用上步创建的.tar.gz文件，恢复配置 -l 列出将会备份的文件列表 -f 从.tar.gz恢复配置
-F 即使升级文件检测失败，也要升级，这个参数是危险的，慎用 -T 验证升级文件和.tar.gz配置文件，但不升级 -h 打印帮助信息
这些参数的使用在脚本中都有介绍，不再多讲。
接下来：[ -z \，意思是：如果没有升级文件参数，且没有命令行参数-b（create-backup)，-r（restore-backup），或者带有-h（help）参数，则打印帮助信息。这个条件为真的话，会在终端打印帮助信息，退出脚本。
接下来：[ -n \，意思是：不要指定-b或-r（创建配置、恢复配置）的同时，指定升级文件。为真的话，打印提示信息，退出脚本。
接下来：[ \，意思是：选择备份配置但传进来的文件为“-”时，不打印备份文件时的过程。
下面展示一下-v选项的作用： 带-v时的升级过程：
root@OpenWrt:/# sysupgrade -i -v /tmp/firmware.img Keep config files over reflash (Y/n): y Edit config file list (y/N): n Saving config files... etc/config/dhcp etc/config/dropbear etc/config/firewall etc/config/fstab etc/config/luci etc/config/network etc/config/system etc/config/ucitrack etc/config/uhttpd etc/config/wireless
etc/dropbear/dropbear_dss_host_key etc/dropbear/dropbear_rsa_host_key etc/group etc/hosts etc/inittab etc/passwd etc/profile etc/rc.local etc/shells etc/sysctl.conf
Sending TERM to remaining processes ... dnsmasq ubusd btnd logd netifd uhttpd ntpd Sending KILL to remaining processes ... Switching to ramdisk...
Performing system upgrade... Unlocking firmware ...
Writing from
Appending jffs2 data from /tmp/sysupgrade.tgz to firmware... Writing from
不带-v时的升级过程：
root@OpenWrt:/# sysupgrade -i /tmp/firmware.img Keep config files over reflash (Y/n): y Edit config file list (y/N): n Saving config files...
Sending TERM to remaining processes ... dnsmasq ubusd btnd logd netifd uhttpd ntpd Sending KILL to remaining processes ... Switching to ramdisk...
Performing system upgrade... Unlocking firmware ...
Writing from
Appending jffs2 data from /tmp/sysupgrade.tgz to firmware... Writing from
继续分析：
if [ $CONF_BACKUP_LIST -eq 1 ]; then add_uci_conffiles \ cat \ rm -f \ exit 0 fi
如果需要列出配置文件列表，就 调用add_uci_conffiles函数生成列表，并打印到终端。函数add_uci_conffiles()，找出需要保存的配置文件。通过在文件/etc/sysupgrade.conf中 ，/lib/upgrade/keep.d/*目录下，以及命令opkg list-changed-conffiles的输出中，找出配置 文件，其中opkg list-changed-conffiles 列出用户修改的配置文件。
接下来：
if [ -n \ do_save_conffiles \ exit $? fi
如果需要创建配置备份文件，则调用函数do_save_conffiles，生成配置文件。函数do_save_conffiles()，打包上一部列出的 配置文件 。
接下来：
if [ -n \需要恢复配置 if [ \判断所需要的配置文件是否存在 echo \ exit 1 fi [ \ tar -C / -x${TAR_V}zf \ exit $? fi
经过一些判断，解压配置文件 包。 接下来：
type platform_check_image，检测platform_check_image命令是否存在，为了 下步做准备。找不到的话，脚本 退出，升级终止。
接下来：
for check in $sysupgrade_image_check;
do( eval \ ###通过board name 和image magic number来判断升级文件是否合法
if [ $FORCE -eq 1 ]; then ####检测失败了，但是因为设置了-F选项，强制升级，停止检测 echo \ break else ###检测失败，且不要求强制升级，脚本退出，停止升级 echo \ exit 1 fi } done
做升级文件的检测，$sysupgrade_image_check就是platform_check_image，这个 检测在升级开始的 时候，已经做过了 ，这里又做了一遍。如果检测失败了，但是设置了-F选项，强制升级，如果没设置，就脚本退出，停止升级。
接下来：
if [ -n \ ####需要从文件中恢复配置 case \ ####获取文件内容，并拷贝2个字节，且转换为16进制输出 # .gz files
1f8b) ;; ###检测文件失败，退出脚本，停止升级 *) echo \ exit 1 ;; esac
get_image \export SAVE_CONFIG=1
elif ask_bool $SAVE_CONFIG \ ###默认升级保存配置 [ $TEST -eq 1 ] || do_save_conffiles export SAVE_CONFIG=1 else export SAVE_CONFIG=0 fi
这段的 意思是，如果需要从文件中恢复配置，就开始处理。这个文件是从命令行参数中传进来的。get_magic_word函数在文件common.sh中，这个函数与前面所讲的get_magic_long函数实现基本一样，所 不同的是get_magic_word函数利用dd bs=2 count=1，获取头2个字
节，而不是4个。 接下来“
if [ $TEST -eq 1 ]; then exit 0 fi
这段的意思是：如果设置了-T选项，因为只是做了升级文件和.tar.gz配置文件的检测，不需要升级，脚本退出，停止升级。
接下来：
run_hooks \
这句的意思是：运行函数sysupgrade_pre_upgrade。先介绍下run_hooks函数，定义在文件common.sh中。 run_hooks() { local arg=\ for func in \ eval \ done }
run_hooks函数是钩子函数，其中传过来的第一个参数是函数运行的参数，其余参数为要运行的函数。
再介绍sysupgrade_pre_upgrade函数。定义在platform.sh文件中。 #append sysupgrade_pre_upgrade disable_watchdog
disable_watchdog() { killall watchdog ( ps | grep -v 'grep' | grep '/dev/watchdog' ) && { echo 'Could not disable watchdog' return 1 } }
其实就是在升级前，去清除watchdog进程。不过这个函数被注释掉了，所以不用管。
接下来：
ubus call system upgrade
openwrt ubus: 为了在OpenWrt中提供守护进程和应用程序间的通讯，开发了ubus项目工程。它包
含了守护进程、库以及一些额外的帮助程序。
核心部分是ubusd守护进程，它提供了其他守护进程将自己注册以及发送消息的接口。因为这个，接口通过使用Unix socket来实现，并使用TLV(type-length-value)消息。
用法：Usage: ubus [
这句的意思是：调用注册到ubus进程的system路径下的update方法，update方法设置了upgrade_running变量值为1，使得在ubus上注册的服务退出时无需等待。
接下来：
kill_remaining TERM sleep 3 kill_remaining KILL kill_remaining函数，这个函数定义在common.sh文件中，就是发送信号给一些应用层进程。 用以升级前清除进程。
接下来：
run_ramfs '. /lib/functions.sh; include /lib/upgrade; do_upgrade'
是sysupgrade脚本的最后一句。也是开始升级的地方。 run_ramfs函数定义在common.sh文件中，先是安装一些命令到/tmp/root下，再在/tmp/root下构建一个临时文件系统。最后调用exec /bin/busybox ash -c \，来调用do_upgrade函数。do_upgrade函数调用platform_do_upgrade函数，platform_do_upgrade函数调用default_do_upgrade函数。
default_do_upgrade() { sync if [ \ get_image \| mtd $MTD_CONFIG_ARGS -j \write - \ else get_image \ fi }
介绍一下这个函数，sync命令的作用是，将有关文件系统的存储器常驻信息送入物理介质内，以确保文件系统的完整性。然后就是根据是否需要保存配置去分别调用mtd命令，去完成升级。
接下来：
v \ [ -n \ ask_bool 1 \ v \ reboot -f sleep 5 echo b 2>/dev/null >/proc/sysrq-trigger
升级完了，需要重启了。整个升级流程到这里，就完成了。
6.添加升级文件标识以及升级文件md5值
功能很简单，就是在升级文件前添加一个自定义的字段，以及升级软件的md5值。用以阻止刷机，以及升级文件被破坏。字段以及md5值添加在编译时进行的。字段、md5值取出，是在升级文件检测时进行的。
添加字段：
在Makefile(路径前面已经列出)文件中，最后生成升级文件的地方添加。 define MkImageSysupgrade/squashfs $(eval output_name=$(IMG_PREFIX)-$(2)-$(1)-$(if $(4),$(4),sysupgrade).bin) $(eval output_name_tmp=$(IMG_PREFIX)-$(2)-$(1)-$(if $(4),$(4),sysupgrade_tmp).bin) cat $(KDIR)/vmlinux-$(2).uImage $(KDIR)/root.$(1) > $(KDIR)/$(output_name) $(call prepare_generic_squashfs,$(KDIR)/$(output_name)) if [ `stat -c%s \ echo \ else \\ $(CP) $(KDIR)/$(output_name) $(BIN_DIR)/$(output_name_tmp); \\ fi + echo \ + md5sum $(BIN_DIR)/$(output_name_tmp) | cut -d ' ' -f 1 >> $(BIN_DIR)/mykey + cat $(BIN_DIR)/mykey $(BIN_DIR)/$(output_name_tmp) > $(BIN_DIR)/$(output_name) + rm -rf $(BIN_DIR)/$(output_name_tmp) + rm -rf $(BIN_DIR)/mykey
endef行前有+号的地方就是添加的代码。添加了”100msh“字段在升级文件前。
字段取出：
get_image() { #
+ {
+ echo \ + }|| + {
+ echo \ + exit 1 + } + sed -i \ + head -n 1 /tmp/myupfile > /tmp/check + sed -i \ + md5sum /tmp/myupfile | cut -d ' ' -f 1 > /tmp/mymd5 + diff -r /tmp/check /tmp/mymd5 + if [ $? -ne 0 ] ; then + echo different + exit 1 + fi + rm -rf /tmp/check /tmp/mymd5 + cat /tmp/myupfile + }
行前有+号的地方，就是添加的代码。就是取出第一行，其他不变。
另外default_do_upgrade()函数中的get_image \，修改成cat /tmp/myupfile，因为在调用default_do_upgrade()函数时，get_image函数中有些命令已经不能再用。
OK，文档到此结束。
水平有限，如有错误，请多包涵。 2015.10.30