diff --git a/docs/source/bsp/arm64/hieulerpi/hieulerpi.rst b/docs/source/bsp/arm64/hieulerpi/hieulerpi.rst index ba1eb62347b0208c5c2fe303ff508ec2cfb39723..69ec930ade2b05cbec6dfbb52281c4f5a33568aa 100644 --- a/docs/source/bsp/arm64/hieulerpi/hieulerpi.rst +++ b/docs/source/bsp/arm64/hieulerpi/hieulerpi.rst @@ -53,15 +53,7 @@ ____ 欧拉派海鸥系列镜像烧写方法 =========================== -1. 烧录工具烧录 - -参考: `待更新 `_ - -2. SD卡烧录 - -参考: ``_ - -____ +参考: :ref:`hieuler_update` 欧拉派海鸥系列其他用法 ======================= diff --git a/docs/source/bsp/arm64/hieulerpi/index.rst b/docs/source/bsp/arm64/hieulerpi/index.rst index a86d7eaa74769015fa5fdb63dc8ecefd87064c25..3856f6737f683b830814070c4b7de8bbbe40d24d 100644 --- a/docs/source/bsp/arm64/hieulerpi/index.rst +++ b/docs/source/bsp/arm64/hieulerpi/index.rst @@ -9,3 +9,4 @@ :maxdepth: 1 hieulerpi.rst + update.rst diff --git a/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109190816122.png b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109190816122.png new file mode 100755 index 0000000000000000000000000000000000000000..f2e41bf9ef9ec994d0bb9d9ff4a55e556dc4d324 Binary files /dev/null and b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109190816122.png differ diff --git a/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109191016753.png b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109191016753.png new file mode 100755 index 0000000000000000000000000000000000000000..c5652927c0a4b7b8ac162907140bd96a6445e751 Binary files /dev/null and b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109191016753.png differ diff --git a/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109191644850.png b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109191644850.png new file mode 100755 index 0000000000000000000000000000000000000000..ac0f9480ea4f14ab3ada0da56f7e8bf079fea1d3 Binary files /dev/null and b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109191644850.png differ diff --git a/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109191741414.png b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109191741414.png new file mode 100755 index 0000000000000000000000000000000000000000..944b7fabbc4dee8b3143c5bfe11fdbb0b0bb86bf Binary files /dev/null and b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240109191741414.png differ diff --git a/docs/source/bsp/arm64/hieulerpi/update.image/image-20240117160750190.png b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240117160750190.png new file mode 100755 index 0000000000000000000000000000000000000000..f3de6310006a7098bbd3063128e2a9441a03383d Binary files /dev/null and b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240117160750190.png differ diff --git a/docs/source/bsp/arm64/hieulerpi/update.image/image-20240117161546287.png b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240117161546287.png new file mode 100755 index 0000000000000000000000000000000000000000..997288e645c224acfe5be6c481e579d76cf3faba Binary files /dev/null and b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240117161546287.png differ diff --git a/docs/source/bsp/arm64/hieulerpi/update.image/image-20240118094323958.png b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240118094323958.png new file mode 100755 index 0000000000000000000000000000000000000000..a1523daaeb1f9b18a84d242c456d5e88b55be87e Binary files /dev/null and b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240118094323958.png differ diff --git a/docs/source/bsp/arm64/hieulerpi/update.image/image-20240118173740655.png b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240118173740655.png new file mode 100755 index 0000000000000000000000000000000000000000..fb3312d3f7ba670c03be06b03e15bd33690c30be Binary files /dev/null and b/docs/source/bsp/arm64/hieulerpi/update.image/image-20240118173740655.png differ diff --git a/docs/source/bsp/arm64/hieulerpi/update.image/img_v3_026u_aeeb3044-6d13-4006-ad00-d132d8d21bbg.jpg b/docs/source/bsp/arm64/hieulerpi/update.image/img_v3_026u_aeeb3044-6d13-4006-ad00-d132d8d21bbg.jpg new file mode 100755 index 0000000000000000000000000000000000000000..5826f1a98d71fa9605720e42fa452e3b4eae3c79 Binary files /dev/null and b/docs/source/bsp/arm64/hieulerpi/update.image/img_v3_026u_aeeb3044-6d13-4006-ad00-d132d8d21bbg.jpg differ diff --git a/docs/source/bsp/arm64/hieulerpi/update.rst b/docs/source/bsp/arm64/hieulerpi/update.rst new file mode 100644 index 0000000000000000000000000000000000000000..9f27a157818a1ecbf5f54fa2d89035983b6ab084 --- /dev/null +++ b/docs/source/bsp/arm64/hieulerpi/update.rst @@ -0,0 +1,194 @@ +.. _hieuler_update: + +SD卡启动与升级操作指南 +====================== + +一、简介 +-------- + +**欧拉派-海鸥** 系列为用户提供以下两种升级方式： + +1. ToolPlatform工具网络升级 + +2. SD卡升级 + +这两种升级方式都是将文件写入到板载的EMMC存储中，系统默认也从此处启动。除此之外还支持SD卡启动，需要额外配置启动参数，具体操作参考第四章——SD卡启动的部分。 + +二、SD卡升级 + +------------ + +若不清楚这文件系统和系统分区可以忽略下面一小段备注，继续后面的操作。 + + 【备注】 + ：SD卡升级功能支持fat32格式和ext4格式的文件系统，在升级时会逐个扫描SD卡的每个分区，直到找到升级文件 + +.. _1-检查文件系统格式: + +1) 检查文件系统格式 +~~~~~~~~~~~~~~~~~~~ + +在windows中插入SD卡，查看SD卡的文件系统格式，若为FAT32则无需操作，若不是则需要格式化。 + +|image1| + +.. _2-拷贝固件: + +2) 拷贝固件 +~~~~~~~~~~~ + +若要进行SD卡升级，需要将固件拷贝到SD卡中，并按以下文件名命名，放在SD卡根目录的boot目录下。 + +.. code:: + + . + └── boot +    ├── boot_env.bin # uboot +    ├── boot_image.bin # uboot环境变量 +    ├── kernel # linux内核 +    └── rootfs.ext4 # 根文件系统 + +由于FAT32文件系统单文件最大仅支持4G的大小，在升级时除正常的单文件升级外还支持分块文件的升级。分块名为原始文件后追加分区编号，\ **编号从0开始**\ ，编号不允许带无意义的0，例如\ **rootfs.ext401**. + +.. code:: + + . + └── boot +    ├── boot_env.bin # uboot +    ├── boot_image.bin # uboot环境变量 +    ├── kernel # linux内核 +    ├── rootfs.ext40 # 根文件系统 +    ├── rootfs.ext41 +    ├── rootfs.ext42 +    ├── rootfs.ext43 +    ├── rootfs.ext44 +    └── rootfs.ext45 + +.. _3-升级固件: + +3) 升级固件 +~~~~~~~~~~~ + +按住update按键，点按reset按键，在reset按键松开之后1~2s即可松开update按键。如果能连接串口可以看到以下输出则表示正在升级 + +|image2| + +出现以下问题属于正常现象，在分区中未找到升级固件，只要最终出现升级进度条即可。 + +|image3| + +三、SD卡启动 +------------ + +.. _1-创建启动sd卡: + +1) 创建启动SD卡 +~~~~~~~~~~~~~~~ + +启动SD卡只需在SD卡中创建ext4格式的文件系统即可，并通过修改\ ``sd_rootfs_num``\ 环境变量指定正确的分区。 + + 【注】： + + 1. 若正常进行分区sd卡的第一分区，分区号为1，后续分区以此类推 + + 2. 若不创建分区表直接在SD卡上创建文件系统，分区号为0 + + 3. 默认从2号分区启动 + +.. code:: bash + + # fdisk 创建分区表，具体设备节点根据实际情况修改 + sudo fidsk /dev/sdb + # mkfs.ext4创建文件系统 + sudo mkfs.ext4 /dev/sdb1 + # 将分区镜像写入分区 + sudo dd if=rootfs.ext4 of=/dev/sdb1 + +.. code:: bash + + # 在uboot终端中执行以下命令设置SD卡启动分区 + setenv sd_rootfs_num 1 + +.. _2-从sd卡启动: + +2) 从SD卡启动 +~~~~~~~~~~~~~ + +若要从SD卡启动则需要修改启动参数\ ``boot_media``\ ，在uboot的串口终端中输入\ ``print boot_media``\ 命令可查看当前的启动方式，boot_media为\ ``emmc``\ 时从板载的emmc启动，boot_media为\ ``sd``\ 时从SD卡启动。 + +.. code:: + + # print boot_media + boot_media=emmc + +设置从SD卡启动 + +.. code:: bash + + # 设置从SD卡启动 + setenv boot_media sd + # 设置从EMMC启动 + setenv boot_media emmc + +.. + + 【注】： + + 1. SD卡启动必须为ext4格式的文件系统 + + 2. 默认从SD卡的第二分区启动，若要修改启动分区可修改环境变量\ ``sd_rootfs_num`` + +四、ToolPlatform工具 +-------------------- + +ToolPlatform工具是烧录芯片镜像的最基本工具，未烧录任何芯片的裸板，或者uboot启动损坏都可以使用该工具重新烧录镜像。若正常使用SD卡升级则无需进行本章的操作。 + +使用ToolPlatform工具烧录时除了四个固件文件，还需要一个分区表，分区表描述了烧录文件的位置，烧录分区的大小等信息 + +初次打开软件可能进入以下页面 + +点击图中最醒目的BurnTool即可进入正常烧录的界面 + +|image4| + +选择分区表后显示以下界面，点击烧写按键开始烧写，烧写开始时须复位开发板 + +|image5| + +下方的控制台在烧录过程中会打印大量日志，在烧录过程中若出现错误可提供更多的错误信息以检查问题。 + +|image6| + +五、常见问题 +------------ + +- 系统无法启动 + + 1. 验证环境变量和分区规划是否匹配 + + 2. 指定的分区位置根文件系统是否损坏 + +- 系统无法升级 + + 1. 验证升级分区是否正常 + + 2. 升级文件的路径是否正确 + + 3. 文件系统格式是否正确 + + 【注】：可直接执行\ ``run updatecmd``\ 尝试升级查看报错 + +- 无法看到系统打印信息，过一段时间会弹出一段编码 + + 1. 这种情况可能是uboot损坏导致的无法启动，参考第四章——ToolPlatform工具重新烧录uboot和env + + |image7| + +.. |image1| image:: update.image/image-20240117160750190.png +.. |image2| image:: update.image/image-20240117161546287.png +.. |image3| image:: update.image/image-20240118094323958.png +.. |image4| image:: update.image/image-20240109191644850.png +.. |image5| image:: update.image/image-20240109191741414.png +.. |image6| image:: update.image/img_v3_026u_aeeb3044-6d13-4006-ad00-d132d8d21bbg.jpg +.. |image7| image:: update.image/image-20240118173740655.png +