应用笔记|米尔NXP iMX 93开发板OTA功能搭建
2024-05-23
472
来源:米尔电子
1. 概述
空中下载技术(Over-the-Air Technology, OTA)是通过移动通信的空中接口实现对移动终端设备及SIM卡数据进行远程管理的技术。本文采用了swupdate的方式进行ota升级,swupdate是一个基于嵌入式的Linux平台的升级服务框架程序,它提供了分区升级,文件升级,差分升级(补丁应用)功能,并提供了开放接口,方便用户添加自定义升级处理函数。本应用笔记主要讲述如何使用搭建在米尔基于NXP iMX 93核心板系统中的OTA功能,实现对米尔基于NXP iMX 93核心板文件系统的远程升级。
2. 环境准备
2.1. 软件资源
OTA升级文件制作工具:ota-generate_swu.tar.gz(路径:03_Tools/ota-tools)。
MYC-LMX9X-Core文件系统:myir-image-core-myd-lmx9x.ext4(路径:02_Images/ 或者通过Yocto编译得到,编译相关情况查看软件开发指南内容)。
Ubuntu操作系统主机环境,虚拟机或者安装的Ubuntu PC主机皆可,没有版本要求。
2.2. 硬件资源
米尔基于NXP iMX 93开发板(或者MYC-LMX9X核心板+自研底板,自研底板要求至少有一个网口或者存在Wifi芯片)。
网线或者Wifi天线。
开发板电源、串口线及其他能够确保开发板能够正常运行启动所需求的配件。
2.3. 主机环境配置
进行OTA升级,必须要要在Ubuntu主机环境搭建Http服务器,以下将以Ubuntu18.04的Http服务器搭建过程举例,用户名将以myir举例,为了后续OTA升级使用,将Http服务器直接配置为后续可直接使用的配置。该过程仅供参考使用,如果使用其他版本的Ubuntu系统在搭建过程中出现任何以下说明中未出现的错误情况,请咨询互联网寻找解决办法。
安装apache2
sudo apt install -y apache2
配置环境
默认是80端口,防止其他情况使用导致冲突,修改为自定义端口:8001,修改 /etc/apache2/ports.conf文件监听端口:
$: vi /etc/apache2/ports.conf Listen 8001 ## 其它行不变
修改/etc/apache2/sites-enabled/000-default.conf文件端口与访问目录,方便后续使用。
$: vi /etc/apache2/sites-enabled/000-default.conf <VirtualHost *:8001> ## 其他行不变 #DocumentRoot /var/www/html ## 默认浏览器访问目录,注释掉 DocumentRoot /home/myir/swupdate ##修改为此目录,用户名请根据修改做修改
修改apache2的配置文件/etc/apache2/apache2.conf:
$: vi /etc/apache2/apache2.conf ##找到如下行,并修改为如下内容 #<Directory /var/www/html> ##配置文件默认目录,注释掉 <Directory "/home/myir/swupdate"> Options Indexes FollowSymLinks AllowOverride None Require all granted </Directory>
重启服务
$: sudo /etc/init.d/apache2 restart
测试
如果是虚拟机请修改Ubuntu网络配置为桥接网卡让虚拟机和Windows主机为同一IP下,如果是其他环境则可以直接打开浏览器,并在浏览器中输入http://{hostIP}:8001,此处hostIP为配置了http服务器的Ubuntu的ip地址,例如Ubuntu 的ip地址为192.168.1.20,则在浏览器中输入:http://192.168.1.20:8001,成功则如下图所示:
图2-1. http搭建成功
3. 升级原理
OTA简单理解就是在线升级固件,将固件从服务器下载之后,相应的写入对应的分区,在这个过程中可能会存在烧录中断电或者其他原因导致分区损坏了问题,所以MYD-LMX9X选择了AB对称分区的方式来保存文件系统。
3.1. AB分区介绍
对于MYD-LMX9X的AB对称文件系统,首先做了以下逻辑处理:
首先在Uboot的env变量中添加了boot_limit,mmcbootpart,mmcbootpart_back三个变量,并且对它们添加了一定的逻辑判断,可以通过uboot命令行看到:
u-boot=> printenv boot_limit boot_limit=3 u-boot=> printenv mmcbootpart mmcbootpart=2 u-boot=> printenv mmcbootpart_back mmcbootpart_back=3 bsp_bootcmd=echo Running BSP bootcmd ...; mmc dev ${mmcdev}; if mmc rescan; then if run loadbootscript; then run bootscript; else if test ${sec_boot} = yes; then if run loadcntr; then run mmcboot; else run netboot; fi; else if run loadimage; then if test ${boot_limit} -gt 0 ;then setexpr boot_limit ${boot_limit} - 1 ;setenv boot_limit ${boot_limit} ;saveenv ;setenv mmcroot /dev/mmcblk${mmcdev}p${mmcbootpart} rootwait rw;else setenv mmcroot /dev/mmcblk${mmcdev}p${mmcbootpart_back} rootwait rw;fi;run mmcboot; else run netboot; fi; fi; fi; fi;
boot_limit的值每当开发板上电进入uboot后会将其减一,可以通过上述高亮的地方可以查看到,但是当文件系统启动成功后会被设置为3,所以假如出现了文件系统损坏的问题导致无法启动,boot_limit无法被设置为3,并且文件系统启动失败后会自动运行看门狗重启,看门狗默认时间为60s,当发现启动失败后手动重启系统也是一样的,重启后再次进入uboot,此时由于boot_limit没有被设置为3,所以此时boot_limit值为2,并且则会被再次减一。
mmcbootpart变量是当前启动的分区号,比如上述中值为2,则稍后会从mmcblk0p2启动;mmcbootpart_back是备份启动的分区号,如上述中值为3,则文件系统mmcblk0p2无法启动或者启动错误后,在boot_limit值在重启多次后为0时,将会启动mmcblk0p3备份分区。
具体的运行逻辑流程图如下:
图3-1. AB分区流程图
可以在文件系统中执行以下命令查看到eMMC中分区的情况:
root@myd-lmx9x:~# cat /proc/partitions major minor #blocks name 179 0 7634944 mmcblk0 179 1 102400 mmcblk0p1 #Image+dtb内核和设备树文件存放分区 179 2 3686400 mmcblk0p2 #A文件系统分区 179 3 3686400 mmcblk0p3 #B文件系统分区 179 32 32640 mmcblk0boot0 179 64 32640 mmcblk0boot1
3.2. Swupdate介绍
本节将介绍在上章节中,在进入文件系统后会进行swupdate的更新,该更新由systemd的服务启动,是自动更新,只需要修改对应的ip地址路径的配置即可。
首先介绍swupdate更新会需要到的swu文件,该文件由脚本制作生产,该制作工具压缩包已存放在03_Tools中,名称为ota-generate_swu.tar.gz,具体制作过程后续4.1章节会介绍,在这里先介绍其中swu文件的配置文件sw-description,该文件如下所示:
software = { version = "1.1"; description = "Firmware update for myd-lmx9x" myd-lmx9x = { hardware-compatibility: [ "1.0", "1.1" ]; stable: { main: { images:( { filename = "myir-image-core-myd-lmx9x.ext4"; device = "/dev/mmcblk0p3"; filesystem = "ext4" ; } ); bootenv:( { name="mmcbootpart"; value="3"; }, { name="mmcbootpart_back"; value="2"; } ); scripts: ( { filename = "update.sh"; type = "shellscript"; } ); };
其中包含了version,设备名称myd-lmx9x,硬件版本hardware-compatibility,stable和之中的main分支,以及images、bootenv、scripts参数。
系统内已经安装了自启动服务,在系统开机后将会自行执行,输入以下命令查看服务具体内容:
[Unit] Description=SWUpdate daemon After=swupdate.service [Service] ExecStart=/etc/myir-swupdate.sh KillMode=mixed [Install] WantedBy=multi-user.target
该服务将会自动执行/etc/myir-swupdate.sh脚本,查看该脚本内容:
#!/bin/sh . /etc/board_part_info.conf echo EMMC_DEV ${EMMC_DEV} echo SD_DEV ${SD_DEV} echo ROOTFS_A_PART=${ROOTFS_A_PART} echo ROOTFS_B_PART=${ROOTFS_B_PART} current_rootfs="" check_root_part_cmdline() { cmdline=`cat /proc/cmdline` for i in $cmdline do if [[ `echo $i | grep "root="` != "" ]];then current_rootfs=${i##*/} fi done } check_need_repalce_env() { echo ${current_rootfs} result=$(echo ${current_rootfs} | grep "mmcblk") if [[ ${result} != "" ]];then bootdev=${current_rootfs%p*} #echo bootdev ${bootdev} if [[ `grep ${bootdev} /etc/fw_env.config` == "" ]];then sed -i "s/mmcblk[0-9]*/${bootdev}/g" /etc/fw_env.config fi fi } function_on_different_part() { case ${current_rootfs:0-1} in ${ROOTFS_A_PART}) echo "rootfs A part" fw_setenv swu_mode 0 fw_setenv boot_limit 3 fw_setenv mmcbootpart ${ROOTFS_A_PART} fw_setenv mmcbootpart_back ${ROOTFS_B_PART} echo "SWUPDATE_ARGS="-v -d -uhttp://192.168.1.20/MYD-LMX9X-IMAGE/myd-lmx9x.swu -e stable,main"" > /etc/myir-swupdate.cfg ;; ${ROOTFS_B_PART}) echo "rootfs B part" fw_setenv swu_mode 0 fw_setenv boot_limit 3 fw_setenv mmcbootpart ${ROOTFS_B_PART} fw_setenv mmcbootpart_back ${ROOTFS_A_PART} echo "SWUPDATE_ARGS="-v -d -uhttp://192.168.1.20/MYD-LMX9X-IMAGE/myd-lmx9x.swu -e stable,alt"" > /etc/myir-swupdate.cfg ;; *) echo "con not distinguish part" exit 1 esac } check_root_part_cmdline check_need_repalce_env function_on_different_part
该脚本中,就会执行上一章节提到的env变量默认设置,以及会将修改/etc/fw_env.config文件,配置正确的fw_env工具可以使用的配置文件,fw_env其中包含了fw_printenv和fw_setenv可以再文件系统中修改uboot的env环境变量。
该脚本最后一部分将会把swupdate需要的配置信息添加到/etc/myir-swupdate.cfg中:
root@myd-lmx9x:~# cat /etc/myir-swupdate.cfg SWUPDATE_ARGS="-v -d -uhttp://192.168.1.20/MYD-LMX9X-IMAGE/myd-lmx9x.swu -e stable,main"
其中包含了http服务器的具体ip,和swu文件的路径,已经sw-description中的分支选择。
4. 操作步骤
4.1. 远程升级
要实现OTA功能,至少需要两块设备,分别是服务器与客户端。服务器只有一个,就是MYD-LMX9X(本文以下皆用MYD-LMX9X开发板做为示例)。开发板通过串口与PC机连接,或者也可以通过ssh的方式远程访问开发板的串口,这个步骤可以阅读快速入门指南和评估指南了解具体信息。然后将需要OTA需要的swu文件存放于PC主机,然后开发板执行对应命令即可完成OTA升级,接下来详细介绍操作步骤和注意事项。
4.1.1. 制作swu文件
首先通过MYD-LMX9X的米尔电子下载中心链接或者百度网盘共享链接获取OTA升级文件制作工具:ota-generate_swu.tar.gz。
1)解压工具
在Ubuntu主机下创建工作目录并解压该工具,解压完成后进入目录:
$: mkdir ~/swupdate $: cp <DownloadPath>/ota-generate_swu.tar.gz ~/swupdate/ota-generate_swu.tar.gz # 此处的<DownloadPath>请根据实际情况填写文件所在路径 $: cd ~/swupdate $: tar xvf ota-generate_swu.tar.gz $: ls -la total 24 drwxrwxr-x 3 beste beste 4096 4月 9 17:52 . drwxrwx--- 55 beste beste 4096 4月 9 17:52 .. -rw-rw-r-- 1 beste beste 10240 4月 9 17:52 ota-generate_swu.tar.gz drwxrwxr-x 2 beste beste 4096 4月 9 17:51 swupdate-ota $: cd swupdate-ota $: ls generate_swu.sh readme.txt sw-description update.sh
2)sw-description说明
swupdate 采用cpio的方式进行归档,该文件是描述文件,默认名称为sw-description。该文件描述了升级包归档文件中的文件信息和升级信息。sw-description内容如下:
software = { version = "1.1"; description = "Firmware update for myd-lmx9x" myd-lmx9x = { hardware-compatibility: [ "1.0", "1.1" ]; stable: { main: { images:( { filename = "myir-image-core-myd-lmx9x.ext4"; device = "/dev/mmcblk0p3"; filesystem = "ext4" ; } ); bootenv:( { name="mmcbootpart"; value="3"; }, { name="mmcbootpart_back"; value="2"; } ); scripts: ( { filename = "update.sh"; type = "shellscript"; } ); }; alt: { images:( { filename = "myir-image-full-mys-8mmx.ext4.gz"; compressed = "zlib"; device = "/dev/mmcblk0p2"; } ); bootenv:( { name="mmcbootpart"; value="2"; }, { name="mmcbootpart_back"; value="3"; } ); scripts: ( { filename = "update.sh"; type = "shellscript"; } ); }; }; }; }
该文件中的内容中,部分关键字将会在后续的开发板中进行update时使用到,这里可以先打开MYD-LMX9X开发板的串口查看下稍后会使用到的脚本,开发板eMMC启动上电并打开串口:
root@myd-lmx9x:~# ls /etc/myir-swupdate* /etc/myir-swupdate.cfg /etc/myir-swupdate.sh
可以看到swupdate使用到的脚本和cfg配置文件,打开配置文件:
root@myd-lmx9x:~# cat /etc/myir-swupdate.cfg SWUPDATE_ARGS="-v -d -uhttp://192.168.1.20/MYD-LMX9X-IMAGE/myd-lmx9x.swu -e stable,main"
如果没有此配置文件,请先执行如下脚本,关于该脚本的具体描述,会在后续的3.1.2章节讲述:
root@myd-lmx9x:~# /etc/myir-swupdate.sh EMMC_DEV 2 SD_DEV 1 ROOTFS_A_PART=2 ROOTFS_B_PART=3 mmcblk0p2 rootfs B part
可以看到配置的swu文件路径为http://192.168.1.20/MYD-LMX9X-IMAGE/myd-lmx9x.swu,其中选择sw-description说明文件中stable的main分支,可以对比参考刚才sw-description中的内容阅读理解。
其中选择main分支下的内容则将把myir-image-core-myd-lmx9x.ext4文件系统烧录到/dev/mmcblk0p3也就是开发板eMMC下的第三个分区,其中mmcblk0p1第一个分区为内核文件和设备树文件存放分区,mmcblk0p2和mmcblk0p3是文件系统分区A和文件系统分区B。
3)构建swu文件
从02_Image或者Yocto构建编译获取到myir-image-core-myd-lmx9x.ext4,并将其放到swupdate-ota目录下
$: cp <WorkDir>/myir-image-core-myd-lmx9x.ext4 ~/swupdate/swupdate-ota # 此处的<WorkDir>请根据实际情况填写文件所在路径 $: ls generate_swu.sh myir-image-core-myd-lmx9x.ext4 readme.txt sw-description update.sh
然后将新添加的文件加入generate_swu.sh脚本:
#!/bin/bash CONTAINER_VER="1.1" PRODUCT_NAME="myd-lmx9x" FILES="sw-description myir-image-core-myd-lmx9x.ext4 update.sh" #openssl dgst -sha256 -sign swupdate-priv.pem sw-description > sw-description.sig for i in $FILES;do echo $i;done | cpio -ov -H crc > ${PRODUCT_NAME}_${CONTAINER_VER}.swu
最后执行generate_swu.sh脚本文件:
$: ./generate_swu.sh sw-description myir-image-core-myd-lmx9x.ext4 update.sh 2362324 blocks
可以看到需要的swu文件myd-lmx9x_1.1.swu构建完成。
$: ls generate_swu.sh myd-lmx9x_1.1.swu myir-image-core-myd-lmx9x.ext4 readme.txt sw-description update.sh
在执行接下来的步骤之前,要确保http服务器上可以正常访问到myd-lmx9x_1.1.swu文件,如下图所示:
图4-1. http服务器
保证开发板和搭建了http服务器ubuntu主机系统处于同一个网段下,如本文示例,开发板的ip为192.168.1.56,ubuntu主机ip为192.168.1.20,并且确保互相能够ping通。
# 查看ubuntu主机 ip $ ifconfig enp0s3: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 inet 192.168.1.20 netmask 255.255.255.0 broadcast 192.168.1.255 inet6 fe80::c403:d51c:76ad:270c prefixlen 64 scopeid 0x20<link> ether 08:00:27:47:6a:48 txqueuelen 1000 (Ethernet) RX packets 1132717 bytes 1333243911 (1.3 GB) RX errors 0 dropped 6181 overruns 0 frame 0 TX packets 64347 bytes 19130410 (19.1 MB) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 # 查看MYD-LMX9X开发板 ip root@myd-lmx9x:~# ifconfig eth0 eth0: flags=4163<UP,BROADCAST,RUNNING,MULTICAST> mtu 1500 inet 192.168.1.56 netmask 255.255.255.0 broadcast 192.168.1.255 inet6 fe80::443e:54ff:fea7:88fb prefixlen 64 scopeid 0x20<link> ether 46:3e:54:a7:88:fb txqueuelen 1000 (Ethernet) RX packets 10516 bytes 989859 (966.6 KiB) RX errors 0 dropped 0 overruns 0 frame 0 TX packets 589 bytes 46288 (45.2 KiB) TX errors 0 dropped 0 overruns 0 carrier 0 collisions 0 # 尝试Ping ubuntu主机 root@myd-lmx9x:~# ping 192.168.1.20 PING 192.168.1.20 (192.168.1.20) 56(84) bytes of data. 64 bytes from 192.168.1.20: icmp_seq=1 ttl=63 time=60.2 ms 64 bytes from 192.168.1.20: icmp_seq=2 ttl=63 time=5.73 ms 64 bytes from 192.168.1.20: icmp_seq=3 ttl=63 time=4.94 ms 64 bytes from 192.168.1.20: icmp_seq=4 ttl=63 time=2.95 ms ^C --- 192.168.1.20 ping statistics --- 4 packets transmitted, 4 received, 0% packet loss, time 3004ms rtt min/avg/max/mdev = 2.948/18.442/60.151/24.101 ms
4.1.2. 更新系统
完成上面的步骤后,开机进入文件系统,修改/etc/swupdate.sh,将网络地址修改为实际情况下的ip以及对应的文件路径:
echo "SWUPDATE_ARGS="-v -d -uhttp://192.168.1.20/swupdate-ota/myd-lmx9x_1.1.swu -e stable,main"" > /etc/myir-swupdate.cfg
修改完成后保存,重启开发板后将会自动更新该swu文件。
2024-09-06
Openharmony软件评估指南-瑞芯微RK3568开发板
Openharmony软件评估指南用于介绍在米尔的开发板上运行Openharmony系统下的核心资源与外设资源的测试步骤与评估方法。本文可作为前期评估指南使用,也可以作为通用系统开发的测试指导书使用。本文档使用于米尔电子的MYD-LR3568系列板卡,该板卡是米尔电子的嵌入式开发平台基于瑞芯微公司的高性能的嵌入式ARM处理器开发的,其中该系列使用的核心芯片为RK3568X。图1-1.米尔MYD-L
2024-09-06
7折,米尔-新唐MA35D1开发板正式开售!
近日,米尔发布基于新唐MA35D1芯片设计的嵌入式处理器模块MYC-LMA35核心板及开发板。MYC-LMA35核心板及开发板不仅集成了高性能的处理器芯片,还采用了创新的设计理念和丰富的外设资源,旨在满足新能源充电桩、工程机械控制器、OBD汽车诊断仪、工业网关、运动控制器和电力DTU等多元化应用场景的需求。为回馈广大客户的支持与厚爱,米尔电子特别推出新品MYD-LMA35开发板7折优惠活动,限量2
2024-09-06
米尔电子获年度AI创新产品奖,多款AI核心板赋能
近日,由电子发烧友网和elexcon2024深圳国际电子展暨嵌入式展、半导体展联合举办的2024第八届人工智能大会顺利举行,大会表彰了在行业中表现卓越的电子元器件和芯片、模组供应商,公布了“2024年度市场卓越表现奖”获奖名单。作为领先的嵌入式处理器模组厂商-米尔电子,凭借多款AI核心板荣获“年度AI创新产品奖”。再次展现出米尔电子在嵌入式模组行业的创新能力。米尔电子深耕嵌入式领域10多年,与ST
2024-08-28
领万元大奖!米尔电子Remi Pi 瑞米派创意秀
大赛简介为鼓励工程师勇于创新探索的精神,提升实践动手能力,更深度的体验瑞米派产品,米尔电子联合瑞萨共同发起“米尔电子&瑞萨 瑞米派创意秀”,提供瑞米派支持开发者创新应用。报名条件:需关注米尔电子公众号的用户;报名对象:面向企业、创客团队、工程师、电子爱好者、研究院等人士,不限个人或团体形式参赛。大赛日程01-活动申请【时间:2024/08/28-2024/09/30】在线填《报名申请表》,
2024-08-28
米尔携瑞萨RZ系列产品亮相Elexcon深圳国际电子展
2024年8月27日-29日,elexcon2024深圳国际电子展在深圳会展中心(福田)隆重开幕。汇聚全球优质品牌广商齐聚现场,打造电子全产业链创新展示、一站式采购及技术交流平台,展示全球产业动态及未来技术趋势。深圳市米尔电子有限公司(简称:米尔电子)作为瑞萨电子的合作伙伴参展,展出基于RZ系列的核心模组和行业应用demo。elexcon瑞萨展台-米尔活动现场精彩1:米尔RZ/G2L开发板的充电桩
2024-08-23
现场送瑞米派!预约瑞萨RZ/G通用MPU研讨会
RZ/G系列是基于Arm®Cortex®架构和RISC-V架构运行Linux操作系统的可扩展MPU平台,具有先进的图形、视频引擎和高速接口。RZ/G系列的可扩展和高效性使其成为工业自动化、楼宇自动化HMI、工业摄像头和网关应用的理想之选。8月28日,瑞萨电子将携手米尔电子、Qt、百问网、AIZIP等合作伙伴举办线下研讨会,邀您赴现场共同探讨RZ/G系列的技术细节,包括硬件架构、软件开发工具以及在工
2024-08-23
国产核心板全面进攻-RK3568开发板评测
随着端侧AI应用的落地,预计集成NPU的SoC产品将迎来爆发式的增量市场。本期与非网给大家带来一款采用国内知名SoC厂商的产品——基于瑞芯微RK3568的开发板(MYD-LR3568J-32E4D-180-I-GK)。此款开发板是米尔电子推出的一款基于瑞芯微RK3568的工业板。笔者手上的为最高规格配置的版本,4GB LPDDR4 + 32GB eMMC,工业级温度的处理器RK3568J。开发板硬
2024-08-15
原生支持17路UART和4路CAN FD,新唐MA35D1核心板发布!
米尔发布基于新唐MA35D1芯片设计的嵌入式处理器模块MYC-LMA35核心板及开发板,MA35D1是集成2个Cortex-A35与1个Cortex-M4的异构微处理器芯片。核心板采用创新LGA 252PIN设计,存储配置256MB DDR3L、256MB Nand Flash/ 8GB EMMC,同时具有丰富的通讯接口,可广泛应用于新能源充电桩、工程机械控制器、OBD汽车诊断仪、工业网关、运动控
2024-07-31
米尔RK3568加推工控板和工控机,更丰富的场景应用
国产之星-瑞芯微RK3568一直备受关注,米尔电子推广的RK3568核心板采用创新LGA设计,核心板质量更可靠,成本更优。除米粉派RK3568(MYD-LR3568开发板)之外,米尔加推MYD-LR3568-GK工控板和MYD-LR3568-GK-B工控机,丰富更多的应用场景。MYD-LR3568-GK工控板基于MYC-LR3568工业级核心板设计,搭载4核ARM Cortex-A55架构的高性能
2024-07-31
新品7折购!米尔RK3568国产开发板
近日,米尔电子发布MYC-LR3568核心板及开发板,核心板基于高性能、低功耗的国产芯片-瑞芯微RK3568。核心板采用LGA 创新设计,可实现100%全国产自主可控。为感谢广大客户支持,新品上架MYD-LR3568系列开发板7折回馈客户,原价499元,抢先体验价350元起!各型号限购20套,每个ID限购1套,售完即止!产品型号对应核心板型号工作温度MYD-LR3568J-32E4D-180-I-