hal库oled显示iic

### 使用 HAL 库通过 IIC 接口驱动 OLED 显示屏

为了使用 STM32 的 HAL 库来控制 OLED 屏幕，主要工作集中在初始化 IIC 接口并替换原有的标准库函数调用为 HAL 函数。以下是具体实现方法：

#### 修改 `oled.h` 文件
在 `oled.h` 中定义用于访问 SDA 和 SCL 引脚的操作应改为调用 HAL 提供的相关 API 来完成数据传输。

// 替换原有 GPIO 操作为 HAL_I2C_Master_Transmit() 或者其他适合的方法
void OLED_WriteByte(uint8_t dat, uint8_t cmd);

此更改确保了所有针对 OLED 的命令和数据发送都经过 HAL 库处理[^1]。

#### 初始化 OLED 并显示内容
下面是一个完整的例子展示如何利用 HAL 库进行 OLED 初期设置以及文字输出：

#include "stm32f1xx_hal.h"
#include "oled.h"

I2C_HandleTypeDef hi2c1;

int main(void){
    /* 初始化系统 */
    HAL_Init();
    
    /* 配置时钟源 */
    SystemClock_Config();

    /* 初始化 IIC 外设 */
    MX_I2C1_Init(&hi2c1);

    // 初始化OLED屏幕
    OLED_Init(); 

    while (1){
        // 清除当前画面
        OLED_Clear();

        // 设置起始位置坐标（X=0,Y=0）
        OLED_SetPos(0, 0);  

        // 打印字符串到指定位置
        OLED_ShowString("Hello");

        // 延迟一段时间以便观察效果
        HAL_Delay(1000);
        
        // 更改打印位置至下一行(Y轴偏移量增加16像素)
        OLED_SetPos(0, 16); 
        
        // 输出中文字符需额外支持字体映射表等功能，在此处简化表示
        OLED_ShowChinese("你好");
        
        HAL_Delay(1000);
    }
}

上述代码片段展示了基本框架，其中包含了必要的头文件引入、外设初始化过程及简单的图形绘制逻辑[^2]。

#### 关键点提示
- **硬件配置**：确认 STM32 的 I/O 口已经按照需求被正确分配给 IIC 功能，并且物理连线无误。
- **模拟 vs 硬件 IIC**：如果采用软件模拟方式，则需要注意调整相应的延时参数以匹配实际通讯速率；而当选用硬件 IIC 模块时则无需过多考虑这些问题。
- **查阅官方文档**：对于更详细的寄存器级编程细节或其他高级特性，请参阅具体的微控制器系列的数据手册获取更多信息[^3]。