这套教程从一块 RK3568、一份开源鸿蒙标准系统开始。今天不装工具、不刷机先说清楚两件事为什么做开源鸿蒙以及这块板适不适合你。第一次把开源鸿蒙刷进板子很多人会晃一下神这不就是 Linux 吗串口能敲命令uname打出来也是 5.10/proc/device-tree还在I2C、GPIO、网卡该有的节点好像都有。你会下意识地掏出在普通嵌入式 Linux 上用惯的那套编一个小工具、拷上去、chmod x、跑。然后它不吃。用户态不是 GNU 那一套。动态链接器叫ld-musl-arm.so.1还是 32 位的应用不是一个 ELF是 hap要签名调试口看着像 adb命令却叫 hdc你改了设备树重启以后屏还是老样子——因为真正生效的那份 dtb往往不在你刚刷的那个分区里。所以它不是「Linux 换了个桌面」。内核那一层做过嵌入式的人确实熟熟的那一层上面是另一套操作系统。这组文章要写的就是这一层错位环境怎么搭、镜像怎么来、屏怎么亮、外设怎么把数据送到应用里。芯片默认是瑞芯微RK3568系统钉在OpenHarmony 4.1API 11。你手头若是同档 Cortex-A、同样跑标准系统路径名可能不同判断问题的方法是一样的。下面先把三件事说清楚开源鸿蒙能用在哪、为什么值得在这条生态上做南向以及你该买什么样的板。选错档后面 70 篇的命令会对不上。开源鸿蒙能用在哪官方把它定义成面向全场景的智能终端操作系统。落到工程上不要把「全场景」当成一次做完的功能清单。按设备形态常见就是这几类。带屏的人机界面。产线操作员看的 7 寸、10 寸屏楼宇门口机仓储终端充电桩和充电柜的面板医疗监护仪的显示部分。RK3568 的 VOP2 能出 HDMI、MIPI、LVDS、RGB、eDP正好覆盖从调试显示器到工业玻璃的几种接法。同一时刻通常只能把一路当主屏——这是后面显示那几篇的核心约束也是这类产品最容易踩的坑。边缘网关和联网终端。双千兆、USB 上网卡、4G/5G 模组。车间里网线优先户外屏和巡检车靠蜂窝。开源鸿蒙标准系统有网络管理子系统板载网口常常能自动 DHCPUSB 网卡和模组却经常是自己拉起来的旁路默认路由和 DNS 要另外处理。网关类产品买板时网口和 USB 口比 CPU 核数重要。采集和执行。I2C 上的温度、光感、血氧UART 上的定位和电台GPIO 上的继电器、电机、报警灯。这类设备以前用 Qt 加一堆/dev。开源鸿蒙上标准 Kit 覆盖不到的芯片仍然是 NAPI 去 open 节点但应用是 hap、要签名、进程不是 root。南向的工作量在「节点出现」和「应用读得到」之间。带预览的相机设备。门口机、扫码工位、检测工位。MIPI CSI 或 USB UVC经 ISP 或 UVC 进预览。花屏、偏暗、三条带多半不是传感器没起来是缓冲区写错、3A 没跑、格式和 stride 不一致。预览几何不正确后面任何识别模型都是吃噪声。教学和研发平台。一块核心板加底板引出 UART/I2C/SPI/GPIO插不同模块练总线和驱动。这组文章按芯片型号写模块不绑某一套外壳。总线对、芯片对就能对上号。轻量系统MCU、一百多 KB 内存做的是模组、传感器节点、简单穿戴没有这套桌面和 hap。小型系统做猫眼、IPC。这组文章只写标准系统要窗口、要 GPU 合成、要 ArkTS 应用。RK3568 属于这一档。为什么要做开源鸿蒙生态而不是只停在 Linux如果你的产品只是「内核起来、有个 Qt 窗口、能 ssh」继续用熟悉的嵌入式 Linux 完全成立。换开源鸿蒙通常是因为产品形态已经靠近「带应用框架的终端」而不只是「带网页或 Qt 的板子」。应用层是统一的。hap、Ability、ArkTS、权限和签名是一套跨设备的包格式。同一套应用模型可以从这块 RK3568 的屏对到别的标准系统设备上——前提是南向把 HDI 对齐了。相机、音频、窗口这些 Kit应用侧才能「一次开发」。HDI 没对齐ArkTS 写得再漂亮也是调空。南向做的就是把芯片接进这套接口。生态在要南向。屏厂、模组厂、做行业终端的团队需要的不是再发一份 Buildroot 镜像而是设备树、HDF、签名过的系统应用、能走 hdc 的调试链。你把 RK3568 上的显示、触摸、相机、网、外设走通后面换同档芯片改的是节点名和时钟不是世界观。这就是「做生态」在工程上的含义先有一块能被应用开发者用的板而不是只有内核开发者能用的板。分布式是后手不是第一周的主线。软总线、跨设备调度官方有专门文档。单机屏都不稳组网只是把不稳乘上 N。这组文章把单机做透分区、dtb、hap、预览。分布式点到为止。端侧模型、NPU、把相机帧送进推理放在预览稳定之后另写。和传统 Linux 不是对立。标准系统的内核就是 Linux 5.10。设备树、dmesg、示波器全部还在。多出来的是 init 配置、HDF、包管理、32 位 musl。你会写 C、会看原理图仍然可能在「刷哪一个分区」「so 是 32 位还是 64 位」上栽半天。栽了不要按发行版的经验继续加补丁按这组文章的分层往上爬。我在 RK3568 上走过的几件具体的事决定了后面为什么写得细dd写到/dev/mmcblk1p5会建成普通文件、md5 还对四颗灯一起灭是因为公版电源节点抢脚hap 没签或指纹对不上整卡刷桌面会一起没。这些不是奇闻是这套系统的路径就是这样长。先选档再选芯片开源鸿蒙能跑的芯片很多文档也因此分成三套口气。拿着 MCU 的轻量手册来对 RK3568 的桌面和 hap会对得很痛苦。档处理器官方最低内存你实际拿到的产品轻量Cortex-M / RISC-V128 KB 量级模组、节点、简单穿戴小型Cortex-A1 MB 量级猫眼、IPC、简单记录仪标准Cortex-A通常要 GPU写过 128 MB带桌面的屏、网关、本系列这条线后面所有文章默认你在标准系统、OpenHarmony 4.1、API 11。内核 Linux 5.10用户态 32 位 musl。RK3568 就是为这一档准备的。官方 128 MB 是「能起来」不是「能拿来开桌面和相机」。1 GB 会把时间耗在杀进程上。2 GB 起步4 GB 开预览更从容。标准系统板上要有什么CPU。四核 Cortex-A55、主频到 1.8 GHz 这一档。更弱的 A 核能编进内核滑动和预览会明显吃力。内存。桌面 2 GBMIPI/UVC 预览优先 4 GB。loader 要和颗粒匹配丝印 4G、loader 过旧可能只认出一部分。存储。eMMC 8 GB 能装系统16 GB 从容。另备 32 GB 以上 SD 卡刷可回滚的包。eMMC 别当草稿纸。GPU。窗口合成靠它。没有 GPU 的 A 核板不适合跟这组文章对练显示和应用。显示。至少一路能稳定出图。先定你手头是 HDMI、MIPI、LVDS 还是 RGB再看底板有没有座子。同一时刻通常只亮一路。调试。UART 控制台这块 BSP 上是1500000 8N1 USB OTGhdc。没有串口早期只能盯黑屏没有 OTG装应用绕远。USB Host。键鼠、U 盘、UVC、网卡走 Host。OTG 留给电脑。两个口不要混。触摸强烈建议有。没有的话 USB 鼠标也能点输入那几篇你只能旁观。为什么是 RK3568而不是一上来上旗舰它比 MCU 强很多完整桌面、相机、双千兆。又比旗舰便宜一截接口却齐——HDMI、MIPI DSI、LVDS、RGB、eDP显示相关的坑在一颗芯片上就能轮一遍。CSI、USB 3.0、CAN、UART/I2C/SPI 也不缺。更强的芯片解码更猛、NPU 更大适合多路相机和大模型。入门用不上价格和电源会先把人劝退。先在 RK3568 上把「dtb 怎么生效、hap 怎么签名、帧写在哪块内存」搞明白换同档芯片改节点名即可。NPU 有更好没有也能在 CPU 上跑量化小模型做演示。那是后续端侧智能篇的事不作为现在能不能学的门槛。按你要做的产品选只写应用。一块已经能进开源鸿蒙桌面的 RK3568带屏带触摸2 GB。Windows 装 DevEco 和 hdc不一定先编内核。要改设备树、点亮自己的屏和外设。必须有串口、OTG、能自己刷启动介质。还要一台 Ubuntu电脑内存 16 GB 能编32 GB 舒服内核 LTO 不够会 137 被杀磁盘 300 GB SSD。板子 2 GB 和电脑 16 GB 是两回事。工业屏。关心 LVDS/eDP 是否长期稳定、电源、双网口。触摸方案和屏一起定。带预览的相机。CSI 或可靠 UVC内存尽量 4 GB。先几何正确再谈识别。网关。网口和 USB 口比核数重要。蜂窝模组先看枚举出来是wwan0QMI还是usb0NCM。端侧检测。RK3568 够把「帧进、小模型出、框画回预览」跑通。更大模型再换同系列更强芯片。都先把预览跑正常。不适合对练这组文章的纯 MCU、只有几百 MB 又要开标准桌面和相机、没有串口也没有 OTG、只能用封闭工具刷一次出厂包。编译发生在电脑上OpenHarmony 4.1 标准系统在 Linux 里编。Windows 编应用、烧板、看日志。Ubuntu 22.04用户名不要中文和空格。板子用 USB 连 hdc、用串口看启动。镜像从编译机拷出来时带 md5不要只留在out/。起步可以只备这些RK3568 核心板内存 2 GB 或 4 GB配底板一块屏接口先定一种带电容触摸更好USB 转串口要能稳定跑1500000不少「115200 专用」线到 1.5 Mbps 会乱码能传数据的 USB 线插 OTG质量可靠的 SD 卡32 GB 以上USB 摄像头、一颗 I2C 温度芯片、一个 USB 网卡有就练。没有不影响先点亮桌面。桌面是后面所有外设的乘法。买之前对照底板丝印调试口、OTG、你的屏插哪。丝印和文档打架时以板上的字为准。下一篇把标准系统的分层和三档再展开一次然后从 Windows 工具链进到刷机。
这套教程从一块 RK3568、一份开源鸿蒙标准系统开始。今天不装工具、不刷机先说清楚两件事为什么做开源鸿蒙以及这块板适不适合你。第一次把开源鸿蒙刷进板子很多人会晃一下神这不就是 Linux 吗串口能敲命令uname打出来也是 5.10/proc/device-tree还在I2C、GPIO、网卡该有的节点好像都有。你会下意识地掏出在普通嵌入式 Linux 上用惯的那套编一个小工具、拷上去、chmod x、跑。然后它不吃。用户态不是 GNU 那一套。动态链接器叫ld-musl-arm.so.1还是 32 位的应用不是一个 ELF是 hap要签名调试口看着像 adb命令却叫 hdc你改了设备树重启以后屏还是老样子——因为真正生效的那份 dtb往往不在你刚刷的那个分区里。所以它不是「Linux 换了个桌面」。内核那一层做过嵌入式的人确实熟熟的那一层上面是另一套操作系统。这组文章要写的就是这一层错位环境怎么搭、镜像怎么来、屏怎么亮、外设怎么把数据送到应用里。芯片默认是瑞芯微RK3568系统钉在OpenHarmony 4.1API 11。你手头若是同档 Cortex-A、同样跑标准系统路径名可能不同判断问题的方法是一样的。下面先把三件事说清楚开源鸿蒙能用在哪、为什么值得在这条生态上做南向以及你该买什么样的板。选错档后面 70 篇的命令会对不上。开源鸿蒙能用在哪官方把它定义成面向全场景的智能终端操作系统。落到工程上不要把「全场景」当成一次做完的功能清单。按设备形态常见就是这几类。带屏的人机界面。产线操作员看的 7 寸、10 寸屏楼宇门口机仓储终端充电桩和充电柜的面板医疗监护仪的显示部分。RK3568 的 VOP2 能出 HDMI、MIPI、LVDS、RGB、eDP正好覆盖从调试显示器到工业玻璃的几种接法。同一时刻通常只能把一路当主屏——这是后面显示那几篇的核心约束也是这类产品最容易踩的坑。边缘网关和联网终端。双千兆、USB 上网卡、4G/5G 模组。车间里网线优先户外屏和巡检车靠蜂窝。开源鸿蒙标准系统有网络管理子系统板载网口常常能自动 DHCPUSB 网卡和模组却经常是自己拉起来的旁路默认路由和 DNS 要另外处理。网关类产品买板时网口和 USB 口比 CPU 核数重要。采集和执行。I2C 上的温度、光感、血氧UART 上的定位和电台GPIO 上的继电器、电机、报警灯。这类设备以前用 Qt 加一堆/dev。开源鸿蒙上标准 Kit 覆盖不到的芯片仍然是 NAPI 去 open 节点但应用是 hap、要签名、进程不是 root。南向的工作量在「节点出现」和「应用读得到」之间。带预览的相机设备。门口机、扫码工位、检测工位。MIPI CSI 或 USB UVC经 ISP 或 UVC 进预览。花屏、偏暗、三条带多半不是传感器没起来是缓冲区写错、3A 没跑、格式和 stride 不一致。预览几何不正确后面任何识别模型都是吃噪声。教学和研发平台。一块核心板加底板引出 UART/I2C/SPI/GPIO插不同模块练总线和驱动。这组文章按芯片型号写模块不绑某一套外壳。总线对、芯片对就能对上号。轻量系统MCU、一百多 KB 内存做的是模组、传感器节点、简单穿戴没有这套桌面和 hap。小型系统做猫眼、IPC。这组文章只写标准系统要窗口、要 GPU 合成、要 ArkTS 应用。RK3568 属于这一档。为什么要做开源鸿蒙生态而不是只停在 Linux如果你的产品只是「内核起来、有个 Qt 窗口、能 ssh」继续用熟悉的嵌入式 Linux 完全成立。换开源鸿蒙通常是因为产品形态已经靠近「带应用框架的终端」而不只是「带网页或 Qt 的板子」。应用层是统一的。hap、Ability、ArkTS、权限和签名是一套跨设备的包格式。同一套应用模型可以从这块 RK3568 的屏对到别的标准系统设备上——前提是南向把 HDI 对齐了。相机、音频、窗口这些 Kit应用侧才能「一次开发」。HDI 没对齐ArkTS 写得再漂亮也是调空。南向做的就是把芯片接进这套接口。生态在要南向。屏厂、模组厂、做行业终端的团队需要的不是再发一份 Buildroot 镜像而是设备树、HDF、签名过的系统应用、能走 hdc 的调试链。你把 RK3568 上的显示、触摸、相机、网、外设走通后面换同档芯片改的是节点名和时钟不是世界观。这就是「做生态」在工程上的含义先有一块能被应用开发者用的板而不是只有内核开发者能用的板。分布式是后手不是第一周的主线。软总线、跨设备调度官方有专门文档。单机屏都不稳组网只是把不稳乘上 N。这组文章把单机做透分区、dtb、hap、预览。分布式点到为止。端侧模型、NPU、把相机帧送进推理放在预览稳定之后另写。和传统 Linux 不是对立。标准系统的内核就是 Linux 5.10。设备树、dmesg、示波器全部还在。多出来的是 init 配置、HDF、包管理、32 位 musl。你会写 C、会看原理图仍然可能在「刷哪一个分区」「so 是 32 位还是 64 位」上栽半天。栽了不要按发行版的经验继续加补丁按这组文章的分层往上爬。我在 RK3568 上走过的几件具体的事决定了后面为什么写得细dd写到/dev/mmcblk1p5会建成普通文件、md5 还对四颗灯一起灭是因为公版电源节点抢脚hap 没签或指纹对不上整卡刷桌面会一起没。这些不是奇闻是这套系统的路径就是这样长。先选档再选芯片开源鸿蒙能跑的芯片很多文档也因此分成三套口气。拿着 MCU 的轻量手册来对 RK3568 的桌面和 hap会对得很痛苦。档处理器官方最低内存你实际拿到的产品轻量Cortex-M / RISC-V128 KB 量级模组、节点、简单穿戴小型Cortex-A1 MB 量级猫眼、IPC、简单记录仪标准Cortex-A通常要 GPU写过 128 MB带桌面的屏、网关、本系列这条线后面所有文章默认你在标准系统、OpenHarmony 4.1、API 11。内核 Linux 5.10用户态 32 位 musl。RK3568 就是为这一档准备的。官方 128 MB 是「能起来」不是「能拿来开桌面和相机」。1 GB 会把时间耗在杀进程上。2 GB 起步4 GB 开预览更从容。标准系统板上要有什么CPU。四核 Cortex-A55、主频到 1.8 GHz 这一档。更弱的 A 核能编进内核滑动和预览会明显吃力。内存。桌面 2 GBMIPI/UVC 预览优先 4 GB。loader 要和颗粒匹配丝印 4G、loader 过旧可能只认出一部分。存储。eMMC 8 GB 能装系统16 GB 从容。另备 32 GB 以上 SD 卡刷可回滚的包。eMMC 别当草稿纸。GPU。窗口合成靠它。没有 GPU 的 A 核板不适合跟这组文章对练显示和应用。显示。至少一路能稳定出图。先定你手头是 HDMI、MIPI、LVDS 还是 RGB再看底板有没有座子。同一时刻通常只亮一路。调试。UART 控制台这块 BSP 上是1500000 8N1 USB OTGhdc。没有串口早期只能盯黑屏没有 OTG装应用绕远。USB Host。键鼠、U 盘、UVC、网卡走 Host。OTG 留给电脑。两个口不要混。触摸强烈建议有。没有的话 USB 鼠标也能点输入那几篇你只能旁观。为什么是 RK3568而不是一上来上旗舰它比 MCU 强很多完整桌面、相机、双千兆。又比旗舰便宜一截接口却齐——HDMI、MIPI DSI、LVDS、RGB、eDP显示相关的坑在一颗芯片上就能轮一遍。CSI、USB 3.0、CAN、UART/I2C/SPI 也不缺。更强的芯片解码更猛、NPU 更大适合多路相机和大模型。入门用不上价格和电源会先把人劝退。先在 RK3568 上把「dtb 怎么生效、hap 怎么签名、帧写在哪块内存」搞明白换同档芯片改节点名即可。NPU 有更好没有也能在 CPU 上跑量化小模型做演示。那是后续端侧智能篇的事不作为现在能不能学的门槛。按你要做的产品选只写应用。一块已经能进开源鸿蒙桌面的 RK3568带屏带触摸2 GB。Windows 装 DevEco 和 hdc不一定先编内核。要改设备树、点亮自己的屏和外设。必须有串口、OTG、能自己刷启动介质。还要一台 Ubuntu电脑内存 16 GB 能编32 GB 舒服内核 LTO 不够会 137 被杀磁盘 300 GB SSD。板子 2 GB 和电脑 16 GB 是两回事。工业屏。关心 LVDS/eDP 是否长期稳定、电源、双网口。触摸方案和屏一起定。带预览的相机。CSI 或可靠 UVC内存尽量 4 GB。先几何正确再谈识别。网关。网口和 USB 口比核数重要。蜂窝模组先看枚举出来是wwan0QMI还是usb0NCM。端侧检测。RK3568 够把「帧进、小模型出、框画回预览」跑通。更大模型再换同系列更强芯片。都先把预览跑正常。不适合对练这组文章的纯 MCU、只有几百 MB 又要开标准桌面和相机、没有串口也没有 OTG、只能用封闭工具刷一次出厂包。编译发生在电脑上OpenHarmony 4.1 标准系统在 Linux 里编。Windows 编应用、烧板、看日志。Ubuntu 22.04用户名不要中文和空格。板子用 USB 连 hdc、用串口看启动。镜像从编译机拷出来时带 md5不要只留在out/。起步可以只备这些RK3568 核心板内存 2 GB 或 4 GB配底板一块屏接口先定一种带电容触摸更好USB 转串口要能稳定跑1500000不少「115200 专用」线到 1.5 Mbps 会乱码能传数据的 USB 线插 OTG质量可靠的 SD 卡32 GB 以上USB 摄像头、一颗 I2C 温度芯片、一个 USB 网卡有就练。没有不影响先点亮桌面。桌面是后面所有外设的乘法。买之前对照底板丝印调试口、OTG、你的屏插哪。丝印和文档打架时以板上的字为准。下一篇把标准系统的分层和三档再展开一次然后从 Windows 工具链进到刷机。
