4. 镜像升级

下面以Android系统为例介绍如何升级镜像。

在Android主机端，通过HMDML C++接口升级固件镜像。

4.1. 升级前操作

在主机端，需要创建一个目录用于存放固件升级程序相关文件，并完成文件准备工作。以下示例以 upgrade_firmware 为目录名。该目录需包含以下内容：

  • 镜像升级源码文件：参考 hm_fw_upgrade_example.c 示例代码，完成镜像升级源码文件，并命名为 firmware_upgrade.cpp。

    示例位于驱动安装包中 /path/to/houmo-drv-xh2/hal/export/samples 目录下，示例详情参看 示例参数说明。

  • 构建脚本：参见 创建构建脚本。

  • 编译脚本：参见 创建编译脚本。

  • 头文件：从系统软件包 /path/to/houmo-drv-xh2/hal/export/include 目录复制 hm_sys.h 和 hm_api.h 到该目录。

4.1.1. 创建构建脚本

镜像升级前，用户需创建一个 CMake 构建脚本，用于在主机端编译生成可执行文件。示例文件名为 CMakeLists.txt，主要操作如下：

  1. 设置 CMake 工程信息与 C++ 标准。

    • 指定 CMake 最低版本和工具链文件。

    • 设置 C++ 标准为 C++17，并开启调试信息。

  2. 配置 Android 平台信息。

    • ANDROID_NDK ：替换为主机端实际 NDK 安装路径。

    • ANDROID_PLATFORM ：指定 Android API 版本，例如 android-24。

    • ANDROID_ABI ：指定目标架构，例如 arm64-v8a。

    • 设置 Android STL 为共享库 c++_shared。

  3. 设置 HAL 库及头文件路径：

    • HAL_LIBRARY ：替换为主机端驱动动态库 libhal_xh2a.so 的路径。该库位于驱动安装包中 houmo-drv-xh2_<release>_android_$arch/houmo-drv-xh2/hal/lib 下。

    • 通过 include_directories 指定头文件路径，例如工程通用头文件 ${CMAKE_BINARY_DIR}/../../common 和 Android 系统头文件 ${ANDROID_NDK}/sysroot/usr/include。

  4. 添加可执行文件并链接库。

    • 通过 add_executable 设置输出可执行文件名。

    • 通过 target_link_libraries 链接 HAL 动态库，实现驱动接口调用。

完整示例如下，示例展示关键步骤代码，仅供参考，不可以直接拷贝运行。

cmake_minimum_required(VERSION 3.16)
set(CMAKE_TOOLCHAIN_FILE ${ANDROID_NDK}/build/cmake/android.toolchain.cmake)
project(IpuTest)

# 设置C++标准
set(CMAKE_CXX_STANDARD 17)
set(CMAKE_CXX_STANDARD_REQUIRED ON)
set(CMAKE_CXX_FLAGS "${CMAKE_CXX_FLAGS} -g")

# Android特定配置 - 需通过命令行传入ANDROID_NDK路径
if(NOT ANDROID_NDK)
    message(FATAL_ERROR "请通过-DANDROID_NDK=指定NDK路径")
endif()

# 设置Android平台和架构
if(NOT ANDROID_PLATFORM)
    set(ANDROID_PLATFORM android-24)  # 最低支持Android 7.0
endif()

if(NOT ANDROID_ABI)
    set(ANDROID_ABI arm64-v8a)  # 默认编译ARM64架构
endif()

# Android平台配置
set(ANDROID_STL c++_shared)  # 使用共享STL
set(ANDROID_USE_LEGACY_TOOLCHAIN_FILE FALSE)

# 设置库文件名称和搜索路径（Android平台）
set(HAL_LIBRARY_NAMES hal_xh2a)
set(LIB_SEARCH_PATHS
    ${CMAKE_CURRENT_SOURCE_DIR}/../lib/android/${ANDROID_ABI}/  # 按架构区分的库路径
    ${CMAKE_CURRENT_SOURCE_DIR}/../lib/android/  # 通用Android库路径
)
set(CMAKE_FIND_LIBRARY_SUFFIXES .so .a)  # Android常用库后缀

# 直接指定库文件绝对路径，替换所有 find_library 相关代码
set(HAL_LIBRARY /path/to/houmo-drv-xh2/hal/lib/libhal_xh2a.so)
if(NOT EXISTS ${HAL_LIBRARY})
    message(FATAL_ERROR "HAL库不存在：${HAL_LIBRARY}")
endif()
message(STATUS "找到HAL库: ${HAL_LIBRARY}")

# 包含头文件目录
include_directories(
    ${CMAKE_BINARY_DIR}/../../common
    ${ANDROID_NDK}/sysroot/usr/include  # Android系统头文件
)

# 添加可执行文件
add_executable(firmware_upgrade firmware_upgrade.cpp)

# 链接库文件
target_link_libraries(firmware_upgrade PRIVATE ${HAL_LIBRARY})

4.1.2. 创建编译脚本

在主机端，需要创建一个用于编译固件升级示例程序的 shell 脚本，并保存为 .sh 文件，例如 compile.sh。主要内容如下：

  1. 设置编译目录。在示例中，将编译产物输出到 build_android 目录。

  2. 示例中用户需根据实际环境修改变量值：

    • NDK_PATH ：主机端 Android NDK 的实际安装路径。

    • HOUMO_SDK_PATH ：主机端后摩驱动路径，通常位于驱动安装包中 houmo-drv-xh2_<release>_android_$arch/houmo-drv-xh2 目录下。

    • ANDROID_ABI ：目标架构，如 arm64-v8a。

    • ANDROID_PLATFORM ：Android平台版本，如 android-27。

  3. 执行 CMake 生成 Makefile，并通过 Make 编译生成可执行文件。

完整示例如下，示例展示关键步骤代码，仅供参考，不可以直接拷贝运行。

#!/bin/bash

# 配置编译目录
BUILD_DIR=build_android
rm -rf $BUILD_DIR
mkdir -p $BUILD_DIR
cd $BUILD_DIR

# 关键：指定 NDK 路径（替换为你的实际 NDK 路径）
NDK_PATH="/path/to/android-ndk-r27c"  # 例如：~/Android/Sdk/ndk/r27d
HOUMO_SDK_PATH="/home/useradmin/wsy/houmo-drv-xh2/houmo-drv-xh2/"
ANDROID_ABI="arm64-v8a"
ANDROID_PLATFORM="android-27"

# 执行 cmake 生成 Makefile（参数必须写在同一行，用空格分隔）
cmake --fresh .. \
-DANDROID_NDK=$NDK_PATH \
-DANDROID_PLATFORM=android-27 \
-DANDROID_ABI=arm64-v8a

# 编译（-j4 表示使用 4 线程加速）
make -j4

# 回到原目录
cd ..

4.2. 升级操作

镜像升级主要步骤如下：

  1. 完成镜像升级前准备。

    1. 确保符合 环境依赖。

    2. 安装驱动。详情参看《后摩大道® 软件平台驱动安装指南》。

    3. 下载固件镜像。

  2. 完成 升级前操作。

  3. 编译生成可执行文件。在主机端执行以下命令，生成可执行文件：

    cd upgrade_firmware
chmod +x compile.sh
./compile.sh

    编译成功后，会在编译脚本中指定的输出目录中生成可执行文件。示例中，该目录为 build_android，可执行文件名称为 firmware_upgrade。

  4. 传输文件至 Android 端。

    1. 启动Android开发板并进入 shell 模式：

      adb shell
su

    2. 将主机端的 upgrade_firmware 文件夹推送至 Android 端的 /data/houmo 目录：

      adb push upgrade_firmware /data/houmo

    3. 传输下载的镜像文件到 Android 端指定目录：

      adb push M50_<product_name>-<target_hw>_<release>/images /data/houmo/upgrade_firmware

  5. 配置环境变量。在 Android 端设置驱动库路径：

    export LD_LIBRARY_PATH=$LD_LIBRARY_PATH:/data/houmo/houmo-drv-xh2/hal/lib

  6. 升级镜像。在 Android 端，进入 upgrade_firmware 目录，执行以下命令升级。仅需升级 firmware.img 镜像。脚本运行还需提供升级镜像等参数，详情参看 示例参数说明。示例如下：

    cd /data/houmo/upgrade_firmware
./firmware_upgrade -m sync -d all -f ../../images/firmware.img

    固件升级以逻辑设备（即单颗 M50 芯片）为基本单元。对于多颗芯片的产品（如 LQ50 Duo M.2卡），须确保完成卡内所有逻辑设备的升级，建议一次完成所有逻辑设备升级。

  7. 重启Android端。升级完成后，在 Android 端执行以下命令重启系统，使新固件生效：

    reboot