NCA9555/PCA9555驱动移植指南：从EFR32BG22到通用MCU平台

2026/6/19 10:02:11

1. NCA9555/PCA9555驱动移植的核心思路

第一次接触NCA9555/PCA9555这类I²C接口的GPIO扩展芯片时，很多人会被官方数据手册里复杂的寄存器配置吓到。但实际移植过程中，最关键的只有两个硬件依赖部分：GPIO操作和延时函数。这就像装修房子时，虽然整体设计很重要，但真正影响施工质量的其实是水电改造这些基础工程。

以EFR32BG22的原始代码为例，所有硬件相关操作都集中在以下几个地方：

GPIO方向设置（输入/输出模式）
GPIO电平控制（置高/置低）
精确到微秒级的延时函数
I²C起始/停止信号的时序控制

我曾在STM32F103上移植这个驱动时，发现原始代码中sl_udelay_wait()这个延时函数直接调用了EFR32的底层库。换成STM32的HAL库后，只需要用HAL_Delay()配合系统时钟调整就能达到同样效果。具体到代码层面，移植的本质就是重写以下硬件抽象层：

// 原始EFR32BG22的GPIO操作 #define IIC_SCL_SET_GPIO_OUTPUT_STATUS(status) \ if(status) GPIO_PinOutSet(IIC_SCL_GPIO_PORT, IIC_SCL_GPIO_PIN); \ else GPIO_PinOutClear(IIC_SCL_GPIO_PORT, IIC_SCL_GPIO_PIN) // STM32移植后的等效实现 #define IIC_SCL_SET_GPIO_OUTPUT_STATUS(status) \ HAL_GPIO_WritePin(IIC_SCL_GPIO_PORT, IIC_SCL_GPIO_PIN, status?GPIO_PIN_SET:GPIO_PIN_RESET)

2. 硬件抽象层的具体移植步骤

2.1 GPIO操作的重构

不同MCU的GPIO库函数命名差异很大，但核心功能都是三类：设置方向、写电平、读电平。在ESP32上移植时，我发现它的驱动库提供了更灵活的配置方式：

// ESP32的GPIO配置示例 void IIC_gpio_init(void) { gpio_config_t io_conf = { .pin_bit_mask = (1ULL<<IIC_SCL_PIN) | (1ULL<<IIC_SDA_PIN), .mode = GPIO_MODE_OUTPUT_OD, // 开漏输出 .pull_up_en = GPIO_PULLUP_ENABLE, .intr_type = GPIO_INTR_DISABLE }; gpio_config(&io_conf); }

对于没有硬件I²C外设的情况，需要特别注意开漏输出(Open-Drain)的模拟。在STM32中，除了设置输出模式，还要额外开启内部上拉：

// STM32的GPIO初始化 GPIO_InitTypeDef GPIO_InitStruct = {0}; GPIO_InitStruct.Pin = IIC_SCL_PIN | IIC_SDA_PIN; GPIO_InitStruct.Mode = GPIO_MODE_OUTPUT_OD; GPIO_InitStruct.Pull = GPIO_PULLUP; GPIO_InitStruct.Speed = GPIO_SPEED_FREQ_HIGH; HAL_GPIO_Init(IIC_PORT, &GPIO_InitStruct);

2.2 延时函数的精准实现

NCA9555的I²C协议对时序要求严格，特别是起始信号(SDA下降沿时SCL必须保持高电平)和停止信号(SDA上升沿时SCL必须保持高电平)的时序。实测发现延时偏差超过2us就会导致通信失败。

在FreeRTOS环境下，直接使用vTaskDelay()的精度不够，推荐采用以下方案：

// 基于系统时钟的精准延时实现(以STM32为例) void IIC_Delay(uint32_t us) { uint32_t ticks = us * (SystemCoreClock / 1000000) / 5; uint32_t start = DWT->CYCCNT; while((DWT->CYCCNT - start) < ticks); }

使用前需要先启用DWT(Data Watchpoint and Trace)时钟：

CoreDebug->DEMCR |= CoreDebug_DEMCR_TRCENA_Msk; DWT->CYCCNT = 0; DWT->CTRL |= DWT_CTRL_CYCCNTENA_Msk;

3. 典型MCU平台的适配案例

3.1 STM32HAL库移植要点

在STM32CubeIDE环境中移植时，HAL库已经封装了大部分底层操作，但需要注意三个坑点：

HAL_I2C库与软件模拟I²C的取舍
时钟树配置影响延时精度
GPIO速度设置对信号边沿的影响

具体到代码实现：

// 修改后的IIC起始信号生成 void IIC_start(void) { IIC_SDA_OUTPUT(); HAL_GPIO_WritePin(IIC_SDA_PORT, IIC_SDA_PIN, GPIO_PIN_SET); HAL_GPIO_WritePin(IIC_SCL_PORT, IIC_SCL_PIN, GPIO_PIN_SET); IIC_Delay(4); HAL_GPIO_WritePin(IIC_SDA_PORT, IIC_SDA_PIN, GPIO_PIN_RESET); IIC_Delay(4); HAL_GPIO_WritePin(IIC_SCL_PORT, IIC_SCL_PIN, GPIO_PIN_RESET); }

3.2 ESP-IDF框架下的优化

ESP32的双核特性可以更好地处理时序问题。我推荐使用xTaskCreatePinnedToCore将I²C操作绑定到指定核心：

void i2c_task(void *pvParameters) { while(1) { // I²C操作代码 vTaskDelay(1 / portTICK_PERIOD_MS); } } void app_main() { xTaskCreatePinnedToCore(i2c_task, "i2c_task", 2048, NULL, 5, NULL, 1); }

同时利用ESP32的RMT外设可以实现纳秒级精度的信号控制，这对需要高速通信的场景特别有用。

4. 移植后的功能验证方法

4.1 基础通信测试

建议分三个阶段验证：

用逻辑分析仪抓取I²C波形，检查起始/停止信号时序
编写寄存器读写测试代码，验证基本通信功能
实际控制外设测试GPIO扩展功能

一个实用的寄存器测试例程：

void nca9555_self_test(uint8_t slave_addr) { uint8_t test_data = 0xAA; uint8_t read_back = 0; // 测试输出寄存器 nca9555_write_byte(slave_addr, OUTPUT_PORT_REGISTER0, test_data); nca9555_read_byte(slave_addr, INPUT_PORT_REGISTER0, &read_back); if((read_back & 0x0F) != (test_data & 0x0F)) { printf("Output test failed! Wrote 0x%02X, read 0x%02X\n", test_data, read_back); } // 测试配置寄存器 nca9555_write_byte(slave_addr, CONFIG_PORT_REGISTER0, 0x00); // 全部输出 nca9555_read_byte(slave_addr, CONFIG_PORT_REGISTER0, &read_back); if(read_back != 0x00) { printf("Config test failed! Expected 0x00, got 0x%02X\n", read_back); } }

4.2 压力测试方案

长时间运行测试中需要关注：

连续通信时的稳定性
不同时钟频率下的兼容性
多从机设备时的总线冲突处理

可以编写自动化测试脚本：

void nca9555_stress_test(uint8_t slave_addr, int cycles) { for(int i=0; i<cycles; i++) { uint8_t pattern = i % 256; nca9555_write_byte(slave_addr, OUTPUT_PORT_REGISTER0, pattern); uint8_t received = 0; nca9555_read_byte(slave_addr, INPUT_PORT_REGISTER0, &received); if(received != pattern) { printf("Error at cycle %d: sent 0x%02X, got 0x%02X\n", i, pattern, received); } if(i % 100 == 0) { printf("Completed %d/%d cycles\n", i, cycles); } } }

移植过程中最常见的错误是忽略GPIO模式设置。有次在GD32上调试时，因为没有配置开漏输出，导致SDA线无法被从机拉低，ACK信号始终检测失败。后来用逻辑分析仪捕获波形才发现这个问题。建议在移植初期就准备好测试工具，可以节省大量调试时间。