跳到主要内容

Version Matrix

本页用于处理四类常见问题：确认设备当前版本、准备开发与烧录组件、排查 OS 升级被拒，以及确认出厂预置内容。

版本基线对应 hailo15-ne503 设备的 OS 1.12.0（build 2026-07-29）。这是一个发布快照，不代表所有设备都完全相同：接口板 MCU 版本为样机实测值，模型和应用则可能随订单或固件配置变化。

1. 版本基线​

1.1 设备端组件​

先核对设备端的版本，再判断 SDK、应用或升级包是否匹配。界面名称保留设备上的英文标签，便于直接定位。

组件版本基线核对位置版本性质
系统 OS1.12.0；build 2026-07-29；machine hailo15-ne503Settings → Device Info 的 System OS Version；也可通过 SSH 执行 cat /etc/os-release 和 cat /etc/build-infoOS 发布版本
平台服务v1.0.1Settings → Device Info 的 Firmware Version；设备文件 /data/aipc/VERSION与 OS 配套发布和升级的平台版本
Web 控制台0.2.4前端源码 web/package.json；Web 控制台不一定显示独立的前端版本号Web UI 包版本，不等同于 OS 或平台服务版本
接口板 MCU 固件0.1.7.0（样机实测）Image → Device Overview 的 MCU Ver；也可查询已认证的设备状态 API设备相关硬件固件，实际值应以设备为准

查询 MCU 版本时，/api/v1 接口需要 Bearer token：

curl -k https://<device-ip>/api/v1/device/status \
  -H "Authorization: Bearer <token>"

读取返回结果中的 data.mcu_version 字段。不要把未携带 token 时的 401 当作 MCU 版本验证失败。

1.2 开发与烧录组件​

这些组件用于开发、打包或烧录，不应与设备端的 OS、平台服务版本混在同一列比较。

组件版本基线使用时的版本关系
Python SDK0.4.0；包名/模块名为 hailo_ipc_sdk使用 neoruntime-sdks Releases 中对应版本的 wheel
C++ SDK0.1.0；命名空间为 hailo_ipc_sdkC++ SDK 独立编号，同时镜像 Python SDK 0.4.0 的接口能力；API 参考见 Doxygen 文档站
示例应用（neoruntime-apps）无独立版本号从 neoruntime-apps Releases 获取构建包，例如 showcase-bundles-latest；应用包随主线发布
烧录工具 hailo15_board_tools1.10.1使用 meta-hailo-os 的 tools/ 目录中与固件发布线配套的工具；操作步骤见系统烧录

版本来源：系统 OS 和烧录工具见 camthink-ai/meta-hailo-os，平台服务和 Web 控制台见 camthink-ai/neoruntime，SDK 见 camthink-ai/neoruntime-sdks。

2. OS 升级兼容关卡​

安装 .swu 升级包前，平台会同时检查升级包、运行中的 OS、设备硬件和恢复镜像。当前 OS 1.12.0 发布线中的基线值如下；machine、product 和 hardware-compatibility 来自设备身份，另外三项用于约束运行时、数据和恢复工具链的版本关系。

关卡当前基线平台检查什么失败时先检查
machinehailo15-ne503升级包目标 machine 必须与设备一致是否拿错了其他机型的升级包
productne503产品标识必须一致是否使用了 NE503 对应的升级包
hardware-compatibility1.0设备硬件版本必须在升级包声明的兼容列表中升级包是否支持当前硬件版本
aipc-compat-level1平台兼容等级必须严格相等OS、平台服务和应用是否来自同一配套发布线
data-schema1数据结构版本必须有效，并与设备数据兼容OS、应用和设备上的数据结构版本是否匹配；不要为绕过校验随意删除数据
min-recovery-version1.0.1当前 recovery 版本必须达到升级包要求的最低版本是否需要先按支持的发布路径更新 recovery

任一关卡不通过，升级包会在安装前被拒绝。校验逻辑见 neoruntime 的 OS upgrade implementation。

处理升级失败时，先按错误中指出的关卡处理：

  • machine、product 或 hardware-compatibility 失败：更换为目标机型、产品和硬件版本匹配的升级包。
  • aipc-compat-level 或 data-schema 失败：使用同一配套发布线的 OS、平台服务和应用，不要混用不同发布线的组件。
  • min-recovery-version 失败：先确认 recovery 版本，并按照支持的升级路径更新 recovery。

如果错误没有明确指出关卡，先保留页面提示和设备日志，暂停升级并确认升级包来源；不要仅凭文件名猜测兼容关系。

3. 可选出厂预置​

以下内容来自 neoruntime 的 configs/preload.yaml，表示平台默认可以打包的出厂预置选项。实际设备是否包含这些内容，以订单和固件配置为准。

默认预置模型（12 个）​

类别模型文件（.hef）用途
检测detection/hailo_yolov8n_384_640.hef通用目标检测
检测detection/yolov5m_vehicles.hef车辆检测
检测detection/tiny_yolov4_license_plates.hef车牌检测
分类classification/vit_large.hef图像分类
分割segmentation/linknet_mbv1_ss_dpm_256.hef图像分割
关键点keypoint/face_landmarks_lite.hef人脸关键点
CLIPclip/clip_vit_b_32_image_encoder_nv12.hefCLIP 图像编码
CLIPclip/clip_vit_b_16_image_encoder.hefCLIP 图像编码
深度估计depth/scdepthv3.hef单目深度估计
OCRocr/paddle_ocr_v5_mobile_detection.hef文本检测
OCRocr/paddle_ocr_v5_mobile_recognition_nv12.hef文本识别
OCRocr/lprnet.hef车牌识别

GenAI 模型 genai/Qwen3-VL-2B-Instruct.hef 在配置中是注释掉的可选项（约 3 GB），不计入上述 12 个默认模型。

可选预装应用​

应用自动启动说明
AI Model Showcase（model-showcase）否多模型能力演示应用；如果设备已预装，首次使用时从 Applications 页面手动启动

4. 相关文档​