板從零到實(shí)戰(zhàn)：資料整理、串口燒錄與網(wǎng)絡(luò)聯(lián)調(diào)全流程指南)
1. 收到開發(fā)板之后的第一件事把資源清單理清楚很多朋友拿到一塊新開發(fā)板第一反應(yīng)就是插USB線上電看燈亮不亮。這個(gè)習(xí)慣我強(qiáng)烈建議改掉。開發(fā)板不是手機(jī)隨手插電可能不會(huì)爆炸但大概率會(huì)讓你在第一步就走彎路。我經(jīng)手過的板子從十幾塊的ESP32-C3到幾千塊的FPGAARM異構(gòu)板卡都有總結(jié)下來正確順序應(yīng)該是先理資料再上電最后才是寫代碼。尤其是像合宙Air202 S6、粵嵌GEC6818、Radxa Rock 5B這類帶完整配套資料包的板子出廠附帶的《用戶手冊》《原理圖》《燒錄工具》這三樣?xùn)|西決定了你后面要花一小時(shí)還是一星期。1.1 資料包整理的三個(gè)核心文件夾建議你在電腦上建一個(gè)以“板卡型號日期”命名的總目錄下面分三個(gè)子目錄官方資料用戶手冊、數(shù)據(jù)手冊Datasheet、原理圖Schematic、PCB封裝庫這些文件優(yōu)先存放不要改動(dòng)文件名。工具鏈燒錄工具、串口驅(qū)動(dòng)、交叉編譯鏈、IDE安裝包注意記錄版本號因?yàn)槟承浌ぞ咧患嫒萏囟ò姹镜墓碳４a例程官方Demo、出廠測試代碼、網(wǎng)友分享的工程建議附帶一個(gè)README文件記錄來源鏈接和驗(yàn)證結(jié)果。這里有個(gè)容易忽略的細(xì)節(jié)很多板卡廠商的資料包下載鏈接是有時(shí)效性的比如某些國產(chǎn)模組廠商的云盤鏈接可能半年就失效。拿到板子當(dāng)天先把所有資料下載到本地備份這一步能幫你省掉后面求人的尷尬。1.2 結(jié)合熱點(diǎn)型號看看你手里的板子屬于哪一類最近熱搜里出現(xiàn)頻率很高的幾款板子剛好代表了開發(fā)板的三種典型定位搞清楚自己的板子屬于哪一類后續(xù)的學(xué)習(xí)路徑完全不同。板卡型號核心定位典型應(yīng)用場景ESP32-S3、ESP32-CAMWi-Fi/藍(lán)牙物聯(lián)網(wǎng)智能家居、圖像采集、MQTT網(wǎng)關(guān)合宙Air202 S64G Cat.1蜂窩通信定位器、DTU數(shù)傳、共享設(shè)備STM32F407ZET6、GEC6818傳統(tǒng)嵌入式MCU/核心板工業(yè)控制、人機(jī)交互、驅(qū)動(dòng)開發(fā)i.MX6ULL、RK3506、Rock 5BLinux應(yīng)用處理器邊緣計(jì)算、網(wǎng)關(guān)、多媒體終端Zynq-7100、AXU15EGPFPGAARM異構(gòu)SoC高速數(shù)據(jù)采集、軟件無線電、AI加速選板的時(shí)候別光盯著核心頻率和內(nèi)存大小看要看你可能用到的外設(shè)豐不豐富、官方資料全不全、社區(qū)活躍度夠不夠。比如ESP32系列功耗和價(jià)格都親民樂鑫官方文檔寫得也很清楚而Zynq-7100這類異構(gòu)平臺(tái)光搞懂PS處理器系統(tǒng)和PL可編程邏輯的交互就要花不少時(shí)間新手慎入除非你導(dǎo)師或公司有明確項(xiàng)目需求。1.3 用手冊反推“板卡能力地圖”我一個(gè)比較受用的習(xí)慣是拿到手冊后先在紙上畫一張“能力地圖”。左邊寫處理器型號、主頻、內(nèi)存、Flash中間寫板載外設(shè)比如LED、按鍵、屏幕接口、攝像頭接口、傳感器右邊寫擴(kuò)展接口排針、排母、天線座、TF卡座。這一步只用花二十分鐘但之后查引腳、找外設(shè)、看復(fù)用關(guān)系時(shí)會(huì)順手非常多。特別提醒一點(diǎn)原理圖一定要看。哪怕是幾百塊的開發(fā)板原理圖上也會(huì)標(biāo)注清楚每個(gè)引腳的默認(rèn)功能、上下拉電阻、供電域劃分。像ESP32開發(fā)板原理圖拿到后先看供電部分——板載的AMS1117-3.3穩(wěn)壓芯片輸入輸出電容的容值決定著你外接大功率傳感器時(shí)的穩(wěn)定性。2. 硬件底子引腳、線序、電源這些“看不見的坑”開發(fā)板硬件層面有三大坑幾乎每個(gè)人都會(huì)踩一遍引腳線序搞錯(cuò)、供電不足、信號電平不匹配。前兩個(gè)問題在入門階段最致命輕則外設(shè)不工作重則燒毀板載芯片。2.1 排針引腳和線序以合宙Air202 S6的26Pin排針為例合宙Air202 S6作為一款4G Cat.1模組板子兩側(cè)各有一排排針一共26Pin。這個(gè)26Pin不是隨便排列的里面藏著電源域和通信接口的邏輯。千萬別靠目測去插杜邦線一定要拿萬用表蜂鳴檔對著原理圖逐個(gè)打一遍。這排排針通常包含電源引腳VBAT主供電3.4V-4.2V、VCC_3.3VLDO輸出、GND多個(gè)GND是為了承載大電流返回路徑。通信引腳UART_TX、UART_RXAT指令通信、USB_DP、USB_DM、I2C、SPI、ADC輸入。控制引腳PWRKEY開機(jī)/關(guān)機(jī)鍵、RESET復(fù)位、GPIO擴(kuò)展。插線之前還要確認(rèn)排針的“1腳”位置一般板子上會(huì)用白色絲印標(biāo)注一個(gè)小方塊或數(shù)字“1”。沒有標(biāo)注時(shí)看排針下方PCB背面的焊盤形狀方形的往往是1腳。接線最忌諱憑記憶和目測老老實(shí)實(shí)用萬用表測一次比什么都強(qiáng)。2.2 供電設(shè)計(jì)USB供電的假象和真實(shí)電流需求很多開發(fā)板宣傳“USB供電即可”但這句話有兩層坑。第一層是USB口自身的輸出能力。電腦前置USB口經(jīng)常只有500mA而后置USB3.0理論上可以到900mA如果你外接了屏幕、攝像頭、4G模組瞬間電流可能超過1A就會(huì)出現(xiàn)“電腦USB口帶不動(dòng)板子反復(fù)重啟”的現(xiàn)象。我實(shí)測過Air202 S6在弱信號環(huán)境下4G射頻發(fā)射的峰值電流能到2A這種場景必須用5V/2A以上的獨(dú)立電源適配器或者直接給VBAT供4V鋰電。第二層是板載LDO低壓差線性穩(wěn)壓器的散熱和壓差問題。比如輸入5V、輸出3.3V的LDO壓差約1.7V電流1A時(shí)就意味著有1.7W的電能變成了熱量小板子根本散不出去。所以別把大功率外設(shè)全掛在板載3.3V引腳上重負(fù)載直接從5V取電3.3V只給邏輯電平使用。2.3 從ESP32原理圖看懂最小系統(tǒng)ESP32開發(fā)板的原理圖是入門最佳教材因?yàn)樗淖钚∠到y(tǒng)很清晰由這幾個(gè)部分組成電源USB 5V輸入 → 二極管防反接 → 穩(wěn)壓芯片轉(zhuǎn)3.3V → 多組0.1uF去耦電容并聯(lián)。時(shí)鐘一顆40MHz晶振配合兩顆負(fù)載電容通常22pF給芯片提供主時(shí)鐘。復(fù)位電路RESET引腳接一個(gè)10K上拉電阻到3.3V再串一個(gè)0.1uF電容到GND按下按鍵瞬間拉低實(shí)現(xiàn)低電平復(fù)位。啟動(dòng)模式配置GPIO0和EN使能引腳組合決定上電后進(jìn)入下載模式還是正常運(yùn)行模式。USB轉(zhuǎn)串口板載CP2102或CH340芯片把USB信號轉(zhuǎn)為UART信號。看懂這張圖你就理解了為什么“按著BOOT鍵再插電”能進(jìn)入下載模式——因?yàn)锽OOT鍵拉低了GPIO0。這不是魔法是芯片出廠固化的Boot ROM邏輯。掌握這個(gè)原理之后換任何一款新板子只要翻原理圖找啟動(dòng)配置引腳就能立刻知道怎么進(jìn)下載模式。2.4 電平不匹配3.3V和5V的不兼容問題單片機(jī)世界里3.3V和5V兩種邏輯電平并存是常態(tài)。ESP8266和STM32通信時(shí)STM32的IO如果是5V容忍如STM32F407的絕大多數(shù)IO可以直接相連但如果反向——3.3V器件接5V器件就很可能把3.3V芯片的IO口打壞。穩(wěn)妥的做法是加電平轉(zhuǎn)換芯片如TXB0108、雙向電平轉(zhuǎn)換模塊或者用串聯(lián)電阻分壓的方式降電平。別圖省事直接連一顆芯片的價(jià)格往往比你整個(gè)開發(fā)板還貴。3. 打通串口鏈路下載、調(diào)試、日志都靠它串口是開發(fā)板的“生命線”——燒錄固件、打印調(diào)試日志、執(zhí)行AT指令全都依賴串口通信。但串口鏈路恰恰是新手遇到問題最多的地方。很多人以為插上USB線就能看到日志結(jié)果設(shè)備管理器里根本沒有串口號心態(tài)直接崩掉。3.1 驅(qū)動(dòng)與端口識(shí)別先確認(rèn)USB轉(zhuǎn)串口芯片開發(fā)板上的USB口本質(zhì)上是一個(gè)USB轉(zhuǎn)串口芯片的接口。常見芯片有CH340、CP2102、FT232、PL2303等。不同的芯片需要不同的驅(qū)動(dòng)程序系統(tǒng)沒有預(yù)裝驅(qū)動(dòng)時(shí)設(shè)備管理器里會(huì)顯示一個(gè)帶黃色感嘆號的“未知設(shè)備”。你可以從板卡資料包里找到驅(qū)動(dòng)安裝包也可以直接搜芯片型號加“驅(qū)動(dòng)”兩個(gè)關(guān)鍵字。一個(gè)比較靠譜的經(jīng)驗(yàn)是安裝驅(qū)動(dòng)后一定要重啟一次電腦或重新插拔USB線讓系統(tǒng)重新枚舉設(shè)備。如果驅(qū)動(dòng)安裝正確設(shè)備管理器“端口(COM和LPT)”下面會(huì)出現(xiàn)類似“USB-SERIAL CH340 (COM3)”的字樣這個(gè)COM3就是串口號。注意USB口插在不同的物理接口上COM口號可能會(huì)變化。有時(shí)候代碼里寫死了COM3換了個(gè)口插就變成COM5導(dǎo)致燒錄失敗。最穩(wěn)妥的辦法是固定使用同一個(gè)USB口插開發(fā)板。3.2 TTL電平與USB轉(zhuǎn)串口模塊一根杜邦線的距離如果開發(fā)板上沒有板載USB轉(zhuǎn)串口芯片比如STM32最小系統(tǒng)板只引出TTL引腳你需要自己外接一個(gè)USB轉(zhuǎn)TTL模塊。這里有一個(gè)關(guān)鍵知識(shí)點(diǎn)USB轉(zhuǎn)TTL模塊上的“TX”要接開發(fā)板的“RX”“RX”接開發(fā)板的“TX”也就是交叉連接同時(shí)共地線GND接GND。TTL電平的標(biāo)準(zhǔn)是高電平接近3.3V或5V低電平接近0V。所以如果你的USB轉(zhuǎn)TTL模塊是5V供電的而你的開發(fā)板是3.3V邏輯建議選擇支持3.3V電平的模塊或者把模塊的跳線帽跳到3.3V檔位。否則5V高電平打進(jìn)3.3V芯片的串口引腳長期使用有燒毀風(fēng)險(xiǎn)。3.3 串口工具的選擇與配置別把波特率搞錯(cuò)串口工具我用過不少從古老的超級終端到SSCOM、PUTTY、MobaXterm、VSCode插件都有各有優(yōu)劣。對于簡單調(diào)試SSCOM或MobaXterm都夠用。配置串口時(shí)有三個(gè)參數(shù)必須正確波特率常見的有9600、115200、921600、1.5M等以代碼或芯片手冊為準(zhǔn)。大多數(shù)Linux開發(fā)板的默認(rèn)調(diào)試串口波特率是115200ESP32默認(rèn)波特率也是115200。數(shù)據(jù)位通常8位。停止位通常1位。校驗(yàn)位通常無。這三個(gè)參數(shù)任何一個(gè)設(shè)置錯(cuò)誤串口工具里就會(huì)看到滿屏亂碼或完全沒有輸出。而且還涉及到后面會(huì)提到的“終端中文亂碼”問題。3.4 實(shí)戰(zhàn)驗(yàn)證從空輸出到跑通日志第一次接通串口按下開發(fā)板復(fù)位鍵串口工具里如果沒有任何信息輸出不要急著懷疑板子壞了。按這個(gè)順序排查設(shè)備管理器中COM口號是否存在不存在則重新插拔。TX/RX是否交叉連接GND是否共地。波特率是否匹配。板子是否已經(jīng)燒錄了帶串口輸出的固件出廠固件不一定每塊板都帶打印。用萬用表量串口引腳的靜態(tài)電平正常空閑時(shí)TX引腳應(yīng)該是高電平3.3V。如果測量為0V說明芯片沒有正常工作可能沒供電、可能被拉低、可能芯片損壞。我遇到過一位朋友折騰一晚上沒輸出結(jié)果是因?yàn)樗腢SB轉(zhuǎn)TTL模塊的VCC和GND接反了模塊指示燈竟然還亮著——因?yàn)殚_發(fā)板上有保護(hù)二極管電流從GND灌進(jìn)去也能讓模塊的LED微亮但就是通信不了。所以模塊指示燈亮不代表接線正確別被錯(cuò)覺騙了。4. 燒錄與首次啟動(dòng)從點(diǎn)燈開始掌握完整流程串口鏈路通了下一步就是把固件燒進(jìn)開發(fā)板。燒錄這件事看著簡單實(shí)際上里面的門道比想象中的多。不同芯片方案的燒錄方式千差萬別ESP32用esptool或IDE一鍵燒錄STM32用STM32CubeProgrammer或Keil下載i.MX6ULL用SD卡或網(wǎng)絡(luò)燒錄Zynq用SDK下載bit流和FSBL。但不管哪一種底層邏輯都是先把芯片置于“下載模式”再通過特定接口傳輸固件數(shù)據(jù)。4.1 進(jìn)入下載模式的幾種路徑以ESP32系列為例前面提到按住BOOT鍵再上電就能進(jìn)入下載模式。實(shí)際細(xì)節(jié)是按住BOOT鍵即拉低GPIO0。按一下EN鍵復(fù)位此時(shí)芯片從Boot ROM啟動(dòng)檢測到GPIO0為低電平進(jìn)入下載模式。松開BOOT鍵。對于沒有EN鍵的板子可以拔插USB線替代復(fù)位操作。STM32的開發(fā)板則更簡單很多板子將一個(gè)BOOT0引腳拉高才能進(jìn)入ISP下載模式而使用ST-Link在線調(diào)試時(shí)調(diào)試器可以直接控制芯片復(fù)位和下載不需要手動(dòng)設(shè)置BOOT引腳。別把“下載模式”和“正常運(yùn)行模式”搞混。在下載模式下芯片不執(zhí)行用戶App代碼而是運(yùn)行出廠Bootloader接收數(shù)據(jù)所以燒錄時(shí)串口準(zhǔn)備就緒、燒錄完成后必須復(fù)位或重新上電芯片才會(huì)跳轉(zhuǎn)到用戶程序執(zhí)行。4.2 燒錄工具的選擇與參數(shù)不同芯片原廠都有官方燒錄工具ESP32官方用esptool.py命令行或通過Thonny、Arduino IDE、ESP-IDF一鍵燒錄。實(shí)際上esptool的關(guān)鍵參數(shù)是--chip esp32s3 --port COM3 --baud 921600 write_flash 0x0 bootloader.bin 0x8000 partitions.bin 0x10000 firmware.bin地址偏移必須和分區(qū)表對齊否則上電后找不到App表現(xiàn)為“串口有打印但系統(tǒng)反復(fù)重啟”。STM32ST官方STM32CubeProgrammer支持串口ISP和ST-LinkSWD/JTAG兩種方式。SWD只需要4根線SWDIO、SWCLK、GND、3.3V可選接線簡單速度遠(yuǎn)快于串口。i.MX6ULL使用NXP官方的NXP-MFG Tool通過USB OTG燒錄或者將鏡像寫入SD卡啟動(dòng)。SD卡燒錄流程是先把SD卡分區(qū)格式化再把u-boot、dtb、rootfs等鏡像用dd命令或balenaEtcher寫入對應(yīng)分區(qū)。我的經(jīng)驗(yàn)是能用官方工具就別用第三方工具。不是因?yàn)榈谌焦ぞ卟疃枪俜焦ぞ叩膮?shù)已經(jīng)默認(rèn)適配燒錄失敗時(shí)更容易排查。4.3 首次啟動(dòng)的觀察點(diǎn)燈、串口日志、網(wǎng)絡(luò)地址燒錄完成后按復(fù)位鍵重新上電。這時(shí)候你的注意力應(yīng)該放在三個(gè)觀察點(diǎn)上LED指示電源指示燈常亮代表供電正常狀態(tài)LED閃爍或常亮代表系統(tǒng)在運(yùn)行。如果板子上有多個(gè)LED查閱原理圖確認(rèn)每個(gè)LED的含義。串口日志波特率正確的前提下應(yīng)該看到芯片的啟動(dòng)信息。ESP32會(huì)打印“rst:0x1 (POWERON_RESET)”、“ets Jun 8 2016 00:22:57”之類的Bootloader信息然后加載App。i.MX6ULL的U-Boot會(huì)打印“U-Boot 2020.04”等版本信息引導(dǎo)Linux后還會(huì)打印內(nèi)核日志。網(wǎng)絡(luò)地址如果是聯(lián)網(wǎng)設(shè)備ESP32、ESP8266、Rock 5B等串口日志中會(huì)打印分配到的IP地址或者通過路由器管理界面查看設(shè)備是否上線。第一次啟動(dòng)出現(xiàn)任何異常輸出都值得截圖記錄。后續(xù)出問題時(shí)這些日志就是你排查的第一手證據(jù)。4.4 從點(diǎn)燈到串聯(lián)外設(shè)最小可行驗(yàn)證我一直推薦新手用“點(diǎn)燈”作為第一個(gè)程序不是因?yàn)楹唵味且驗(yàn)長ED亮滅的反饋?zhàn)钪庇^能確認(rèn)MCU的GPIO、時(shí)鐘、下載鏈路、代碼編譯環(huán)境全鏈路通暢。燈亮了至少說明編譯器工具鏈安裝正確且能編譯出可運(yùn)行的固件。燒錄鏈路通暢。板載晶振正常起振CPU能跑起來。GPIO引腳沒有短路損壞。點(diǎn)燈之后下一個(gè)建議是“串口回環(huán)”——板子收到一個(gè)字節(jié)再原樣發(fā)回上位機(jī)。這能順帶驗(yàn)證串口配置、中斷處理、緩沖區(qū)邏輯。兩步走完你的環(huán)境調(diào)試能力已經(jīng)比絕大多數(shù)初學(xué)者強(qiáng)了。5. 讓開發(fā)板和外部世界聯(lián)動(dòng)Ubuntu掛載、跨板通信與上位機(jī)很多開發(fā)板項(xiàng)目不是單板孤立的尤其是嵌入式Linux和物聯(lián)網(wǎng)場景。開發(fā)板要跟PC交換文件、跟其他MCU板通信、跟局域網(wǎng)內(nèi)的設(shè)備交互每一步都有固定套路今天我挑幾個(gè)高頻場景展開聊聊。5.1 開發(fā)板掛載UbuntuNFS和SSH是兩件套“開發(fā)板掛載Ubuntu”這個(gè)熱搜詞指的一般是兩種情況一是你在PC的Ubuntu上交叉編譯程序然后把可執(zhí)行文件放到開發(fā)板上運(yùn)行二是開發(fā)板通過網(wǎng)絡(luò)掛載PC上的Ubuntu共享目錄讓開發(fā)板直接讀取PC上的文件。前者常用SSH scp后者常用NFS或Samba。NFS的具體配置很簡單# 在Ubuntu主機(jī)上 sudo apt install nfs-kernel-server sudo mkdir -p /srv/nfs/rootfs sudo chown nobody:nogroup /srv/nfs/rootfs echo /srv/nfs/rootfs *(rw,sync,no_subtree_check,no_root_squash) | sudo tee -a /etc/exports sudo systemctl restart nfs-kernel-server# 在開發(fā)板上例如i.MX6ULL或RK3506的目標(biāo)系統(tǒng) mount -t nfs -o nolock 192.168.1.100:/srv/nfs/rootfs /mnt注意Windows防火墻、Ubuntu主機(jī)的IP地址、開發(fā)板與主機(jī)的網(wǎng)絡(luò)連通性。我剛開始總掛載不上排查了半天發(fā)現(xiàn)是主機(jī)和開發(fā)板不在同一個(gè)網(wǎng)段加上路由表配置后秒通。如果你的開發(fā)板和PC各自連著不同的Wi-Fi或路由器先統(tǒng)一網(wǎng)絡(luò)環(huán)境這是所有網(wǎng)絡(luò)功能的前提。SSH的配置更簡單開發(fā)板上如果有dropbear或openssh-server直接ssh root開發(fā)板IP登錄用scp傳文件比反復(fù)拔SD卡方便得多。5.2 ESP8266與STM32的串口通信案例很多項(xiàng)目要做“STM32采集數(shù)據(jù)ESP8266上云”這時(shí)候兩塊板子之間的通信就很重要。交叉正確接線之后還有三個(gè)容易出錯(cuò)的點(diǎn)電平匹配STM32F407的串口引腳是3.3V電平ESP8266也是3.3V直接連沒問題。如果換5V單片機(jī)比如老51必須加電平轉(zhuǎn)換。波特率匹配兩邊的串口波特率必須一致。通常選擇115200或9600考慮干擾環(huán)境9600更穩(wěn)。字符串協(xié)議約定兩邊必須約定好幀格式比如AA 55 0A 01 23 45 67 0D 0A前兩個(gè)字節(jié)為幀頭中間為數(shù)據(jù)末尾為校驗(yàn)和幀尾。協(xié)議不匹配時(shí)解碼端的表現(xiàn)是偶爾收到一兩個(gè)字節(jié)的亂碼然后又恢復(fù)正常這類問題很難查所以通信前先寫雙方都認(rèn)可的協(xié)議文檔。ESP8266側(cè)建議先通過串口調(diào)試助手單獨(dú)測試AT指令集聯(lián)網(wǎng)確認(rèn)Wi-Fi穩(wěn)定、TCP連接建立成功之后再和STM32接在一起。分步調(diào)試一次只解決一個(gè)問題這是嵌入式聯(lián)調(diào)最核心的方法論。5.3 ESP32-CAM的管理地址與局域網(wǎng)訪問ESP32-CAM這塊板子有意思它的板載串口芯片和攝像頭共用部分引腳所以“管理地址”這個(gè)概念讓很多人迷惑。所謂管理地址實(shí)際上是燒錄到ESP32-CAM里的固件運(yùn)行后板子在局域網(wǎng)中獲取到的IP地址。如果你燒錄的是官方出廠固件帶CameraWebServer例程串口波特率115200下啟動(dòng)日志會(huì)打印類似這樣的信息Camera Ready! Use http://192.168.1.24 to connect打開瀏覽器就能看到實(shí)時(shí)圖像。你可以在串口助手里看到這個(gè)IP地址也可以去路由器管理頁面的DHCP客戶端列表里找名為espressif或esp-cam的設(shè)備。沒有IP地址時(shí)優(yōu)先檢查三點(diǎn)Wi-Fi連接的SSID/密碼是否寫死對了、路由器是否開啟了AP隔離禁止客戶端互訪、板子附近的Wi-Fi信號強(qiáng)度是否足夠。尤其是AP隔離這個(gè)選項(xiàng)很多路由器默認(rèn)關(guān)閉但一旦開啟開發(fā)板就永遠(yuǎn)無法被手機(jī)或PC訪問而它自己卻以為自己聯(lián)網(wǎng)正常。5.4 Radxa Rock 5B的配置與上手測試Rock 5B是一塊RK3588方案的SBC性能已經(jīng)接近入門PC。它的上手流程和樹莓派很像但有幾個(gè)細(xì)節(jié)不同鏡像選擇官方提供Debian/Ubuntu鏡像下載后用balenaEtcher寫入SD卡或者寫入eMMC模塊。注意RK3588對電源要求更苛刻官方建議12V/2A或更高規(guī)格的DC適配器用劣質(zhì)電源會(huì)出現(xiàn)隨機(jī)死機(jī)或USB外設(shè)掉線。首次啟動(dòng)接上HDMI、鍵盤、網(wǎng)線上電開機(jī)正常會(huì)進(jìn)入桌面系統(tǒng)。若接HDMI無輸出檢查電源是否夠、是不是用了非標(biāo)準(zhǔn)HDMI轉(zhuǎn)接頭。配置檢查用cat /proc/cpuinfo查看核心數(shù)量free -h查看內(nèi)存lsusb查看USB設(shè)備識(shí)別情況。性能測試可以用glmark2跑OpenGL圖形性能用dd或fio測試存儲(chǔ)讀寫用iperf3測試網(wǎng)絡(luò)吞吐。這塊板子的調(diào)試串口在40Pin排針上需要USB轉(zhuǎn)TTL模塊但板子不焊排針需要自己焊接或用杜邦線頂住。買之前想清楚自己是拿它當(dāng)迷你Linux電腦還是做嵌入式底層的開發(fā)兩者對配件的需求差別很大。如果你只是想體驗(yàn)Linux桌面其實(shí)用Rock 5B這類SBC挺合適想深入理解設(shè)備樹、內(nèi)核驅(qū)動(dòng)那i.MX6ULL或RK3506的開發(fā)板更能練手。6. 終端顯示亂碼一個(gè)典型問題的完整排查鏈路熱搜詞里有一條“imx6ull開發(fā)板在屏幕終端中文顯示亂碼但是在MobaXterm可以顯示中文”。這個(gè)問題非常典型幾乎能串起嵌入式Linux開發(fā)中所有關(guān)于編碼、終端、字庫的知識(shí)點(diǎn)值得單獨(dú)拎出來講一遍完整的排查鏈路。6.1 問題復(fù)現(xiàn)與初步定位先在開發(fā)板本地終端比如通過HDMI接的顯示器、或板載LCD屏幕執(zhí)行echo 中文測試屏幕顯示亂碼而在MobaXterm的串口終端里執(zhí)行同樣命令中文正常。同樣是Linux同一塊板子為什么輸出不一樣首先要搞清楚“中文顯示”實(shí)際上需要三層都支持缺一不可系統(tǒng)里有中文字符集locale和字體。應(yīng)用軟件輸出UTF-8編碼的字符串。終端模擬器按照UTF-8解碼并加載了中文字體渲染。MobaXterm能在Windows上顯示中文說明它自帶或多字節(jié)字庫支持并默認(rèn)按UTF-8解析串口數(shù)據(jù)。本地屏幕亂碼說明三層里至少有一層斷了。6.2 三種常見根因分析根因一locale環(huán)境變量未配置用locale命令查看當(dāng)前系統(tǒng)語言設(shè)置。如果輸出是C或POSIX說明系統(tǒng)默認(rèn)沒有啟用UTF-8。臨時(shí)設(shè)置方法export LANGen_US.UTF-8 export LC_ALLen_US.UTF-8永久生效需要修改/etc/profile或/etc/locale.conf并執(zhí)行l(wèi)ocale-gen en_US.UTF-8。很多精簡版根文件系統(tǒng)沒有安裝語言包即使設(shè)置了locale也沒有對應(yīng)字庫。根因二終端模擬器缺中文字庫本地屏幕顯示用的不是MobaXterm而是Linux自帶的終端模擬器比如Qt的QTermWidget、或者fbterm/直接寫framebuffer的顯示程序。這些程序渲染中文需要系統(tǒng)有字體文件比如wqy-microhei.ttc或NotoSansCJK-Regular.ttc。檢查方式fc-list | grep -i CJK\|wenquanyi\|noto如果沒有輸出就是缺字體把字體文件放到/usr/share/fonts/下執(zhí)行fc-cache -f刷新。根因三終端編碼與實(shí)際字節(jié)流不匹配本地終端的編碼配置可能是GBK或Latin-1而程序輸出的是UTF-8字節(jié)流解碼錯(cuò)位就變成亂碼。檢查終端軟件的設(shè)置項(xiàng)把編碼強(qiáng)制改為UTF-8。MobaXterm能顯示中文恰恰是它默認(rèn)按UTF-8解碼。6.3 實(shí)操排查順序與驗(yàn)證我推薦的排查順序是先看locale再查字體最后檢查具體終端應(yīng)用的編碼設(shè)置。快速命令組合echo $LANG locale fc-list | grep -i CJK三條命令執(zhí)行完大概就能看出是哪一層斷了。還有一個(gè)隱蔽的問題如果應(yīng)用程序本身是用sprintf拼接的GBK編碼字符串比如某些國產(chǎn)嵌入式GUI框架默認(rèn)GBK而終端按UTF-8解碼同樣亂碼。這種屬于“輸出源頭編碼不對”要修改程序或做編碼轉(zhuǎn)換用iconv -f GBK -t UTF-8可以驗(yàn)證是否是這個(gè)原因。從這個(gè)案例里我想再強(qiáng)調(diào)一句經(jīng)驗(yàn)開發(fā)板上的“顯示中文”從來不只是程序代碼的事它是“編碼 字庫 終端 渲染”整條鏈路的系統(tǒng)工程。下次遇到任何顯示異常先按鏈路思維拆問題比自己悶頭改代碼高效得多。6.4 順手解決串口中文亂碼的其他技巧如果MobaXterm串口里也出現(xiàn)亂碼先檢查會(huì)話設(shè)置中“Encoding”是否為UTF-8。部分板卡廠商將調(diào)試串口默認(rèn)波特率設(shè)置為1500000或921600而MobaXterm默認(rèn)是115200。波特率錯(cuò)誤時(shí)中文和英文都會(huì)亂碼但亂碼形態(tài)不同。有的晶振有頻偏導(dǎo)致串口實(shí)際波特率和理論值有偏差表現(xiàn)為“偶爾亂碼、復(fù)位后恢復(fù)”可以用邏輯分析儀抓一下UART波形測量實(shí)際位寬。7. 從“能用”到“好用”我的開發(fā)板調(diào)試習(xí)慣沉淀寫完這么多技術(shù)細(xì)節(jié)最后回歸到方法論。開發(fā)板用久了你會(huì)發(fā)現(xiàn)真正讓你和別人拉開差距的往往不是多會(huì)寫幾行代碼而是調(diào)試習(xí)慣和工作方法。7.1 最小改動(dòng)原則與備份習(xí)慣我見過太多人拿到開發(fā)板第一件事就是改代碼改完編譯下載不對再改最后連官方Demo都被改得面目全非出了Bug都不知道是不是自己的鍋。正確的做法是時(shí)刻保持一個(gè)能運(yùn)行的基線版本。新板子燒錄的出廠固件通通拉出來備份為factory.bin。每次修改代碼之前用git或普通復(fù)制留一個(gè)備份。改一行、編譯、驗(yàn)證確認(rèn)無誤再繼續(xù)下一行。別一口氣改十行然后面對一堆編譯錯(cuò)誤無從下手。備份的顆粒度我個(gè)人是用“日期功能點(diǎn)”命名比如20250115_button_led。嵌入式項(xiàng)目Bug往往藏在“改了很久之后”有備份回溯就很快。7.2 建立自己的實(shí)驗(yàn)記錄模板記錄每一塊開發(fā)板的關(guān)鍵信息可以用一個(gè)簡單的表格也可以寫在個(gè)人Wiki、Notion或本地Markdown里字段大概是項(xiàng)目內(nèi)容板卡型號ESP32S3-DevKitC-1主控芯片ESP32-S3-WROOM-1板載串口芯片CP2102默認(rèn)串口波特率115200進(jìn)入下載模式方式按住BOOT再按EN燒錄工具esptool v4.5 / ESP-IDF v5.2調(diào)試串口引腳GPIO43 (TX), GPIO44 (RX)攝像頭接口OV2640/OV56408位DVP這塊兒是最容易被忽略的。每次重新搜“怎么進(jìn)下載模式”“串口連不上”都會(huì)浪費(fèi)半小時(shí)但記到自己的筆記里就只需要翻一次文檔。7.3 進(jìn)階路線從裸機(jī)到系統(tǒng)再到異構(gòu)計(jì)算最后聊一下后續(xù)可以怎么走。開發(fā)板這東西本質(zhì)是“麻雀雖小五臟俱全”的微縮計(jì)算機(jī)系統(tǒng)。入門階段用ESP32、STM32跑裸機(jī)或RTOS能讓你理解寄存器、中斷、外設(shè)驅(qū)動(dòng)進(jìn)階階段用i.MX6ULL、RK3506跑Linux能讓你掌握設(shè)備樹、內(nèi)核模塊、交叉編譯、文件系統(tǒng)再往上就是Zynq-7100、AXU15EGP這類FPGAARM異構(gòu)平臺(tái)那里是并行的世界硬件邏輯和軟件協(xié)同設(shè)計(jì)。每一步進(jìn)階都在用到前面積累的串口、燒錄、網(wǎng)絡(luò)、排錯(cuò)能力。所以我的建議很簡單把每一塊板子的基礎(chǔ)流程吃透記錄下踩過的坑形成自己的工具箱。遇到新板子按這套流程走——理資料、看原理圖、通串口、燒固件、跑Demo、連網(wǎng)絡(luò)、查日志——基本都能在兩三天內(nèi)從零跑到可用狀態(tài)這才是“完整的開發(fā)板使用流程”沉淀下來的最終價(jià)值。 開發(fā)板從零到實(shí)戰(zhàn)：資料整理、串口燒錄與網(wǎng)絡(luò)聯(lián)調(diào)全流程指南
1. 收到開發(fā)板之后的第一件事把資源清單理清楚很多朋友拿到一塊新開發(fā)板第一反應(yīng)就是插USB線上電看燈亮不亮。這個(gè)習(xí)慣我強(qiáng)烈建議改掉。開發(fā)板不是手機(jī)隨手插電可能不會(huì)爆炸但大概率會(huì)讓你在第一步就走彎路。我經(jīng)手過的板子從十幾塊的ESP32-C3到幾千塊的FPGAARM異構(gòu)板卡都有總結(jié)下來正確順序應(yīng)該是先理資料再上電最后才是寫代碼。尤其是像合宙Air202 S6、粵嵌GEC6818、Radxa Rock 5B這類帶完整配套資料包的板子出廠附帶的《用戶手冊》《原理圖》《燒錄工具》這三樣?xùn)|西決定了你后面要花一小時(shí)還是一星期。1.1 資料包整理的三個(gè)核心文件夾建議你在電腦上建一個(gè)以“板卡型號日期”命名的總目錄下面分三個(gè)子目錄官方資料用戶手冊、數(shù)據(jù)手冊Datasheet、原理圖Schematic、PCB封裝庫這些文件優(yōu)先存放不要改動(dòng)文件名。工具鏈燒錄工具、串口驅(qū)動(dòng)、交叉編譯鏈、IDE安裝包注意記錄版本號因?yàn)槟承浌ぞ咧患嫒萏囟ò姹镜墓碳４a例程官方Demo、出廠測試代碼、網(wǎng)友分享的工程建議附帶一個(gè)README文件記錄來源鏈接和驗(yàn)證結(jié)果。這里有個(gè)容易忽略的細(xì)節(jié)很多板卡廠商的資料包下載鏈接是有時(shí)效性的比如某些國產(chǎn)模組廠商的云盤鏈接可能半年就失效。拿到板子當(dāng)天先把所有資料下載到本地備份這一步能幫你省掉后面求人的尷尬。1.2 結(jié)合熱點(diǎn)型號看看你手里的板子屬于哪一類最近熱搜里出現(xiàn)頻率很高的幾款板子剛好代表了開發(fā)板的三種典型定位搞清楚自己的板子屬于哪一類后續(xù)的學(xué)習(xí)路徑完全不同。板卡型號核心定位典型應(yīng)用場景ESP32-S3、ESP32-CAMWi-Fi/藍(lán)牙物聯(lián)網(wǎng)智能家居、圖像采集、MQTT網(wǎng)關(guān)合宙Air202 S64G Cat.1蜂窩通信定位器、DTU數(shù)傳、共享設(shè)備STM32F407ZET6、GEC6818傳統(tǒng)嵌入式MCU/核心板工業(yè)控制、人機(jī)交互、驅(qū)動(dòng)開發(fā)i.MX6ULL、RK3506、Rock 5BLinux應(yīng)用處理器邊緣計(jì)算、網(wǎng)關(guān)、多媒體終端Zynq-7100、AXU15EGPFPGAARM異構(gòu)SoC高速數(shù)據(jù)采集、軟件無線電、AI加速選板的時(shí)候別光盯著核心頻率和內(nèi)存大小看要看你可能用到的外設(shè)豐不豐富、官方資料全不全、社區(qū)活躍度夠不夠。比如ESP32系列功耗和價(jià)格都親民樂鑫官方文檔寫得也很清楚而Zynq-7100這類異構(gòu)平臺(tái)光搞懂PS處理器系統(tǒng)和PL可編程邏輯的交互就要花不少時(shí)間新手慎入除非你導(dǎo)師或公司有明確項(xiàng)目需求。1.3 用手冊反推“板卡能力地圖”我一個(gè)比較受用的習(xí)慣是拿到手冊后先在紙上畫一張“能力地圖”。左邊寫處理器型號、主頻、內(nèi)存、Flash中間寫板載外設(shè)比如LED、按鍵、屏幕接口、攝像頭接口、傳感器右邊寫擴(kuò)展接口排針、排母、天線座、TF卡座。這一步只用花二十分鐘但之后查引腳、找外設(shè)、看復(fù)用關(guān)系時(shí)會(huì)順手非常多。特別提醒一點(diǎn)原理圖一定要看。哪怕是幾百塊的開發(fā)板原理圖上也會(huì)標(biāo)注清楚每個(gè)引腳的默認(rèn)功能、上下拉電阻、供電域劃分。像ESP32開發(fā)板原理圖拿到后先看供電部分——板載的AMS1117-3.3穩(wěn)壓芯片輸入輸出電容的容值決定著你外接大功率傳感器時(shí)的穩(wěn)定性。2. 硬件底子引腳、線序、電源這些“看不見的坑”開發(fā)板硬件層面有三大坑幾乎每個(gè)人都會(huì)踩一遍引腳線序搞錯(cuò)、供電不足、信號電平不匹配。前兩個(gè)問題在入門階段最致命輕則外設(shè)不工作重則燒毀板載芯片。2.1 排針引腳和線序以合宙Air202 S6的26Pin排針為例合宙Air202 S6作為一款4G Cat.1模組板子兩側(cè)各有一排排針一共26Pin。這個(gè)26Pin不是隨便排列的里面藏著電源域和通信接口的邏輯。千萬別靠目測去插杜邦線一定要拿萬用表蜂鳴檔對著原理圖逐個(gè)打一遍。這排排針通常包含電源引腳VBAT主供電3.4V-4.2V、VCC_3.3VLDO輸出、GND多個(gè)GND是為了承載大電流返回路徑。通信引腳UART_TX、UART_RXAT指令通信、USB_DP、USB_DM、I2C、SPI、ADC輸入。控制引腳PWRKEY開機(jī)/關(guān)機(jī)鍵、RESET復(fù)位、GPIO擴(kuò)展。插線之前還要確認(rèn)排針的“1腳”位置一般板子上會(huì)用白色絲印標(biāo)注一個(gè)小方塊或數(shù)字“1”。沒有標(biāo)注時(shí)看排針下方PCB背面的焊盤形狀方形的往往是1腳。接線最忌諱憑記憶和目測老老實(shí)實(shí)用萬用表測一次比什么都強(qiáng)。2.2 供電設(shè)計(jì)USB供電的假象和真實(shí)電流需求很多開發(fā)板宣傳“USB供電即可”但這句話有兩層坑。第一層是USB口自身的輸出能力。電腦前置USB口經(jīng)常只有500mA而后置USB3.0理論上可以到900mA如果你外接了屏幕、攝像頭、4G模組瞬間電流可能超過1A就會(huì)出現(xiàn)“電腦USB口帶不動(dòng)板子反復(fù)重啟”的現(xiàn)象。我實(shí)測過Air202 S6在弱信號環(huán)境下4G射頻發(fā)射的峰值電流能到2A這種場景必須用5V/2A以上的獨(dú)立電源適配器或者直接給VBAT供4V鋰電。第二層是板載LDO低壓差線性穩(wěn)壓器的散熱和壓差問題。比如輸入5V、輸出3.3V的LDO壓差約1.7V電流1A時(shí)就意味著有1.7W的電能變成了熱量小板子根本散不出去。所以別把大功率外設(shè)全掛在板載3.3V引腳上重負(fù)載直接從5V取電3.3V只給邏輯電平使用。2.3 從ESP32原理圖看懂最小系統(tǒng)ESP32開發(fā)板的原理圖是入門最佳教材因?yàn)樗淖钚∠到y(tǒng)很清晰由這幾個(gè)部分組成電源USB 5V輸入 → 二極管防反接 → 穩(wěn)壓芯片轉(zhuǎn)3.3V → 多組0.1uF去耦電容并聯(lián)。時(shí)鐘一顆40MHz晶振配合兩顆負(fù)載電容通常22pF給芯片提供主時(shí)鐘。復(fù)位電路RESET引腳接一個(gè)10K上拉電阻到3.3V再串一個(gè)0.1uF電容到GND按下按鍵瞬間拉低實(shí)現(xiàn)低電平復(fù)位。啟動(dòng)模式配置GPIO0和EN使能引腳組合決定上電后進(jìn)入下載模式還是正常運(yùn)行模式。USB轉(zhuǎn)串口板載CP2102或CH340芯片把USB信號轉(zhuǎn)為UART信號。看懂這張圖你就理解了為什么“按著BOOT鍵再插電”能進(jìn)入下載模式——因?yàn)锽OOT鍵拉低了GPIO0。這不是魔法是芯片出廠固化的Boot ROM邏輯。掌握這個(gè)原理之后換任何一款新板子只要翻原理圖找啟動(dòng)配置引腳就能立刻知道怎么進(jìn)下載模式。2.4 電平不匹配3.3V和5V的不兼容問題單片機(jī)世界里3.3V和5V兩種邏輯電平并存是常態(tài)。ESP8266和STM32通信時(shí)STM32的IO如果是5V容忍如STM32F407的絕大多數(shù)IO可以直接相連但如果反向——3.3V器件接5V器件就很可能把3.3V芯片的IO口打壞。穩(wěn)妥的做法是加電平轉(zhuǎn)換芯片如TXB0108、雙向電平轉(zhuǎn)換模塊或者用串聯(lián)電阻分壓的方式降電平。別圖省事直接連一顆芯片的價(jià)格往往比你整個(gè)開發(fā)板還貴。3. 打通串口鏈路下載、調(diào)試、日志都靠它串口是開發(fā)板的“生命線”——燒錄固件、打印調(diào)試日志、執(zhí)行AT指令全都依賴串口通信。但串口鏈路恰恰是新手遇到問題最多的地方。很多人以為插上USB線就能看到日志結(jié)果設(shè)備管理器里根本沒有串口號心態(tài)直接崩掉。3.1 驅(qū)動(dòng)與端口識(shí)別先確認(rèn)USB轉(zhuǎn)串口芯片開發(fā)板上的USB口本質(zhì)上是一個(gè)USB轉(zhuǎn)串口芯片的接口。常見芯片有CH340、CP2102、FT232、PL2303等。不同的芯片需要不同的驅(qū)動(dòng)程序系統(tǒng)沒有預(yù)裝驅(qū)動(dòng)時(shí)設(shè)備管理器里會(huì)顯示一個(gè)帶黃色感嘆號的“未知設(shè)備”。你可以從板卡資料包里找到驅(qū)動(dòng)安裝包也可以直接搜芯片型號加“驅(qū)動(dòng)”兩個(gè)關(guān)鍵字。一個(gè)比較靠譜的經(jīng)驗(yàn)是安裝驅(qū)動(dòng)后一定要重啟一次電腦或重新插拔USB線讓系統(tǒng)重新枚舉設(shè)備。如果驅(qū)動(dòng)安裝正確設(shè)備管理器“端口(COM和LPT)”下面會(huì)出現(xiàn)類似“USB-SERIAL CH340 (COM3)”的字樣這個(gè)COM3就是串口號。注意USB口插在不同的物理接口上COM口號可能會(huì)變化。有時(shí)候代碼里寫死了COM3換了個(gè)口插就變成COM5導(dǎo)致燒錄失敗。最穩(wěn)妥的辦法是固定使用同一個(gè)USB口插開發(fā)板。3.2 TTL電平與USB轉(zhuǎn)串口模塊一根杜邦線的距離如果開發(fā)板上沒有板載USB轉(zhuǎn)串口芯片比如STM32最小系統(tǒng)板只引出TTL引腳你需要自己外接一個(gè)USB轉(zhuǎn)TTL模塊。這里有一個(gè)關(guān)鍵知識(shí)點(diǎn)USB轉(zhuǎn)TTL模塊上的“TX”要接開發(fā)板的“RX”“RX”接開發(fā)板的“TX”也就是交叉連接同時(shí)共地線GND接GND。TTL電平的標(biāo)準(zhǔn)是高電平接近3.3V或5V低電平接近0V。所以如果你的USB轉(zhuǎn)TTL模塊是5V供電的而你的開發(fā)板是3.3V邏輯建議選擇支持3.3V電平的模塊或者把模塊的跳線帽跳到3.3V檔位。否則5V高電平打進(jìn)3.3V芯片的串口引腳長期使用有燒毀風(fēng)險(xiǎn)。3.3 串口工具的選擇與配置別把波特率搞錯(cuò)串口工具我用過不少從古老的超級終端到SSCOM、PUTTY、MobaXterm、VSCode插件都有各有優(yōu)劣。對于簡單調(diào)試SSCOM或MobaXterm都夠用。配置串口時(shí)有三個(gè)參數(shù)必須正確波特率常見的有9600、115200、921600、1.5M等以代碼或芯片手冊為準(zhǔn)。大多數(shù)Linux開發(fā)板的默認(rèn)調(diào)試串口波特率是115200ESP32默認(rèn)波特率也是115200。數(shù)據(jù)位通常8位。停止位通常1位。校驗(yàn)位通常無。這三個(gè)參數(shù)任何一個(gè)設(shè)置錯(cuò)誤串口工具里就會(huì)看到滿屏亂碼或完全沒有輸出。而且還涉及到后面會(huì)提到的“終端中文亂碼”問題。3.4 實(shí)戰(zhàn)驗(yàn)證從空輸出到跑通日志第一次接通串口按下開發(fā)板復(fù)位鍵串口工具里如果沒有任何信息輸出不要急著懷疑板子壞了。按這個(gè)順序排查設(shè)備管理器中COM口號是否存在不存在則重新插拔。TX/RX是否交叉連接GND是否共地。波特率是否匹配。板子是否已經(jīng)燒錄了帶串口輸出的固件出廠固件不一定每塊板都帶打印。用萬用表量串口引腳的靜態(tài)電平正常空閑時(shí)TX引腳應(yīng)該是高電平3.3V。如果測量為0V說明芯片沒有正常工作可能沒供電、可能被拉低、可能芯片損壞。我遇到過一位朋友折騰一晚上沒輸出結(jié)果是因?yàn)樗腢SB轉(zhuǎn)TTL模塊的VCC和GND接反了模塊指示燈竟然還亮著——因?yàn)殚_發(fā)板上有保護(hù)二極管電流從GND灌進(jìn)去也能讓模塊的LED微亮但就是通信不了。所以模塊指示燈亮不代表接線正確別被錯(cuò)覺騙了。4. 燒錄與首次啟動(dòng)從點(diǎn)燈開始掌握完整流程串口鏈路通了下一步就是把固件燒進(jìn)開發(fā)板。燒錄這件事看著簡單實(shí)際上里面的門道比想象中的多。不同芯片方案的燒錄方式千差萬別ESP32用esptool或IDE一鍵燒錄STM32用STM32CubeProgrammer或Keil下載i.MX6ULL用SD卡或網(wǎng)絡(luò)燒錄Zynq用SDK下載bit流和FSBL。但不管哪一種底層邏輯都是先把芯片置于“下載模式”再通過特定接口傳輸固件數(shù)據(jù)。4.1 進(jìn)入下載模式的幾種路徑以ESP32系列為例前面提到按住BOOT鍵再上電就能進(jìn)入下載模式。實(shí)際細(xì)節(jié)是按住BOOT鍵即拉低GPIO0。按一下EN鍵復(fù)位此時(shí)芯片從Boot ROM啟動(dòng)檢測到GPIO0為低電平進(jìn)入下載模式。松開BOOT鍵。對于沒有EN鍵的板子可以拔插USB線替代復(fù)位操作。STM32的開發(fā)板則更簡單很多板子將一個(gè)BOOT0引腳拉高才能進(jìn)入ISP下載模式而使用ST-Link在線調(diào)試時(shí)調(diào)試器可以直接控制芯片復(fù)位和下載不需要手動(dòng)設(shè)置BOOT引腳。別把“下載模式”和“正常運(yùn)行模式”搞混。在下載模式下芯片不執(zhí)行用戶App代碼而是運(yùn)行出廠Bootloader接收數(shù)據(jù)所以燒錄時(shí)串口準(zhǔn)備就緒、燒錄完成后必須復(fù)位或重新上電芯片才會(huì)跳轉(zhuǎn)到用戶程序執(zhí)行。4.2 燒錄工具的選擇與參數(shù)不同芯片原廠都有官方燒錄工具ESP32官方用esptool.py命令行或通過Thonny、Arduino IDE、ESP-IDF一鍵燒錄。實(shí)際上esptool的關(guān)鍵參數(shù)是--chip esp32s3 --port COM3 --baud 921600 write_flash 0x0 bootloader.bin 0x8000 partitions.bin 0x10000 firmware.bin地址偏移必須和分區(qū)表對齊否則上電后找不到App表現(xiàn)為“串口有打印但系統(tǒng)反復(fù)重啟”。STM32ST官方STM32CubeProgrammer支持串口ISP和ST-LinkSWD/JTAG兩種方式。SWD只需要4根線SWDIO、SWCLK、GND、3.3V可選接線簡單速度遠(yuǎn)快于串口。i.MX6ULL使用NXP官方的NXP-MFG Tool通過USB OTG燒錄或者將鏡像寫入SD卡啟動(dòng)。SD卡燒錄流程是先把SD卡分區(qū)格式化再把u-boot、dtb、rootfs等鏡像用dd命令或balenaEtcher寫入對應(yīng)分區(qū)。我的經(jīng)驗(yàn)是能用官方工具就別用第三方工具。不是因?yàn)榈谌焦ぞ卟疃枪俜焦ぞ叩膮?shù)已經(jīng)默認(rèn)適配燒錄失敗時(shí)更容易排查。4.3 首次啟動(dòng)的觀察點(diǎn)燈、串口日志、網(wǎng)絡(luò)地址燒錄完成后按復(fù)位鍵重新上電。這時(shí)候你的注意力應(yīng)該放在三個(gè)觀察點(diǎn)上LED指示電源指示燈常亮代表供電正常狀態(tài)LED閃爍或常亮代表系統(tǒng)在運(yùn)行。如果板子上有多個(gè)LED查閱原理圖確認(rèn)每個(gè)LED的含義。串口日志波特率正確的前提下應(yīng)該看到芯片的啟動(dòng)信息。ESP32會(huì)打印“rst:0x1 (POWERON_RESET)”、“ets Jun 8 2016 00:22:57”之類的Bootloader信息然后加載App。i.MX6ULL的U-Boot會(huì)打印“U-Boot 2020.04”等版本信息引導(dǎo)Linux后還會(huì)打印內(nèi)核日志。網(wǎng)絡(luò)地址如果是聯(lián)網(wǎng)設(shè)備ESP32、ESP8266、Rock 5B等串口日志中會(huì)打印分配到的IP地址或者通過路由器管理界面查看設(shè)備是否上線。第一次啟動(dòng)出現(xiàn)任何異常輸出都值得截圖記錄。后續(xù)出問題時(shí)這些日志就是你排查的第一手證據(jù)。4.4 從點(diǎn)燈到串聯(lián)外設(shè)最小可行驗(yàn)證我一直推薦新手用“點(diǎn)燈”作為第一個(gè)程序不是因?yàn)楹唵味且驗(yàn)長ED亮滅的反饋?zhàn)钪庇^能確認(rèn)MCU的GPIO、時(shí)鐘、下載鏈路、代碼編譯環(huán)境全鏈路通暢。燈亮了至少說明編譯器工具鏈安裝正確且能編譯出可運(yùn)行的固件。燒錄鏈路通暢。板載晶振正常起振CPU能跑起來。GPIO引腳沒有短路損壞。點(diǎn)燈之后下一個(gè)建議是“串口回環(huán)”——板子收到一個(gè)字節(jié)再原樣發(fā)回上位機(jī)。這能順帶驗(yàn)證串口配置、中斷處理、緩沖區(qū)邏輯。兩步走完你的環(huán)境調(diào)試能力已經(jīng)比絕大多數(shù)初學(xué)者強(qiáng)了。5. 讓開發(fā)板和外部世界聯(lián)動(dòng)Ubuntu掛載、跨板通信與上位機(jī)很多開發(fā)板項(xiàng)目不是單板孤立的尤其是嵌入式Linux和物聯(lián)網(wǎng)場景。開發(fā)板要跟PC交換文件、跟其他MCU板通信、跟局域網(wǎng)內(nèi)的設(shè)備交互每一步都有固定套路今天我挑幾個(gè)高頻場景展開聊聊。5.1 開發(fā)板掛載UbuntuNFS和SSH是兩件套“開發(fā)板掛載Ubuntu”這個(gè)熱搜詞指的一般是兩種情況一是你在PC的Ubuntu上交叉編譯程序然后把可執(zhí)行文件放到開發(fā)板上運(yùn)行二是開發(fā)板通過網(wǎng)絡(luò)掛載PC上的Ubuntu共享目錄讓開發(fā)板直接讀取PC上的文件。前者常用SSH scp后者常用NFS或Samba。NFS的具體配置很簡單# 在Ubuntu主機(jī)上 sudo apt install nfs-kernel-server sudo mkdir -p /srv/nfs/rootfs sudo chown nobody:nogroup /srv/nfs/rootfs echo /srv/nfs/rootfs *(rw,sync,no_subtree_check,no_root_squash) | sudo tee -a /etc/exports sudo systemctl restart nfs-kernel-server# 在開發(fā)板上例如i.MX6ULL或RK3506的目標(biāo)系統(tǒng) mount -t nfs -o nolock 192.168.1.100:/srv/nfs/rootfs /mnt注意Windows防火墻、Ubuntu主機(jī)的IP地址、開發(fā)板與主機(jī)的網(wǎng)絡(luò)連通性。我剛開始總掛載不上排查了半天發(fā)現(xiàn)是主機(jī)和開發(fā)板不在同一個(gè)網(wǎng)段加上路由表配置后秒通。如果你的開發(fā)板和PC各自連著不同的Wi-Fi或路由器先統(tǒng)一網(wǎng)絡(luò)環(huán)境這是所有網(wǎng)絡(luò)功能的前提。SSH的配置更簡單開發(fā)板上如果有dropbear或openssh-server直接ssh root開發(fā)板IP登錄用scp傳文件比反復(fù)拔SD卡方便得多。5.2 ESP8266與STM32的串口通信案例很多項(xiàng)目要做“STM32采集數(shù)據(jù)ESP8266上云”這時(shí)候兩塊板子之間的通信就很重要。交叉正確接線之后還有三個(gè)容易出錯(cuò)的點(diǎn)電平匹配STM32F407的串口引腳是3.3V電平ESP8266也是3.3V直接連沒問題。如果換5V單片機(jī)比如老51必須加電平轉(zhuǎn)換。波特率匹配兩邊的串口波特率必須一致。通常選擇115200或9600考慮干擾環(huán)境9600更穩(wěn)。字符串協(xié)議約定兩邊必須約定好幀格式比如AA 55 0A 01 23 45 67 0D 0A前兩個(gè)字節(jié)為幀頭中間為數(shù)據(jù)末尾為校驗(yàn)和幀尾。協(xié)議不匹配時(shí)解碼端的表現(xiàn)是偶爾收到一兩個(gè)字節(jié)的亂碼然后又恢復(fù)正常這類問題很難查所以通信前先寫雙方都認(rèn)可的協(xié)議文檔。ESP8266側(cè)建議先通過串口調(diào)試助手單獨(dú)測試AT指令集聯(lián)網(wǎng)確認(rèn)Wi-Fi穩(wěn)定、TCP連接建立成功之后再和STM32接在一起。分步調(diào)試一次只解決一個(gè)問題這是嵌入式聯(lián)調(diào)最核心的方法論。5.3 ESP32-CAM的管理地址與局域網(wǎng)訪問ESP32-CAM這塊板子有意思它的板載串口芯片和攝像頭共用部分引腳所以“管理地址”這個(gè)概念讓很多人迷惑。所謂管理地址實(shí)際上是燒錄到ESP32-CAM里的固件運(yùn)行后板子在局域網(wǎng)中獲取到的IP地址。如果你燒錄的是官方出廠固件帶CameraWebServer例程串口波特率115200下啟動(dòng)日志會(huì)打印類似這樣的信息Camera Ready! Use http://192.168.1.24 to connect打開瀏覽器就能看到實(shí)時(shí)圖像。你可以在串口助手里看到這個(gè)IP地址也可以去路由器管理頁面的DHCP客戶端列表里找名為espressif或esp-cam的設(shè)備。沒有IP地址時(shí)優(yōu)先檢查三點(diǎn)Wi-Fi連接的SSID/密碼是否寫死對了、路由器是否開啟了AP隔離禁止客戶端互訪、板子附近的Wi-Fi信號強(qiáng)度是否足夠。尤其是AP隔離這個(gè)選項(xiàng)很多路由器默認(rèn)關(guān)閉但一旦開啟開發(fā)板就永遠(yuǎn)無法被手機(jī)或PC訪問而它自己卻以為自己聯(lián)網(wǎng)正常。5.4 Radxa Rock 5B的配置與上手測試Rock 5B是一塊RK3588方案的SBC性能已經(jīng)接近入門PC。它的上手流程和樹莓派很像但有幾個(gè)細(xì)節(jié)不同鏡像選擇官方提供Debian/Ubuntu鏡像下載后用balenaEtcher寫入SD卡或者寫入eMMC模塊。注意RK3588對電源要求更苛刻官方建議12V/2A或更高規(guī)格的DC適配器用劣質(zhì)電源會(huì)出現(xiàn)隨機(jī)死機(jī)或USB外設(shè)掉線。首次啟動(dòng)接上HDMI、鍵盤、網(wǎng)線上電開機(jī)正常會(huì)進(jìn)入桌面系統(tǒng)。若接HDMI無輸出檢查電源是否夠、是不是用了非標(biāo)準(zhǔn)HDMI轉(zhuǎn)接頭。配置檢查用cat /proc/cpuinfo查看核心數(shù)量free -h查看內(nèi)存lsusb查看USB設(shè)備識(shí)別情況。性能測試可以用glmark2跑OpenGL圖形性能用dd或fio測試存儲(chǔ)讀寫用iperf3測試網(wǎng)絡(luò)吞吐。這塊板子的調(diào)試串口在40Pin排針上需要USB轉(zhuǎn)TTL模塊但板子不焊排針需要自己焊接或用杜邦線頂住。買之前想清楚自己是拿它當(dāng)迷你Linux電腦還是做嵌入式底層的開發(fā)兩者對配件的需求差別很大。如果你只是想體驗(yàn)Linux桌面其實(shí)用Rock 5B這類SBC挺合適想深入理解設(shè)備樹、內(nèi)核驅(qū)動(dòng)那i.MX6ULL或RK3506的開發(fā)板更能練手。6. 終端顯示亂碼一個(gè)典型問題的完整排查鏈路熱搜詞里有一條“imx6ull開發(fā)板在屏幕終端中文顯示亂碼但是在MobaXterm可以顯示中文”。這個(gè)問題非常典型幾乎能串起嵌入式Linux開發(fā)中所有關(guān)于編碼、終端、字庫的知識(shí)點(diǎn)值得單獨(dú)拎出來講一遍完整的排查鏈路。6.1 問題復(fù)現(xiàn)與初步定位先在開發(fā)板本地終端比如通過HDMI接的顯示器、或板載LCD屏幕執(zhí)行echo 中文測試屏幕顯示亂碼而在MobaXterm的串口終端里執(zhí)行同樣命令中文正常。同樣是Linux同一塊板子為什么輸出不一樣首先要搞清楚“中文顯示”實(shí)際上需要三層都支持缺一不可系統(tǒng)里有中文字符集locale和字體。應(yīng)用軟件輸出UTF-8編碼的字符串。終端模擬器按照UTF-8解碼并加載了中文字體渲染。MobaXterm能在Windows上顯示中文說明它自帶或多字節(jié)字庫支持并默認(rèn)按UTF-8解析串口數(shù)據(jù)。本地屏幕亂碼說明三層里至少有一層斷了。6.2 三種常見根因分析根因一locale環(huán)境變量未配置用locale命令查看當(dāng)前系統(tǒng)語言設(shè)置。如果輸出是C或POSIX說明系統(tǒng)默認(rèn)沒有啟用UTF-8。臨時(shí)設(shè)置方法export LANGen_US.UTF-8 export LC_ALLen_US.UTF-8永久生效需要修改/etc/profile或/etc/locale.conf并執(zhí)行l(wèi)ocale-gen en_US.UTF-8。很多精簡版根文件系統(tǒng)沒有安裝語言包即使設(shè)置了locale也沒有對應(yīng)字庫。根因二終端模擬器缺中文字庫本地屏幕顯示用的不是MobaXterm而是Linux自帶的終端模擬器比如Qt的QTermWidget、或者fbterm/直接寫framebuffer的顯示程序。這些程序渲染中文需要系統(tǒng)有字體文件比如wqy-microhei.ttc或NotoSansCJK-Regular.ttc。檢查方式fc-list | grep -i CJK\|wenquanyi\|noto如果沒有輸出就是缺字體把字體文件放到/usr/share/fonts/下執(zhí)行fc-cache -f刷新。根因三終端編碼與實(shí)際字節(jié)流不匹配本地終端的編碼配置可能是GBK或Latin-1而程序輸出的是UTF-8字節(jié)流解碼錯(cuò)位就變成亂碼。檢查終端軟件的設(shè)置項(xiàng)把編碼強(qiáng)制改為UTF-8。MobaXterm能顯示中文恰恰是它默認(rèn)按UTF-8解碼。6.3 實(shí)操排查順序與驗(yàn)證我推薦的排查順序是先看locale再查字體最后檢查具體終端應(yīng)用的編碼設(shè)置。快速命令組合echo $LANG locale fc-list | grep -i CJK三條命令執(zhí)行完大概就能看出是哪一層斷了。還有一個(gè)隱蔽的問題如果應(yīng)用程序本身是用sprintf拼接的GBK編碼字符串比如某些國產(chǎn)嵌入式GUI框架默認(rèn)GBK而終端按UTF-8解碼同樣亂碼。這種屬于“輸出源頭編碼不對”要修改程序或做編碼轉(zhuǎn)換用iconv -f GBK -t UTF-8可以驗(yàn)證是否是這個(gè)原因。從這個(gè)案例里我想再強(qiáng)調(diào)一句經(jīng)驗(yàn)開發(fā)板上的“顯示中文”從來不只是程序代碼的事它是“編碼 字庫 終端 渲染”整條鏈路的系統(tǒng)工程。下次遇到任何顯示異常先按鏈路思維拆問題比自己悶頭改代碼高效得多。6.4 順手解決串口中文亂碼的其他技巧如果MobaXterm串口里也出現(xiàn)亂碼先檢查會(huì)話設(shè)置中“Encoding”是否為UTF-8。部分板卡廠商將調(diào)試串口默認(rèn)波特率設(shè)置為1500000或921600而MobaXterm默認(rèn)是115200。波特率錯(cuò)誤時(shí)中文和英文都會(huì)亂碼但亂碼形態(tài)不同。有的晶振有頻偏導(dǎo)致串口實(shí)際波特率和理論值有偏差表現(xiàn)為“偶爾亂碼、復(fù)位后恢復(fù)”可以用邏輯分析儀抓一下UART波形測量實(shí)際位寬。7. 從“能用”到“好用”我的開發(fā)板調(diào)試習(xí)慣沉淀寫完這么多技術(shù)細(xì)節(jié)最后回歸到方法論。開發(fā)板用久了你會(huì)發(fā)現(xiàn)真正讓你和別人拉開差距的往往不是多會(huì)寫幾行代碼而是調(diào)試習(xí)慣和工作方法。7.1 最小改動(dòng)原則與備份習(xí)慣我見過太多人拿到開發(fā)板第一件事就是改代碼改完編譯下載不對再改最后連官方Demo都被改得面目全非出了Bug都不知道是不是自己的鍋。正確的做法是時(shí)刻保持一個(gè)能運(yùn)行的基線版本。新板子燒錄的出廠固件通通拉出來備份為factory.bin。每次修改代碼之前用git或普通復(fù)制留一個(gè)備份。改一行、編譯、驗(yàn)證確認(rèn)無誤再繼續(xù)下一行。別一口氣改十行然后面對一堆編譯錯(cuò)誤無從下手。備份的顆粒度我個(gè)人是用“日期功能點(diǎn)”命名比如20250115_button_led。嵌入式項(xiàng)目Bug往往藏在“改了很久之后”有備份回溯就很快。7.2 建立自己的實(shí)驗(yàn)記錄模板記錄每一塊開發(fā)板的關(guān)鍵信息可以用一個(gè)簡單的表格也可以寫在個(gè)人Wiki、Notion或本地Markdown里字段大概是項(xiàng)目內(nèi)容板卡型號ESP32S3-DevKitC-1主控芯片ESP32-S3-WROOM-1板載串口芯片CP2102默認(rèn)串口波特率115200進(jìn)入下載模式方式按住BOOT再按EN燒錄工具esptool v4.5 / ESP-IDF v5.2調(diào)試串口引腳GPIO43 (TX), GPIO44 (RX)攝像頭接口OV2640/OV56408位DVP這塊兒是最容易被忽略的。每次重新搜“怎么進(jìn)下載模式”“串口連不上”都會(huì)浪費(fèi)半小時(shí)但記到自己的筆記里就只需要翻一次文檔。7.3 進(jìn)階路線從裸機(jī)到系統(tǒng)再到異構(gòu)計(jì)算最后聊一下后續(xù)可以怎么走。開發(fā)板這東西本質(zhì)是“麻雀雖小五臟俱全”的微縮計(jì)算機(jī)系統(tǒng)。入門階段用ESP32、STM32跑裸機(jī)或RTOS能讓你理解寄存器、中斷、外設(shè)驅(qū)動(dòng)進(jìn)階階段用i.MX6ULL、RK3506跑Linux能讓你掌握設(shè)備樹、內(nèi)核模塊、交叉編譯、文件系統(tǒng)再往上就是Zynq-7100、AXU15EGP這類FPGAARM異構(gòu)平臺(tái)那里是并行的世界硬件邏輯和軟件協(xié)同設(shè)計(jì)。每一步進(jìn)階都在用到前面積累的串口、燒錄、網(wǎng)絡(luò)、排錯(cuò)能力。所以我的建議很簡單把每一塊板子的基礎(chǔ)流程吃透記錄下踩過的坑形成自己的工具箱。遇到新板子按這套流程走——理資料、看原理圖、通串口、燒固件、跑Demo、連網(wǎng)絡(luò)、查日志——基本都能在兩三天內(nèi)從零跑到可用狀態(tài)這才是“完整的開發(fā)板使用流程”沉淀下來的最終價(jià)值。