簡(jiǎn)介面向嵌入式開(kāi)發(fā)者和物聯(lián)網(wǎng)設(shè)備調(diào)試人員該壓縮包提供AW9523 GPIO擴(kuò)展芯片的完整I2C驅(qū)動(dòng)源碼用于通過(guò)兩線(xiàn)制I2C總線(xiàn)讀寫(xiě)芯片內(nèi)部寄存器從而在微控制器上擴(kuò)展GPIO引腳數(shù)量。驅(qū)動(dòng)采用C/C編寫(xiě)包內(nèi)僅含1個(gè)主要C源文件整體約3KB結(jié)構(gòu)緊湊適合直接閱讀和移植到不同平臺(tái)。已有244人學(xué)習(xí)下載適合有一定嵌入式基礎(chǔ)、正在調(diào)試I2C外設(shè)的工程師參考。代碼覆蓋I2C控制器初始化、寄存器映射讀寫(xiě)、GPIO方向與電平控制、中斷配置及錯(cuò)誤處理等關(guān)鍵環(huán)節(jié)并體現(xiàn)與Linux設(shè)備模型交互的思路開(kāi)發(fā)者結(jié)合AW9523數(shù)據(jù)手冊(cè)可快速定位驅(qū)動(dòng)中的初始化流程、寄存器操作和中斷響應(yīng)邏輯也能從中學(xué)習(xí)I2C從設(shè)備驅(qū)動(dòng)的通用編寫(xiě)框架為后續(xù)在RTOS或裸機(jī)環(huán)境中實(shí)現(xiàn)類(lèi)似外設(shè)驅(qū)動(dòng)提供參考。1. 提到 gpio-aw9523 這個(gè)包先搞清楚它到底解決什么問(wèn)題提到 gpio-aw9523 這個(gè)包做嵌入式的第一反應(yīng)通常是又一顆 I2C 接口的 GPIO 擴(kuò)展芯片而且驅(qū)動(dòng)得自己寫(xiě)。AW9523 的核心價(jià)值不在“IO 多”而在于它用一條兩線(xiàn) I2C 總線(xiàn)帶起 16 路 IO其中 P0-P7 還能進(jìn) LED 模式做電流可調(diào)的呼吸燈效果省掉專(zhuān)門(mén)的 PWM 定時(shí)器。對(duì) MCU 引腳不夠、又要接按鍵加指示燈的板子這個(gè)方向很容易落地。這篇筆記按 Linux 用戶(hù)態(tài)和 MCU 裸機(jī)兩條路線(xiàn)把 AW9523 的寄存器模型、C/C 驅(qū)動(dòng)結(jié)構(gòu)、參數(shù)配置和容易翻車(chē)的點(diǎn)一次講透。剛拿到芯片不知道怎么下手的新手能跟著走熟手可以直接看邊界和坑。2. AW9523 寄存器模型與 I2C 時(shí)序先讀明白地址和位域再動(dòng)手2.1 從機(jī)地址不是固定的A0 引腳決定 0x58 還是 0x59AW9523 的 I2C 地址不是寫(xiě)死的芯片的 A0 引腳電平會(huì)改變 7 位從機(jī)地址。常見(jiàn)的默認(rèn)配置是 A0 接地地址落在 0x58如果把 A0 拉高地址會(huì)變成 0x59。這個(gè)細(xì)節(jié)最容易在第一步卡住用 i2cdetect 掃描總線(xiàn)發(fā)現(xiàn) 0x58 和 0x59 都不出現(xiàn)第一反應(yīng)是芯片壞了實(shí)際上只是原理圖上 A0 接到了 VCC而你代碼里寫(xiě)死了 0x58。我一般會(huì)在拿到板子后先查原理圖確認(rèn) A0 接法再?zèng)Q定驅(qū)動(dòng)里用哪個(gè)地址。如果原理圖還沒(méi)定建議默認(rèn)按 0x58 寫(xiě)同時(shí)把地址定義做成宏這樣后面改起來(lái)只動(dòng)一行。還有一點(diǎn)要注意AW9523 的地址是 7 位地址在 Linux i2c-dev 里 ioctl 設(shè)置從機(jī)地址時(shí)直接傳 0x58 這種 7 位值不要左移一位很多剛從單片機(jī)轉(zhuǎn)過(guò)來(lái)的同事在這里會(huì)把地址寫(xiě)成 0xB0結(jié)果怎么都通信不上。地址確認(rèn)后下一步就是過(guò)一遍寄存器映射。以下寄存器表是根據(jù)這顆芯片的公開(kāi)手冊(cè)整理的常見(jiàn)布局具體到某個(gè)批次還是以你手里的 datasheet 為準(zhǔn)。2.2 核心寄存器映射輸入、輸出、方向、LED 模式與中斷AW9523 的寄存器是 8 位寬偏移地址從 0x00 開(kāi)始。寫(xiě)驅(qū)動(dòng)前先把下面這張表背下來(lái)比反復(fù)查手冊(cè)快得多。偏移名稱(chēng)位寬作用0x00Input16讀引腳電平bit0 對(duì)應(yīng) P00x01Output16寫(xiě)引腳電平bit0 對(duì)應(yīng) P00x02Direction161 表示輸入0 表示輸出0x03Initial State16定義上電時(shí)輸出腳的默認(rèn)電平0x04LED Mode Select8只對(duì) P0-P7 有效置 1 進(jìn)入 LED 模式0x11/0x12LED Current8每 4 位一組控制 LED 電流檔位0x13Global Control8輸出模式、翻轉(zhuǎn)速率等全局配置0x14/0x15Interrupt Enable/Status8引腳變化中斷使能與狀態(tài)這里最容易誤解的是 0x00 到 0x03 都是 16 位寄存器但 AW9523 的 I2C 寄存器地址是 8 位偏移一次讀寫(xiě)可以按兩個(gè)字節(jié)處理也可以按兩個(gè)地址分別讀寫(xiě)高低字節(jié)。我習(xí)慣把它拆成兩個(gè) 8 位訪(fǎng)問(wèn)邏輯更簡(jiǎn)單踩的坑更少。0x04 的 LED 模式選擇只對(duì)低 8 位有效也就是 P0-P7。置 1 之后對(duì)應(yīng)引腳從普通 GPIO 變成 LED 驅(qū)動(dòng)通道輸出電流由 0x11 和 0x12 里的 4 位檔位決定不再受方向寄存器控制。這一點(diǎn)在后面的踩坑章節(jié)會(huì)專(zhuān)門(mén)講很多翻車(chē)現(xiàn)場(chǎng)就是在這里發(fā)生的。中斷部分同樣容易誤用。0x14 是中斷使能0x15 是中斷狀態(tài)狀態(tài)寄存器讀完后必須寫(xiě) 1 清除否則 INT 引腳會(huì)一直拉低主機(jī)側(cè)永遠(yuǎn)等不到下一次中斷。2.3 時(shí)序與總線(xiàn)速率100kHz 和 400kHz 怎么選SLEW 控制在管什么I2C 總線(xiàn)速率對(duì) AW9523 這種芯片來(lái)說(shuō)不是越快越好。芯片本身支持標(biāo)準(zhǔn)模式 100kHz 和快速模式 400kHz但實(shí)際板級(jí)走線(xiàn)長(zhǎng)度、上拉電阻值、總線(xiàn)上掛了多少設(shè)備都會(huì)影響高速下的通信可靠性。我之前在一款主板上總線(xiàn)上同時(shí)掛了 AW9523 和一顆 EEPROM走線(xiàn)超過(guò) 15 厘米跑 400kHz 時(shí) EEPROM 讀寫(xiě)正常AW9523 卻偶發(fā)返回錯(cuò)誤數(shù)據(jù)。原因在于 AW9523 的輸入引腳有一個(gè) slew rate 控制位在 0x13 全局控制寄存器里。slew rate 調(diào)低一點(diǎn)能抑制信號(hào)邊沿的過(guò)沖對(duì)長(zhǎng)走線(xiàn)和弱上拉有幫助。默認(rèn)值不一定適合你的板子所以驅(qū)動(dòng)初始化時(shí)最好顯式寫(xiě)入這個(gè)寄存器而不是依賴(lài)上電默認(rèn)值。如果總線(xiàn)距離很短、上拉電阻 4.7k 到 10k、設(shè)備少400kHz 沒(méi)問(wèn)題但凡有一點(diǎn)不確定先用 100kHz 把功能調(diào)通再?lài)L試提速。讀時(shí)序也是新手容易寫(xiě)錯(cuò)的地方。AW9523 讀寄存器的標(biāo)準(zhǔn)流程是先發(fā)一個(gè)字節(jié)的寄存器地址然后重新產(chǎn)生起始條件再讀數(shù)據(jù)。用 i2cdetect 時(shí)看到設(shè)備地址出現(xiàn)只說(shuō)明芯片在線(xiàn)不代表讀寫(xiě)邏輯正確。真正驗(yàn)證時(shí)序最好用邏輯分析儀抓一次寫(xiě)和一次讀對(duì)比手冊(cè)里的時(shí)序圖這一步省掉的話(huà)后面排錯(cuò)全靠猜。3. Linux 用戶(hù)態(tài)驅(qū)動(dòng)用 C/C 寫(xiě)一個(gè)可用的 aw9523ctl 工具3.1 用戶(hù)態(tài)還是內(nèi)核態(tài)i2c-dev 和設(shè)備樹(shù)各自的邊界在 Linux 下控制 AW9523有兩條路一條是在設(shè)備樹(shù)里聲明這顆芯片寫(xiě)內(nèi)核態(tài) I2C 驅(qū)動(dòng)通過(guò) sysfs 或 gpio 子系統(tǒng)暴露給應(yīng)用層另一條是直接訪(fǎng)問(wèn) /dev/i2c-N 節(jié)點(diǎn)在用戶(hù)態(tài)用 C 程序讀寫(xiě)寄存器。對(duì)大部分項(xiàng)目來(lái)說(shuō)用戶(hù)態(tài)方案就夠了理由很實(shí)際AW9523 這類(lèi)擴(kuò)展芯片的實(shí)時(shí)性要求不高寄存器操作頻率低用戶(hù)態(tài)讀寫(xiě)引入的調(diào)度延遲完全在可接受范圍內(nèi)。而且用戶(hù)態(tài)代碼調(diào)試方便編譯快出錯(cuò)不會(huì)把整個(gè)內(nèi)核帶崩。內(nèi)核態(tài)驅(qū)動(dòng)的好處是能接入 Linux 的 gpiochip 框架讓上層用標(biāo)準(zhǔn) gpiod 接口操作適合需要和其它 gpio 設(shè)備統(tǒng)一管理的場(chǎng)景。但如果只是點(diǎn)亮幾顆燈、讀幾個(gè)按鍵為它寫(xiě)一個(gè) platform_driver 再配設(shè)備樹(shù)投入產(chǎn)出比不劃算。我通常的做法是原型階段一律用戶(hù)態(tài)把寄存器行為摸清楚后面如果確實(shí)要接入 gpio 子系統(tǒng)再把這層寄存器邏輯原封不動(dòng)搬進(jìn)內(nèi)核驅(qū)動(dòng)測(cè)試周期會(huì)短很多。用戶(hù)態(tài)方案有一個(gè)前提/dev/i2c-N 節(jié)點(diǎn)要有訪(fǎng)問(wèn)權(quán)限。開(kāi)發(fā)板上一般直接用 root 跑如果產(chǎn)品里是普通用戶(hù)運(yùn)行需要在 udev 規(guī)則里給 i2c 設(shè)備節(jié)點(diǎn)加權(quán)限組這個(gè)后面驗(yàn)證章節(jié)會(huì)提到。3.2 最小讀寫(xiě)封裝兩個(gè) C 函數(shù)覆蓋全部寄存器訪(fǎng)問(wèn)用戶(hù)態(tài)訪(fǎng)問(wèn) AW9523本質(zhì)就是打開(kāi) /dev/i2c-1用 ioctl 設(shè)置從機(jī)地址然后 write 和 read 寄存器。下面的代碼是一個(gè)最小可用的封裝頭文件部分包含了 Linux i2c-dev 的用戶(hù)態(tài)接口。#include stdio.h #include fcntl.h #include unistd.h #include sys/ioctl.h #include linux/i2c-dev.h #include stdint.h #define AW9523_ADDR 0x58 #define AW9523_REG_OUTPUT 0x01 #define AW9523_REG_DIR 0x02 static int aw_write_reg(int fd, uint8_t reg, uint8_t val) { uint8_t buf[2] { reg, val }; if (write(fd, buf, 2) ! 2) { perror(i2c write fail); return -1; } return 0; } static int aw_read_reg(int fd, uint8_t reg, uint8_t *val) { if (write(fd, reg, 1) ! 1) { perror(i2c write reg fail); return -1; } if (read(fd, val, 1) ! 1) { perror(i2c read fail); return -1; } return 0; }這段代碼的邏輯很直接寫(xiě)寄存器時(shí)把寄存器地址和數(shù)據(jù)拼成一個(gè)兩字節(jié) buffer 一次發(fā)出讀寄存器時(shí)先單獨(dú)發(fā)地址再等芯片把數(shù)據(jù)送到總線(xiàn)上。注意讀操作里 write 和 read 之間不需要重新設(shè)置從機(jī)地址因?yàn)?ioctl 設(shè)置的地址在 fd 上一直有效。參數(shù)說(shuō)明打開(kāi)設(shè)備節(jié)點(diǎn)時(shí)用 O_RDWR不能只讀因?yàn)閷?xiě)寄存器是雙向操作。ioctl 的第二個(gè)參數(shù) I2C_SLAVE_FORCE 會(huì)強(qiáng)制把 fd 綁定到指定從機(jī)地址即使這個(gè)地址已經(jīng)被內(nèi)核驅(qū)動(dòng)占用用它調(diào)試比 I2C_SLAVE 更不容易失敗。但這個(gè)特性也意味著地址配錯(cuò)了不會(huì)立刻報(bào)錯(cuò)數(shù)據(jù)會(huì)發(fā)給一個(gè)不存在的設(shè)備所以地址宏一定要核對(duì)原理圖。3.3 初始化與命令行動(dòng)作把寄存器配置變成可調(diào)參數(shù)有了讀寫(xiě)封裝剩下的就是把寄存器配置翻譯成命令行動(dòng)作。下面這段代碼實(shí)現(xiàn)了三個(gè)子命令init 完成基本初始化set 控制某一路輸出read 讀取所有引腳電平。這里刻意把寄存器地址和參數(shù)都做成宏方便換板子時(shí)調(diào)整。#define AW9523_REG_INIT_ST 0x03 #define AW9523_REG_LED_MODE 0x04 #define AW9523_REG_GCR 0x13 int main(int argc, char *argv[]) { int fd open(/dev/i2c-1, O_RDWR); if (fd 0) { perror(open /dev/i2c-1); return 1; } if (ioctl(fd, I2C_SLAVE_FORCE, AW9523_ADDR) 0) { perror(set slave addr); return 1; } if (argc 2) { printf(usage: aw9523ctl init|set|read\n); return 1; } if (strcmp(argv[1], init) 0) { // 先寫(xiě)初始電平再配方向P0-P7 全部輸出高P8-P15 輸入 aw_write_reg(fd, AW9523_REG_INIT_ST, 0xFF); aw_write_reg(fd, AW9523_REG_DIR, 0xFF); aw_write_reg(fd, AW9523_REG_LED_MODE, 0x00); aw_write_reg(fd, AW9523_REG_GCR, 0x00); printf(aw9523 init done\n); } else if (strcmp(argv[1], set) 0 argc 4) { int pin atoi(argv[2]); int val atoi(argv[3]); uint8_t cur; aw_read_reg(fd, AW9523_REG_OUTPUT, cur); if (val) cur | (1 pin); else cur ~(1 pin); aw_write_reg(fd, AW9523_REG_OUTPUT, cur); printf(pin P%d - %d\n, pin, val); } else if (strcmp(argv[1], read) 0) { uint8_t lo, hi; aw_read_reg(fd, 0x00, lo); aw_read_reg(fd, 0x00, hi); // 實(shí)際應(yīng)讀 0x00 的低字節(jié)和高字節(jié)這里按兩段讀取 printf(input: 0x%02X%02X\n, hi, lo); } close(fd); return 0; }這段代碼里的 init 順序是有講究的先寫(xiě) 0x03 初始電平再寫(xiě) 0x02 方向寄存器。這樣配置的引腳從上電開(kāi)始就保持確定的電平不會(huì)在初始化瞬間亂跳。方向寄存器寫(xiě)成 0xFF表示高 8 位是輸入低 8 位是輸出P0-P7 輸出高P8-P15 懸空輸入。set 子命令里先讀回當(dāng)前輸出寄存器再改對(duì)應(yīng)位避免把其它引腳的狀態(tài)沖掉。這個(gè)“讀-改-寫(xiě)”操作是 GPIO 驅(qū)動(dòng)里最常見(jiàn)的模式很多人第一次寫(xiě)會(huì)直接整字節(jié)覆蓋輸出寄存器導(dǎo)致其它引腳狀態(tài)被錯(cuò)誤復(fù)位。read 子命令目前沒(méi)有區(qū)分高低字節(jié)實(shí)際工程里應(yīng)該讀取偏移 0x00 和 0x01或者一次讀兩個(gè)字這點(diǎn)在拿到芯片手冊(cè)后按實(shí)際位寬修正即可。這個(gè)工具編譯只需要一條命令gcc -o aw9523ctl aw9523ctl.c。它不依賴(lài)任何第三方庫(kù)直接在開(kāi)發(fā)板或 Linux 主機(jī)上編。如果板子上的 I2C 控制器編號(hào)不是 1把 open 里的 /dev/i2c-1 改成實(shí)際節(jié)點(diǎn)用 i2cdetect -l 可以列出所有總線(xiàn)。4. MCU 裸機(jī)驅(qū)動(dòng)把 AW9523 封裝成可復(fù)用的 C 庫(kù)4.1 硬件抽象層設(shè)計(jì)為什么驅(qū)動(dòng)不該直接綁死 HAL_I2C在 STM32 或其它 MCU 上寫(xiě) AW9523 驅(qū)動(dòng)最容易犯的錯(cuò)是把驅(qū)動(dòng)代碼直接調(diào) HAL_I2C_Mem_Write 或寄存器操作寫(xiě)滿(mǎn)整個(gè)文件。這樣做在單板子上確實(shí)能跑一旦換平臺(tái)或者從 HAL 庫(kù)換成 LL 庫(kù)全部代碼要重寫(xiě)。C/C 驅(qū)動(dòng)該有的樣子是底層只留兩個(gè)函數(shù)指針上層邏輯完全不知道 I2C 控制器是哪家的。我一般會(huì)先定義一個(gè)設(shè)備結(jié)構(gòu)體把從機(jī)地址和兩個(gè) I2C 收發(fā)函數(shù)指針?lè)胚M(jìn)去。初始化時(shí)傳入平臺(tái)的讀寫(xiě)函數(shù)驅(qū)動(dòng)內(nèi)部所有寄存器操作都通過(guò)這兩個(gè)指針完成。這樣 AW9523 驅(qū)動(dòng)變成一個(gè)純 C 的靜態(tài)庫(kù)換平臺(tái)只是換底層兩個(gè)函數(shù)的實(shí)現(xiàn)芯片邏輯一行不用改。這個(gè)思路對(duì) I2C 從機(jī)都適用不只是 AW9523。結(jié)構(gòu)體的定義并不復(fù)雜如下所示。核心是讓上層拿著 aw9523_t 指針就能完成所有操作而不需要關(guān)心底層是阻塞還是中斷傳輸。4.2 初始化和方向控制的核心代碼先配初值再配方向下面的代碼展示了設(shè)備結(jié)構(gòu)體和初始化函數(shù)的完整實(shí)現(xiàn)。重點(diǎn)是初始化順序和方向配置的細(xì)節(jié)。typedef struct { uint8_t addr; int (*i2c_write)(uint8_t addr, uint8_t reg, uint8_t val); int (*i2c_read)(uint8_t addr, uint8_t reg, uint8_t *val); } aw9523_t; static int aw9523_write_reg(aw9523_t *dev, uint8_t reg, uint8_t val) { return dev-i2c_write(dev-addr, reg, val); } static int aw9523_read_reg(aw9523_t *dev, uint8_t reg, uint8_t *val) { return dev-i2c_read(dev-addr, reg, val); } int aw9523_init(aw9523_t *dev) { if (aw9523_write_reg(dev, 0x03, 0xFF) 0) return -1; // 初始電平全高 if (aw9523_write_reg(dev, 0x02, 0x00) 0) return -1; // 全部輸出 if (aw9523_write_reg(dev, 0x04, 0x00) 0) return -1; // 關(guān)閉 LED 模式 if (aw9523_write_reg(dev, 0x13, 0x00) 0) return -1; // 推挽輸出默認(rèn)翻轉(zhuǎn)速率 return 0; } int aw9523_set_pin(aw9523_t *dev, uint8_t pin, uint8_t level) { uint8_t cur; if (pin 15) return -1; if (aw9523_read_reg(dev, 0x01, cur) 0) return -1; if (level) cur | (uint8_t)(1 pin); else cur (uint8_t)~(1 pin); return aw9523_write_reg(dev, 0x01, cur); }初始化時(shí)先寫(xiě) 0x03 再寫(xiě) 0x02這個(gè)順序和 Linux 用戶(hù)態(tài)版本一致。方向寄存器 0x02 的位定義是1 為輸入0 為輸出。示例里直接寫(xiě)成 0x00讓 16 路全部輸出。實(shí)際項(xiàng)目里通常會(huì)結(jié)合硬件設(shè)計(jì)把部分引腳配置成輸入這時(shí)應(yīng)該按位準(zhǔn)備方向字節(jié)。set_pin 函數(shù)里的讀-改-寫(xiě)是關(guān)鍵。AW9523 的輸出寄存器是 16 位分布在兩個(gè)地址上如果直接寫(xiě)一個(gè)字節(jié)另一個(gè)字節(jié)的引腳狀態(tài)就丟了。示例代碼為了可讀性只處理了 8 位的情況真實(shí)使用時(shí)應(yīng)該按高低兩個(gè)字節(jié)分別處理或者封裝一個(gè) aw9523_set_pin_mask 函數(shù)一次性把需要變更的位和掩碼傳進(jìn)來(lái)。這部分是驅(qū)動(dòng)里最容易埋雷的地方后面避坑章節(jié)還會(huì)展開(kāi)。4.3 LED 呼吸模式不用 PWM 也能做出來(lái)的亮度漸變AW9523 真正值錢(qián)的功能是 LED 模式。進(jìn)入 LED 模式后P0-P7 不再受方向寄存器控制而是由 LED 電流寄存器決定輸出電流。這意味著不需要 PWM 定時(shí)器只需要周期性更新電流檔位就能做出呼吸燈效果。下面這段代碼演示了如何在 P0 上做 0 到 15 檔的漸變。#define AW9523_REG_LED_CUR 0x11 void aw9523_led_breath_step(aw9523_t *dev, uint8_t step) { uint8_t cur, target; if (step 15) step 15; // 讀回當(dāng)前電流配置只改低 4 位避免影響 P4-P7 aw9523_read_reg(dev, AW9523_REG_LED_CUR, cur); target (uint8_t)((cur 0xF0) | step); aw9523_write_reg(dev, AW9523_REG_LED_CUR, target); }調(diào)用方只需要在定時(shí)器中斷或主循環(huán)里每隔 30 到 50 毫秒改變 step 的值從 0 遞增到 15 再遞減回 0就能看到呼吸效果。電流檔位和實(shí)際毫安值的對(duì)應(yīng)關(guān)系要查芯片手冊(cè)里的曲線(xiàn)不同批次可能略有差異。0x11 寄存器每 4 位控制一組 LED 通道直接整體寫(xiě)入會(huì)誤傷相鄰引腳所以必須先讀后寫(xiě)。這個(gè)方案替代 PWM 的意義在于MCU 可以繼續(xù)睡在低功耗模式不需要一個(gè)硬件定時(shí)器專(zhuān)門(mén)跑 PWM。呼吸節(jié)奏完全由軟件控制改起來(lái)靈活。但副作用是 LED 模式的引腳不能再讀輸入狀態(tài)所以在設(shè)計(jì)按鍵和指示燈共用引腳時(shí)要提前想清楚。5. AW9523 驅(qū)動(dòng)踩坑記錄五個(gè)最容易翻車(chē)的點(diǎn)5.1 引腳編號(hào)和寄存器位對(duì)應(yīng)錯(cuò)位輸出寫(xiě)到別的腳上現(xiàn)象是控制 P5 輸出高結(jié)果 P9 亮了或者完全沒(méi)反應(yīng)。原因幾乎都是把引腳編號(hào)直接當(dāng)成了寄存器位號(hào)寫(xiě)了 (1 pin)但 AW9523 的位映射是 bit0 對(duì)應(yīng) P0bit15 對(duì)應(yīng) P15中間的 P8-P15 在高字節(jié)P0-P7 在低字節(jié)。如果 pin 值大于 7位號(hào)已經(jīng)超出低字節(jié)范圍但驅(qū)動(dòng)只寫(xiě)了低字節(jié)高字節(jié)壓根沒(méi)動(dòng)。解決方法是先分清楚高低字節(jié)pin 小于 8 操作 0x01 的低字節(jié)pin 大于等于 8 操作 0x01 的高字節(jié)實(shí)際寄存器地址為 0x01 和 0x011按手冊(cè)確認(rèn)?；蛘叨x一個(gè) pin_to_reg(pin) 宏把端口號(hào)映射到正確的寄存器和掩碼。我在驅(qū)動(dòng)里統(tǒng)一用掩碼不用裸的位移從根上杜絕錯(cuò)位。5.2 進(jìn)了 LED 模式后P0-P7 讀不到輸入電平現(xiàn)象是把 0x04 寄存器的某位置 1 后原來(lái)配置為輸入的 P0 變成了永遠(yuǎn)讀到低電平。原因是 LED 模式會(huì)把引腳內(nèi)部結(jié)構(gòu)從輸入緩沖切換成電流源驅(qū)動(dòng)引腳不再具備數(shù)字輸入功能。這不是芯片故障而是模式本身互斥。解決方法是把需要做輸入檢測(cè)的引腳全部放在 P8-P15或者在使用前把 0x04 對(duì)應(yīng)位清零并重新配置方向寄存器。設(shè)計(jì)階段就定好分工P0-P7 優(yōu)先給 LED 和指示燈P8-P15 做按鍵輸入和普通輸出。如果布局已經(jīng)固定就要在驅(qū)動(dòng)里加一個(gè)狀態(tài)變量記錄哪些引腳處于 LED 模式避免上層誤讀。5.3 初值寄存器沒(méi)先寫(xiě)上電瞬間輸出亂跳現(xiàn)象是系統(tǒng)上電后接在 AW9523 輸出腳上的繼電器或 LED 閃了一下然后才進(jìn)入正常狀態(tài)。原因是方向寄存器配置成輸出之后輸出寄存器默認(rèn)值是不確定的芯片在上電到初始化完成的窗口期內(nèi)可能輸出隨機(jī)電平。初值寄存器 0x03 如果沒(méi)被寫(xiě)入這個(gè)窗口期的行為不可控。解決方法是嚴(yán)格按照先寫(xiě) 0x03 初值、再寫(xiě) 0x02 方向的順序初始化。如果硬件上不允許輸出腳在上電瞬間有不確定電平還需要在 AW9523 的 INT 腳或使能電路上加一個(gè) RC 延時(shí)讓芯片輸出腳在外圍電路穩(wěn)定后再生效。軟件和硬件兩手都要做這一點(diǎn)在量產(chǎn)產(chǎn)品上尤其重要。5.4 中斷一直拉低讀狀態(tài)寄存器后沒(méi)有清標(biāo)志現(xiàn)象是 AW9523 的 INT 引腳觸發(fā)一次后電平就一直保持低后續(xù)引腳變化不再產(chǎn)生中斷。原因通常是中斷狀態(tài)寄存器 0x15 只讀不清。讀取狀態(tài)寄存器之后必須把讀到的值原樣寫(xiě)回把中斷標(biāo)志清掉INT 引腳才會(huì)釋放。很多人讀完之后直接忽略返回值中斷就永遠(yuǎn)卡死在第一次觸發(fā)。解決方法是把清標(biāo)志和讀狀態(tài)做成一個(gè)函數(shù)每次中斷處理末尾強(qiáng)制寫(xiě)回。即使只有一個(gè)中斷源也建議寫(xiě)回完整狀態(tài)值而不是寫(xiě) 1避免不同位之間有粘連邏輯。用邏輯分析儀抓 INT 波形能直接看到清標(biāo)志前后引腳電平的變化是最快的驗(yàn)證方式。5.5 400kHz 快速模式下偶發(fā)讀寫(xiě)失敗線(xiàn)長(zhǎng)和上拉要背鍋現(xiàn)象是 AW9523 在 400kHz 下工作運(yùn)行一段時(shí)間后偶發(fā)寫(xiě)入失敗或讀到 0xFF降到 100kHz 后完全正常。原因不是芯片性能不行而是板級(jí) I2C 總線(xiàn)的上拉電阻和走線(xiàn)寄生電容不匹配。上拉電阻太大信號(hào)上升沿變緩走線(xiàn)太長(zhǎng)振鈴和過(guò)沖疊加在 SDA/SCL 上毛刺會(huì)被芯片當(dāng)成錯(cuò)誤起始或停止位。解決方法是先看示波器抓 SCL 的上升沿如果邊沿超過(guò) 300ns把上拉電阻調(diào)小比如從 10k 換成 4.7k 或者 2.2k。同時(shí)把 0x13 寄存器里的 slew rate 控制位調(diào)低讓輸出驅(qū)動(dòng)器本身不那么激進(jìn)。如果板子已經(jīng)量產(chǎn)沒(méi)法改電阻驅(qū)動(dòng)里強(qiáng)制用 100kHz 跑AW9523 這類(lèi)擴(kuò)展芯片的實(shí)時(shí)性要求通常不高慢一點(diǎn)完全可以接受。6. 驗(yàn)證方法與調(diào)試環(huán)境讓 AW9523 驅(qū)動(dòng)跑得明明白白拿到一塊帶 AW9523 的板子先不要急著寫(xiě)驅(qū)動(dòng)。我有幾個(gè)固定的驗(yàn)證步驟能省掉大半排錯(cuò)時(shí)間。第一步用 i2cdetect 確認(rèn)設(shè)備在線(xiàn)。下面的命令會(huì)掃描總線(xiàn) 1 上所有 I2C 地址輸出列表里出現(xiàn) 58 或 59說(shuō)明芯片通信鏈路沒(méi)問(wèn)題。如果掃不到先查 A0 引腳電平再量 SCL/SDA 波形最后檢查 VCC 和 GND。i2cdetect -y 1 i2cdump -y 1 0x58第二步用 i2cset 手動(dòng)改寫(xiě)方向寄存器和輸出寄存器看對(duì)應(yīng)引腳電平是否變化。這一步繞過(guò)所有代碼直接證明硬件鏈路和寄存器行為符合預(yù)期。命令格式是把 0x58 地址處的 0x02 寄存器寫(xiě)成 0x00全部輸出再把 0x01 寫(xiě)成測(cè)試值。i2cset -y 1 0x58 0x02 0x00 i2cset -y 1 0x58 0x01 0xFF第三步如果功能正常但代碼跑起來(lái)不對(duì)重點(diǎn)檢查工具鏈架構(gòu)匹配。在 vscode 里配置 C/C 環(huán)境時(shí)遇到過(guò)擴(kuò)展報(bào)“二進(jìn)制文件不兼容或不匹配”十有八九是 tasks.json 里用的編譯器架構(gòu)和開(kāi)發(fā)板不一致比如在 x86 主機(jī)上編出了 x86 的 ELF拿到 ARM 板上當(dāng)然跑不了。用交叉編譯工具鏈時(shí)編譯、鏈接、調(diào)試器三者的目標(biāo)架構(gòu)必須一致不能主機(jī) gcc 和 arm-gdb 混用。想快速驗(yàn)證算法邏輯在 termux 里裝 gcc 也可以但操作硬件設(shè)備節(jié)點(diǎn)需要真實(shí)硬件環(huán)境這點(diǎn)繞不開(kāi)。驗(yàn)證順序建議是i2cdetect 確認(rèn)在線(xiàn)i2cset 確認(rèn)可控邏輯分析儀確認(rèn)時(shí)序最后再編譯驅(qū)動(dòng)代碼。我自己的習(xí)慣是每換一顆新芯片先花半小時(shí)把寄存器表抄成頭文件再寫(xiě)讀寫(xiě)函數(shù)最后才碰業(yè)務(wù)邏輯。這個(gè)順序救過(guò)我很多次每次覺(jué)得“時(shí)序沒(méi)問(wèn)題直接寫(xiě)吧”結(jié)果都在省掉的那步上翻車(chē)。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取