鸿蒙南向开发教程Day1:Hi3861 开发环境配置完全指南

适用场景 :OpenHarmony 轻量系统开发、物联网 Wi-Fi 设备原型、鸿蒙南向设备入门

更新时间 :2026年6月

官网下载 :https://device.harmonyos.com/cn/develop/ide


一、前言:为什么选择 Hi3861?

Hi3861 是华为海思推出的 2.4GHz Wi-Fi SoC 芯片 ,内置 Cortex-M0+ 内核,支持 OpenHarmony 轻量系统(LiteOS-M)。它广泛应用于智能家居、传感器节点、远程控制等物联网场景,是学习 鸿蒙南向开发 的理想起点。


二、方案选择

方案 适用人群 优点 缺点
Windows + DevEco Device Tool + 个人贡献工具链 ⭐ 初学者、快速验证 一键安装、工具链解压即用、示例代码完整 社区维护,非官方
Windows + DevEco Device Tool(官网流程) 追求官方支持 官方文档完善 工具链需手动下载配置,示例代码不全
Linux + DevEco Device Tool Ubuntu 用户 原生 Linux 环境 内存要求较高(16GB+)
Ubuntu + 命令行编译 深度开发者 贴近生产环境 配置复杂

⭐ 强烈推荐新手 :使用 个人贡献的 DevTools_Hi3861V100_v1.0 工具链 + 完整示例代码仓库,5 分钟完成环境搭建。


三、Windows 环境搭建(推荐方案)

3.1 系统要求

  • 操作系统:Windows 10 64位
  • 内存:8GB 及以上(建议 16GB)
  • 硬盘:100GB 及以上
  • 分辨率:1280×800 像素及以上

3.2 下载安装 DevEco Device Tool(必须从官网)

⚠️ 重要 :DevEco Device Tool 必须从官网下载安装包,不要从 VSCode 插件市场直接安装。

  1. 访问官网:https://device.harmonyos.com/cn/develop/ide
  2. 下载 devicetool-windows-tool-4.0.0.400.zip(194MB)
  3. 解压并运行安装程序
  4. 安装过程中自动集成 VSCode + DevEco Device Tool 插件
  5. 一定要先下载好python3.8

3.3 下载个人贡献工具链(⭐ 关键步骤)

由于 Windows 下 DevEco Device Tool 无法直接下载工程,且官网工具链配置繁琐,社区贡献者打包了一站式工具链:

资源 地址 说明
编译烧录工具链 https://atomgit.com/zjx_jason/DevTools_Hi3861V100_v1.0 含 riscv32-unknown-elf-gcc、gn、ninja、HiBurn、CH341SER 驱动
完整示例代码 https://atomgit.com/zjx_jason/Hi3861 含 DHT11、OLED、MQTT、华为云等完整示例

该工具链和示例代码由 HiSpark 社区 / zjx_jason 个人贡献,包含:

  • riscv32-unknown-elf-gcc 编译工具链
  • gn、ninja 构建工具
  • HiBurn 烧录工具
  • CH341SER.EXE USB 转串口驱动
  • DHT11 温湿度传感器、0.96寸 OLED、MQTT 上传华为云等完整示例代码

解压路径建议 :使用纯英文路径,如 D:\DevTools_Hi3861V100_v1.0,不要放在中文目录或桌面。


四、获取源码并导入工程

4.1 问题说明

在 Windows 环境下,DevEco Device Tool 无法直接从 IDE 内下载/拉取 OpenHarmony 工程源码 。必须通过 Git 命令行 先手动克隆源码到本地,然后再导入到 IDE 中。

4.2 安装 Git

如果尚未安装 Git,先下载安装:

4.3 克隆源码(两种方式)

方式一:使用个人贡献的完整示例代码(⭐ 推荐)

该仓库包含更完整的示例代码(DHT11、OLED、MQTT、华为云等):

bash 复制代码
# 创建工作目录(放在磁盘根目录,避免 Windows 260 字符路径限制)
mkdir D:\OpenHarmony && cd D:\OpenHarmony

# 克隆完整示例代码
git clone https://atomgit.com/zjx_jason/Hi3861.git
方式二:使用 HiSpark 官方 SDK
bash 复制代码
mkdir D:\OpenHarmony && cd D:\OpenHarmony

# 克隆 HiSpark SDK(体积小,约 413MB)
git clone https://gitee.com/HiSpark/hi3861_hdu_iot_application.git

⚠️ Windows 路径限制 :由于 Windows 自身限制,路径不能超过 260 个字符。Git 下载和解压时尽量放在磁盘根目录下,否则会导致编译报错 account_related_group_manager_mock.c: No such file or directory。

4.4 导入工程到 DevEco Device Tool

  1. 打开 VSCode
  2. 按 Ctrl+Shift+P → 输入 DevEco: Import Project
  3. 选择刚才 Git 克隆的源码目录
  4. SOC 选择 HI3861 ,开发板选择 hi3861 ,点击"导入"

4.5 配置工具链路径

  1. 点击左侧 工程配置(Project Settings)

  2. 找到 compiler_bin_path 选项

  3. 选择之前下载的 DevTools_Hi3861V100_v1.0 文件夹路径

  4. 确保指向 env_set.py 文件所在的目录层级


五、编译验证

5.1 编译

  • VSCode 底部工具栏点击 Build 按钮
  • 或使用快捷键 Ctrl+Shift+B
  • 初次编译约需 2分30秒 (使用裁剪后的 SDK)

编译成功后,会在 out/ 目录下生成 Hi3861_wifiiot_app_allinone.bin 文件。

5.2 烧录(可选,验证硬件)

  1. 安装驱动 :如电脑未安装 CH340G 驱动,运行 DevTools_Hi3861V100_v1.0/usb_serial_driver/CH341SER.EXE

  2. 连接开发板:USB 线连接电脑

  3. 配置烧录端口 :点击左侧"工程配置",找到 upload_port ,选择开发板对应的 COM 口

  4. 点击烧录 :IDE 内点击 Upload,或使用 BurnTool.exe

烧录参数:Baud: 921600,Flash 起始地址: 0x0,烧录过程约 30 秒。


六、命令行编译方式(可选)

如果你习惯命令行,可以使用工具链自带的脚本:

bash 复制代码
# 进入工具链目录,双击运行 env_start.bat,进入专用命令行环境
D:\DevTools_Hi3861V100_v1.0> env_start.bat

# 切换到 SDK 的 src 目录
[DevTools] D:\DevTools_Hi3861V100_v1.0> cd D:\OpenHarmony\Hi3861\src

# 编译
[DevTools] D:\OpenHarmony\Hi3861\src> hb set
[DevTools] D:\OpenHarmony\Hi3861\src> hb build

编译后使用 BurnTool.exe 烧录镜像。


七、常见问题排查

问题现象 可能原因 解决方案
IDE 内无法下载工程 Windows 版限制 必须先用 Git 克隆,再导入
编译报错路径过长 Windows 260 字符限制 将 SDK 放在磁盘根目录,如 D:\OpenHarmony\
找不到 DevEco 命令 未从官网安装 必须从官网下载安装包
烧录时端口消失 串口被占用 关闭其他串口调试工具
设备管理器显示未知 USB 驱动未安装 运行 CH341SER.EXE 安装驱动
编译提示找不到工具链 路径配置错误 检查 compiler_bin_path 是否指向 env_set.py 所在目录
烧录后无输出 波特率不匹配 串口工具设置为 115200 波特率

八、总结

Hi3861 的 Windows 开发环境核心要点:

  1. DevEco Device Tool 必须从官网下载安装包
  2. 源码必须通过 Git 克隆,IDE 内无法直接下载
  3. 使用个人贡献的 DevTools_Hi3861V100_v1.0 工具链,省去手动配置
  4. 使用个人贡献的 Hi3861 完整示例代码,包含 DHT11、OLED、MQTT、华为云等实战代码
  5. 路径必须用英文且尽量短,避免 Windows 260 字符限制

掌握这套流程后,30 分钟内即可完成环境搭建并编译通过。


参考资源

资源 地址 说明
DevEco Device Tool 官网 https://device.harmonyos.com/cn/develop/ide 官方 IDE 下载
个人贡献工具链 https://atomgit.com/zjx_jason/DevTools_Hi3861V100_v1.0 含编译工具、烧录工具、驱动
个人贡献完整示例代码 https://atomgit.com/zjx_jason/Hi3861 含 DHT11、OLED、MQTT、华为云示例
HiSpark SDK 源码 https://gitee.com/HiSpark/hi3861_hdu_iot_application 官方裁剪版 SDK
OpenHarmony 完整源码 https://gitee.com/openharmony 完整系统源码
官方文档(Windows 编译指南) https://device.harmonyos.com/cn/docs/documentation/guide/hi3861-windows-0000001445255984 华为官方指南
相关推荐
Sirius_Ji18 小时前
# 一份鸿蒙原生支持硬解的 ffmpeg 开发基座
harmonyos
贾伟康19 小时前
HarmonyOS API 26 Navigation路由栈上限:stackSizeLimit、过载保护与容量观测
harmonyos·arkts·navigation·navpathstack·api26
江华森1 天前
把鸿蒙云手机调试的 5 个坑写成 Skill:12 项检查清单与报错决策树
harmonyos
木木子221 天前
用华为云码道构建校园导航应用「新生通」:从需求分析到工程落地
华为·华为云·harmonyos
贾伟康1 天前
HarmonyOS API 26 Navigation 自适应模式:mode、分栏切换与窗口断点治理
harmonyos·arkts·arkui·navigation·自适应布局
贾伟康1 天前
【转盘决定吧|07】HarmonyOS ArkTS 6.0.2.130 趣味题库:场景分类、随机选择与详情页解耦
harmonyos·arkts·路由·数据建模·arkui
贾伟康1 天前
【电路实验模拟|03】HarmonyOS ArkTS 交通灯实战:用定时状态切换红黄绿灯
harmonyos·arkts·canvas·arkui·交通灯
贾伟康2 天前
HarmonyOS API 26 嵌套 Navigation:getParent、父子栈边界与返回分发
harmonyos·arkts·navigation·嵌套路由·navpathstack
行者-全栈开发2 天前
【鸿蒙心迹】多线程并发实战——TaskPool 与 Worker 选型与踩坑(HarmonyOS 7.x)
华为·harmonyos·多线程并发·worker·taskpool·线程通信·harmonyos 并发
OH_TPC2 天前
@ohos/aki 源码解读(一):一行绑定背后,宏、模板与索引分发
harmonyos