华为小鸿AI 开发者进阶与二次开发：从环境搭建到烧录实战

系列博客第 4 篇 · 关键词：Ubuntu 环境 / 源码编译 / 镜像烧录 / 14 个示例 / 全开源

前面三篇都是"用"。这一篇，我们动手"改"——毕竟它最大的卖点就是原理图 + 固件全开源。

为什么要折腾开发环境

普通用户配完网、聊聊天就够用了。但小鸿真正的差异化在于：硬件原理图和底层固件全开源。这意味着你能：

• 改写固件、定制系统行为；
• 通过 UART / I2C / GPIO 接自己的外设；
• 把自有 AI 服务接进去，打造专属语音终端；
• 作为鸿蒙 + RISC-V + 星闪的教学/实训载体。

官方文档仓库在 atomgit.com/xiaohong-ai/docs，工具和驱动（如 UartAssist、CH341 驱动）在 tools 目录。下面按"搭环境 → 编源码 → 烧镜像 → 跑示例"的顺序走一遍。

---

一、开发环境搭建（Ubuntu）

官方推荐在 Ubuntu 18.04 ~ 22.04 下编译。Windows / macOS 用户可用虚拟机装 Ubuntu。

系统要求

• 系统版本：Ubuntu 18.04 ~ 22.04（推荐 22.04）；
• 内存：16GB 及以上；
• 硬盘：200GB 及以上；
• 用户名：不能包含中文字符（否则后续编译/路径可能踩坑）。

没有 Ubuntu 实体机？在 Windows 里用 VirtualBox / VMware 装一个 Ubuntu 22.04 虚拟机即可，官方文档也明确支持这种"虚拟机方式搭建"。

把 Shell 改成 bash

OpenHarmony 工具链大量脚本依赖 bash，Ubuntu 默认 sh 可能指向 dash，需要改回来：

# 1. 查看当前 sh 指向
ls -l /bin/sh
# 期望输出：/bin/sh -> bash
# 如果不是 bash，执行下面一步修改为 bash

若上一步输出不是 bash，用下面命令切换（会弹出菜单，选 bash 并确认）：

sudo dpkg-reconfigure dash

改完再次 ls -l /bin/sh 确认指向 bash，环境准备就完成了。

---

二、获取源码与文档

从小鸿官方文档中心拉取文档与源码入口（文档仓库 atomgit.com/xiaohong-ai/docs）。整体开发路径官方概括为三步：

1. 了解产品：读「产品概述」；
2. 搭建与烧录：按「开发指南」完成 环境搭建 → 编译小鸿源码 → 烧录镜像；
3. 运行示例：从「实操案例」进入各示例。

---

三、编译小鸿源码

在 Ubuntu 环境就绪后，按官方开发指南执行源码编译。具体编译命令以官方「开发指南 / 源码编译」章节为准（不同版本路径可能微调，请以你拉取到的文档为准）。

编译前确认：用户名无中文、Shell 为 bash、内存 ≥16GB、磁盘余量充足。这些条件不满足时，编译最容易在半路报错。

---

四、烧录镜像（Windows / macOS）

编译产出镜像后，需要烧录到小鸿的 WS63 芯片上。官方提供了分平台的烧录指南：

• Windows：参考「开发指南 / 烧录小鸿镜像 (windows).md」，并准备 CH341 等驱动、UartAssist 等工具（在仓库 tools 目录获取）；
• macOS：参考「开发指南 / 烧录小鸿镜像 (macos).md」。

烧录通用要点：

1. 用 Type-C 数据线连接小鸿与电脑（小鸿的 Type-C 支持数据传输 + 供电）；
2. 安装对应驱动（如 CH341）；
3. 用烧录工具载入编译好的镜像，按指南步骤写入；
4. 烧录完成后重启设备，验证是否进入新固件。

烧录属于"写死"操作，建议首次严格照官方文档逐步走，别跳步。烧错镜像可能导致设备无法启动，需要重新烧回官方镜像。

---

五、14 个实操示例：从 HelloWorld 开始

官方「实操案例」提供了 14 个示例，覆盖从基础到外设：

• HelloWorld：验证工具链与烧录链路通不通的" Hello World"；
• UART / I2C / SPI / GPIO 等外设示例：对接串口、传感器、扩展接口；
• Wi-Fi 示例：联网能力验证；
• 其余示例涵盖更多系统/联接能力。

运行任何示例前，务必先读官方的 「重要：示例运行前」 说明（各案例入口页均有提示），避免硬件/环境前置条件没满足就跑。

扩展接口一览（二次开发重点）

小鸿预留了三组扩展接口，是接外设的关键：

接口	数量	典型用途
UART	×1	串口调试、接串口外设/传感器
I2C	×1	接 I2C 传感器、显示屏等
GPIO	×1	通用输入输出，控制继电器/LED 等

配合 UART / I2C / SPI / GPIO 示例，你可以把小鸿从"语音盒子"扩展成"带语音的 IoT 网关"。

---

六、全开源的生态价值

把四篇串起来看，小鸿 AI 的独特性就清楚了：

• 对用户：一台能聊天、能控家的端侧 AI 小方块；
• 对开发者/高校：原理图 + 固件全开源，可读、可改、可学，是鸿蒙 + RISC-V + 星闪 三大自主技术栈的低成本实训平台。

在"可用"到"好用"的国产开源生态爬坡期，这种"看得见、改得动、学得会"的硬件，价值不止于产品本身。

---

七、系列总结

篇目	主题	你学到什么
① 开箱与初识	产品定位 + 技术底座 + 参数	认清楚这是"华为技术底座上的开源鸿蒙硬件"
② 配网与初始化	SoftAP 配网 + 云端绑定	从开机到连上云端全链路打通
③ 日常使用与语音交互	唤醒 + 对话 + 控家	三颗键、一块屏、一声唤醒的日常玩法
④ 开发者进阶	环境 + 编译 + 烧录 + 示例	把开源优势真正用起来的开发路径

小鸿 AI 很小，但它是"开源鸿蒙 + RISC-V + 星闪"全栈自主技术的一个漂亮缩影。无论你是想用它提升生活效率，还是想改它练手国产技术栈，这台 47mm 的小方块都值得上手。