簡介面向STM32F103C8T6的搖桿模塊與串口模塊聯(lián)合控制方向示例工程適合嵌入式單片機(jī)開發(fā)初學(xué)者或需要快速搭建方向控制功能的項目開發(fā)者。工程代碼框架完整預(yù)留了添加自定義邏輯的特定代碼位置可在此基礎(chǔ)上實現(xiàn)搖桿坐標(biāo)采集、串口指令發(fā)送與方向判定便于擴(kuò)展為手柄、智能小車等實際應(yīng)用。軟件包共614個文件以C源文件、H頭文件為主并配有啟動文件、鏈接腳本、IAR與Keil工程文件以及AXF/HEX/MAP等編譯燒錄與調(diào)試輔助文件同時集成STM32 HAL庫和部分CMSIS DSP庫代碼容量約18.17MB目錄結(jié)構(gòu)清晰可直接打開編譯。已有1560人學(xué)習(xí)下載代碼使用中若有具體問題作者提供私聊交流支持。 做小車、機(jī)械臂、云臺這類項目第一步基本都是把“方向控制”跑通。而 STM32F103C8T6 最小系統(tǒng)板搭配一個 PS2 搖桿模塊Joystick、一個串口模塊是我實踐中驗證過最快、也最適合新手學(xué)習(xí)和二次開發(fā)的組合。這篇內(nèi)容就是圍繞這套硬件給出完整的代碼例程搖桿 ADC 采集、方向判定邏輯、串口數(shù)據(jù)輸出以及預(yù)留的功能擴(kuò)展點位——你在對應(yīng)的位置加上電機(jī)驅(qū)動、舵機(jī)控制或上位機(jī)協(xié)議就能直接接入自己的項目。適合誰看正在做循跡小車、遙控小車、舵機(jī)云臺或者剛開始接觸 STM32 開發(fā)、想搞明白“搖桿數(shù)值怎么讀、方向怎么判、串口怎么發(fā)”的人。文中貼出的例程基于 HAL 庫 CubeMX代碼結(jié)構(gòu)清楚改一改就能用。1. 項目整體設(shè)計與思路拆解1.1 這套組合能干什么、適合什么場景先說清楚這套方案的本質(zhì)搖桿是一個模擬量輸入設(shè)備STM32 通過 ADC模數(shù)轉(zhuǎn)換器讀取搖桿在 X 軸和 Y 軸上的電壓偏移再通過串口把方向數(shù)據(jù)發(fā)送給上位機(jī)或者其他主控板。最典型的應(yīng)用場景有兩類調(diào)試驗證類你還沒寫電機(jī)驅(qū)動先想確認(rèn)“搖桿讀數(shù)對不對、方向判斷準(zhǔn)不準(zhǔn)、串口收不收得到”這套代碼直接把方向結(jié)果打在串口助手上5 分鐘就能驗證。模塊預(yù)研類你最終要做的是遙控小車、水下機(jī)器人、云臺相機(jī)方向盤讀取和串口上報是公共底層功能先把這部分做穩(wěn)后續(xù)業(yè)務(wù)代碼直接在預(yù)留位置擴(kuò)展不用回頭改底層。我自己的習(xí)慣是“先打通數(shù)據(jù)鏈路再寫業(yè)務(wù)邏輯”。搖桿方向數(shù)據(jù)如果能穩(wěn)定地出現(xiàn)在串口助手上說明 ADC 采集、方向算法、串口發(fā)送三個環(huán)節(jié)都沒有問題后面接電機(jī)、接舵機(jī)就只剩邏輯問題而不是硬件問題。1.2 為什么選 STM32F103C8T6 搖桿 串口STM32F103C8T6 幾乎是國內(nèi)嵌入式入門最常用的一顆芯片Cortex-M3 內(nèi)核主頻 72MHz20KB RAM、64KB Flash片上自帶的 12 位 ADC 和多個 UART 完全夠用。重點是小系統(tǒng)板價格便宜壞了不心疼而且網(wǎng)上資料極多遇到問題很容易搜到答案。搖桿模塊用的是最常見的 PS2 手柄搖桿模塊內(nèi)部就是兩個電位器加一個按鍵開關(guān)X 軸和 Y 軸各輸出一路電壓信號按下?lián)u桿時輸出一個開關(guān)量。這類模塊大量用在 Arduino 項目中電路簡單也完全兼容 STM32。串口選擇 CH340 方案的 USB 轉(zhuǎn) TTL 模塊主要是因為驅(qū)動成熟、兼容性好。Windows、Linux、macOS 都有驅(qū)動串口助手打開直接能看到數(shù)據(jù)是非常穩(wěn)妥的調(diào)試通道。整個方案沒有復(fù)雜外設(shè)沒有外部中斷依賴只需要基本的 ADC 采樣和 UART 發(fā)送非常適合作為入門級方向控制模板。1.3 整體架構(gòu)模塊劃分與代碼組織結(jié)構(gòu)我把整個程序拆成三層這樣后續(xù)擴(kuò)展最省事硬件驅(qū)動層負(fù)責(zé) ADC、UART、按鍵引腳初始化通過 CubeMX 生成業(yè)務(wù)邏輯層負(fù)責(zé)讀取搖桿 ADC 值、做方向判定、生成方向字符串應(yīng)用擴(kuò)展層預(yù)留的代碼點位你后續(xù)加的電機(jī)控制、協(xié)議解析、狀態(tài)機(jī)全部放在這里。代碼里每一層都有明確的注釋和函數(shù)邊界主循環(huán)里只保留最核心的調(diào)用關(guān)系不堆業(yè)務(wù)。這樣做的好處是如果以后要換搖桿模塊接不同的引腳只改硬件驅(qū)動層如果要改方向判定算法只動業(yè)務(wù)邏輯層而不管你怎么改應(yīng)用擴(kuò)展層都不受影響。2. 硬件連接與底層配置2.1 搖桿模塊的工作原理搖桿模塊的本質(zhì)是兩路電位器分壓電路。搖桿水平方向移動時X 軸電位器的動片位置變化、輸出電壓變化垂直方向移動時Y 軸電位器同理。當(dāng)搖桿處于中心位置時兩個輸出腳電壓大約是電源電壓的一半3.3V 供電時約為 1.65V。STM32 的 ADC 是 12 位分辨率滿量程對應(yīng)數(shù)值范圍是 04095。也就是說搖桿中心讀數(shù)大約在 2048 附近向一個方向推到底接近 0 或 4095。模塊還有一個 SW 腳按下?lián)u桿時輸出低電平平時是高電平可以當(dāng)作一個普通按鍵使用。這里有一個很容易踩的坑不同廠家生產(chǎn)的搖桿模塊中心點電壓并不嚴(yán)格等于 1.65V可能存在幾百毫伏的偏差對應(yīng)到 ADC 數(shù)值上就是一兩百的偏移。所以方向判定不能直接用 2048 作為唯一中心點我會在后面的死區(qū)處理里重點說明。2.2 引腳分配與接線表我使用的是 STM32F103C8T6 最小系統(tǒng)板引腳分配如下模塊引腳STM32引腳對應(yīng)功能搖桿 GNDGND電源地?fù)u桿 VCC3.3V電源正搖桿 VRxPA0ADC1_IN0X軸搖桿 VRyPA1ADC1_IN1Y軸搖桿 SWPB0普通輸入按鍵串口 TXPA9USART1_TX串口 RXPA10USART1_RX串口 GNDGND共地接線注意事項串口模塊 TTL 電平需要和 STM32 的 3.3V 邏輯兼容CH340 模塊一般都有 3.3V 電平模式如果模塊上有跳線帽確認(rèn)設(shè)置在 3.3V 或 TTL 位置串口 TX 接模塊 RX串口 RX 接模塊 TX交叉連接一定共地。我見過很多人串口收不到數(shù)據(jù)最后發(fā)現(xiàn)是 GND 沒連。2.3 CubeMX 基礎(chǔ)配置我用的是 STM32CubeMX HAL 庫下面幾步是必須配置的SYS 里的 Debug 設(shè)置為 Serial Wire防止第一次燒錄后調(diào)試口被占用將 PA0、PA1 配置為 ADC1 的 IN0、IN1 兩個通道選擇掃描模式Scan Mode Enabled分辨率 12 位關(guān)閉連續(xù)轉(zhuǎn)換因為我在主循環(huán)里用輪詢方式讀取USART1 設(shè)置為異步模式Asynchronous波特率 1152008 位數(shù)據(jù)無校驗1 位停止位PB0 配置為 GPIO_Input同時把上拉電阻打開Pull-up保證搖桿 SW 懸空時是高電平。代碼生成選擇 MDK-ARMToolchain 選自己的編譯器版本。CubeMX 生成完成后打開工程接下來先在main.c里補(bǔ)上 printf 重定向這樣后續(xù)可以直接用printf打印調(diào)試信息省去每次調(diào)用串口發(fā)送函數(shù)的麻煩。2.4 串口重定向與初始化驗證在串口調(diào)試階段用printf比直接調(diào)HAL_UART_Transmit方便得多。重定向代碼如下#include stdio.h int fputc(int ch, FILE *f) { HAL_UART_Transmit(huart1, (uint8_t *)ch, 1, 0xFFFF); return ch; }加完這段printf(Hello\r\n)就能直接通過 USART1 發(fā)送。注意 Windows 串口助手如果顯示亂碼優(yōu)先檢查波特率是否和代碼一致。初始化部分我做了一個基礎(chǔ)驗證函數(shù)上電后通過串口打印一行系統(tǒng)啟動信息同時打印搖桿 X/Y 軸的原始 ADC 值和按鍵狀態(tài)。這行日志不是擺設(shè)它能幫你快速確認(rèn)硬件接線、ADC 配置和串口鏈路是否全部正常是整套例程的“自檢燈”。3. 核心邏輯方向判定算法與代碼實現(xiàn)3.1 方向判定的核心思路ADC 原始值到方向離散值搖桿 ADC 讀出來是 04095 的連續(xù)數(shù)值直接發(fā)給串口沒有意義用戶或者上位機(jī)需要的是“上、下、左、右、左前、右后”這樣離散的方向結(jié)果。因此核心思路是把模擬量映射成狀態(tài)量。我采用的判定方法是X 軸和 Y 軸各自獨立判斷成 3 種狀態(tài)再組合成 9 種方向結(jié)果X 軸狀態(tài)左L、中C、右RY 軸狀態(tài)上U、中C、下D組合結(jié)果就是上、下、左、右、左上、右上、左下、右下、中間。如果搖桿按鍵按下則優(yōu)先上報按鍵事件。這樣做的好處是每一軸邏輯獨立代碼可讀性強(qiáng)后續(xù)想擴(kuò)展靈敏度參數(shù)也很方便。3.2 死區(qū)處理與閾值計算ADC 中心理論值是 2048但實際回中位置會漂移且機(jī)械搖桿在使用過程中會有抖動如果直接把閾值卡死在 2048搖桿放在中心位置時方向會在“左/右”之間反復(fù)跳變噪聲非常大。所以必須引入死區(qū)以中心值為基準(zhǔn)左右各留一段不判向的范圍。我實測自己這塊板子的搖桿回中值在 19802100 之間波動因此設(shè)定了兩個閾值#define AXIS_MIN 1700 // 小于該值判斷為低左/下 #define AXIS_MAX 2300 // 大于該值判斷為高右/上也就是說ADC 值落在 [1700, 2300] 區(qū)間內(nèi)都算“中間狀態(tài)”。死區(qū)寬度是 600對大多數(shù)搖桿模塊來說足夠穩(wěn)定同時又不會讓方向觸發(fā)顯得遲鈍。如果你發(fā)現(xiàn)搖桿推一點方向就有反應(yīng)但回中時還是偶爾跳方向就把這個區(qū)間再調(diào)大一點反過來如果覺得推動行程很大才有反應(yīng)就適當(dāng)調(diào)小。這里順便說一下方向符號約定不同模塊 X/Y 軸的正負(fù)方向可能和標(biāo)注相反以實際測試為準(zhǔn)。比如我這塊板子把搖桿向右推X 軸 ADC 值增大向下推Y 軸 ADC 值增大。如果你的模塊相反只需把狀態(tài)判斷里的比較方向?qū)φ{(diào)即可。3.3 完整代碼實現(xiàn)與預(yù)留點位下面是完整的核心代碼在 CubeMX 生成的工程上替換 main 函數(shù)即可。代碼里已經(jīng)預(yù)留了功能擴(kuò)展位置。/* 引腳與 ADC 相關(guān) */ ADC_HandleTypeDef hadc1; UART_HandleTypeDef huart1; #define AXIS_MIN 1700 #define AXIS_MAX 2300 /* 搖桿按鍵狀態(tài) */ #define JOYSTICK_SW_PRESSED (HAL_GPIO_ReadPin(GPIOB, GPIO_PIN_0) GPIO_PIN_RESET) /* X 軸和 Y 軸的狀態(tài)枚舉 */ typedef enum { AXIS_STATE_LOW 0, AXIS_STATE_CENTER, AXIS_STATE_HIGH } AxisState_t; /* 根據(jù) ADC 值判斷軸狀態(tài) */ AxisState_t get_axis_state(uint16_t adc_value) { if (adc_value AXIS_MIN) { return AXIS_STATE_LOW; } else if (adc_value AXIS_MAX) { return AXIS_STATE_HIGH; } return AXIS_STATE_CENTER; } /* 讀取搖桿 ADC 值 */ void joystick_read(uint16_t *x_value, uint16_t *y_value) { /* 啟動 ADC 轉(zhuǎn)換 */ HAL_ADC_Start(hadc1); /* 第一次轉(zhuǎn)換對應(yīng) Rank1 - ADC_IN0 (PA0, X軸) */ HAL_ADC_PollForConversion(hadc1, 10); *x_value HAL_ADC_GetValue(hadc1); /* 第二次轉(zhuǎn)換對應(yīng) Rank2 - ADC_IN1 (PA1, Y軸) */ HAL_ADC_PollForConversion(hadc1, 10); *y_value HAL_ADC_GetValue(hadc1); /* 停止 ADC */ HAL_ADC_Stop(hadc1); } /* 生成方向字符串 */ void get_direction_str(uint16_t x_value, uint16_t y_value, char *buf, uint8_t buf_len) { AxisState_t x_state get_axis_state(x_value); AxisState_t y_state get_axis_state(y_value); const char *x_str C; const char *y_str C; if (x_state AXIS_STATE_LOW) x_str L; if (x_state AXIS_STATE_HIGH) x_str R; if (y_state AXIS_STATE_LOW) y_str U; /* 注意這里按實際方向調(diào)整 */ if (y_state AXIS_STATE_HIGH) y_str D; /* 組合方向 */ if (strcmp(x_str, C) 0 strcmp(y_str, C) 0) { snprintf(buf, buf_len, CENTER); } else { snprintf(buf, buf_len, %s%s, x_str, y_str); } } int main(void) { HAL_Init(); SystemClock_Config(); MX_GPIO_Init(); MX_ADC1_Init(); MX_USART1_UART_Init(); uint16_t x_val 0, y_val 0; char dir_buf[16]; printf(System Boot OK\r\n); while (1) { /* 讀取搖桿原始值 */ joystick_read(x_val, y_val); /* 按鍵按下時優(yōu)先處理按鍵事件 */ if (JOYSTICK_SW_PRESSED) { snprintf(dir_buf, sizeof(dir_buf), PRESS); } else { /* 生成方向字符串 */ get_direction_str(x_val, y_val, dir_buf, sizeof(dir_buf)); } /* 通過串口輸出方向結(jié)果和原始數(shù)值 */ printf(Dir: %-6s X: %4d Y: %4d\r\n, dir_buf, x_val, y_val); /* */ /* 在這里添加你想要的功能代碼 */ /* */ /* 比如根據(jù) dir_buf 控制電機(jī) / 舵機(jī) / 上報協(xié)議 */ /* 比如根據(jù) x_val、y_val 做云臺速度閉環(huán) */ /* */ HAL_Delay(50); /* 50ms 采樣周期25ms 可能太靈敏看實際情況 */ } }關(guān)鍵點解釋joystick_read函數(shù)里兩次HAL_ADC_PollForConversion對應(yīng)兩個通道的轉(zhuǎn)換結(jié)果順序由 CubeMX 里的 Rank 順序決定我配置的 Rank1 是 IN0、Rank2 是 IN1所以順序不能寫反方向字符串選擇了簡化命名L左、R右、U上、D下組合如LU左上、RD右下printf里的%-6s是為了讓方向字符串在串口助手里對齊顯示看著方便主循環(huán)里的HAL_Delay(50)是采樣周期50ms 對方向控制來說足夠了不會影響實時性也不至于刷屏太快導(dǎo)致上位機(jī)處理不過來。4. 實操驗證與常見問題排查4.1 串口調(diào)試完整步驟燒錄完成后打開串口調(diào)試助手按以下順序驗證選擇正確的串口號。在電腦設(shè)備管理器里看端口COM編號CH340 通常會顯示 “USB-SERIAL CH340 (COMx)”設(shè)置波特率 115200數(shù)據(jù)位 8停止位 1無校驗這與代碼配置保持一致打開串口后如果一切正常首先會收到一行System Boot OK不動搖桿時屏幕上會持續(xù)刷新Dir: CENTER X: 約2000 Y: 約2000這樣的數(shù)據(jù)推動搖桿方向字符串會變成L、R、U、D或組合方向同時 X/Y 數(shù)值也會相應(yīng)變化按下?lián)u桿會打印PRESS。如果第 3 步就卡住了說明串口鏈路本身有問題優(yōu)先檢查接線和驅(qū)動如果第 4 步中心數(shù)值偏差很大比如讀到 3000 多優(yōu)先檢查搖桿 VCC 是否接了 3.3V以及電位器模塊是否是壞的。4.2 常見問題速查表現(xiàn)象可能原因解決方向串口助手收不到任何數(shù)據(jù)串口 RX/TX 接反、GND 未共地、沒裝 CH340 驅(qū)動交叉檢查接線重裝驅(qū)動后查看設(shè)備管理器收到數(shù)據(jù)但全是亂碼波特率不一致、時鐘配置錯誤確認(rèn)兩邊波特率一致檢查 CubeMX 里 HSE 晶振頻率是否填對只收到一次System Boot OK后無輸出主循環(huán)卡死、HAL_Delay 配置異常檢查是否在while(1)里死循環(huán)仿真器單步調(diào)試定位搖桿放中間方向偶爾跳變死區(qū)太小、中心值偏了調(diào)大AXIS_MIN和AXIS_MAX的差距實測打印中心值再定ADC 數(shù)值跳動厲害供電不穩(wěn)、接線過長、ADC 未濾波加濾波或者做幾次滑動平均縮短杜邦線距離按下按鍵沒反應(yīng)SW 引腳沒有內(nèi)部上拉 / 模塊無上拉電阻把 PB0 配置為 Pull-up或者外接 10k 上拉電阻Hal 庫串口中斷只收一次接收中斷未重新開啟 / 沒清標(biāo)志位這個例程以發(fā)送為主如果后面做接收每收一幀后重新調(diào)用接收函數(shù)4.3 我踩過的幾個坑做這個例程時有幾次調(diào)試經(jīng)歷印象很深寫出來供大家參考。第一是關(guān)于 ADC 順序的坑。第一次用 CubeMX 配置雙通道 ADC 時我以為HAL_ADC_GetValue會自動返回指定通道的值結(jié)果發(fā)現(xiàn)兩個通道讀出來的數(shù)據(jù)是反的。原因就是 Rank 順序決定了轉(zhuǎn)換順序必須按 Rank1、Rank2 的順序讀取不能想當(dāng)然。這也是我在代碼里加了詳細(xì)注釋的原因。第二是死區(qū)參數(shù)。我最初用的是基于 2048 的對稱死區(qū)范圍設(shè)得非常窄結(jié)果搖桿回中時方向信息一直在 CENTER 和 LEFT 之間來回跳。后來我把串口讀到的基礎(chǔ)值打出來花了十幾分鐘盯著一組數(shù)據(jù)看偏移情況才確定合理閾值。這里強(qiáng)烈建議拿到一個搖桿模塊先寫一個打印原始 ADC 值的測試程序把中心值、四向推滿的值都記錄下來再定死區(qū)參數(shù)效果比直接套別人的參數(shù)好得多。第三是串口地線的問題。有次在項目板上調(diào)試怎么都收不到數(shù)據(jù)波形也看不清折騰半小時后才發(fā)現(xiàn) USB 轉(zhuǎn)串口模塊和 STM32 板子各自接了不同的電源GND 沒有連在一起。嵌入式調(diào)試?yán)铩肮驳亍边@個事說一百遍都不嫌多。5. 預(yù)留擴(kuò)展與后續(xù)方向代碼里已經(jīng)預(yù)留了非常明確的擴(kuò)展點在/* 在這里添加你想要的功能代碼 */下面你可以加任何內(nèi)容。這里給幾個我實際做過的擴(kuò)展思路接電機(jī)驅(qū)動根據(jù)dir_buf控制 L298N 或 TB6612 的 IN 引腳和 PWM 輸出實現(xiàn)搖桿控制小車前進(jìn)、后退、轉(zhuǎn)向接舵機(jī)云臺把 X 軸 ADC 值映射到舵機(jī)角度實現(xiàn)搖桿控制云臺轉(zhuǎn)動。映射公式大致是angle (adc_value / 4095.0) * 180.0需要注意限幅和回差接上位機(jī)協(xié)議把當(dāng)前代碼里的printf輸出換成自定義協(xié)議比如幀頭 長度 類型 數(shù)據(jù) 校驗和這樣可以和 PC 端軟件、手機(jī) App 對接做速度控制不用方向離散量直接根據(jù)搖桿偏離中心的幅度計算目標(biāo)速度也就是把 X/Y 模擬量映射成 PWM 占空比實現(xiàn)漸進(jìn)式調(diào)速。這套代碼雖然看著簡單但已經(jīng)包含了“采集 — 算法 — 輸出 — 擴(kuò)展”完整的一套工程思路在此基礎(chǔ)上做項目會比直接抄一份電機(jī)控制代碼理解深得多。最后再分享一個小技巧調(diào)方向閾值參數(shù)時別靠猜直接在串口助手打印原始 X/Y 值然后用一個紙筆記錄搖桿在中心、上下左右盡頭時的讀數(shù)。把讀數(shù)寫下來再確定代碼里的閾值比反復(fù)改代碼下載快得多。我現(xiàn)在做所有搖桿類項目都會先跑一遍原始值打印例程把這個習(xí)慣保留下來能省掉大量調(diào)參時間。本文還有配套的精品資源點擊獲取