L61　附录导读：SOWL HDF 服务一览

HDF（Hardware Driver Foundation）是 OpenHarmony 的硬件驱动框架：把「找设备、发命令、传数据」从芯片寄存器细节里抽出来，让应用按服务名访问外设。官方用 HCS 描述板级配置，驱动实现 HdfDriverEntry 的 Bind、Init、Release。

本课是教学子集，不是官方 hdf_core 的二进制兼容实现。配置改成静态设备表 g_sowl_devices；应用侧签名对齐官方：HdfIoServiceBind / Recycle，Dispatch(cmdId, HdfSBuf *data, HdfSBuf *reply)。概念与第六章对齐，便于在 MixGo SOWL 上把 LiteOS-M 和板载外设接起来。

附录实验的共同入口是 HdfSowlBoardInit()：先注册 uart/gpio 以及全部 SOWL 外设驱动，再按优先级加载设备表。应用随后只做两件事：按名绑定，再发命令或写字节。

1. HdfSowlBoardInit：注册驱动 + HdfDeviceManagerInit(g_sowl_devices)。
2. HdfIoServiceBind("rgb")：按 serviceName 取得 HdfIoService*（官方同形）。
3. Dispatch：serv->dispatcher->Dispatch(&serv->object, cmdId, data, reply)，载荷为 HdfSBuf；便捷可用 HdfIoCall。
4. HdfDeviceWrite / HdfDeviceRead：字节流；本板主要用于 uart0 打日志。
5. HdfIoServiceRecycle：用毕释放服务句柄（教学静态池）。

签名对齐官方：Bind 得 HdfIoService*，命令经 HdfSBuf。教学便捷 HdfIoCall 内部 Obtain/Write/Dispatch/Read/Recycle。像素参数仍可用 SowlRgbPixelArg 打成 uint32 再写入 data。

struct HdfIoService *rgb = HdfIoServiceBind("rgb");
HdfIoCall(rgb, HDF_RGB_CMD_SET_PIXEL, SowlRgbPixelArg(0, 255, 0, 0), 1, NULL);
HdfIoCall(rgb, HDF_RGB_CMD_SHOW, 0, 0, NULL);

仿真与真机用同一套应用代码：Bind + Dispatch/Write。差别只在驱动底下——仿真时工作台把按键、触摸、▼ 传感器写入 0x6000FE00 起的 MMIO，驱动 READ 读到的就是这些数；真机则读真实芯片。点灯/画屏经 FX 邮箱或串口 @MIXOS_JSON 映到壳上，便于对照。应用课不要自己拼 JSON。

moduleName 决定加载哪份驱动，serviceName 是应用 Bind 的名字。priority 越小越先加载：uart0 为 10，便于所有实验打日志。杜邦 LED/蜂鸣/按键没有单独服务名，走 gpio 的 P1/P7/P4；电位器另有 adc。

执行类外设用专用 CMD 宏；传感类用 HDF_SENSOR_CMD_READ / READ2 / READ3，读数写入 reply（HdfSbufReadInt32），返回值只表示成功/失败。网络类 wifi 可用 WifiConstruct / IWiFi，或直接 Bind("wifi") + Dispatch。表中的 INJECT 不是给学生实验写的：工作台 ▼ 面板改滑条时，由壳把数值写入仿真 MMIO；真机则从 I2C/HAL 读真实芯片。应用永远只 Bind + Dispatch/READ，不必分支「是不是仿真」。gpio 的 data：低 8 位为脚号，次 8 位为电平或模式。

overview 实验不点灯、不读传感器：它只 Bind 上表每一个名字。成功打印「名字 ok」，缺驱动打印「MISSING」。全部通过后打印 overview ok。若某行 MISSING，先查 HdfSowlBoardInit 是否编译进 LOS_HAVE_HDF，再核对设备表里的 serviceName 拼写。

从 L62 起，每一课只深入一个服务：在本页表里找到命令，再到对应 main.c 里看 Dispatch 怎么用。仿真与真机共用同一份 main；若行为不同，查驱动里是读 MMIO 还是读 HAL，而不是改应用分支。