簡介面向STM32F103C8T6的搖桿模塊與串口模塊聯(lián)合控制方向示例工程適合嵌入式單片機(jī)開發(fā)初學(xué)者或需要快速搭建方向控制功能的項(xiàng)目開發(fā)者。工程代碼框架完整預(yù)留了添加自定義邏輯的特定代碼位置可在此基礎(chǔ)上實(shí)現(xiàn)搖桿坐標(biāo)采集、串口指令發(fā)送與方向判定便于擴(kuò)展為手柄、智能小車等實(shí)際應(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ī)械臂、云臺這類項(xiàng)目第一步基本都是把“方向控制”跑通。而 STM32F103C8T6 最小系統(tǒng)板搭配一個 PS2 搖桿模塊Joystick、一個串口模塊是我實(shí)踐中驗(yàn)證過最快、也最適合新手學(xué)習(xí)和二次開發(fā)的組合。這篇內(nèi)容就是圍繞這套硬件給出完整的代碼例程搖桿 ADC 采集、方向判定邏輯、串口數(shù)據(jù)輸出以及預(yù)留的功能擴(kuò)展點(diǎn)位——你在對應(yīng)的位置加上電機(jī)驅(qū)動、舵機(jī)控制或上位機(jī)協(xié)議就能直接接入自己的項(xiàng)目。適合誰看正在做循跡小車、遙控小車、舵機(jī)云臺或者剛開始接觸 STM32 開發(fā)、想搞明白“搖桿數(shù)值怎么讀、方向怎么判、串口怎么發(fā)”的人。文中貼出的例程基于 HAL 庫 CubeMX代碼結(jié)構(gòu)清楚改一改就能用。1. 項(xiàng)目整體設(shè)計(jì)與思路拆解1.1 這套組合能干什么、適合什么場景先說清楚這套方案的本質(zhì)搖桿是一個模擬量輸入設(shè)備STM32 通過 ADC模數(shù)轉(zhuǎn)換器讀取搖桿在 X 軸和 Y 軸上的電壓偏移再通過串口把方向數(shù)據(jù)發(fā)送給上位機(jī)或者其他主控板。最典型的應(yīng)用場景有兩類調(diào)試驗(yàn)證類你還沒寫電機(jī)驅(qū)動先想確認(rèn)“搖桿讀數(shù)對不對、方向判斷準(zhǔn)不準(zhǔn)、串口收不收得到”這套代碼直接把方向結(jié)果打在串口助手上5 分鐘就能驗(yàn)證。模塊預(yù)研類你最終要做的是遙控小車、水下機(jī)器人、云臺相機(jī)方向盤讀取和串口上報(bào)是公共底層功能先把這部分做穩(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 完全夠用。重點(diǎn)是小系統(tǒng)板價格便宜壞了不心疼而且網(wǎng)上資料極多遇到問題很容易搜到答案。搖桿模塊用的是最常見的 PS2 手柄搖桿模塊內(nèi)部就是兩個電位器加一個按鍵開關(guān)X 軸和 Y 軸各輸出一路電壓信號按下?lián)u桿時輸出一個開關(guān)量。這類模塊大量用在 Arduino 項(xiàng)目中電路簡單也完全兼容 STM32。串口選擇 CH340 方案的 USB 轉(zhuǎn) TTL 模塊主要是因?yàn)轵?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ù)留的代碼點(diǎn)位你后續(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)的搖桿模塊中心點(diǎn)電壓并不嚴(yán)格等于 1.65V可能存在幾百毫伏的偏差對應(yīng)到 ADC 數(shù)值上就是一兩百的偏移。所以方向判定不能直接用 2048 作為唯一中心點(diǎn)我會在后面的死區(qū)處理里重點(diǎn)說明。2.2 引腳分配與接線表我使用的是 STM32F103C8T6 最小系統(tǒng)板引腳分配如下模塊引腳STM32引腳對應(yīng)功能搖桿 GNDGND電源地?fù)u桿 VCC3.3V電源正搖桿 VRxPA0ADC1_IN0X軸搖桿 VRyPA1ADC1_IN1Y軸搖桿 SWPB0普通輸入按鍵串口 TXPA9USART1_TX串口 RXPA10USART1_RX串口 GNDGND共地接線注意事項(xiàng)串口模塊 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)換因?yàn)槲以谥餮h(huán)里用輪詢方式讀取USART1 設(shè)置為異步模式Asynchronous波特率 1152008 位數(shù)據(jù)無校驗(yàn)1 位停止位PB0 配置為 GPIO_Input同時把上拉電阻打開Pull-up保證搖桿 SW 懸空時是高電平。代碼生成選擇 MDK-ARMToolchain 選自己的編譯器版本。CubeMX 生成完成后打開工程接下來先在main.c里補(bǔ)上 printf 重定向這樣后續(xù)可以直接用printf打印調(diào)試信息省去每次調(diào)用串口發(fā)送函數(shù)的麻煩。2.4 串口重定向與初始化驗(yàn)證在串口調(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ǔ)驗(yàn)證函數(shù)上電后通過串口打印一行系統(tǒng)啟動信息同時打印搖桿 X/Y 軸的原始 ADC 值和按鍵狀態(tài)。這行日志不是擺設(shè)它能幫你快速確認(rèn)硬件接線、ADC 配置和串口鏈路是否全部正常是整套例程的“自檢燈”。3. 核心邏輯方向判定算法與代碼實(shí)現(xiàn)3.1 方向判定的核心思路ADC 原始值到方向離散值搖桿 ADC 讀出來是 04095 的連續(xù)數(shù)值直接發(fā)給串口沒有意義用戶或者上位機(jī)需要的是“上、下、左、右、左前、右后”這樣離散的方向結(jié)果。因此核心思路是把模擬量映射成狀態(tài)量。我采用的判定方法是X 軸和 Y 軸各自獨(dú)立判斷成 3 種狀態(tài)再組合成 9 種方向結(jié)果X 軸狀態(tài)左L、中C、右RY 軸狀態(tài)上U、中C、下D組合結(jié)果就是上、下、左、右、左上、右上、左下、右下、中間。如果搖桿按鍵按下則優(yōu)先上報(bào)按鍵事件。這樣做的好處是每一軸邏輯獨(dú)立代碼可讀性強(qiáng)后續(xù)想擴(kuò)展靈敏度參數(shù)也很方便。3.2 死區(qū)處理與閾值計(jì)算ADC 中心理論值是 2048但實(shí)際回中位置會漂移且機(jī)械搖桿在使用過程中會有抖動如果直接把閾值卡死在 2048搖桿放在中心位置時方向會在“左/右”之間反復(fù)跳變噪聲非常大。所以必須引入死區(qū)以中心值為基準(zhǔn)左右各留一段不判向的范圍。我實(shí)測自己這塊板子的搖桿回中值在 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)搖桿推一點(diǎn)方向就有反應(yīng)但回中時還是偶爾跳方向就把這個區(qū)間再調(diào)大一點(diǎn)反過來如果覺得推動行程很大才有反應(yīng)就適當(dāng)調(diào)小。這里順便說一下方向符號約定不同模塊 X/Y 軸的正負(fù)方向可能和標(biāo)注相反以實(shí)際測試為準(zhǔn)。比如我這塊板子把搖桿向右推X 軸 ADC 值增大向下推Y 軸 ADC 值增大。如果你的模塊相反只需把狀態(tài)判斷里的比較方向?qū)φ{(diào)即可。3.3 完整代碼實(shí)現(xiàn)與預(yù)留點(diǎn)位下面是完整的核心代碼在 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; /* 注意這里按實(shí)際方向調(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ī) / 上報(bào)協(xié)議 */ /* 比如根據(jù) x_val、y_val 做云臺速度閉環(huán) */ /* */ HAL_Delay(50); /* 50ms 采樣周期25ms 可能太靈敏看實(shí)際情況 */ } }關(guān)鍵點(diǎ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 對方向控制來說足夠了不會影響實(shí)時性也不至于刷屏太快導(dǎo)致上位機(jī)處理不過來。4. 實(shí)操驗(yàn)證與常見問題排查4.1 串口調(diào)試完整步驟燒錄完成后打開串口調(diào)試助手按以下順序驗(yàn)證選擇正確的串口號。在電腦設(shè)備管理器里看端口COM編號CH340 通常會顯示 “USB-SERIAL CH340 (COMx)”設(shè)置波特率 115200數(shù)據(jù)位 8停止位 1無校驗(yàn)這與代碼配置保持一致打開串口后如果一切正常首先會收到一行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的差距實(shí)測打印中心值再定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ù)好得多。第三是串口地線的問題。有次在項(xiàng)目板上調(diào)試怎么都收不到數(shù)據(jù)波形也看不清折騰半小時后才發(fā)現(xiàn) USB 轉(zhuǎn)串口模塊和 STM32 板子各自接了不同的電源GND 沒有連在一起。嵌入式調(diào)試?yán)铩肮驳亍边@個事說一百遍都不嫌多。5. 預(yù)留擴(kuò)展與后續(xù)方向代碼里已經(jīng)預(yù)留了非常明確的擴(kuò)展點(diǎn)在/* 在這里添加你想要的功能代碼 */下面你可以加任何內(nèi)容。這里給幾個我實(shí)際做過的擴(kuò)展思路接電機(jī)驅(qū)動根據(jù)dir_buf控制 L298N 或 TB6612 的 IN 引腳和 PWM 輸出實(shí)現(xiàn)搖桿控制小車前進(jìn)、后退、轉(zhuǎn)向接舵機(jī)云臺把 X 軸 ADC 值映射到舵機(jī)角度實(shí)現(xiàn)搖桿控制云臺轉(zhuǎn)動。映射公式大致是angle (adc_value / 4095.0) * 180.0需要注意限幅和回差接上位機(jī)協(xié)議把當(dāng)前代碼里的printf輸出換成自定義協(xié)議比如幀頭 長度 類型 數(shù)據(jù) 校驗(yàn)和這樣可以和 PC 端軟件、手機(jī) App 對接做速度控制不用方向離散量直接根據(jù)搖桿偏離中心的幅度計(jì)算目標(biāo)速度也就是把 X/Y 模擬量映射成 PWM 占空比實(shí)現(xiàn)漸進(jìn)式調(diào)速。這套代碼雖然看著簡單但已經(jīng)包含了“采集 — 算法 — 輸出 — 擴(kuò)展”完整的一套工程思路在此基礎(chǔ)上做項(xiàng)目會比直接抄一份電機(jī)控制代碼理解深得多。最后再分享一個小技巧調(diào)方向閾值參數(shù)時別靠猜直接在串口助手打印原始 X/Y 值然后用一個紙筆記錄搖桿在中心、上下左右盡頭時的讀數(shù)。把讀數(shù)寫下來再確定代碼里的閾值比反復(fù)改代碼下載快得多。我現(xiàn)在做所有搖桿類項(xiàng)目都會先跑一遍原始值打印例程把這個習(xí)慣保留下來能省掉大量調(diào)參時間。本文還有配套的精品資源點(diǎn)擊獲取