專欄前言前面我們已經(jīng)掌握了 GPIO 輸入輸出、UART 串口通信完成了ESP32最基礎(chǔ)的兩大外設(shè)。從本篇開始我們進(jìn)入串行通信外設(shè)實(shí)戰(zhàn)階段第一個(gè)核心就是I2C 總線。I2C 是嵌入式最常用的低速外設(shè)總線傳感器、屏幕、存儲(chǔ)芯片、擴(kuò)展IO幾乎都依賴它。而0.96寸OLEDSSD1306則是物聯(lián)網(wǎng)項(xiàng)目的標(biāo)配顯示器件成本低、功耗低、接線簡單非常適合新手入門。本篇帶你從零打通I2C 核心原理 → ESP-IDF 硬件I2C配置 → OLED驅(qū)動(dòng)移植 → 文字/數(shù)字/圖標(biāo)顯示 → 動(dòng)態(tài)數(shù)據(jù)刷新。全程代碼可直接編譯燒錄零基礎(chǔ)也能做出自己的第一個(gè)顯示界面。一、I2C 通信核心基礎(chǔ)新手必懂1. 什么是I2CI2C 是一種半雙工、兩線制、多設(shè)備串行總線僅需兩根線即可掛載多個(gè)從設(shè)備SCL時(shí)鐘線主機(jī)控制通信節(jié)奏SDA數(shù)據(jù)線雙向傳輸數(shù)據(jù)和UART相比I2C最大優(yōu)勢兩根線可掛載十幾個(gè)設(shè)備通過不同設(shè)備地址區(qū)分大大節(jié)省IO資源。2. ESP32 硬件I2C資源ESP32 內(nèi)置2 路硬件I2C控制器支持標(biāo)準(zhǔn)模式(100kHz)、快速模式(400kHz)同樣支持任意GPIO軟件映射無需固定引腳。I2C0常用可自由配置I2C1擴(kuò)展使用二、硬件準(zhǔn)備與接線說明1. 物料清單ESP32-S3 / ESP32 開發(fā)板0.96寸 OLED 屏幕SSD1306 驅(qū)動(dòng)芯片I2C接口杜邦線 4 根2. 標(biāo)準(zhǔn)接線表OLED 引腳ESP32 引腳說明VCC3.3V電源供電禁止接5VGNDGND共地SCLGPIO9時(shí)鐘線可自定義SDAGPIO8數(shù)據(jù)線可自定義重要提醒OLED 默認(rèn) I2C 地址一般為0x3C或0x3D不顯示優(yōu)先排查地址是否正確。三、ESP-IDF 硬件I2C 初始化配置ESP-IDF 提供標(biāo)準(zhǔn)化 I2C 驅(qū)動(dòng)庫driver/i2c.h初始化固定三步配置參數(shù)→安裝驅(qū)動(dòng)→完成就緒。標(biāo)準(zhǔn)初始化代碼可直接復(fù)用#include driver/i2c.h #define I2C_MASTER_SCL_IO GPIO_NUM_9 #define I2C_MASTER_SDA_IO GPIO_NUM_8 #define I2C_MASTER_NUM I2C_NUM_0 #define I2C_MASTER_FREQ_HZ 400000 static void i2c_master_init(void) { i2c_config_t conf { .mode I2C_MODE_MASTER, // 主機(jī)模式 .sda_io_num I2C_MASTER_SDA_IO, // SDA引腳 .scl_io_num I2C_MASTER_SCL_IO, // SCL引腳 .sda_pullup_en GPIO_PULLUP_ENABLE, // 開啟內(nèi)部上拉 .scl_pullup_en GPIO_PULLUP_ENABLE, // 開啟內(nèi)部上拉 .master.clk_speed I2C_MASTER_FREQ_HZ, // 時(shí)鐘頻率400kHz }; // 加載配置 i2c_param_config(I2C_MASTER_NUM, conf); // 安裝驅(qū)動(dòng) i2c_driver_install(I2C_MASTER_NUM, conf.mode, 0, 0, 0); }關(guān)鍵知識(shí)點(diǎn)ESP32 內(nèi)部自帶上拉電阻一般無需外部接上拉標(biāo)準(zhǔn)模式 100kHz快速模式 400kHz新手建議先用 100kHz 調(diào)試必須配置為主機(jī)模式由ESP32主動(dòng)發(fā)起通信四、實(shí)戰(zhàn)SSD1306 OLED 完整驅(qū)動(dòng)與顯示我們采用SSD1306 128×64 分辨率屏幕驅(qū)動(dòng)邏輯分為三層底層I2C寫入 → 命令/數(shù)據(jù)發(fā)送 → 應(yīng)用層顯示函數(shù)。1. 完整驅(qū)動(dòng)源碼復(fù)制即用#include stdio.h #include string.h #include freertos/FreeRTOS.h #include freertos/task.h #include driver/i2c.h #include font.h // 引腳與地址定義 #define I2C_SCL_PIN GPIO_NUM_9 #define I2C_SDA_PIN GPIO_NUM_8 #define OLED_I2C_ADDR 0x3C #define I2C_PORT I2C_NUM_0 // OLED命令/數(shù)據(jù)標(biāo)記 #define OLED_CMD 0 #define OLED_DATA 1 // 寫命令函數(shù) static void oled_write_cmd(uint8_t cmd) { uint8_t buf[2] {0x00, cmd}; i2c_master_write_to_device(I2C_PORT, OLED_I2C_ADDR, buf, 2, pdMS_TO_TICKS(10)); } // 寫數(shù)據(jù)函數(shù) static void oled_write_data(uint8_t data) { uint8_t buf[2] {0x40, data}; i2c_master_write_to_device(I2C_PORT, OLED_I2C_ADDR, buf, 2, pdMS_TO_TICKS(10)); } // OLED初始化 void oled_init(void) { vTaskDelay(pdMS_TO_TICKS(100)); // 上電延時(shí) oled_write_cmd(0xAE); // 關(guān)閉顯示 oled_write_cmd(0xD5); // 設(shè)置時(shí)鐘分頻 oled_write_cmd(0x80); oled_write_cmd(0xA8); // 設(shè)置分辨率 oled_write_cmd(0x3F); oled_write_cmd(0xD3); // 顯示偏移 oled_write_cmd(0x00); oled_write_cmd(0x40); // 起始行 oled_write_cmd(0x8D); // 電荷泵 oled_write_cmd(0x14); oled_write_cmd(0x20); // 內(nèi)存尋址模式 oled_write_cmd(0x02); oled_write_cmd(0xA1); // 段重映射 oled_write_cmd(0xC8); // 掃描方向 oled_write_cmd(0xDA); // 引腳配置 oled_write_cmd(0x12); oled_write_cmd(0x81); // 對(duì)比度 oled_write_cmd(0xCF); oled_write_cmd(0xD9); // 預(yù)充電周期 oled_write_cmd(0xF1); oled_write_cmd(0xDB); // VCOMH oled_write_cmd(0x30); oled_write_cmd(0xA4); // 全局顯示開啟 oled_write_cmd(0xA6); // 正常顯示 oled_write_cmd(0xAF); // 開啟顯示 oled_clear(); } // 清屏函數(shù) void oled_clear(void) { for(uint8_t i0; i8; i) { oled_write_cmd(0xB0 i); oled_write_cmd(0x00); oled_write_cmd(0x10); for(uint8_t j0; j128; j) { oled_write_data(0x00); } } } // 設(shè)置光標(biāo)位置 void oled_set_pos(uint8_t x, uint8_t y) { oled_write_cmd(0xB0 y); oled_write_cmd(((x0xF0)4) | 0x10); oled_write_cmd((x0x0F) | 0x00); } // 顯示單個(gè)ASCII字符 void oled_show_char(uint8_t x, uint8_t y, uint8_t chr) { uint8_t c 0; c chr - ; // 偏移 oled_set_pos(x, y); for(uint8_t i0; i8; i) { oled_write_data(F8X16[c*16 i]); } oled_set_pos(x, y1); for(uint8_t i0; i8; i) { oled_write_data(F8X16[c*16 i 8]); } } // 顯示字符串 void oled_show_string(uint8_t x, uint8_t y, char *str) { uint8_t i 0; while(str[i] ! \0) { oled_show_char(x 8*i, y, str[i]); i; } } // 顯示數(shù)字 void oled_show_num(uint8_t x, uint8_t y, uint32_t num, uint8_t len) { char buf[16]; snprintf(buf, sizeof(buf), %lu, num); oled_show_string(x, y, buf); }2. 字庫文件說明代碼中用到的font.h為標(biāo)準(zhǔn) 8×16 ASCII 字庫包含常用英文字符、數(shù)字、符號(hào)。中文字符需額外取模生成后續(xù)進(jìn)階篇會(huì)詳細(xì)講解。五、主函數(shù)實(shí)戰(zhàn)靜態(tài)文字 動(dòng)態(tài)計(jì)數(shù)刷新結(jié)合前面的 I2C 初始化與 OLED 驅(qū)動(dòng)實(shí)現(xiàn)開機(jī)顯示標(biāo)題、底部實(shí)時(shí)刷新運(yùn)行秒數(shù)。// I2C初始化函數(shù)復(fù)用上面的i2c_master_init static void i2c_master_init(void) { i2c_config_t conf { .mode I2C_MODE_MASTER, .sda_io_num I2C_SDA_PIN, .scl_io_num I2C_SCL_PIN, .sda_pullup_en GPIO_PULLUP_ENABLE, .scl_pullup_en GPIO_PULLUP_ENABLE, .master.clk_speed 100000, // 新手先用100kHz更穩(wěn)定 }; i2c_param_config(I2C_PORT, conf); i2c_driver_install(I2C_PORT, conf.mode, 0, 0, 0); } void app_main(void) { // 初始化I2C i2c_master_init(); // 初始化OLED oled_init(); // 顯示靜態(tài)標(biāo)題 oled_show_string(0, 0, ESP32 I2C OLED); oled_show_string(0, 2, Hello ESP-IDF!); oled_show_string(0, 4, Run Time(s):); uint32_t sec 0; while(1) { // 動(dòng)態(tài)刷新運(yùn)行時(shí)間 oled_show_num(88, 4, sec, 5); sec; vTaskDelay(pdMS_TO_TICKS(1000)); } }預(yù)期效果第0行標(biāo)題文字第2行歡迎字符串第4行運(yùn)行時(shí)間秒數(shù)每秒1六、新手進(jìn)階拓展方向中文顯示使用字模軟件生成中文點(diǎn)陣存入數(shù)組即可顯示圖片/圖標(biāo)顯示取模工具生成位圖數(shù)據(jù)逐頁寫入顯存滾動(dòng)動(dòng)畫SSD1306自帶硬件滾動(dòng)命令無需軟件刷新多設(shè)備掛載同一條I2C總線掛載OLED、傳感器、RTC時(shí)鐘七、I2C OLED 高頻踩坑匯總屏幕完全不亮先查供電是否3.3V、地址是否正確、SCL/SDA是否接反花屏亂碼降低I2C時(shí)鐘頻率、檢查接線接觸不良、初始化順序是否正確部分區(qū)域不顯示坐標(biāo)計(jì)算錯(cuò)誤、顯存分頁越界通信失敗報(bào)錯(cuò)開啟內(nèi)部上拉、共地是否良好、設(shè)備地址掃描確認(rèn)中文顯示亂碼取模方式與驅(qū)動(dòng)寫入方式不匹配需統(tǒng)一行列順序下一篇預(yù)告07篇ESP-IDF保姆級(jí)入門07DHT11溫濕度傳感器 OLED 數(shù)據(jù)顯示打造第一個(gè)完整物聯(lián)網(wǎng)監(jiān)測小項(xiàng)目實(shí)現(xiàn)數(shù)據(jù)采集→屏幕顯示→串口打印全鏈路