簡(jiǎn)介這份資源是 PAJ7620 手勢(shì)識(shí)別傳感器的開源庫(kù)文件面向使用 Arduino 或嵌入式平臺(tái)開發(fā)手勢(shì)交互的創(chuàng)客、學(xué)生與硬件工程師。PAJ7620U2 將手勢(shì)識(shí)別與通用 I2C 接口集成于單芯片可識(shí)別 9 種基本手勢(shì)通過(guò) I2C 總線即可讀取手勢(shì)信息常用于控制執(zhí)行單元、計(jì)算機(jī)、手機(jī)、智能車或機(jī)器人等設(shè)備實(shí)現(xiàn)輕觸即控的交互方式。壓縮包共 8 個(gè)文件約 12KB包含 2 個(gè) ino 示例程序、cpp 與 h 庫(kù)源碼、keywords.txt 關(guān)鍵字高亮文件、library.properties 庫(kù)描述文件、LICENSE 授權(quán)協(xié)議及 README.md 說(shuō)明文檔覆蓋從庫(kù)安裝到示例運(yùn)行的基本要素。目前已有 724 人學(xué)習(xí)下載。借助其中的 9 種手勢(shì)與 15 種手勢(shì)示例讀者可快速完成傳感器接線、庫(kù)導(dǎo)入與手勢(shì)數(shù)據(jù)讀取驗(yàn)證并在此基礎(chǔ)上將手勢(shì)識(shí)別集成到自己的 Arduino 項(xiàng)目中縮短底層驅(qū)動(dòng)調(diào)試時(shí)間。1. 手勢(shì)識(shí)別模塊 PAJ7620 到底能做成什么從一顆傳感器到一套可復(fù)現(xiàn)的手勢(shì)交互如果你手上有一塊 PAJ7620 手勢(shì)識(shí)別傳感器想用最低成本把它跑起來(lái)做出上下左右、接近、遠(yuǎn)離、順時(shí)針、逆時(shí)針這類手勢(shì)動(dòng)作的識(shí)別那Gesture_PAJ7620-master.zip這個(gè)方向就是為你準(zhǔn)備的。它解決的不是“手勢(shì)識(shí)別算法怎么從零訓(xùn)練”的問(wèn)題而是“我已經(jīng)有一顆現(xiàn)成的紅外手勢(shì)傳感器怎么在嵌入式主控上穩(wěn)定讀出九種手勢(shì)并把它接到自己的交互邏輯里”。適合做智能燈控、非接觸式翻頁(yè)器、車載中控輔助、教學(xué)演示裝置的開發(fā)者也適合剛接觸 I2C 傳感器、想找一個(gè)完整閉環(huán)練手的新手。核心難點(diǎn)不在驅(qū)動(dòng)本身而在初始化時(shí)序、寄存器配置和中斷讀取的配合這幾處不處理好讀出來(lái)的數(shù)據(jù)會(huì)飄得讓你懷疑人生。2. PAJ7620 的 I2C 通信與寄存器模型先搞懂它在跟誰(shuí)說(shuō)話PAJ7620 是一顆集成紅外 LED、光學(xué)鏡頭和手勢(shì)識(shí)別算法的傳感器模組對(duì)外只暴露 I2C 接口。它內(nèi)部有一塊寄存器空間分 bank 0 和 bank 1bank 切換靠寫0xEF寄存器實(shí)現(xiàn)。手勢(shì)結(jié)果放在 bank 0 的0x43到0x45這幾個(gè)地址里分別對(duì)應(yīng)不同手勢(shì)組。很多人第一次讀不出數(shù)據(jù)不是接線錯(cuò)了而是沒(méi)做 bank 切換或者初始化數(shù)組沒(méi)寫全。2.1 為什么必須先寫初始化寄存器數(shù)組PAJ7620 上電后不會(huì)自動(dòng)進(jìn)入手勢(shì)識(shí)別模式它需要一段固定的寄存器配置序列把內(nèi)部增益、LED 驅(qū)動(dòng)電流、手勢(shì)檢測(cè)閾值都設(shè)好。這段序列在常見(jiàn)做法里是一張幾十項(xiàng)的{寄存器地址, 值}表通常放在驅(qū)動(dòng)文件里作為常量數(shù)組。跳過(guò)這一步直接讀手勢(shì)寄存器返回值基本是 0 或者隨機(jī)跳變。我一般會(huì)把初始化數(shù)組分成兩段第一段是通用配置第二段是手勢(shì)模式專屬配置。寫的時(shí)候按順序逐條寫每條之間不需要額外延時(shí)但整段寫完后要留至少 10ms 讓傳感器穩(wěn)定。下面是一個(gè)典型的初始化片段結(jié)構(gòu)// PAJ7620 初始化寄存器配置表節(jié)選bank 切換已包含在序列中 typedef struct { uint8_t reg; uint8_t val; } paj7620_init_reg_t; static const paj7620_init_reg_t init_sequence[] { {0xEF, 0x00}, // 切換到 bank 0 {0x37, 0x07}, // 設(shè)置手勢(shì)檢測(cè)模式相關(guān)位 {0x38, 0x17}, {0x39, 0x06}, {0x41, 0x00}, {0x42, 0x00}, {0x46, 0x2D}, {0x47, 0x0F}, {0x48, 0x3C}, {0x49, 0x00}, {0x4A, 0x1E}, {0x4C, 0x20}, {0x51, 0x10}, {0x5E, 0x10}, {0x60, 0x20}, {0x80, 0x20}, {0x81, 0x40}, {0x82, 0x04}, {0x8B, 0x01}, {0x90, 0x00}, {0x95, 0x00}, {0x96, 0x00}, {0x97, 0x00}, {0x9A, 0x00}, {0x9C, 0x00}, {0xA5, 0x00}, {0xEF, 0x01}, // 切換到 bank 1 {0x00, 0x00}, {0x01, 0x1E}, {0x02, 0x0F}, {0x03, 0x10}, {0x04, 0x02}, {0x05, 0x00}, {0x06, 0x00}, {0x07, 0x00}, {0x08, 0x00}, {0xEF, 0x00}, // 切回 bank 0 {0x41, 0x00}, {0x42, 0x00}, {0x43, 0x00}, {0x44, 0x00}, {0x45, 0x00}, };這段代碼的邏輯是先切 bank再按順序?qū)懪渲米詈蟀咽謩?shì)結(jié)果寄存器清零。參數(shù)說(shuō)明上0xEF是 bank 選擇寄存器寫 0 進(jìn) bank 0寫 1 進(jìn) bank 1。0x41到0x45是手勢(shì)中斷和結(jié)果相關(guān)寄存器初始化末尾清零是為了防止上電殘留數(shù)據(jù)被誤讀。注意不同批次的模組初始化序列可能有細(xì)微差異如果讀不到手勢(shì)優(yōu)先檢查這張表是否完整。2.2 手勢(shì)結(jié)果寄存器的讀取與解析初始化完成后手勢(shì)結(jié)果會(huì)出現(xiàn)在 bank 0 的0x43、0x44、0x45三個(gè)寄存器里。常見(jiàn)做法是讀0x43和0x44兩個(gè)字節(jié)拼成一個(gè) 16 位值再按位判斷具體手勢(shì)。0x43的低幾位對(duì)應(yīng)上下左右0x44對(duì)應(yīng)接近、遠(yuǎn)離、順時(shí)針、逆時(shí)針。讀取時(shí)建議先讀0x43再讀0x44中間不要插入其他 I2C 操作避免數(shù)據(jù)不同步。// 讀取手勢(shì)結(jié)果并解析為枚舉值 typedef enum { GESTURE_NONE 0, GESTURE_UP 1, GESTURE_DOWN 2, GESTURE_LEFT 3, GESTURE_RIGHT 4, GESTURE_NEAR 5, GESTURE_FAR 6, GESTURE_CLOCKWISE 7, GESTURE_COUNTER 8, } gesture_t; gesture_t paj7620_read_gesture(void) { uint8_t data[2] {0}; i2c_read_reg(PAJ7620_ADDR, 0x43, data[0], 1); i2c_read_reg(PAJ7620_ADDR, 0x44, data[1], 1); uint16_t val ((uint16_t)data[1] 8) | data[0]; if (val 0x0001) return GESTURE_UP; if (val 0x0002) return GESTURE_DOWN; if (val 0x0004) return GESTURE_LEFT; if (val 0x0008) return GESTURE_RIGHT; if (val 0x0100) return GESTURE_NEAR; if (val 0x0200) return GESTURE_FAR; if (val 0x0400) return GESTURE_CLOCKWISE; if (val 0x0800) return GESTURE_COUNTER; return GESTURE_NONE; }邏輯說(shuō)明先分別讀兩個(gè)寄存器再拼成 16 位。位判斷的順序會(huì)影響多手勢(shì)同時(shí)觸發(fā)時(shí)的優(yōu)先級(jí)我一般把上下左右放在前面因?yàn)檫@幾個(gè)手勢(shì)誤觸發(fā)率相對(duì)低。參數(shù)上PAJ7620_ADDR通常是 0x737 位地址具體以模組手冊(cè)為準(zhǔn)。如果讀出來(lái)一直是 0先確認(rèn) I2C 地址對(duì)不對(duì)再確認(rèn)初始化是否成功。3. 在主流嵌入式平臺(tái)上跑通最小可復(fù)現(xiàn)工程拿到Gesture_PAJ7620-master.zip這類工程后不要急著改業(yè)務(wù)邏輯先把最小讀取跑通。不同平臺(tái)的差異主要在 I2C 底層接口和延時(shí)函數(shù)上層寄存器操作是一樣的。下面按常見(jiàn)做法給出兩個(gè)平臺(tái)的接入方式選你手上有的那個(gè)就行。3.1 基于 Arduino 框架的最小讀取示例Arduino 平臺(tái)適合快速驗(yàn)證。接線只有四根VCC、GND、SDA、SCL。注意 PAJ7620 的工作電壓常見(jiàn)是 3.3V如果主控是 5VI2C 電平要確認(rèn)是否兼容否則容易讀不到數(shù)據(jù)。#include Wire.h #define PAJ7620_ADDR 0x73 // 初始化序列省略實(shí)際使用時(shí)把完整數(shù)組填入 void paj7620_init() { for (size_t i 0; i sizeof(init_sequence)/sizeof(init_sequence[0]); i) { Wire.beginTransmission(PAJ7620_ADDR); Wire.write(init_sequence[i].reg); Wire.write(init_sequence[i].val); Wire.endTransmission(); } delay(10); } uint16_t paj7620_read() { uint8_t lo 0, hi 0; Wire.beginTransmission(PAJ7620_ADDR); Wire.write(0x43); Wire.endTransmission(false); Wire.requestFrom(PAJ7620_ADDR, 1); if (Wire.available()) lo Wire.read(); Wire.beginTransmission(PAJ7620_ADDR); Wire.write(0x44); Wire.endTransmission(false); Wire.requestFrom(PAJ7620_ADDR, 1); if (Wire.available()) hi Wire.read(); return ((uint16_t)hi 8) | lo; } void setup() { Serial.begin(115200); Wire.begin(); paj7620_init(); } void loop() { uint16_t g paj7620_read(); if (g ! 0) { Serial.println(g, HEX); delay(200); // 防止同一次手勢(shì)被連續(xù)上報(bào) } }邏輯說(shuō)明paj7620_init逐條寫初始化表paj7620_read分兩次讀寄存器。參數(shù)上delay(200)是去抖用的PAJ7620 一次手勢(shì)會(huì)持續(xù)輸出一段時(shí)間不加延時(shí)你會(huì)看到同一個(gè)手勢(shì)刷屏。如果串口一直輸出 0先量 SDA/SCL 有沒(méi)有上拉電阻很多裸模組不帶需要外接 4.7k 上拉。3.2 基于 STM32 HAL 庫(kù)的接入要點(diǎn)STM32 平臺(tái)上I2C 讀寫要用 HAL 庫(kù)的HAL_I2C_Mem_Read和HAL_I2C_Mem_Write。和 Arduino 的區(qū)別在于地址要左移一位HAL 庫(kù)用的是 8 位地址形式。#define PAJ7620_ADDR_8BIT (0x73 1) void paj7620_write_reg(uint8_t reg, uint8_t val) { HAL_I2C_Mem_Write(hi2c1, PAJ7620_ADDR_8BIT, reg, I2C_MEMADD_SIZE_8BIT, val, 1, 100); } uint8_t paj7620_read_reg(uint8_t reg) { uint8_t val 0; HAL_I2C_Mem_Read(hi2c1, PAJ7620_ADDR_8BIT, reg, I2C_MEMADD_SIZE_8BIT, val, 1, 100); return val; }邏輯說(shuō)明PAJ7620_ADDR_8BIT是 7 位地址左移一位的結(jié)果HAL 庫(kù)要求這種形式。I2C_MEMADD_SIZE_8BIT表示寄存器地址是 8 位。超時(shí)參數(shù) 100ms 在低速 I2C 下夠用如果總線被拉死這個(gè)值會(huì)直接返回錯(cuò)誤方便你定位。注意 STM32 的 I2C 在某些系列上有已知的時(shí)序問(wèn)題如果讀數(shù)據(jù)不穩(wěn)定可以先把 I2C 速率降到 100kHz 以下試試。4. 避坑與排查手勢(shì)讀不出來(lái)、亂跳、重復(fù)觸發(fā)怎么查這一章是我自己踩過(guò)的坑按現(xiàn)象、原因、解決三段寫。你遇到問(wèn)題的時(shí)候可以按順序?qū)φ沾蟾怕誓苁∠虏簧贂r(shí)間。4.1 現(xiàn)象上電后讀到的全是 0 或者 0xFF原因通常是三類I2C 地址不對(duì)、初始化序列沒(méi)寫完整、bank 沒(méi)切對(duì)。PAJ7620 的 7 位地址常見(jiàn)是 0x73但有些模組出廠時(shí)改了地址需要用 I2C 掃描確認(rèn)。初始化序列如果漏了 bank 切換那兩條后面寫的配置全落在錯(cuò)誤的 bank 里等于沒(méi)配。解決方法是先用掃描程序確認(rèn)地址再逐條核對(duì)初始化表重點(diǎn)看0xEF那兩條有沒(méi)有寫。4.2 現(xiàn)象手勢(shì)能讀出來(lái)但方向經(jīng)常反原因多半是傳感器安裝方向和你代碼里的判斷邏輯不一致。PAJ7620 的手勢(shì)方向是相對(duì)傳感器自身坐標(biāo)系的如果你把模組旋轉(zhuǎn)了 90 度裝到面板上讀出來(lái)的“上”在用戶看來(lái)可能是“左”。解決辦法是在解析函數(shù)里加一層方向映射或者在結(jié)構(gòu)裝配時(shí)就把模組方向固定好。我一般會(huì)在代碼里留一個(gè)#define SENSOR_ROTATION宏方便后期調(diào)整。4.3 現(xiàn)象同一個(gè)手勢(shì)連續(xù)觸發(fā)很多次原因是手勢(shì)結(jié)果寄存器在一次手勢(shì)期間會(huì)保持置位你的輪詢頻率又高于手勢(shì)持續(xù)時(shí)間。解決方法是加去抖讀到手勢(shì)后記錄時(shí)間戳在 200ms 到 500ms 內(nèi)忽略重復(fù)值。另一種做法是讀完后手動(dòng)清一下0x43和0x44但有些固件版本不支持手動(dòng)清還是軟件去抖更穩(wěn)。4.4 現(xiàn)象手勢(shì)識(shí)別距離很短手要貼得很近原因是紅外 LED 驅(qū)動(dòng)電流設(shè)小了或者環(huán)境光太強(qiáng)。PAJ7620 的檢測(cè)距離和 LED 電流、環(huán)境紅外噪聲都有關(guān)。可以先檢查初始化表里 LED 驅(qū)動(dòng)相關(guān)的寄存器值適當(dāng)調(diào)大。如果是在陽(yáng)光直射或者白熾燈下紅外干擾會(huì)明顯縮短檢測(cè)距離這種場(chǎng)景下建議加遮光罩或者換用帶調(diào)制功能的模組。4.5 現(xiàn)象I2C 通信偶爾卡死程序跑飛原因是 I2C 總線被從機(jī)拉低主控沒(méi)有超時(shí)機(jī)制。PAJ7620 在供電不穩(wěn)或者熱插拔時(shí)可能出現(xiàn)這種狀態(tài)。解決辦法是在 I2C 讀寫函數(shù)里加超時(shí)返回不要用死等。另外SDA/SCL 的上拉電阻不能省很多開發(fā)板自帶上拉但外接模組時(shí)線一長(zhǎng)就容易出問(wèn)題。我一般會(huì)在總線卡死后加一個(gè) GPIO 模擬時(shí)鐘脈沖的恢復(fù)流程把從機(jī)狀態(tài)踢出來(lái)。5. 把 PAJ7620 接進(jìn)真實(shí)交互邏輯從讀到手勢(shì)到做出反應(yīng)手勢(shì)讀出來(lái)只是第一步真正決定體驗(yàn)的是你怎么用它。這一章講幾個(gè)進(jìn)階用法和驗(yàn)證方法都是我在實(shí)際裝置里用過(guò)的。5.1 手勢(shì)組合與狀態(tài)機(jī)設(shè)計(jì)單個(gè)手勢(shì)能做的事有限把上下左右和接近遠(yuǎn)離組合起來(lái)可以做出層級(jí)操作。比如“接近”喚醒設(shè)備“左右”切換選項(xiàng)“上下”調(diào)參數(shù)“遠(yuǎn)離”休眠。實(shí)現(xiàn)上用一個(gè)簡(jiǎn)單狀態(tài)機(jī)把手勢(shì)事件映射成狀態(tài)遷移。下面是一個(gè)狀態(tài)機(jī)的骨架typedef enum { STATE_IDLE, STATE_ACTIVE, STATE_ADJUST, } ui_state_t; ui_state_t state STATE_IDLE; void handle_gesture(gesture_t g) { switch (state) { case STATE_IDLE: if (g GESTURE_NEAR) state STATE_ACTIVE; break; case STATE_ACTIVE: if (g GESTURE_LEFT) ui_prev(); if (g GESTURE_RIGHT) ui_next(); if (g GESTURE_UP) state STATE_ADJUST; if (g GESTURE_FAR) state STATE_IDLE; break; case STATE_ADJUST: if (g GESTURE_UP) ui_inc(); if (g GESTURE_DOWN) ui_dec(); if (g GESTURE_FAR) state STATE_ACTIVE; break; } }邏輯說(shuō)明狀態(tài)機(jī)把連續(xù)手勢(shì)變成有上下文的操作避免誤觸發(fā)直接改參數(shù)。參數(shù)上狀態(tài)遷移條件可以根據(jù)你的交互習(xí)慣調(diào)整關(guān)鍵是每個(gè)狀態(tài)只響應(yīng)它關(guān)心的手勢(shì)其他手勢(shì)忽略。這樣即使用戶手揮得快也不會(huì)把界面搞亂。5.2 用串口日志驗(yàn)證手勢(shì)穩(wěn)定性調(diào)手勢(shì)的時(shí)候最有效的驗(yàn)證手段是打日志。把每次讀到的手勢(shì)值、時(shí)間戳、當(dāng)前狀態(tài)一起打到串口連續(xù)觀察幾分鐘你就能看出哪些手勢(shì)誤觸發(fā)率高、哪些方向容易混。我一般會(huì)加一個(gè)統(tǒng)計(jì)計(jì)數(shù)每 100 次手勢(shì)打印一次各手勢(shì)的觸發(fā)次數(shù)這樣調(diào)閾值的時(shí)候有數(shù)據(jù)可依不是靠感覺(jué)。5.3 靈敏度與響應(yīng)速度的取舍PAJ7620 的寄存器里可以調(diào)檢測(cè)閾值和響應(yīng)速度但這兩個(gè)是矛盾的閾值調(diào)低靈敏度高誤觸發(fā)多閾值調(diào)高穩(wěn)定但手要揮得更用力。我的習(xí)慣是先按默認(rèn)值跑記錄誤觸發(fā)和漏觸發(fā)的情況再針對(duì)性微調(diào)。如果誤觸發(fā)集中在某個(gè)方向優(yōu)先調(diào)那個(gè)方向?qū)?yīng)的閾值位不要全局改。響應(yīng)速度上輪詢周期建議在 20ms 到 50ms 之間太快了浪費(fèi) CPU太慢了丟手勢(shì)。5.4 一個(gè)具體技巧用“接近”做喚醒用“遠(yuǎn)離”做休眠這是我用得最多的組合。設(shè)備平時(shí)休眠手靠近時(shí) PAJ7620 輸出接近手勢(shì)主控被中斷喚醒進(jìn)入工作狀態(tài)手離開后一段時(shí)間沒(méi)有手勢(shì)自動(dòng)回到休眠。實(shí)現(xiàn)上接近和遠(yuǎn)離手勢(shì)的誤觸發(fā)率相對(duì)低適合做狀態(tài)切換。注意休眠前要把手勢(shì)結(jié)果寄存器清一次防止殘留值在喚醒瞬間被誤讀。這個(gè)技巧在電池供電的裝置上尤其有用能明顯降低待機(jī)功耗。我自己調(diào) PAJ7620 最大的教訓(xùn)是不要相信第一次讀出來(lái)的數(shù)據(jù)一定要用日志跑夠時(shí)間再下結(jié)論。初始化序列、上拉電阻、去抖時(shí)間這三樣任何一個(gè)沒(méi)弄對(duì)后面所有邏輯都是白搭。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取