也能跳舞？用定時(shí)器+PWM+狀態(tài)機(jī)實(shí)現(xiàn)LED、OLED與舵機(jī)協(xié)同動(dòng)畫)
剛看到“月薪喵到底怎么在單片機(jī)上跳起來舞的”這個(gè)問題時(shí)我一度以為是某個(gè)工科學(xué)生的整活文案。但把這句話翻譯成技術(shù)語言它其實(shí)問的是單片機(jī)這種資源極度受限的設(shè)備怎么在有限時(shí)間內(nèi)完成多個(gè)外設(shè)的節(jié)奏協(xié)同輸出“跳舞”不是一個(gè)單一動(dòng)作它至少包含三層含義LED按節(jié)奏閃爍是“光之舞”O(jiān)LED屏幕上一幀一幀地切換人物動(dòng)作是“動(dòng)畫之舞”舵機(jī)帶動(dòng)機(jī)械結(jié)構(gòu)在固定節(jié)拍里擺動(dòng)是“機(jī)械之舞”。這三層背后分別對(duì)應(yīng)定時(shí)器、幀刷新和PWM控制而這些恰好是單片機(jī)開發(fā)里最常用的幾塊核心技能。這篇文章用STM32F103C8T6最小系統(tǒng)板作為主控帶著你從點(diǎn)亮一顆LED開始一路做到OLED的逐幀動(dòng)畫和舵機(jī)動(dòng)作序列最后再討論怎么用前后臺(tái)任務(wù)結(jié)構(gòu)讓它們“一起跳”。讀完你會(huì)得到一套可以直接遷移的方案也能理解為什么很多看起來復(fù)雜的單片機(jī)項(xiàng)目本質(zhì)都是“定時(shí)器 狀態(tài)機(jī) 外設(shè)驅(qū)動(dòng)”的組合。1. 為什么“單片機(jī)跳舞”這件事值得單獨(dú)寫一篇在很多初學(xué)者眼里單片機(jī)做的事情無非是“點(diǎn)燈”“按鍵”“讀傳感器”好像和“跳舞”這種詞完全不搭界。但等你真正接過一個(gè)帶屏、帶電機(jī)、帶多路傳感器的項(xiàng)目之后會(huì)發(fā)現(xiàn)最難的不是某個(gè)外設(shè)單獨(dú)怎么驅(qū)動(dòng)而是怎么讓好幾個(gè)外設(shè)在同一個(gè)時(shí)間軸上協(xié)調(diào)工作。比如你做了一個(gè)智能小車想讓它在避障的同時(shí)OLED上顯示速度信息還要根據(jù)轉(zhuǎn)向撥動(dòng)舵機(jī)。如果每個(gè)功能都寫成獨(dú)立的延時(shí)阻塞循環(huán)系統(tǒng)就會(huì)變成轉(zhuǎn)向的時(shí)候屏幕不刷新屏幕刷新的時(shí)候按鍵不響應(yīng)所有事情都“做完一件再做下一件”看起來像卡頓的PPT?！疤琛钡谋举|(zhì)就是把這種阻塞式的寫法改成時(shí)間片驅(qū)動(dòng)的寫法。LED什么時(shí)候亮、OLED第幾毫秒切換到下一幀、舵機(jī)什么時(shí)候轉(zhuǎn)到一個(gè)角度全部由定時(shí)器或者主循環(huán)里的節(jié)拍來管理。外設(shè)之間不再互相搶CPU而是各自按照自己的時(shí)間表運(yùn)行。所以這篇文章表面在講“跳舞”實(shí)際要解決的是一個(gè)工程問題在資源有限的單片機(jī)上如何設(shè)計(jì)出流暢、可維護(hù)的多任務(wù)動(dòng)畫效果。這個(gè)能力從小項(xiàng)目到大項(xiàng)目都會(huì)用到。2. 跳舞之前必須理解的核心概念在動(dòng)手寫代碼之前先把幾個(gè)容易混淆的概念理清楚。這些概念在熱搜詞里反復(fù)出現(xiàn)比如“單片機(jī)如何實(shí)現(xiàn)同時(shí)運(yùn)行多個(gè)任務(wù)調(diào)度機(jī)制”“定時(shí)器”“PWM”“捕獲”說明它們是很多開發(fā)者共同卡住的地方。2.1 定時(shí)器單片機(jī)的節(jié)拍器定時(shí)器是單片機(jī)內(nèi)部的一個(gè)硬件計(jì)數(shù)器。你可以設(shè)置它每計(jì)數(shù)到某個(gè)值就產(chǎn)生一次中斷或者翻轉(zhuǎn)一個(gè)引腳整個(gè)過程不占用CPU的軟件循環(huán)。初學(xué)者最容易犯的錯(cuò)是用delay()這類軟件延時(shí)來做節(jié)奏控制while (1) { HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); HAL_Delay(500); // 這500ms內(nèi)CPU什么都干不了 }這個(gè)方式在只控制一個(gè)LED時(shí)沒問題一旦塞入OLED刷新、舵機(jī)控制、按鍵掃描所有功能都會(huì)被延時(shí)卡住。正確做法是用定時(shí)器產(chǎn)生一個(gè)10ms或者1ms的“心跳”主循環(huán)每檢測(cè)到一個(gè)節(jié)拍就推進(jìn)一件事。這個(gè)節(jié)奏就是整個(gè)系統(tǒng)“跳舞”的底拍。2.2 PWM控制舵機(jī)和LED亮度的關(guān)鍵PWM脈沖寬度調(diào)制的本質(zhì)是在固定周期內(nèi)通過改變高電平占空比來改變有效輸出。控制LED亮度時(shí)占空比越大越亮控制舵機(jī)時(shí)占空比決定舵機(jī)轉(zhuǎn)角。很多人第一次看舵機(jī)資料會(huì)蒙圈因?yàn)閷?duì)于SG90這種常見的9g舵機(jī)它不是靠數(shù)字量“0”或“1”控制而是靠一個(gè)周期為20ms對(duì)應(yīng)50Hz頻率的PWM信號(hào)。在這個(gè)20ms周期內(nèi)高電平時(shí)間從0.5ms到2.5ms對(duì)應(yīng)舵機(jī)從0度轉(zhuǎn)到180度。這一塊是“機(jī)械之舞”的底層原理。沒有PWM舵機(jī)只能停在某一個(gè)固定角度不可能按節(jié)奏連續(xù)擺動(dòng)。2.3 OLED與幀動(dòng)畫先畫完一頁再快速翻頁OLED屏尤其是I2C接口的SSD1306這種128x64分辨率屏幕內(nèi)部有一塊顯示數(shù)據(jù)RAM。你在單片機(jī)里把像素點(diǎn)寫入這塊RAM屏幕就會(huì)點(diǎn)亮對(duì)應(yīng)的點(diǎn)?！皠?dòng)畫”的原理和紙質(zhì)動(dòng)畫一樣準(zhǔn)備好好幾幀畫面每幀之間間隔幾十毫秒連續(xù)切換人眼就會(huì)覺得畫面在動(dòng)。單片機(jī)端需要做的一是準(zhǔn)備幀數(shù)據(jù)二是在固定時(shí)間間隔內(nèi)把幀數(shù)據(jù)寫到OLED的RAM里。由于OLED是通過I2C寫入速度相對(duì)SPI要慢一些所以幀率不能太高一般10到20幀每秒已經(jīng)夠用。你要做的是在“更新時(shí)間間隔”這段時(shí)間里盡量把一幀完整寫完。2.4 前后臺(tái)任務(wù)調(diào)度讓多個(gè)“舞者”各跳各的“前后臺(tái)”是最容易理解的多任務(wù)結(jié)構(gòu)前臺(tái)定時(shí)器中斷負(fù)責(zé)產(chǎn)生系統(tǒng)心跳以及處理對(duì)時(shí)間敏感的操作后臺(tái)主循環(huán)負(fù)責(zé)處理LED刷新、OLED翻幀、舵機(jī)角度推進(jìn)等非緊急任務(wù)。這種結(jié)構(gòu)和操作系統(tǒng)的區(qū)別在于沒有任務(wù)切換、沒有信號(hào)量但勝在簡(jiǎn)單、可控、不依賴額外代碼。一個(gè)幾百行的C文件就能撐起一個(gè)多外設(shè)Demo。具體實(shí)現(xiàn)時(shí)可以定義一個(gè)全局變量sys_tick在定時(shí)器中斷里每1ms加一。主循環(huán)里不斷讀取它再根據(jù)各個(gè)任務(wù)的周期決定是否執(zhí)行if (sys_tick - led_last_tick 200) { led_last_tick sys_tick; HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); } if (sys_tick - oled_last_tick 100) { oled_last_tick sys_tick; oled_next_frame(); }這種寫法看似簡(jiǎn)單卻是單片機(jī)項(xiàng)目的基本功。很多看起來上了RTOS的項(xiàng)目核心思想也仍然是“定時(shí)觸發(fā) 任務(wù)分時(shí)”。3. 硬件準(zhǔn)備與開發(fā)環(huán)境為了讓代碼能直接跑通我把主控固定在STM32F103C8T6上。如果你手里只有51單片機(jī)思路同樣適用只需要把HAL庫API換成51的寄存器操作。3.1 硬件清單硬件型號(hào)/規(guī)格用途主控板STM32F103C8T6 最小系統(tǒng)板運(yùn)行代碼輸出控制信號(hào)下載器ST-Link V2 或 USB轉(zhuǎn)TTL燒錄程序LED任意顏色串聯(lián)220Ω電阻演示流水燈和呼吸燈OLED屏0.96寸I2C接口SSD1306顯示逐幀動(dòng)畫舵機(jī)SG90 9g執(zhí)行機(jī)械動(dòng)作面包板與杜邦線若干接線和供電按鍵輕觸按鍵切換跳舞模式可選3.2 軟件環(huán)境我使用Keil MDK 5 STM32CubeMX。版本以你本機(jī)安裝的為準(zhǔn)重點(diǎn)是會(huì)用CubeMX生成初始化代碼然后在用戶代碼區(qū)里添加邏輯。需要配置的外設(shè)一個(gè)通用定時(shí)器作為系統(tǒng)心跳本文用TIM21ms中斷一個(gè)定時(shí)器輸出PWM給舵機(jī)本文用TIM3的通道1一個(gè)定時(shí)器輸出PWM給LED呼吸燈本文用TIM2的通道1也可以直接用上面的TIM2同一通道復(fù)用但為了清晰起見單獨(dú)配置更穩(wěn)妥I2C1用于OLED通信若干GPIO輸出連接LED和按鍵輸入。3.3 接線表外設(shè)STM32引腳備注LED正極串聯(lián)電阻PA5輸出高電平點(diǎn)亮OLED SCLPB6I2C1時(shí)鐘OLED SDAPB7I2C1數(shù)據(jù)SG90信號(hào)線PA6TIM3_CH1SG90電源線5V獨(dú)立供電見第9節(jié)SG90地線GND與單片機(jī)共地4. 第一支舞LED節(jié)奏燈與呼吸燈LED是最容易看到效果的外設(shè)也最適合用來理解定時(shí)器和PWM。4.1 用定時(shí)器心跳實(shí)現(xiàn)流水燈在CubeMX里把TIM2設(shè)置為1kHz計(jì)數(shù)頻率并開啟更新中斷。這樣每1ms進(jìn)入一次中斷在中斷里遞增一個(gè)sys_tick變量。主循環(huán)里的代碼如下假設(shè)有4顆LED分別接在PA0到PA3// 文件路徑Core/Src/main.c void led_update(uint32_t tick) { static uint32_t led_last_tick 0; static uint8_t led_index 0; if (tick - led_last_tick 200) { led_last_tick tick; // 先全部熄滅 HAL_GPIO_WritePin(LED0_GPIO_Port, LED0_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(LED2_GPIO_Port, LED2_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(LED3_GPIO_Port, LED3_Pin, GPIO_PIN_RESET); // 點(diǎn)亮當(dāng)前這一顆 switch (led_index) { case 0: HAL_GPIO_WritePin(LED0_GPIO_Port, LED0_Pin, GPIO_PIN_SET); break; case 1: HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, GPIO_PIN_SET); break; case 2: HAL_GPIO_WritePin(LED2_GPIO_Port, LED2_Pin, GPIO_PIN_SET); break; case 3: HAL_GPIO_WritePin(LED3_GPIO_Port, LED3_Pin, GPIO_PIN_SET); break; } led_index (led_index 1) % 4; } }這個(gè)函數(shù)放在主循環(huán)里調(diào)用。因?yàn)閟ys_tick是全局變量主循環(huán)每次執(zhí)行l(wèi)ed_update(sys_tick)時(shí)函數(shù)會(huì)檢查距離上一次動(dòng)作是否已經(jīng)過去200ms。如果還沒到直接返回不阻塞其他任務(wù)。這就是“非阻塞延時(shí)”的基本思路。4.2 用PWM實(shí)現(xiàn)呼吸燈呼吸燈的效果是LED從最暗慢慢變亮再慢慢變暗。如果用數(shù)字IO直接輸出高低電平只能靠快速翻轉(zhuǎn)模擬漸變效果不自然還占用CPU。用硬件PWM更合適。假設(shè)TIM2通道1輸出PWM頻率設(shè)為1kHz占空比從0逐步增加到100再?gòu)?00逐步減少到0。每隔10ms改變一次占空比// 文件路徑Core/Src/main.c void breath_led_update(uint32_t tick) { static uint32_t breath_last_tick 0; static uint16_t pwm_value 0; static int8_t pwm_dir 1; if (tick - breath_last_tick 10) { breath_last_tick tick; __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, pwm_value); pwm_value pwm_dir; if (pwm_value 1000) { pwm_dir -1; } else if (pwm_value 0) { pwm_dir 1; } } }__HAL_TIM_SET_COMPARE是修改定時(shí)器比較值的宏比較值的大小決定占空比這里PWM周期對(duì)應(yīng)的ARR是1000所以pwm_value在0到1000之間變化。如果在實(shí)際測(cè)試中覺得呼吸變化太快或太慢調(diào)整兩個(gè)地方一是pwm_value pwm_dir的步長(zhǎng)二是10ms的判斷周期。這個(gè)小節(jié)的關(guān)鍵結(jié)論定時(shí)器為L(zhǎng)ED提供了穩(wěn)定的節(jié)拍PWM讓LED具備了“漸變”的表達(dá)能力。這兩種能力疊加就是很多音樂節(jié)奏燈項(xiàng)目的技術(shù)底座。5. 第二支舞OLED小人逐幀動(dòng)畫OLED動(dòng)畫比LED要復(fù)雜一點(diǎn)因?yàn)樗壬婕帮@示緩沖區(qū)又涉及I2C數(shù)據(jù)寫入效率。5.1 SSD1306的最小驅(qū)動(dòng)思路SSD1306通過I2C接收命令和數(shù)據(jù)?？刂谱止?jié)0x00表示后續(xù)發(fā)送的是命令0x40表示后續(xù)發(fā)送的是顯示數(shù)據(jù)。以128x64分辨率的屏幕為例總共分成8頁每頁8行像素。要讓一個(gè)小人動(dòng)起來最簡(jiǎn)單的做法是準(zhǔn)備兩幀或者多幀位圖數(shù)組每一幀都是一份uint8_t frame[1024]大小的數(shù)據(jù)。由于完整的一幀數(shù)據(jù)很長(zhǎng)這里不貼全部?jī)?nèi)容只展示幀切換的核心函數(shù)。實(shí)際項(xiàng)目中你可以用圖片取模軟件生成自己的動(dòng)畫幀。// 文件路徑Core/Inc/oled_frame.h #ifndef __OLED_FRAME_H #define __OLED_FRAME_H #include stdint.h // 128x64 OLED每幀1024字節(jié) #define OLED_FRAME_SIZE 1024 extern const uint8_t frame_dance_1[OLED_FRAME_SIZE]; extern const uint8_t frame_dance_2[OLED_FRAME_SIZE]; extern const uint8_t frame_dance_3[OLED_FRAME_SIZE]; #endif幀數(shù)據(jù)定義在另一個(gè)C文件里。手寫1024字節(jié)不現(xiàn)實(shí)更推薦先用PC端繪圖工具畫出每一幀再用取模軟件輸出C數(shù)組直接復(fù)制進(jìn)工程。5.2 OLED翻幀函數(shù)使用HAL庫的I2C寫入每次寫入一小段數(shù)據(jù)例如每行128字節(jié)。由于I2C一次傳輸過長(zhǎng)容易出錯(cuò)可以按頁寫入。// 文件路徑Core/Src/oled_frame.c #include oled_frame.h #include i2c.h #define OLED_I2C_ADDR 0x78 static void OLED_Write_Cmd(uint8_t cmd) { uint8_t buffer[2]; buffer[0] 0x00; // 控制字節(jié)命令 buffer[1] cmd; HAL_I2C_Master_Transmit(hi2c1, OLED_I2C_ADDR, buffer, 2, 100); } static void OLED_Write_Data(uint8_t *data, uint16_t len) { uint8_t buffer[129]; buffer[0] 0x40; // 控制字節(jié)數(shù)據(jù) for (uint16_t i 0; i len; i) { buffer[i 1] data[i]; } HAL_I2C_Master_Transmit(hi2c1, OLED_I2C_ADDR, buffer, len 1, 100); } void OLED_Draw_Frame(const uint8_t *frame) { // 設(shè)置列地址范圍 OLED_Write_Cmd(0x21); OLED_Write_Cmd(0x00); OLED_Write_Cmd(0x7F); // 設(shè)置頁地址范圍 OLED_Write_Cmd(0x22); OLED_Write_Cmd(0x00); OLED_Write_Cmd(0x07); // 0到7頁每頁128字節(jié) for (uint8_t page 0; page 8; page) { OLED_Write_Data((uint8_t *)(frame page * 128), 128); } }上述代碼里的frame page * 128表示取當(dāng)前頁對(duì)應(yīng)的128字節(jié)數(shù)據(jù)。HAL_I2C_Master_Transmit是標(biāo)準(zhǔn)HAL庫函數(shù)只要CubeMX正確初始化了I2C這段代碼可以直接調(diào)用。5.3 讓幀動(dòng)起來在主循環(huán)中用100ms間隔切換三幀畫面// 文件路徑Core/Src/main.c void oled_dance_update(uint32_t tick) { static uint32_t oled_last_tick 0; static uint8_t frame_index 0; if (tick - oled_last_tick 100) { oled_last_tick tick; switch (frame_index) { case 0: OLED_Draw_Frame(frame_dance_1); break; case 1: OLED_Draw_Frame(frame_dance_2); break; case 2: OLED_Draw_Frame(frame_dance_3); break; } frame_index (frame_index 1) % 3; } }這樣做之后屏幕上的小人會(huì)以10幀每秒的速度循環(huán)切換動(dòng)作。因?yàn)槊繋g只有動(dòng)作位置不同視覺上看起來就像在跳舞。如果發(fā)現(xiàn)屏幕閃爍通常有兩個(gè)原因I2C寫入速度太慢導(dǎo)致一幀沒畫完就到了下一次切換幀數(shù)據(jù)本身沒有做“雙緩沖”處理邊寫邊顯示。對(duì)于I2C屏幕升級(jí)到SPI接口屏幕可以顯著提升刷新速度。如果只能用I2C可以縮短單頁寫入的數(shù)據(jù)長(zhǎng)度或者降低幀率到8幀每秒左右。6. 第三支舞舵機(jī)機(jī)械臂的舞蹈動(dòng)作舵機(jī)是“機(jī)械之舞”最直接的執(zhí)行者。SG90比較便宜適合用來練手但它的力量和精度都很有限多個(gè)舵機(jī)同時(shí)帶載時(shí)需要額外注意供電。6.1 SG90的角度控制原理SG90的可控角度范圍一般是0度到180度對(duì)應(yīng)PWM脈寬角度脈寬占空比20ms周期0度0.5ms2.5%45度0.75ms3.75%90度1.5ms7.5%135度1.75ms8.75%180度2.5ms12.5%不同品牌的舵機(jī)在邊界值上略有差異實(shí)際調(diào)試時(shí)可以從0.5ms和2.5ms這兩個(gè)脈寬開始先確認(rèn)轉(zhuǎn)動(dòng)范圍避免舵機(jī)堵轉(zhuǎn)。6.2 用TIM3輸出50Hz PWM在CubeMX中配置TIM3通道1輸出PWM。假設(shè)系統(tǒng)主頻72MHz預(yù)分頻PSC設(shè)為71計(jì)數(shù)值A(chǔ)RR設(shè)為19999則PWM頻率為頻率 72MHz / (71 1) / (19999 1) 50Hz 周期 20ms這個(gè)頻率正好符合SG90的輸入要求。6.3 動(dòng)作序列與實(shí)現(xiàn)把“跳舞”拆成一組角度序列例如// 文件路徑Core/Src/servo_dance.c #include tim.h // 每個(gè)動(dòng)作包含目標(biāo)角度對(duì)應(yīng)的比較值 // 計(jì)算方式比較值 (脈寬 / 20ms) * 20000 typedef struct { uint16_t compare_value; uint16_t hold_time_ms; } ServoAction; const ServoAction dance_actions[] { { 500, 300 }, // 0度保持300ms { 1500, 300 }, // 90度 { 2000, 300 }, // 約135度 { 750, 300 }, // 約45度 { 1250, 200 }, // 約67.5度 { 2000, 200 }, // 約135度 { 500, 400 }, // 復(fù)位到0度 }; #define ACTION_COUNT (sizeof(dance_actions) / sizeof(dance_actions[0])) void servo_dance_update(uint32_t tick) { static uint32_t action_last_tick 0; static uint16_t action_index 0; if (tick - action_last_tick dance_actions[action_index].hold_time_ms) { action_last_tick tick; __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, dance_actions[action_index].compare_value); action_index (action_index 1) % ACTION_COUNT; } }這里把原本多個(gè)HAL_Delay串起來的動(dòng)作序列改成了“按時(shí)間切換角度”的狀態(tài)推進(jìn)邏輯。主循環(huán)只需反復(fù)調(diào)用servo_dance_update(sys_tick)舵機(jī)就會(huì)自動(dòng)按照dance_actions數(shù)組里的順序一段一段地執(zhí)行動(dòng)作。如果想讓舵機(jī)動(dòng)起來更像“跳舞”而不是僵硬地跳變角度可以加入插值。例如每20ms讓角度遞增或者遞減一個(gè)固定步長(zhǎng)從當(dāng)前脈寬平滑過渡到目標(biāo)脈寬。這樣動(dòng)作會(huì)柔和很多也更接近人在跳舞時(shí)連續(xù)運(yùn)動(dòng)的效果。7. 讓三支舞一起跳多任務(wù)與節(jié)奏同步前面幾支舞分別實(shí)現(xiàn)了LED、OLED、舵機(jī)的獨(dú)立控制?，F(xiàn)在把它們放進(jìn)同一個(gè)主循環(huán)看看怎么協(xié)調(diào)。7.1 完整的前后臺(tái)主循環(huán)把之前的函數(shù)統(tǒng)一放在main的while (1)里調(diào)用// 文件路徑Core/Src/main.c int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); MX_TIM2_Init(); MX_TIM3_Init(); HAL_TIM_Base_Start_IT(htim2); HAL_TIM_PWM_Start(htim2, TIM_CHANNEL_1); HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); uint32_t last_tick 0; while (1) { uint32_t now HAL_GetTick(); led_update(now); breath_led_update(now); oled_dance_update(now); servo_dance_update(now); // 簡(jiǎn)單模式切換按鍵按下時(shí)切換動(dòng)作節(jié)奏 if (HAL_GPIO_ReadPin(BTN_GPIO_Port, BTN_Pin) GPIO_PIN_RESET) { last_tick now; } // 防止主循環(huán)跑飛讓CPU稍微休息 // 注意不能在這里加長(zhǎng)延時(shí)否則會(huì)阻塞舵機(jī)動(dòng)作 } }這里有幾個(gè)關(guān)鍵點(diǎn)所有xxx_update函數(shù)都不包含阻塞延時(shí)只根據(jù)tick判斷是否需要執(zhí)行循環(huán)的執(zhí)行頻率遠(yuǎn)高于每個(gè)動(dòng)作的更新頻率所以多個(gè)任務(wù)看起來是“同時(shí)”在運(yùn)行HAL_GetTick()是HAL庫自帶的1ms系統(tǒng)節(jié)拍可以直接當(dāng)sys_tick使用用CubeMX生成的工程默認(rèn)已經(jīng)啟動(dòng)了SysTick所以不需要額外寫定時(shí)器中斷來維護(hù)sys_tick除非你想用獨(dú)立定時(shí)器。7.2 常見節(jié)奏同步問題如果LED、OLED和舵機(jī)各自為政觀感上會(huì)顯得“各跳各的”。同步節(jié)奏最簡(jiǎn)單的方法是讓所有動(dòng)作的起始點(diǎn)都對(duì)準(zhǔn)某個(gè)全局節(jié)拍例如統(tǒng)一在now % 1000 100時(shí)觸發(fā)一個(gè)“Reset”信號(hào)讓三路動(dòng)作同時(shí)回到起始位置。更復(fù)雜的方法是用狀態(tài)機(jī)把整套舞蹈拆成幾個(gè)階段階段1LED慢閃舵機(jī)擺動(dòng)OLED顯示第一組動(dòng)作階段2LED快閃舵機(jī)停下OLED顯示第二組動(dòng)作階段3全部停止OLED顯示結(jié)束畫面。每個(gè)階段有一個(gè)持續(xù)時(shí)間到了時(shí)間就切換到下一個(gè)階段。這樣整個(gè)系統(tǒng)就有了一個(gè)共同的“編排表”而不是各跑各的。8. 運(yùn)行驗(yàn)證與常見問題排查寫完代碼后編譯燒錄通電觀察現(xiàn)象。如果一切正常你應(yīng)該看到LED按200ms或300ms間隔流水點(diǎn)亮呼吸燈以約1秒為周期漸亮漸滅OLED屏幕上每隔100ms切換一幀小人的動(dòng)作連續(xù)舵機(jī)按動(dòng)作序列往復(fù)擺動(dòng)方向明確。如果你看到的不是這個(gè)現(xiàn)象可以按下面的順序排查。8.1 先看最小系統(tǒng)是否正常第一步確認(rèn)下載和供電正常。用ST-Link燒錄一個(gè)最簡(jiǎn)單的LED閃爍程序如果LED都不亮優(yōu)先查ST-Link和主板連接是否牢固供電電壓是否是3.3V或5V接線是否短路CubeMX生成的引腳配置和實(shí)際接線是否一致。8.2 再分別隔離每個(gè)外設(shè)不要一上來就同時(shí)調(diào)試三個(gè)外設(shè)。把OLED和舵機(jī)的代碼先注釋掉只保留LED流水燈。確認(rèn)LED正常后再單獨(dú)調(diào)OLED再單獨(dú)調(diào)舵機(jī)。這樣做的好處是能快速定位問題是外設(shè)本身還是多任務(wù)協(xié)調(diào)。8.3 常見問題表問題現(xiàn)象可能原因排查方式解決方案LED亮度很低或基本不亮GPIO配置為開漏輸出或者沒有串聯(lián)限流電阻用萬用表測(cè)量引腳電壓在CubeMX中把LED引腳配置為推挽輸出并串聯(lián)220Ω電阻呼吸燈沒有漸變效果PWM通道沒有開啟查看代碼是否調(diào)用了HAL_TIM_PWM_Start在初始化中啟動(dòng)對(duì)應(yīng)通道OLED顯示亂碼或白屏I2C地址錯(cuò)誤或幀數(shù)據(jù)格式不對(duì)檢查屏幕背面的地址選擇電阻常見為0x78或0x7A使用I2C掃描程序讀取實(shí)際地址OLED畫面閃爍嚴(yán)重I2C寫入速度太慢或者幀率過高在翻幀函數(shù)里加入計(jì)時(shí)統(tǒng)計(jì)單幀耗時(shí)降低幀率到8-10幀或升級(jí)為SPI接口屏幕舵機(jī)不轉(zhuǎn)PWM頻率不對(duì)或信號(hào)線接錯(cuò)用邏輯分析儀測(cè)PWM波形確認(rèn)PSC和ARR設(shè)置得到50Hz檢查信號(hào)引腳舵機(jī)抖動(dòng)、發(fā)熱供電電流不足用手觸摸舵機(jī)電機(jī)和電源穩(wěn)壓芯片的溫度給舵機(jī)單獨(dú)提供5V供電不要和單片機(jī)共用同一個(gè)LDO多個(gè)任務(wù)一起跑后卡頓某個(gè)驅(qū)動(dòng)中含有阻塞延時(shí)搜索代碼里的HAL_Delay把延時(shí)改成基于全局tick的狀態(tài)判斷按鍵切換模式無響應(yīng)按鍵沒有使用內(nèi)部上拉引腳配置錯(cuò)誤用萬用表測(cè)量按鍵按下后的電平變化在CubeMX中把按鍵輸入配置為上拉輸入9. 從Demo到工程項(xiàng)目最佳實(shí)踐與工程建議到這里“三支舞”已經(jīng)全部能跑了。但如果只是停留在“能閃、能動(dòng)、能顯示”的程度距離一個(gè)規(guī)范的嵌入式項(xiàng)目還很遠(yuǎn)。下面幾條建議能幫你把這套代碼升級(jí)成工程級(jí)的寫法。9.1 把每個(gè)外設(shè)封裝成獨(dú)立模塊不要把所有代碼堆在main.c里。隨著項(xiàng)目變大main.c會(huì)變成幾百行甚至上千行的“大泥球”。建議的目錄結(jié)構(gòu)Core/ Inc/ led_driver.h oled_driver.h servo_driver.h app_dance.h Src/ main.c led_driver.c oled_driver.c servo_driver.c app_dance.c每個(gè)驅(qū)動(dòng)文件負(fù)責(zé)一類外設(shè)的初始化和基本操作app_dance.c負(fù)責(zé)編排邏輯。未來如果從“跳舞”改成“顯示傳感器數(shù)據(jù)”只需要更換app_dance.c驅(qū)動(dòng)層不用動(dòng)。9.2 狀態(tài)機(jī)代替“一長(zhǎng)串延時(shí)”很多人寫動(dòng)作順序時(shí)習(xí)慣這樣寫HAL_Delay(500); servo_set(0); HAL_Delay(500); servo_set(90);這在寫死流程時(shí)很直觀但一旦需要響應(yīng)按鍵、處理異常這種寫法就非常不便。推薦改用動(dòng)作序列數(shù)組加狀態(tài)索引的方式就像前面dance_actions那樣。修改動(dòng)作順序時(shí)只用改動(dòng)數(shù)組里的數(shù)值不用重寫整個(gè)控制邏輯。9.3 注意舵機(jī)和電機(jī)供電SG90雖然是小舵機(jī)但它堵轉(zhuǎn)時(shí)的電流可能接近幾百毫安甚至更大。如果和單片機(jī)共用同一個(gè)USB供電或者同一個(gè)LDO很容易導(dǎo)致電壓跌落進(jìn)而引起單片機(jī)重啟或者舵機(jī)亂抖。實(shí)操上推薦舵機(jī)單獨(dú)接5V電源比如用一塊小面包板電源模塊舵機(jī)電源地和單片機(jī)地必須連在一起如果項(xiàng)目要控制多個(gè)舵機(jī)建議加一個(gè)標(biāo)稱電流足夠的5V穩(wěn)壓模塊。9.4 善用日志和打印如果板子上有串口可以在關(guān)鍵位置加上打印printf(led tick: %lu\n, (unsigned long)now);這樣能清楚看到每個(gè)任務(wù)的推進(jìn)時(shí)間判斷是邏輯問題還是時(shí)序問題。沒有串口的板子也可以用一個(gè)空閑LED作為調(diào)試指示燈在特定事件發(fā)生時(shí)翻轉(zhuǎn)它。9.5 性能意識(shí)不要在中斷里做耗時(shí)操作定時(shí)器中斷里只做“清標(biāo)志位、更新計(jì)數(shù)器”這類輕量操作。OLED翻幀和舵機(jī)PWM更新都放在主循環(huán)里。如果一幀OLED數(shù)據(jù)要占幾十毫秒放在中斷里會(huì)直接擠占主循環(huán)導(dǎo)致其他任務(wù)饑餓。10. 總結(jié)與后續(xù)學(xué)習(xí)方向從LED呼吸燈到OLED逐幀動(dòng)畫再到舵機(jī)動(dòng)作序列再進(jìn)一步把它們裝進(jìn)同一個(gè)主循環(huán)整個(gè)過程中真正反復(fù)出現(xiàn)的技術(shù)點(diǎn)其實(shí)就三樣定時(shí)器、PWM、狀態(tài)機(jī)。把它們組合好單片機(jī)就能從一個(gè)只會(huì)點(diǎn)燈的玩具變成一個(gè)具備節(jié)奏感的小型演出系統(tǒng)。如果你已經(jīng)跟著代碼跑通了這篇文章里的Demo下一步可以按下面的方向繼續(xù)深入給系統(tǒng)引入音樂播放模塊用音頻信號(hào)或者藍(lán)牙串口控制LED亮度做真正的音樂節(jié)奏燈把OLED動(dòng)畫從手動(dòng)取模改成程序生成比如根據(jù)加速度傳感器數(shù)據(jù)實(shí)時(shí)繪制人物動(dòng)作在動(dòng)作序列里加入插值算法讓舵機(jī)運(yùn)動(dòng)更平滑減少機(jī)械沖擊當(dāng)任務(wù)數(shù)量繼續(xù)增加時(shí)了解FreeRTOS這種輕量級(jí)實(shí)時(shí)操作系統(tǒng)的任務(wù)調(diào)度和消息隊(duì)列機(jī)制。一個(gè)建議是不要急著把所有新學(xué)的東西都塞進(jìn)一個(gè)項(xiàng)目而是每次只替換其中一個(gè)模塊。比如先只把LED控制從阻塞延時(shí)改成定時(shí)器驅(qū)動(dòng)跑通后再改OLED最后再改舵機(jī)。這樣每一步都有明確的驗(yàn)證點(diǎn)出問題時(shí)也容易定位。下一次再有人問“單片機(jī)也能跳舞嗎”你就可以直接把他拉到屏幕前面點(diǎn)顆燈切幀畫面再讓舵機(jī)擺兩下——然后用這篇文章里的“定時(shí)器 狀態(tài)機(jī) 外設(shè)驅(qū)動(dòng)”這組關(guān)鍵詞告訴他這一切是怎么做到的。 單片機(jī)也能跳舞？用定時(shí)器+PWM+狀態(tài)機(jī)實(shí)現(xiàn)LED、OLED與舵機(jī)協(xié)同動(dòng)畫
剛看到“月薪喵到底怎么在單片機(jī)上跳起來舞的”這個(gè)問題時(shí)我一度以為是某個(gè)工科學(xué)生的整活文案。但把這句話翻譯成技術(shù)語言它其實(shí)問的是單片機(jī)這種資源極度受限的設(shè)備怎么在有限時(shí)間內(nèi)完成多個(gè)外設(shè)的節(jié)奏協(xié)同輸出“跳舞”不是一個(gè)單一動(dòng)作它至少包含三層含義LED按節(jié)奏閃爍是“光之舞”O(jiān)LED屏幕上一幀一幀地切換人物動(dòng)作是“動(dòng)畫之舞”舵機(jī)帶動(dòng)機(jī)械結(jié)構(gòu)在固定節(jié)拍里擺動(dòng)是“機(jī)械之舞”。這三層背后分別對(duì)應(yīng)定時(shí)器、幀刷新和PWM控制而這些恰好是單片機(jī)開發(fā)里最常用的幾塊核心技能。這篇文章用STM32F103C8T6最小系統(tǒng)板作為主控帶著你從點(diǎn)亮一顆LED開始一路做到OLED的逐幀動(dòng)畫和舵機(jī)動(dòng)作序列最后再討論怎么用前后臺(tái)任務(wù)結(jié)構(gòu)讓它們“一起跳”。讀完你會(huì)得到一套可以直接遷移的方案也能理解為什么很多看起來復(fù)雜的單片機(jī)項(xiàng)目本質(zhì)都是“定時(shí)器 狀態(tài)機(jī) 外設(shè)驅(qū)動(dòng)”的組合。1. 為什么“單片機(jī)跳舞”這件事值得單獨(dú)寫一篇在很多初學(xué)者眼里單片機(jī)做的事情無非是“點(diǎn)燈”“按鍵”“讀傳感器”好像和“跳舞”這種詞完全不搭界。但等你真正接過一個(gè)帶屏、帶電機(jī)、帶多路傳感器的項(xiàng)目之后會(huì)發(fā)現(xiàn)最難的不是某個(gè)外設(shè)單獨(dú)怎么驅(qū)動(dòng)而是怎么讓好幾個(gè)外設(shè)在同一個(gè)時(shí)間軸上協(xié)調(diào)工作。比如你做了一個(gè)智能小車想讓它在避障的同時(shí)OLED上顯示速度信息還要根據(jù)轉(zhuǎn)向撥動(dòng)舵機(jī)。如果每個(gè)功能都寫成獨(dú)立的延時(shí)阻塞循環(huán)系統(tǒng)就會(huì)變成轉(zhuǎn)向的時(shí)候屏幕不刷新屏幕刷新的時(shí)候按鍵不響應(yīng)所有事情都“做完一件再做下一件”看起來像卡頓的PPT?！疤琛钡谋举|(zhì)就是把這種阻塞式的寫法改成時(shí)間片驅(qū)動(dòng)的寫法。LED什么時(shí)候亮、OLED第幾毫秒切換到下一幀、舵機(jī)什么時(shí)候轉(zhuǎn)到一個(gè)角度全部由定時(shí)器或者主循環(huán)里的節(jié)拍來管理。外設(shè)之間不再互相搶CPU而是各自按照自己的時(shí)間表運(yùn)行。所以這篇文章表面在講“跳舞”實(shí)際要解決的是一個(gè)工程問題在資源有限的單片機(jī)上如何設(shè)計(jì)出流暢、可維護(hù)的多任務(wù)動(dòng)畫效果。這個(gè)能力從小項(xiàng)目到大項(xiàng)目都會(huì)用到。2. 跳舞之前必須理解的核心概念在動(dòng)手寫代碼之前先把幾個(gè)容易混淆的概念理清楚。這些概念在熱搜詞里反復(fù)出現(xiàn)比如“單片機(jī)如何實(shí)現(xiàn)同時(shí)運(yùn)行多個(gè)任務(wù)調(diào)度機(jī)制”“定時(shí)器”“PWM”“捕獲”說明它們是很多開發(fā)者共同卡住的地方。2.1 定時(shí)器單片機(jī)的節(jié)拍器定時(shí)器是單片機(jī)內(nèi)部的一個(gè)硬件計(jì)數(shù)器。你可以設(shè)置它每計(jì)數(shù)到某個(gè)值就產(chǎn)生一次中斷或者翻轉(zhuǎn)一個(gè)引腳整個(gè)過程不占用CPU的軟件循環(huán)。初學(xué)者最容易犯的錯(cuò)是用delay()這類軟件延時(shí)來做節(jié)奏控制while (1) { HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); HAL_Delay(500); // 這500ms內(nèi)CPU什么都干不了 }這個(gè)方式在只控制一個(gè)LED時(shí)沒問題一旦塞入OLED刷新、舵機(jī)控制、按鍵掃描所有功能都會(huì)被延時(shí)卡住。正確做法是用定時(shí)器產(chǎn)生一個(gè)10ms或者1ms的“心跳”主循環(huán)每檢測(cè)到一個(gè)節(jié)拍就推進(jìn)一件事。這個(gè)節(jié)奏就是整個(gè)系統(tǒng)“跳舞”的底拍。2.2 PWM控制舵機(jī)和LED亮度的關(guān)鍵PWM脈沖寬度調(diào)制的本質(zhì)是在固定周期內(nèi)通過改變高電平占空比來改變有效輸出。控制LED亮度時(shí)占空比越大越亮控制舵機(jī)時(shí)占空比決定舵機(jī)轉(zhuǎn)角。很多人第一次看舵機(jī)資料會(huì)蒙圈因?yàn)閷?duì)于SG90這種常見的9g舵機(jī)它不是靠數(shù)字量“0”或“1”控制而是靠一個(gè)周期為20ms對(duì)應(yīng)50Hz頻率的PWM信號(hào)。在這個(gè)20ms周期內(nèi)高電平時(shí)間從0.5ms到2.5ms對(duì)應(yīng)舵機(jī)從0度轉(zhuǎn)到180度。這一塊是“機(jī)械之舞”的底層原理。沒有PWM舵機(jī)只能停在某一個(gè)固定角度不可能按節(jié)奏連續(xù)擺動(dòng)。2.3 OLED與幀動(dòng)畫先畫完一頁再快速翻頁OLED屏尤其是I2C接口的SSD1306這種128x64分辨率屏幕內(nèi)部有一塊顯示數(shù)據(jù)RAM。你在單片機(jī)里把像素點(diǎn)寫入這塊RAM屏幕就會(huì)點(diǎn)亮對(duì)應(yīng)的點(diǎn)?！皠?dòng)畫”的原理和紙質(zhì)動(dòng)畫一樣準(zhǔn)備好好幾幀畫面每幀之間間隔幾十毫秒連續(xù)切換人眼就會(huì)覺得畫面在動(dòng)。單片機(jī)端需要做的一是準(zhǔn)備幀數(shù)據(jù)二是在固定時(shí)間間隔內(nèi)把幀數(shù)據(jù)寫到OLED的RAM里。由于OLED是通過I2C寫入速度相對(duì)SPI要慢一些所以幀率不能太高一般10到20幀每秒已經(jīng)夠用。你要做的是在“更新時(shí)間間隔”這段時(shí)間里盡量把一幀完整寫完。2.4 前后臺(tái)任務(wù)調(diào)度讓多個(gè)“舞者”各跳各的“前后臺(tái)”是最容易理解的多任務(wù)結(jié)構(gòu)前臺(tái)定時(shí)器中斷負(fù)責(zé)產(chǎn)生系統(tǒng)心跳以及處理對(duì)時(shí)間敏感的操作后臺(tái)主循環(huán)負(fù)責(zé)處理LED刷新、OLED翻幀、舵機(jī)角度推進(jìn)等非緊急任務(wù)。這種結(jié)構(gòu)和操作系統(tǒng)的區(qū)別在于沒有任務(wù)切換、沒有信號(hào)量但勝在簡(jiǎn)單、可控、不依賴額外代碼。一個(gè)幾百行的C文件就能撐起一個(gè)多外設(shè)Demo。具體實(shí)現(xiàn)時(shí)可以定義一個(gè)全局變量sys_tick在定時(shí)器中斷里每1ms加一。主循環(huán)里不斷讀取它再根據(jù)各個(gè)任務(wù)的周期決定是否執(zhí)行if (sys_tick - led_last_tick 200) { led_last_tick sys_tick; HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin); } if (sys_tick - oled_last_tick 100) { oled_last_tick sys_tick; oled_next_frame(); }這種寫法看似簡(jiǎn)單卻是單片機(jī)項(xiàng)目的基本功。很多看起來上了RTOS的項(xiàng)目核心思想也仍然是“定時(shí)觸發(fā) 任務(wù)分時(shí)”。3. 硬件準(zhǔn)備與開發(fā)環(huán)境為了讓代碼能直接跑通我把主控固定在STM32F103C8T6上。如果你手里只有51單片機(jī)思路同樣適用只需要把HAL庫API換成51的寄存器操作。3.1 硬件清單硬件型號(hào)/規(guī)格用途主控板STM32F103C8T6 最小系統(tǒng)板運(yùn)行代碼輸出控制信號(hào)下載器ST-Link V2 或 USB轉(zhuǎn)TTL燒錄程序LED任意顏色串聯(lián)220Ω電阻演示流水燈和呼吸燈OLED屏0.96寸I2C接口SSD1306顯示逐幀動(dòng)畫舵機(jī)SG90 9g執(zhí)行機(jī)械動(dòng)作面包板與杜邦線若干接線和供電按鍵輕觸按鍵切換跳舞模式可選3.2 軟件環(huán)境我使用Keil MDK 5 STM32CubeMX。版本以你本機(jī)安裝的為準(zhǔn)重點(diǎn)是會(huì)用CubeMX生成初始化代碼然后在用戶代碼區(qū)里添加邏輯。需要配置的外設(shè)一個(gè)通用定時(shí)器作為系統(tǒng)心跳本文用TIM21ms中斷一個(gè)定時(shí)器輸出PWM給舵機(jī)本文用TIM3的通道1一個(gè)定時(shí)器輸出PWM給LED呼吸燈本文用TIM2的通道1也可以直接用上面的TIM2同一通道復(fù)用但為了清晰起見單獨(dú)配置更穩(wěn)妥I2C1用于OLED通信若干GPIO輸出連接LED和按鍵輸入。3.3 接線表外設(shè)STM32引腳備注LED正極串聯(lián)電阻PA5輸出高電平點(diǎn)亮OLED SCLPB6I2C1時(shí)鐘OLED SDAPB7I2C1數(shù)據(jù)SG90信號(hào)線PA6TIM3_CH1SG90電源線5V獨(dú)立供電見第9節(jié)SG90地線GND與單片機(jī)共地4. 第一支舞LED節(jié)奏燈與呼吸燈LED是最容易看到效果的外設(shè)也最適合用來理解定時(shí)器和PWM。4.1 用定時(shí)器心跳實(shí)現(xiàn)流水燈在CubeMX里把TIM2設(shè)置為1kHz計(jì)數(shù)頻率并開啟更新中斷。這樣每1ms進(jìn)入一次中斷在中斷里遞增一個(gè)sys_tick變量。主循環(huán)里的代碼如下假設(shè)有4顆LED分別接在PA0到PA3// 文件路徑Core/Src/main.c void led_update(uint32_t tick) { static uint32_t led_last_tick 0; static uint8_t led_index 0; if (tick - led_last_tick 200) { led_last_tick tick; // 先全部熄滅 HAL_GPIO_WritePin(LED0_GPIO_Port, LED0_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(LED2_GPIO_Port, LED2_Pin, GPIO_PIN_RESET); HAL_GPIO_WritePin(LED3_GPIO_Port, LED3_Pin, GPIO_PIN_RESET); // 點(diǎn)亮當(dāng)前這一顆 switch (led_index) { case 0: HAL_GPIO_WritePin(LED0_GPIO_Port, LED0_Pin, GPIO_PIN_SET); break; case 1: HAL_GPIO_WritePin(LED1_GPIO_Port, LED1_Pin, GPIO_PIN_SET); break; case 2: HAL_GPIO_WritePin(LED2_GPIO_Port, LED2_Pin, GPIO_PIN_SET); break; case 3: HAL_GPIO_WritePin(LED3_GPIO_Port, LED3_Pin, GPIO_PIN_SET); break; } led_index (led_index 1) % 4; } }這個(gè)函數(shù)放在主循環(huán)里調(diào)用。因?yàn)閟ys_tick是全局變量主循環(huán)每次執(zhí)行l(wèi)ed_update(sys_tick)時(shí)函數(shù)會(huì)檢查距離上一次動(dòng)作是否已經(jīng)過去200ms。如果還沒到直接返回不阻塞其他任務(wù)。這就是“非阻塞延時(shí)”的基本思路。4.2 用PWM實(shí)現(xiàn)呼吸燈呼吸燈的效果是LED從最暗慢慢變亮再慢慢變暗。如果用數(shù)字IO直接輸出高低電平只能靠快速翻轉(zhuǎn)模擬漸變效果不自然還占用CPU。用硬件PWM更合適。假設(shè)TIM2通道1輸出PWM頻率設(shè)為1kHz占空比從0逐步增加到100再?gòu)?00逐步減少到0。每隔10ms改變一次占空比// 文件路徑Core/Src/main.c void breath_led_update(uint32_t tick) { static uint32_t breath_last_tick 0; static uint16_t pwm_value 0; static int8_t pwm_dir 1; if (tick - breath_last_tick 10) { breath_last_tick tick; __HAL_TIM_SET_COMPARE(htim2, TIM_CHANNEL_1, pwm_value); pwm_value pwm_dir; if (pwm_value 1000) { pwm_dir -1; } else if (pwm_value 0) { pwm_dir 1; } } }__HAL_TIM_SET_COMPARE是修改定時(shí)器比較值的宏比較值的大小決定占空比這里PWM周期對(duì)應(yīng)的ARR是1000所以pwm_value在0到1000之間變化。如果在實(shí)際測(cè)試中覺得呼吸變化太快或太慢調(diào)整兩個(gè)地方一是pwm_value pwm_dir的步長(zhǎng)二是10ms的判斷周期。這個(gè)小節(jié)的關(guān)鍵結(jié)論定時(shí)器為L(zhǎng)ED提供了穩(wěn)定的節(jié)拍PWM讓LED具備了“漸變”的表達(dá)能力。這兩種能力疊加就是很多音樂節(jié)奏燈項(xiàng)目的技術(shù)底座。5. 第二支舞OLED小人逐幀動(dòng)畫OLED動(dòng)畫比LED要復(fù)雜一點(diǎn)因?yàn)樗壬婕帮@示緩沖區(qū)又涉及I2C數(shù)據(jù)寫入效率。5.1 SSD1306的最小驅(qū)動(dòng)思路SSD1306通過I2C接收命令和數(shù)據(jù)?？刂谱止?jié)0x00表示后續(xù)發(fā)送的是命令0x40表示后續(xù)發(fā)送的是顯示數(shù)據(jù)。以128x64分辨率的屏幕為例總共分成8頁每頁8行像素。要讓一個(gè)小人動(dòng)起來最簡(jiǎn)單的做法是準(zhǔn)備兩幀或者多幀位圖數(shù)組每一幀都是一份uint8_t frame[1024]大小的數(shù)據(jù)。由于完整的一幀數(shù)據(jù)很長(zhǎng)這里不貼全部?jī)?nèi)容只展示幀切換的核心函數(shù)。實(shí)際項(xiàng)目中你可以用圖片取模軟件生成自己的動(dòng)畫幀。// 文件路徑Core/Inc/oled_frame.h #ifndef __OLED_FRAME_H #define __OLED_FRAME_H #include stdint.h // 128x64 OLED每幀1024字節(jié) #define OLED_FRAME_SIZE 1024 extern const uint8_t frame_dance_1[OLED_FRAME_SIZE]; extern const uint8_t frame_dance_2[OLED_FRAME_SIZE]; extern const uint8_t frame_dance_3[OLED_FRAME_SIZE]; #endif幀數(shù)據(jù)定義在另一個(gè)C文件里。手寫1024字節(jié)不現(xiàn)實(shí)更推薦先用PC端繪圖工具畫出每一幀再用取模軟件輸出C數(shù)組直接復(fù)制進(jìn)工程。5.2 OLED翻幀函數(shù)使用HAL庫的I2C寫入每次寫入一小段數(shù)據(jù)例如每行128字節(jié)。由于I2C一次傳輸過長(zhǎng)容易出錯(cuò)可以按頁寫入。// 文件路徑Core/Src/oled_frame.c #include oled_frame.h #include i2c.h #define OLED_I2C_ADDR 0x78 static void OLED_Write_Cmd(uint8_t cmd) { uint8_t buffer[2]; buffer[0] 0x00; // 控制字節(jié)命令 buffer[1] cmd; HAL_I2C_Master_Transmit(hi2c1, OLED_I2C_ADDR, buffer, 2, 100); } static void OLED_Write_Data(uint8_t *data, uint16_t len) { uint8_t buffer[129]; buffer[0] 0x40; // 控制字節(jié)數(shù)據(jù) for (uint16_t i 0; i len; i) { buffer[i 1] data[i]; } HAL_I2C_Master_Transmit(hi2c1, OLED_I2C_ADDR, buffer, len 1, 100); } void OLED_Draw_Frame(const uint8_t *frame) { // 設(shè)置列地址范圍 OLED_Write_Cmd(0x21); OLED_Write_Cmd(0x00); OLED_Write_Cmd(0x7F); // 設(shè)置頁地址范圍 OLED_Write_Cmd(0x22); OLED_Write_Cmd(0x00); OLED_Write_Cmd(0x07); // 0到7頁每頁128字節(jié) for (uint8_t page 0; page 8; page) { OLED_Write_Data((uint8_t *)(frame page * 128), 128); } }上述代碼里的frame page * 128表示取當(dāng)前頁對(duì)應(yīng)的128字節(jié)數(shù)據(jù)。HAL_I2C_Master_Transmit是標(biāo)準(zhǔn)HAL庫函數(shù)只要CubeMX正確初始化了I2C這段代碼可以直接調(diào)用。5.3 讓幀動(dòng)起來在主循環(huán)中用100ms間隔切換三幀畫面// 文件路徑Core/Src/main.c void oled_dance_update(uint32_t tick) { static uint32_t oled_last_tick 0; static uint8_t frame_index 0; if (tick - oled_last_tick 100) { oled_last_tick tick; switch (frame_index) { case 0: OLED_Draw_Frame(frame_dance_1); break; case 1: OLED_Draw_Frame(frame_dance_2); break; case 2: OLED_Draw_Frame(frame_dance_3); break; } frame_index (frame_index 1) % 3; } }這樣做之后屏幕上的小人會(huì)以10幀每秒的速度循環(huán)切換動(dòng)作。因?yàn)槊繋g只有動(dòng)作位置不同視覺上看起來就像在跳舞。如果發(fā)現(xiàn)屏幕閃爍通常有兩個(gè)原因I2C寫入速度太慢導(dǎo)致一幀沒畫完就到了下一次切換幀數(shù)據(jù)本身沒有做“雙緩沖”處理邊寫邊顯示。對(duì)于I2C屏幕升級(jí)到SPI接口屏幕可以顯著提升刷新速度。如果只能用I2C可以縮短單頁寫入的數(shù)據(jù)長(zhǎng)度或者降低幀率到8幀每秒左右。6. 第三支舞舵機(jī)機(jī)械臂的舞蹈動(dòng)作舵機(jī)是“機(jī)械之舞”最直接的執(zhí)行者。SG90比較便宜適合用來練手但它的力量和精度都很有限多個(gè)舵機(jī)同時(shí)帶載時(shí)需要額外注意供電。6.1 SG90的角度控制原理SG90的可控角度范圍一般是0度到180度對(duì)應(yīng)PWM脈寬角度脈寬占空比20ms周期0度0.5ms2.5%45度0.75ms3.75%90度1.5ms7.5%135度1.75ms8.75%180度2.5ms12.5%不同品牌的舵機(jī)在邊界值上略有差異實(shí)際調(diào)試時(shí)可以從0.5ms和2.5ms這兩個(gè)脈寬開始先確認(rèn)轉(zhuǎn)動(dòng)范圍避免舵機(jī)堵轉(zhuǎn)。6.2 用TIM3輸出50Hz PWM在CubeMX中配置TIM3通道1輸出PWM。假設(shè)系統(tǒng)主頻72MHz預(yù)分頻PSC設(shè)為71計(jì)數(shù)值A(chǔ)RR設(shè)為19999則PWM頻率為頻率 72MHz / (71 1) / (19999 1) 50Hz 周期 20ms這個(gè)頻率正好符合SG90的輸入要求。6.3 動(dòng)作序列與實(shí)現(xiàn)把“跳舞”拆成一組角度序列例如// 文件路徑Core/Src/servo_dance.c #include tim.h // 每個(gè)動(dòng)作包含目標(biāo)角度對(duì)應(yīng)的比較值 // 計(jì)算方式比較值 (脈寬 / 20ms) * 20000 typedef struct { uint16_t compare_value; uint16_t hold_time_ms; } ServoAction; const ServoAction dance_actions[] { { 500, 300 }, // 0度保持300ms { 1500, 300 }, // 90度 { 2000, 300 }, // 約135度 { 750, 300 }, // 約45度 { 1250, 200 }, // 約67.5度 { 2000, 200 }, // 約135度 { 500, 400 }, // 復(fù)位到0度 }; #define ACTION_COUNT (sizeof(dance_actions) / sizeof(dance_actions[0])) void servo_dance_update(uint32_t tick) { static uint32_t action_last_tick 0; static uint16_t action_index 0; if (tick - action_last_tick dance_actions[action_index].hold_time_ms) { action_last_tick tick; __HAL_TIM_SET_COMPARE(htim3, TIM_CHANNEL_1, dance_actions[action_index].compare_value); action_index (action_index 1) % ACTION_COUNT; } }這里把原本多個(gè)HAL_Delay串起來的動(dòng)作序列改成了“按時(shí)間切換角度”的狀態(tài)推進(jìn)邏輯。主循環(huán)只需反復(fù)調(diào)用servo_dance_update(sys_tick)舵機(jī)就會(huì)自動(dòng)按照dance_actions數(shù)組里的順序一段一段地執(zhí)行動(dòng)作。如果想讓舵機(jī)動(dòng)起來更像“跳舞”而不是僵硬地跳變角度可以加入插值。例如每20ms讓角度遞增或者遞減一個(gè)固定步長(zhǎng)從當(dāng)前脈寬平滑過渡到目標(biāo)脈寬。這樣動(dòng)作會(huì)柔和很多也更接近人在跳舞時(shí)連續(xù)運(yùn)動(dòng)的效果。7. 讓三支舞一起跳多任務(wù)與節(jié)奏同步前面幾支舞分別實(shí)現(xiàn)了LED、OLED、舵機(jī)的獨(dú)立控制?，F(xiàn)在把它們放進(jìn)同一個(gè)主循環(huán)看看怎么協(xié)調(diào)。7.1 完整的前后臺(tái)主循環(huán)把之前的函數(shù)統(tǒng)一放在main的while (1)里調(diào)用// 文件路徑Core/Src/main.c int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_I2C1_Init(); MX_TIM2_Init(); MX_TIM3_Init(); HAL_TIM_Base_Start_IT(htim2); HAL_TIM_PWM_Start(htim2, TIM_CHANNEL_1); HAL_TIM_PWM_Start(htim3, TIM_CHANNEL_1); uint32_t last_tick 0; while (1) { uint32_t now HAL_GetTick(); led_update(now); breath_led_update(now); oled_dance_update(now); servo_dance_update(now); // 簡(jiǎn)單模式切換按鍵按下時(shí)切換動(dòng)作節(jié)奏 if (HAL_GPIO_ReadPin(BTN_GPIO_Port, BTN_Pin) GPIO_PIN_RESET) { last_tick now; } // 防止主循環(huán)跑飛讓CPU稍微休息 // 注意不能在這里加長(zhǎng)延時(shí)否則會(huì)阻塞舵機(jī)動(dòng)作 } }這里有幾個(gè)關(guān)鍵點(diǎn)所有xxx_update函數(shù)都不包含阻塞延時(shí)只根據(jù)tick判斷是否需要執(zhí)行循環(huán)的執(zhí)行頻率遠(yuǎn)高于每個(gè)動(dòng)作的更新頻率所以多個(gè)任務(wù)看起來是“同時(shí)”在運(yùn)行HAL_GetTick()是HAL庫自帶的1ms系統(tǒng)節(jié)拍可以直接當(dāng)sys_tick使用用CubeMX生成的工程默認(rèn)已經(jīng)啟動(dòng)了SysTick所以不需要額外寫定時(shí)器中斷來維護(hù)sys_tick除非你想用獨(dú)立定時(shí)器。7.2 常見節(jié)奏同步問題如果LED、OLED和舵機(jī)各自為政觀感上會(huì)顯得“各跳各的”。同步節(jié)奏最簡(jiǎn)單的方法是讓所有動(dòng)作的起始點(diǎn)都對(duì)準(zhǔn)某個(gè)全局節(jié)拍例如統(tǒng)一在now % 1000 100時(shí)觸發(fā)一個(gè)“Reset”信號(hào)讓三路動(dòng)作同時(shí)回到起始位置。更復(fù)雜的方法是用狀態(tài)機(jī)把整套舞蹈拆成幾個(gè)階段階段1LED慢閃舵機(jī)擺動(dòng)OLED顯示第一組動(dòng)作階段2LED快閃舵機(jī)停下OLED顯示第二組動(dòng)作階段3全部停止OLED顯示結(jié)束畫面。每個(gè)階段有一個(gè)持續(xù)時(shí)間到了時(shí)間就切換到下一個(gè)階段。這樣整個(gè)系統(tǒng)就有了一個(gè)共同的“編排表”而不是各跑各的。8. 運(yùn)行驗(yàn)證與常見問題排查寫完代碼后編譯燒錄通電觀察現(xiàn)象。如果一切正常你應(yīng)該看到LED按200ms或300ms間隔流水點(diǎn)亮呼吸燈以約1秒為周期漸亮漸滅OLED屏幕上每隔100ms切換一幀小人的動(dòng)作連續(xù)舵機(jī)按動(dòng)作序列往復(fù)擺動(dòng)方向明確。如果你看到的不是這個(gè)現(xiàn)象可以按下面的順序排查。8.1 先看最小系統(tǒng)是否正常第一步確認(rèn)下載和供電正常。用ST-Link燒錄一個(gè)最簡(jiǎn)單的LED閃爍程序如果LED都不亮優(yōu)先查ST-Link和主板連接是否牢固供電電壓是否是3.3V或5V接線是否短路CubeMX生成的引腳配置和實(shí)際接線是否一致。8.2 再分別隔離每個(gè)外設(shè)不要一上來就同時(shí)調(diào)試三個(gè)外設(shè)。把OLED和舵機(jī)的代碼先注釋掉只保留LED流水燈。確認(rèn)LED正常后再單獨(dú)調(diào)OLED再單獨(dú)調(diào)舵機(jī)。這樣做的好處是能快速定位問題是外設(shè)本身還是多任務(wù)協(xié)調(diào)。8.3 常見問題表問題現(xiàn)象可能原因排查方式解決方案LED亮度很低或基本不亮GPIO配置為開漏輸出或者沒有串聯(lián)限流電阻用萬用表測(cè)量引腳電壓在CubeMX中把LED引腳配置為推挽輸出并串聯(lián)220Ω電阻呼吸燈沒有漸變效果PWM通道沒有開啟查看代碼是否調(diào)用了HAL_TIM_PWM_Start在初始化中啟動(dòng)對(duì)應(yīng)通道OLED顯示亂碼或白屏I2C地址錯(cuò)誤或幀數(shù)據(jù)格式不對(duì)檢查屏幕背面的地址選擇電阻常見為0x78或0x7A使用I2C掃描程序讀取實(shí)際地址OLED畫面閃爍嚴(yán)重I2C寫入速度太慢或者幀率過高在翻幀函數(shù)里加入計(jì)時(shí)統(tǒng)計(jì)單幀耗時(shí)降低幀率到8-10幀或升級(jí)為SPI接口屏幕舵機(jī)不轉(zhuǎn)PWM頻率不對(duì)或信號(hào)線接錯(cuò)用邏輯分析儀測(cè)PWM波形確認(rèn)PSC和ARR設(shè)置得到50Hz檢查信號(hào)引腳舵機(jī)抖動(dòng)、發(fā)熱供電電流不足用手觸摸舵機(jī)電機(jī)和電源穩(wěn)壓芯片的溫度給舵機(jī)單獨(dú)提供5V供電不要和單片機(jī)共用同一個(gè)LDO多個(gè)任務(wù)一起跑后卡頓某個(gè)驅(qū)動(dòng)中含有阻塞延時(shí)搜索代碼里的HAL_Delay把延時(shí)改成基于全局tick的狀態(tài)判斷按鍵切換模式無響應(yīng)按鍵沒有使用內(nèi)部上拉引腳配置錯(cuò)誤用萬用表測(cè)量按鍵按下后的電平變化在CubeMX中把按鍵輸入配置為上拉輸入9. 從Demo到工程項(xiàng)目最佳實(shí)踐與工程建議到這里“三支舞”已經(jīng)全部能跑了。但如果只是停留在“能閃、能動(dòng)、能顯示”的程度距離一個(gè)規(guī)范的嵌入式項(xiàng)目還很遠(yuǎn)。下面幾條建議能幫你把這套代碼升級(jí)成工程級(jí)的寫法。9.1 把每個(gè)外設(shè)封裝成獨(dú)立模塊不要把所有代碼堆在main.c里。隨著項(xiàng)目變大main.c會(huì)變成幾百行甚至上千行的“大泥球”。建議的目錄結(jié)構(gòu)Core/ Inc/ led_driver.h oled_driver.h servo_driver.h app_dance.h Src/ main.c led_driver.c oled_driver.c servo_driver.c app_dance.c每個(gè)驅(qū)動(dòng)文件負(fù)責(zé)一類外設(shè)的初始化和基本操作app_dance.c負(fù)責(zé)編排邏輯。未來如果從“跳舞”改成“顯示傳感器數(shù)據(jù)”只需要更換app_dance.c驅(qū)動(dòng)層不用動(dòng)。9.2 狀態(tài)機(jī)代替“一長(zhǎng)串延時(shí)”很多人寫動(dòng)作順序時(shí)習(xí)慣這樣寫HAL_Delay(500); servo_set(0); HAL_Delay(500); servo_set(90);這在寫死流程時(shí)很直觀但一旦需要響應(yīng)按鍵、處理異常這種寫法就非常不便。推薦改用動(dòng)作序列數(shù)組加狀態(tài)索引的方式就像前面dance_actions那樣。修改動(dòng)作順序時(shí)只用改動(dòng)數(shù)組里的數(shù)值不用重寫整個(gè)控制邏輯。9.3 注意舵機(jī)和電機(jī)供電SG90雖然是小舵機(jī)但它堵轉(zhuǎn)時(shí)的電流可能接近幾百毫安甚至更大。如果和單片機(jī)共用同一個(gè)USB供電或者同一個(gè)LDO很容易導(dǎo)致電壓跌落進(jìn)而引起單片機(jī)重啟或者舵機(jī)亂抖。實(shí)操上推薦舵機(jī)單獨(dú)接5V電源比如用一塊小面包板電源模塊舵機(jī)電源地和單片機(jī)地必須連在一起如果項(xiàng)目要控制多個(gè)舵機(jī)建議加一個(gè)標(biāo)稱電流足夠的5V穩(wěn)壓模塊。9.4 善用日志和打印如果板子上有串口可以在關(guān)鍵位置加上打印printf(led tick: %lu\n, (unsigned long)now);這樣能清楚看到每個(gè)任務(wù)的推進(jìn)時(shí)間判斷是邏輯問題還是時(shí)序問題。沒有串口的板子也可以用一個(gè)空閑LED作為調(diào)試指示燈在特定事件發(fā)生時(shí)翻轉(zhuǎn)它。9.5 性能意識(shí)不要在中斷里做耗時(shí)操作定時(shí)器中斷里只做“清標(biāo)志位、更新計(jì)數(shù)器”這類輕量操作。OLED翻幀和舵機(jī)PWM更新都放在主循環(huán)里。如果一幀OLED數(shù)據(jù)要占幾十毫秒放在中斷里會(huì)直接擠占主循環(huán)導(dǎo)致其他任務(wù)饑餓。10. 總結(jié)與后續(xù)學(xué)習(xí)方向從LED呼吸燈到OLED逐幀動(dòng)畫再到舵機(jī)動(dòng)作序列再進(jìn)一步把它們裝進(jìn)同一個(gè)主循環(huán)整個(gè)過程中真正反復(fù)出現(xiàn)的技術(shù)點(diǎn)其實(shí)就三樣定時(shí)器、PWM、狀態(tài)機(jī)。把它們組合好單片機(jī)就能從一個(gè)只會(huì)點(diǎn)燈的玩具變成一個(gè)具備節(jié)奏感的小型演出系統(tǒng)。如果你已經(jīng)跟著代碼跑通了這篇文章里的Demo下一步可以按下面的方向繼續(xù)深入給系統(tǒng)引入音樂播放模塊用音頻信號(hào)或者藍(lán)牙串口控制LED亮度做真正的音樂節(jié)奏燈把OLED動(dòng)畫從手動(dòng)取模改成程序生成比如根據(jù)加速度傳感器數(shù)據(jù)實(shí)時(shí)繪制人物動(dòng)作在動(dòng)作序列里加入插值算法讓舵機(jī)運(yùn)動(dòng)更平滑減少機(jī)械沖擊當(dāng)任務(wù)數(shù)量繼續(xù)增加時(shí)了解FreeRTOS這種輕量級(jí)實(shí)時(shí)操作系統(tǒng)的任務(wù)調(diào)度和消息隊(duì)列機(jī)制。一個(gè)建議是不要急著把所有新學(xué)的東西都塞進(jìn)一個(gè)項(xiàng)目而是每次只替換其中一個(gè)模塊。比如先只把LED控制從阻塞延時(shí)改成定時(shí)器驅(qū)動(dòng)跑通后再改OLED最后再改舵機(jī)。這樣每一步都有明確的驗(yàn)證點(diǎn)出問題時(shí)也容易定位。下一次再有人問“單片機(jī)也能跳舞嗎”你就可以直接把他拉到屏幕前面點(diǎn)顆燈切幀畫面再讓舵機(jī)擺兩下——然后用這篇文章里的“定時(shí)器 狀態(tài)機(jī) 外設(shè)驅(qū)動(dòng)”這組關(guān)鍵詞告訴他這一切是怎么做到的。