从USB转串口芯片CH9344的视角：HDF驱动框架下的硬件适配与内核协同

算法是你的笨蛋

168人浏览 · 2026-02-07 11:23:02

算法是你的笨蛋 · 2026-02-07 11:23:02 发布

CH9344在OpenHarmony HDF框架下的硬件适配与内核协同实战

在工业控制和物联网设备开发中，多串口扩展是一个常见且关键的需求。RK3568这类高性能处理器虽然功能强大，但原生串口资源往往难以满足复杂应用场景的需求。CH9344作为一款成熟的USB转四串口芯片，为系统扩展提供了可靠的硬件基础。本文将深入探讨如何在OpenHarmony的HDF驱动框架下，实现CH9344芯片的完整驱动适配，并解决实际开发中遇到的内核协同问题。

1. 深入理解HDF驱动框架与CH9344芯片特性

OpenHarmony的HDF驱动框架采用分层解耦的设计理念，旨在为不同硬件设备提供统一的驱动接口。对于串口设备，HDF框架在用户态提供标准的UART API，而在内核态则通过适配层与Linux内核的TTY子系统进行交互。

CH9344是一款高度集成的USB转串口芯片，能够将单个USB接口扩展为四个独立的串口。该芯片在Linux内核中已有成熟的驱动支持，通过注册为USB串口设备，会在/dev目录下生成相应的tty设备节点，如ttyCH9344USB0到ttyCH9344USB3。

关键特性对比：

特性	CH9344芯片	HDF UART框架
接口类型	USB 2.0	标准串口API
支持串口数	4个独立串口	无限制（依赖硬件）
数据位宽	5、6、7、8位	5、6、7、8位
流控支持	RTS/CTS	RTS/CTS
中断处理	内置中断机制	依赖内核中断子系统

在实际适配过程中，开发者需要理解HDF框架的UART驱动实际上是通过文件操作接口（open、read、write、ioctl）与内核态的tty设备进行交互。这种设计意味着只要CH9344驱动正确注册生成了tty设备，HDF框架就能无缝地进行操作。

2. CH9344驱动移植与内核配置

将CH9344驱动移植到OpenHarmony内核是整个过程的基础步骤。首先需要获取官方的Linux驱动源码，通常包含ch9344.c和ch9344.h两个主要文件。

驱动移植步骤：

源码放置：将驱动文件复制到内核源码的适当目录，通常是drivers/usb/serial/目录下

修改Kconfig：在drivers/usb/serial/Kconfig中添加配置选项：

config USB_SERIAL_CH9344
    tristate "USB Winchiphead CH9344 Four Port Serial Driver"
    depends on USB
    help
      Say Y here if you want to use a Winchiphead CH9344 four port
      USB to serial adapter.

修改Makefile：在drivers/usb/serial/Makefile中添加编译规则：
```
obj-$(CONFIG_USB_SERIAL_CH9344) += ch9344.o
```
内核配置：通过make menuconfig或直接修改defconfig文件，确保启用CONFIG_USB_SERIAL_CH9344选项

注意：在编译内核前，务必确认USB串口支持（CONFIG_USB_SERIAL）和相应的USB控制器驱动已经启用，否则CH9344驱动将无法正常工作。

完成驱动移植后，编译并烧写新内核。系统启动后，可以通过dmesg命令查看驱动加载状态，正常情况下应该能看到CH9344驱动初始化的相关信息，并在/dev目录下看到生成的tty设备节点。

3. HCS配置与设备节点管理

HDF使用HCS配置文件来描述硬件设备信息，这是驱动匹配和设备初始化的关键。对于CH9344这样的多串口设备，需要为每个生成的串口单独配置。

完整的HCS配置示例：

device_uart_ch9344_0 :: uart_device {
    driver_name = "ttyCH9344USB";  // 设备名称前缀
    num = 0;                      // 设备编号
    match_attr = "rockchip_rk3568_uart_ch9344_0"; // 匹配属性
}

device_uart_ch9344_1 :: uart_device {
    driver_name = "ttyCH9344USB";
    num = 1;
    match_attr = "rockchip_rk3568_uart_ch9344_1";
}

device_uart_ch9344_2 :: uart_device {
    driver_name = "ttyCH9344USB";
    num = 2;
    match_attr = "rockchip_rk3568_uart_ch9344_2";
}

device_uart_ch9344_3 :: uart_device {
    driver_name = "ttyCH9344USB";
    num = 3;
    match_attr = "rockchip_rk3568_uart_ch9344_3";
}

配置参数详解：

driver_name：必须与内核中注册的设备名前缀完全一致，否则HDF无法正确打开设备
num：设备编号，与driver_name组合形成完整的设备名（如ttyCH9344USB0）
match_attr：用于设备匹配的唯一标识符，必须与device_info.hcs中的配置相对应

在device_info.hcs中，需要为每个CH9344串口添加设备信息：

device_uart_ch9344_0 :: device {
    deviceMatchAttr = "rockchip_rk3568_uart_ch9344_0";
    serviceName = "ch9344_uart_service_0";
}

// 同样为其他三个串口添加配置

重要提示：修改HCS配置后，需要删除旧的HCB编译产物并重新编译，否则更改可能不会生效。HCB是HCS的二进制编译结果，系统优先使用已存在的HCB文件。

4. 实战问题排查与性能优化

在实际开发过程中，我们遇到了几个典型问题，这些问题的解决方案对于类似项目具有参考价值。

4.1 设备打开失败问题

最初发现应用层无法正确打开CH9344串口，通过在内核驱动中添加调试信息，发现设备名解析异常。HDF框架中的uart_adapter.c存在一个逻辑缺陷：它使用静态数组存储设备名，但在多设备情况下会发生覆盖。

修复方案：

// 修改前的代码（有bug）
static int32_t GetUartDeviceName(struct UartHost *host, uint32_t port, char *deviceName)
{
    if (snprintf_s(deviceName, NAME_LEN, NAME_LEN - 1, "/dev/%s%u", 
                  host->driverName, port) < 0) {
        return HDF_FAILURE;
    }
    return HDF_SUCCESS;
}

// 修改后的代码
static int32_t GetUartDeviceName(struct UartHost *host, uint32_t port, char *deviceName, size_t nameLen)
{
    if (snprintf_s(deviceName, nameLen, nameLen - 1, "/dev/%s%u", 
                  host->driverName, port) < 0) {
        return HDF_FAILURE;
    }
    return HDF_SUCCESS;
}

4.2 阻塞模式失效问题

HDF UART驱动中的阻塞设置最初是伪实现，没有实际效果。这会导致在读取数据时无法正确阻塞等待。

修复方案：

// 在uart_adapter.c中完善阻塞设置逻辑
static int32_t UartSetBlocking(struct UartHost *host, bool blocking)
{
    int flags = fcntl(host->fd, F_GETFL, 0);
    if (flags < 0) {
        return HDF_FAILURE;
    }
    
    if (blocking) {
        flags &= ~O_NONBLOCK;
    } else {
        flags |= O_NONBLOCK;
    }
    
    if (fcntl(host->fd, F_SETFL, flags) < 0) {
        return HDF_FAILURE;
    }
    
    return HDF_SUCCESS;
}

4.3 数据接收异常问题

在测试中发现CH9344串口可以发送数据但无法接收数据。通过分析源码，发现是文件描述符的FLAG参数配置不正确，缺少必要的读写权限设置。

修复方案：

// 修改设备打开逻辑，确保设置正确的标志位
host->fd = open(deviceName, O_RDWR | O_NOCTTY | O_NONBLOCK);
if (host->fd < 0) {
    HDF_LOGE("Open UART device %s failed", deviceName);
    return HDF_FAILURE;
}

// 立即设置正确的阻塞模式
UartSetBlocking(host, true);