gd32 iic 实例

### GD32微控制器IIC通信协议概述 GD32 微控制器系列基于 ARM Cortex-M 内核架构，支持多种外设接口，其中包括 I²C (Inter-Integrated Circuit) 协议。I²C 是一种广泛应用于低速率数据传输的同步串行总线技术，通常用于连接微控制器与外围设备（如传感器、显示屏等）。对于 Arduino 使用 SSD1306 驱动 OLED 的场景[^1]，可以类比到 GD32 上实现类似的硬件功能。 以下是关于如何在 GD32 微控制器上配置并使用 I²C 通信的一个典型示例： --- ### 初始化和配置 I²C 外设 为了使能 I²C 功能，在 GD32 中需要完成以下操作： 1. **启用时钟源**：确保目标 I²C 外设及时钟树被正确初始化。 2. **设置波特率**：根据实际需求调整 SCL 信号频率，默认为标准模式下的 100kHz 或快速模式下的 400kHz。 3. **定义地址长度**：7-bit 地址或者更少见的 10-bit 地址格式取决于具体应用场景。 4. **中断或 DMA 支持**（可选）：如果项目涉及大量连续读写，则推荐采用这些高级特性来优化性能。 下面展示了一段基础代码片段用来启动一个基本型态下运行于默认参数设定中的主控端实例化过程: ```c #include "gd32fxxx.h" void i2c_master_init(void){ // Enable GPIO and I2Cx clock rcu_periph_clock_enable(RCU_GPIOx); rcu_periph_clock_enable(RCU_I2Cx); gpio_init(GPIOx, GPIO_MODE_AF_OD, GPIO_OSPEED_50MHZ, GPIO_PIN_SDA | GPIO_PIN_SCL); /* Configure the I2C */ struct i2c_mode_struct mode; mode.i2c_duty_cycle = I2C_DTCY_CLK_HIGH_LONG; mode.i2c_addressing_mode = I2C_ADDRESSINGMODE_7BIT; i2c_deinit(I2Cx); // Deinitialize before reconfiguring. i2c_struct_para_init(&mode); // Initialize structure with default values. i2c_init(I2Cx,&mode); // Apply configuration settings to hardware registers. } ``` 上述函数实现了针对特定型号 GD32 芯片上的某个指定编号 `I2Cx` 总线资源的基础激活流程[^2]。 --- ### 发送数据至从机设备 当成功建立主机角色之后，就可以向挂载在同一物理链路上的目标节点发送消息包了。这里给出一段演示如何将字符串 `"Hello World!"` 输出给假设具有固定 ID 值等于 `0x3C` 的某款 OLED 屏幕组件的例子： ```c #define SLAVE_ADDR_OLED 0x3C << 1 // Shifted address as per protocol specification uint8_t buffer[] = {'H','e','l','l','o', ' ', 'W','o','r','l','d','!'}; // Function prototype declaration omitted here... int main(){ i2c_master_init(); while(i2c_flag_get(I2Cx,I2C_FLAG_BUSY)!=RESET){} // Wait until bus is free i2c_start_on_bus(I2Cx); // Generate START condition on the line if(!i2c_check_acknowledge_status(I2Cx)){ printf("No Acknowledgement received.\n"); return -1; } i2c_send_7bit_address(I2Cx,SLAVE_ADDR_OLED,I2C_MASTER_TRANSMITTER); if(!i2c_check_acknowledge_status(I2Cx)){ printf("Slave did not respond correctly after addressing.\n"); return -1; } for(int idx=0 ;idx<sizeof(buffer)-1;++idx){ i2c_transmit_data8(I2Cx,*buffer++); if(!i2c_check_acknowledge_status(I2Cx)){ break; } } i2c_stop_on_bus(I2Cx); // Send STOP signal at end of transaction sequence } ``` 此部分逻辑遵循标准 I²C 操作规程逐字节传递有效负载直至整个序列结束为止。 --- ###

### GD32微控制器与OLED显示屏通过IIC接口通信 对于GD32微控制器与OLED显示屏之间的IIC通信，通常涉及初始化配置、数据传输协议以及具体的编程实现。 #### 初始化配置 为了使能IIC功能，在GD32上需设置相应的GPIO引脚为AF模式，并开启对应的外设时钟。具体来说，需要调用`rcu_periph_clock_enable()`函数来启动IIC模块的时钟供应[^1]。接着要设定SCL和SDA线路上的工作参数，这可以通过结构体如`i2c_parameter_struct`完成，其中包含了频率分频器和其他必要的属性定义[^2]。 #### 数据传输流程 当硬件准备就绪之后，就可以利用库函数来进行读写操作了。发送命令给OLED屏前先发出起始信号并等待应答；随后传送设备地址加上读/写位标志；再根据需求传递指令集或图形缓冲区的数据字节流至显示器内部RAM中存储起来待显示刷新之用[^3]。 #### 编程实例 下面给出一段简单的C语言代码片段用于展示如何向SSD1306驱动型OLED屏幕发送字符串： ```c #include "gd32f1x0.h" #include "ssd1306.h" void oled_init(void){ /* Initialize the IIC interface */ i2c_deinit(I2Cx); i2c_struct_para_init(&i2c_initpara); rcu_periph_clock_enable(RCU_I2Cx); // Enable clock i2c_initpara.i2c_clk_speed = 100000; // Set speed to 100kHz i2c_initpara.i2c_duty_cycle = I2C_DUTYCYCLE_2; i2c_initpara.i2c_ack = I2C_ACK_ENABLE; i2c_initpara.i2c_acklast = I2C_LASTACK_DISABLE; i2c_init(I2Cx, &i2c_initpara); ssd1306_Init(); // Call SSD1306 initialization function from library } int main(){ oled_init(); while(1){ ssd1306_SetCursor(0, 0); ssd1306_WriteString("Hello World", Font_7x10, White); delay_ms(500); } } ```