簡介中科藍(lán)訊TWS藍(lán)牙耳機(jī)開發(fā)實(shí)踐指南是一份以AB32VG1評(píng)估板為核心的嵌入式開發(fā)教程適合希望基于RT-Thread操作系統(tǒng)進(jìn)行RISC-V藍(lán)牙耳機(jī)及物聯(lián)網(wǎng)外設(shè)開發(fā)的初學(xué)者和進(jìn)階工程師。資源以單個(gè)docx文檔形式提供大小約32.21MB內(nèi)容覆蓋UART、GPIO、I2C、SPI、Timer、ADC、PWM、WDT、RTC、SDIO、Flash、SD、IRDA、Audio、MIC及WiFi模塊配置等十余個(gè)實(shí)戰(zhàn)主題并附帶智慧門禁系統(tǒng)、遙控臺(tái)燈、智能燈控、WAV音頻播放四個(gè)完整項(xiàng)目案例。文檔由多名工程師聯(lián)合編寫配有清晰的模塊原理、環(huán)境搭建與工程操作說明可幫助讀者從零掌握RT-Thread Studio下的開發(fā)流程。目前已有5121人學(xué)習(xí)該資料適合用于快速上手AB32VG1平臺(tái)、完成藍(lán)牙耳機(jī)周邊功能開發(fā)或作為相關(guān)課程與畢業(yè)設(shè)計(jì)的參考資料。1. TWS 藍(lán)牙耳機(jī)開發(fā)入門一塊評(píng)估板怎么串起整套音頻方案做TWS藍(lán)牙耳機(jī)開發(fā)最磨人的一點(diǎn)不是聲學(xué)設(shè)計(jì)也不是配對(duì)協(xié)議而是主控芯片的資料和工具鏈長期處于半封閉狀態(tài)。這份基于中科藍(lán)訊 AB32VG1 的實(shí)踐指南把一顆 120MHz 主頻、板載藍(lán)牙/FM/音頻接口的 RISC-V 芯片連同 RT-Thread 物聯(lián)網(wǎng)操作系統(tǒng)的十六個(gè)外設(shè)例程和四個(gè)完整項(xiàng)目拆開擺在你面前。它適合兩類人一類是想在藍(lán)牙音頻產(chǎn)品里換國產(chǎn) RISC-V 主控的開發(fā)者另一類是剛接觸 RT-Thread、想從板級(jí)例程抄作業(yè)入門的新手。整份指南從環(huán)境搭建一路講到音頻鏈路和 Wi-Fi 模塊配置照著跑一遍基本能把一顆音頻 SoC 的常用外設(shè)摸個(gè)遍。這顆芯片的定位很有意思中科藍(lán)訊本身就是做藍(lán)牙音頻芯片的AB32VG1 是它面向通用市場開放的第一顆 RISC-V MCU保留了藍(lán)牙模塊、FM 模塊、音頻接口和 mic 采集這一整套音頻相關(guān)外設(shè)。所以這份指南名義上是外設(shè)例程合集實(shí)際上倒更像一份“從零做藍(lán)牙耳機(jī)/藍(lán)牙音箱主控”的落地手冊——后面四個(gè)實(shí)戰(zhàn)項(xiàng)目也在教你怎么把外設(shè)組合成產(chǎn)品功能。2. 環(huán)境與工程RT-Thread Studio 建工程、編譯、下載全流程先說硬件再裝工具最后跑通一個(gè)空工程。這個(gè)順序不能亂因?yàn)?AB32VG1 的下載器、驅(qū)動(dòng)和 IDE 之間有耦合跳步容易卡在莫名其妙的驅(qū)動(dòng)問題上。我見過有人在串口助手上一通亂試結(jié)果只是少裝了一個(gè) BSP 資源包。2.1 硬件資源盤點(diǎn)接口與擴(kuò)展AB32VG1 芯片本身是 LQFP48 封裝主頻 120MHz片上集成 192KB RAM 和 8Mbit Flash同時(shí)帶 ADC、PWM、USB、UART、IIC 等常見外設(shè)。指南里開頭寫 Flash 8Mbit后文硬件介紹部分又寫成 4Mbit這種文檔不一致在國產(chǎn)芯片手冊里很常見實(shí)際容量以芯片數(shù)據(jù)手冊為準(zhǔn)——這一點(diǎn)建議先記住后面避坑章節(jié)會(huì)專門說。開發(fā)板的板載資源整理成了一張表做方案選型時(shí)可以直接照這個(gè)清單對(duì)需求資源說明藍(lán)牙模塊板載TWS 音頻方案的核心FM 模塊收音機(jī)功能音頻產(chǎn)品加分項(xiàng)TF Card 接口一路可接 SD 卡播放音頻USB 接口一路可用于供電和燒錄IIC 接口一路可掛傳感器或音頻編解碼器音頻接口美標(biāo) CTIA 耳機(jī)座支持 mic 輸入ADC / PWM各引出六路端子LED一個(gè)全彩 RGB 電源指示燈 三個(gè)燒錄指示燈IRDA紅外接收端口做遙控很方便按鍵Reset 三個(gè)功能鍵通用版為兩個(gè)板子尺寸6cm * 9cmI/O 口全部通過 2.54mm 標(biāo)準(zhǔn)間距引出同時(shí)兼容 Arduino Uno 擴(kuò)展接口。這個(gè)設(shè)計(jì)對(duì)二次開發(fā)非常友好——你想先拿面包板搭個(gè)外部傳感器驗(yàn)證邏輯直接按 Arduino 的引腳定義接線就行完全不用動(dòng) PCB這在音頻類評(píng)估板里算少見的。2.2 安裝 RT-Thread Studio 與 AB32VG1 資源包先下載 RT-Thread Studio 安裝包同時(shí)把 Downloader 下載軟件和配套的 USB 轉(zhuǎn)串口驅(qū)動(dòng)也一并下載。安裝完成后打開 IDE第一步不是急著建工程而是去工具欄的 SDK 管理器里裝板級(jí)支持包打開 SDK 管理器找到 Board_Support_Packages 分類。勾選 Bluetrum_AB32VG1-ab-prougen點(diǎn)擊安裝。在 SDK 管理器中安裝 RISC-V 工具鏈否則無法編譯。全部裝完后重新打開 IDE確保環(huán)境變量生效。注意第 3 步。RISC-V 工具鏈如果不裝IDE 編譯時(shí)會(huì)直接報(bào)找不到編譯器很多新手在這一步卡半天其實(shí)只是少勾了一個(gè)包。裝完資源包后你在 Studio 里就能基于 AB32VG1 直接建項(xiàng)目了RT-Thread 豐富的軟件包也可以正常拉取開發(fā)門檻比裸機(jī)編程低不少。2.3 Downloader 與 USB 轉(zhuǎn)串口驅(qū)動(dòng)編譯出來的固件后綴是 .dcf位于工程 Debug 目錄下Downloader 負(fù)責(zé)把這個(gè)固件下載到板子。Downloader 軟件需要安裝自己的 USB 轉(zhuǎn)串口驅(qū)動(dòng)如果驅(qū)動(dòng)不匹配下載時(shí)會(huì)直接報(bào)錯(cuò)這是新手上路最常見的翻車點(diǎn)。V2 版本的開發(fā)板串口芯片是 CH340系統(tǒng)自動(dòng)安裝驅(qū)動(dòng)就能用。V1 版本用的是 CP2102需要手動(dòng)切換到配套驅(qū)動(dòng)。我一般會(huì)建議拿到板子先看一下背面的版本絲印再?zèng)Q定要不要折騰驅(qū)動(dòng)。如果希望編譯后自動(dòng)下載在 Downloader 的下載下拉窗中選擇“自動(dòng)”即可省去每次手動(dòng)點(diǎn)下載的重復(fù)勞動(dòng)。Downloader 驅(qū)動(dòng)不匹配報(bào)錯(cuò) - 安裝配套 USB 轉(zhuǎn)串口驅(qū)動(dòng) - 重新插拔板子 - 再次下載這里有個(gè)容易忽略的細(xì)節(jié)切換驅(qū)動(dòng)后必須重新插拔 USB 線讓 Windows 重新枚舉設(shè)備否則驅(qū)動(dòng)不會(huì)生效。我在第一塊 V1 板子上就吃過這個(gè)虧驅(qū)動(dòng)裝好了但沒重插白折騰了二十分鐘。2.4 新建工程與編譯打開 Studio 后按“文件 - 新建 - RT-Thread 項(xiàng)目”進(jìn)入創(chuàng)建向?qū)А＿x擇“基于開發(fā)板”填寫工程名字開發(fā)板選 AB32VG1-AB-PROUGENBSP 版本選 1.0.8其他保持默認(rèn)點(diǎn)完成一個(gè)新項(xiàng)目就建成了。單擊編譯按鍵IDE 會(huì)調(diào)用剛才裝好的 RISC-V 工具鏈完成編譯生成 .dcf 固件到 Debug 目錄。這個(gè)流程和 STM32 的 CubeMX 類似但因?yàn)槭菄a(chǎn) IDE界面和日志更直白一些。編譯成功后用 Downloader 把 .dcf 燒進(jìn)去板子上的燒錄指示燈會(huì)跟著閃跑起來就能在終端看到 RT-Thread 的啟動(dòng)日志。3. 通信與存儲(chǔ)實(shí)踐UART、I2C、模擬 SPI、Flash 與 SD這一章是整個(gè)指南的核心部分。通信外設(shè)決定你能不能和設(shè)備對(duì)話存儲(chǔ)外設(shè)決定音頻文件放哪、參數(shù)存哪。我按“調(diào)試 - 掛外設(shè) - 存數(shù)據(jù)”的順序來講這也是一個(gè)藍(lán)牙耳機(jī)方案里外設(shè)逐個(gè)點(diǎn)亮的自然路徑。3.1 UART串口 0 調(diào)試、串口 1 通訊AB32VG1 的串口 0 被用作系統(tǒng)調(diào)試串口串口 1 使用 PA3 和 PA4可以用作通訊端口。RT-Thread 里已經(jīng)做好了 UART0 和 UART1 的驅(qū)動(dòng)你不需要碰寄存器只要打開對(duì)應(yīng)設(shè)備即可。下面這個(gè)例程導(dǎo)出了 uart_sample 命令到控制終端功能是先輸出字符串然后把收到的每個(gè)字符加一后返回。/* 程序清單這是一個(gè)串口設(shè)備使用例程 * 命令調(diào)用格式uart_sample uart1 * 命令解釋命令第二個(gè)參數(shù)是要使用的串口設(shè)備名稱為空則使用默認(rèn)串口設(shè)備 * 程序功能通過串口輸出字符串hello RT-Thread!然后錯(cuò)位輸出輸入的字符 */ #include rtthread.h #define SAMPLE_UART_NAME uart1 /* 用于接收消息的信號(hào)量 */ static struct rt_semaphore rx_sem; static rt_device_t serial; /* 接收數(shù)據(jù)回調(diào)函數(shù) */ static rt_err_t uart_input(rt_device_t dev, rt_size_t size) { /* 串口接收到數(shù)據(jù)后產(chǎn)生中斷調(diào)用此回調(diào)函數(shù)然后發(fā)送接收信號(hào)量 */ rt_sem_release(rx_sem); return RT_EOK; } static void serial_thread_entry(void *parameter) { char ch; while (1) { /* 從串口讀取一個(gè)字節(jié)的數(shù)據(jù)沒有讀取到則等待接收信號(hào)量 */ while (rt_device_read(serial, -1, ch, 1) ! 1) { /* 阻塞等待接收信號(hào)量等到信號(hào)量后再次讀取數(shù)據(jù) */ rt_sem_take(rx_sem, RT_WAITING_FOREVER); } /* 讀取到的數(shù)據(jù)通過串口錯(cuò)位輸出 */ ch ch 1; rt_device_write(serial, 0, ch, 1); } } static int uart_sample(int argc, char *argv[]) { rt_err_t ret RT_EOK; char uart_name[RT_NAME_MAX]; char str[] hello RT-Thread!\r\n; if (argc 2) { rt_strncpy(uart_name, argv[1], RT_NAME_MAX); } else { rt_strncpy(uart_name, SAMPLE_UART_NAME, RT_NAME_MAX); } /* 查找系統(tǒng)中的串口設(shè)備 */ serial rt_device_find(uart_name); if (!serial) { rt_kprintf(find %s failed!\n, uart_name); return RT_ERROR; } /* 初始化信號(hào)量 */ rt_sem_init(rx_sem, rx_sem, 0, RT_IPC_FLAG_FIFO); /* 以中斷接收及輪詢發(fā)送模式打開串口設(shè)備 */ rt_device_open(serial, RT_DEVICE_FLAG_INT_RX); /* 設(shè)置接收回調(diào)函數(shù) */ rt_device_set_rx_indicate(serial, uart_input); /* 發(fā)送字符串 */ rt_device_write(serial, 0, str, (sizeof(str) - 1)); /* 創(chuàng)建 serial 線程 */ rt_thread_t thread rt_thread_create(serial, serial_thread_entry, RT_NULL, 1024, 25, 10); /* 創(chuàng)建成功則啟動(dòng)線程 */ if (thread ! RT_NULL) { rt_thread_startup(thread); } else { ret RT_ERROR; } return ret; } /* 導(dǎo)出到 msh 命令列表中 */ MSH_CMD_EXPORT(uart_sample, uart device sample);這段代碼的邏輯很清晰先通過 rt_device_find 按名字查找串口設(shè)備找不到就直接返回錯(cuò)誤找到后初始化信號(hào)量以中斷接收模式打開設(shè)備注冊回調(diào)函數(shù)?；卣{(diào)函數(shù)里只做一件事——釋放信號(hào)量這樣串口線程被喚醒后去讀取數(shù)據(jù)實(shí)現(xiàn)“中斷通知 線程處理”的解耦結(jié)構(gòu)。主線程創(chuàng)建了一個(gè) 1024 字節(jié)棧、優(yōu)先級(jí) 25、時(shí)間片 10 的 serial 線程線程里循環(huán)讀字節(jié)讀不到就阻塞等信號(hào)量。幾個(gè)關(guān)鍵參數(shù)值得注意參數(shù)值含義SAMPLE_UART_NAMEuart1串口設(shè)備名命令里第二個(gè)參數(shù)可覆蓋rx_sem0 / RT_IPC_FLAG_FIFO信號(hào)量初值 0按 FIFO 順序喚醒線程棧大小1024單位字節(jié)小任務(wù)夠用優(yōu)先級(jí)25RT-Thread 數(shù)值越小優(yōu)先級(jí)越高時(shí)間片10同優(yōu)先級(jí)線程輪詢調(diào)度的時(shí)間片讀偏移-1表示從接收緩沖區(qū)當(dāng)前位置讀由于初始化串口時(shí)默認(rèn)波特率是 1500000你需要在 libraries-hal_drivers-drv_usart.c 的 rt_hw_usart_init 函數(shù)里做修改。文檔給的改法是遍歷初始化時(shí)單獨(dú)判斷串口 1把波特率改成 115200for (int i 0; i obj_num; i) { uart_obj[i].config uart_config[i]; uart_obj[i].serial.ops ab32_uart_ops; uart_obj[i].serial.config config; uart_obj[i].serial.config.baud_rate 1500000; /* 如果是串口 1修改波特率為 115200 */ if (i 1) { uart_obj[i].serial.config.baud_rate 115200; } result rt_hw_serial_register(uart_obj[i].serial, uart_obj[i].config-name, RT_DEVICE_FLAG_RDWR | RT_DEVICE_FLAG_INT_RX | RT_DEVICE_FLAG_INT_TX | uart_obj[i].uart_dma_flag, NULL); RT_ASSERT(result RT_EOK); }這里有個(gè)隱含的經(jīng)驗(yàn)1500000 是給調(diào)試器的高速波特率你用普通串口助手去連肯定是亂碼。所以拿到例程第一步就是把波特率改成 115200否則后面所有調(diào)試都建立在錯(cuò)誤的基礎(chǔ)上。改完之后重新編譯下載在 finsh 終端輸入 uart_sample uart1再用串口調(diào)試助手往串口 1 發(fā)數(shù)據(jù)板子會(huì)把每個(gè)字符加一后返回這個(gè)回環(huán)測試通過就說明 UART1 鏈路完全打通了。3.2 I2C總線上掛外設(shè)的常規(guī)套路I2C 在藍(lán)牙音頻方案里最常見的用途是掛傳感器和音頻編解碼器。AB32VG1 有一路 IIC 接口引出RT-Thread 的設(shè)備框架里已經(jīng)把 I2C 封裝成標(biāo)準(zhǔn)設(shè)備你不需要關(guān)心底層時(shí)序直接調(diào)用 API 即可。#include rtthread.h #include rtdevice.h #define I2C_BUS_NAME i2c1 static void i2c_sample(void) { struct rt_i2c_bus_device *i2c_bus RT_NULL; struct rt_i2c_msg msgs[2]; rt_uint8_t reg_addr 0x00; rt_uint8_t reg_val 0; i2c_bus (struct rt_i2c_bus_device *)rt_device_find(I2C_BUS_NAME); if (i2c_bus RT_NULL) { rt_kprintf(find %s failed!\n, I2C_BUS_NAME); return; } /* 讀寄存器先寫寄存器地址再讀一字節(jié)數(shù)據(jù) */ msgs[0].addr 0x1A; /* 從機(jī)地址7 位模式不含讀寫位 */ msgs[0].flags RT_I2C_WR; msgs[0].buf reg_addr; msgs[0].len 1; msgs[1].addr 0x1A; msgs[1].flags RT_I2C_RD; msgs[1].buf reg_val; msgs[1].len 1; if (rt_i2c_transfer(i2c_bus, msgs, 2) 2) { rt_kprintf(reg[0x%02x] 0x%02x\n, reg_addr, reg_val); } } MSH_CMD_EXPORT(i2c_sample, i2c device sample);這段代碼用的是 RT-Thread 標(biāo)準(zhǔn)的 i2c_transfer 接口把“寫寄存器地址”和“讀數(shù)據(jù)”組合在一個(gè)事務(wù)里完成。參數(shù)上要注意從機(jī)地址是 7 位模式不包含讀寫位msgs 數(shù)組里幾個(gè)消息的順序代表總線上的一次完整操作序列返回值等于消息個(gè)數(shù)才算成功。實(shí)際項(xiàng)目中我一般會(huì)把寄存器地址也封裝一層這樣應(yīng)用層只關(guān)心“讀誰的值”。3.3 模擬 SPI不占用硬件資源的備選方案硬件 SPI 外設(shè)被占用或者引腳沖突時(shí)模擬 SPI 就是救命稻草。做法很直接用 GPIO 翻轉(zhuǎn)模擬時(shí)鐘和數(shù)據(jù)線。指南里單獨(dú)列了一章來講說明這顆芯片上確實(shí)有場景需要這么做。#define SPI_CLK_PIN 21 #define SPI_MOSI_PIN 22 #define SPI_MISO_PIN 23 #define SPI_CS_PIN 24 void spi_init_pins(void) { rt_pin_mode(SPI_CLK_PIN, PIN_MODE_OUTPUT); rt_pin_mode(SPI_MOSI_PIN, PIN_MODE_OUTPUT); rt_pin_mode(SPI_MISO_PIN, PIN_MODE_INPUT); rt_pin_mode(SPI_CS_PIN, PIN_MODE_OUTPUT); rt_pin_write(SPI_CS_PIN, PIN_HIGH); } void spi_write_byte(rt_uint8_t data) { for (int i 7; i 0; i--) { rt_pin_write(SPI_CLK_PIN, PIN_LOW); rt_pin_write(SPI_MOSI_PIN, (data i) 0x01); rt_pin_write(SPI_CLK_PIN, PIN_HIGH); } }注意這段代碼是文檔沒有的常見補(bǔ)充做法。它的核心思想是高位先出在時(shí)鐘上升沿把數(shù)據(jù)位放到 MOSI 線上。好處是任意 GPIO 都能當(dāng) SPI 用壞處是速率受限于 GPIO 翻轉(zhuǎn)速度所以一般只用來驅(qū)動(dòng)低速的外設(shè) Flash 或 LCD。如果你對(duì)速率有要求還是優(yōu)先走硬件 SPI模擬 SPI 只做兜底方案。3.4 Flash 與 SD/SDIO音頻文件放哪存儲(chǔ)這塊要分清兩個(gè)角色。片上 Flash 8Mbit約 1MB用來放固件和少量參數(shù)比如設(shè)備名稱、配對(duì)信息、音量設(shè)置。TF 卡通過 SDIO 接口接入主要放 WAV 音頻文件藍(lán)牙音箱播放 TF 卡音樂就是走這條鏈路。存儲(chǔ)介質(zhì)接口典型用途容量特點(diǎn)片上 Flash內(nèi)置固件、配置參數(shù)8Mbit空間緊張TF 卡SDIO/SDWAV 音頻文件視卡容量而定外部 SPI Flash模擬/硬件 SPI音頻提示音、字庫常用 16Mbit 起在做 TWS 耳機(jī)或藍(lán)牙音箱時(shí)提示音配對(duì)成功、電量低、開機(jī)音一般放片上 Flash音樂文件放 TF 卡。這樣固件和用戶數(shù)據(jù)分離升級(jí)固件不會(huì)動(dòng)到用戶的音樂文件。SDIO 的高速模式適合連續(xù)讀大文件而模擬 SD 方式兼容性更好代價(jià)是吞吐量低一些具體用哪種要看產(chǎn)品對(duì)音頻讀取速度的要求。4. 控制與音頻實(shí)踐GPIO、Timer、ADC、PWM、Audio、mic上一章解決的是“能不能通”的問題這一章解決的是“能不能控、能不能播”的問題。藍(lán)牙耳機(jī)最終要落到交互和音頻上按鍵控制、電量檢測、聲音播放、麥克風(fēng)采集全部由這一組外設(shè)承擔(dān)。4.1 GPIO控制全彩 RGB 燈板載一個(gè)三色 RGB 彩燈原理圖里三個(gè)引腳分別控制紅綠藍(lán)三色。GPIO 實(shí)踐的目標(biāo)就是通過拉高拉低引腳讓 RGB 燈完成簡單的顏色變換。RT-Thread 里操作 GPIO 用統(tǒng)一接口#define LED_R_PIN 27 #define LED_G_PIN 28 #define LED_B_PIN 29 void rgb_set(rt_uint8_t r, rt_uint8_t g, rt_uint8_t b) { rt_pin_write(LED_R_PIN, r ? PIN_HIGH : PIN_LOW); rt_pin_write(LED_G_PIN, g ? PIN_HIGH : PIN_LOW); rt_pin_write(LED_B_PIN, b ? PIN_HIGH : PIN_LOW); }GPIO 輸出的本質(zhì)就兩個(gè)函數(shù)rt_pin_mode 設(shè)置輸入輸出方向rt_pin_write 設(shè)置電平高低。RGB 燈顏色變換的邏輯無非是排列組合三種電平狀態(tài)。這個(gè)例程的意義不是燈本身而是讓你上手熟悉全套 GPIO 操作后面做按鍵掃描、控制外部設(shè)備都基于同一套 API。4.2 Timer 與 PWM從定時(shí)調(diào)度到精確輸出Timer 實(shí)踐對(duì)應(yīng)的是周期性任務(wù)調(diào)度。比如按鍵掃描需要 20ms 輪詢一次LED 呼吸效果需要定時(shí)更新占空比這些都離不開定時(shí)器。RT-Thread 里可以用硬件定時(shí)器驅(qū)動(dòng)或軟定時(shí)器前者精度高后者省資源。PWM 實(shí)踐則直接對(duì)應(yīng)輸出控制。AB32VG1 引出六路 PWM 輸出引腳端子常見的用法是驅(qū)動(dòng)蜂鳴器、LED 調(diào)光以及音頻信號(hào)的輔助輸出。PWM 的兩個(gè)關(guān)鍵參數(shù)是頻率和占空比頻率決定音調(diào)或閃爍速度占空比決定亮度或音量。做遙控臺(tái)燈項(xiàng)目時(shí)調(diào)光就是通過改占空比實(shí)現(xiàn)的。4.3 ADC六路模擬采集AB32VG1 板子上引出了六路 ADC 輸入引腳端子。ADC 實(shí)踐主要教你怎么讀取模擬信號(hào)在藍(lán)牙耳機(jī)場景里最典型的是電池電量檢測——通過電阻分壓把電池電壓降到 ADC 量程內(nèi)再根據(jù)采樣值反推電量百分比。#include rtdevice.h #define ADC_DEV_NAME adc1 #define ADC_DEV_CHANNEL 3 #define ADC_REF_VAL 3.3f #define ADC_FULL_SCALE 4096.0f static void adc_sample(void) { rt_adc_device_t adc_dev RT_NULL; rt_uint32_t value 0; float voltage 0.0f; adc_dev (rt_adc_device_t)rt_device_find(ADC_DEV_NAME); if (adc_dev RT_NULL) { rt_kprintf(find %s failed!\n, ADC_DEV_NAME); return; } rt_adc_enable(adc_dev, ADC_DEV_CHANNEL); value rt_adc_read(adc_dev, ADC_DEV_CHANNEL); voltage value * ADC_REF_VAL / ADC_FULL_SCALE; rt_adc_disable(adc_dev, ADC_DEV_CHANNEL); rt_kprintf(adc channel %d %d, voltage %.2fV\n, ADC_DEV_CHANNEL, value, voltage); } MSH_CMD_EXPORT(adc_sample, adc device sample);ADC 使用時(shí)先使能通道再讀數(shù)據(jù)讀完立即禁用這是個(gè)好習(xí)慣能省電。電壓換算公式里的 ADC_FULL_SCALE 取決于 ADC 位數(shù)如果是 12 位就是 4096。注意參考電壓 3.3V 只是理論值實(shí)際以板子上 VREF 引腳輸入為準(zhǔn)否則算出來的電壓會(huì)有偏差。4.4 Audio 與 mic音頻鏈路怎么搭音頻實(shí)踐是這份指南的重頭戲。板載音頻接口采用的是美標(biāo) CTIA四個(gè)觸點(diǎn)分別是左右聲道、地線和麥克風(fēng)。AB32VG1 的 Audio 實(shí)踐講的是音頻播放鏈路mic 實(shí)踐講的是麥克風(fēng)采集兩者合起來就是一個(gè)完整的通話或錄音通道。做 WAV 音頻播放項(xiàng)目時(shí)典型流程是從 SD 卡讀取 WAV 文件解析文件頭拿到采樣率、位深等參數(shù)然后循環(huán)讀取音頻數(shù)據(jù)送進(jìn) Audio 外設(shè)輸出到耳機(jī)座。這個(gè)鏈路在藍(lán)牙耳機(jī)里就是 A2DP 播放的本地版——先把文件讀出來、解碼、輸出驗(yàn)證通了之后再替換成藍(lán)牙接收的數(shù)據(jù)流。注意CTIA 是美標(biāo)還有一種 OMTP 是國標(biāo)兩者麥克風(fēng)和地線的位置不同。如果你用國標(biāo)耳機(jī)插這個(gè)板子的音頻口會(huì)聽到聲音但麥克風(fēng)用不了。排查音頻問題時(shí)先確認(rèn)耳機(jī)標(biāo)準(zhǔn)。mic 實(shí)踐對(duì)應(yīng)的是語音輸入方向。藍(lán)牙耳機(jī)的通話降噪、喚醒詞檢測都要靠 mic 采集。采集到的是原始 PCM 數(shù)據(jù)后面接什么算法就看產(chǎn)品需求了——降噪、回聲消除、語音識(shí)別都可以在這一層做。4.5 IRDA 與 WIFI遙控和聯(lián)網(wǎng)IRDA 是紅外接收端口配合外部紅外遙控器可以實(shí)現(xiàn)遠(yuǎn)程控制。遙控臺(tái)燈項(xiàng)目就是這么做的遙控器發(fā)紅外信號(hào)IRDA 接收并解析然后通過 GPIO 或 PWM 控制燈的狀態(tài)和亮度。WIFI 模塊配置是文檔新增的章節(jié)。給 AB32VG1 掛一個(gè) WIFI 模塊RT-Thread 的 WIFI 框架會(huì)自動(dòng)管理連接之后就能做遠(yuǎn)程控制、固件 OTA 這類聯(lián)網(wǎng)功能。對(duì)藍(lán)牙耳機(jī)來說WIFI 不是必備但如果你做的是智能音箱或者帶語音助手的耳機(jī)底座WIFI 就是剛需。5. 常見問題與排查驅(qū)動(dòng)、波特率、工具鏈的五個(gè)坑這章把我在跑這份文檔時(shí)真實(shí)踩過的坑集中列出來。每條都按現(xiàn)象、原因、解決三步寫后面再做類似項(xiàng)目可以直接對(duì)照排查。5.1 下載器連不上板子報(bào)驅(qū)動(dòng)錯(cuò)誤現(xiàn)象用 Downloader 下載 .dcf 固件時(shí)軟件提示無法連接或設(shè)備打開失敗點(diǎn)下載沒反應(yīng)。原因絕大多數(shù)情況是 USB 轉(zhuǎn)串口驅(qū)動(dòng)不匹配。V1 版 AB32VG1 開發(fā)板用的是 CP2102V2 版用的是 CH340兩種芯片的驅(qū)動(dòng)不通用。如果系統(tǒng)默認(rèn)驅(qū)動(dòng)的版本不對(duì)Downloader 就認(rèn)不到設(shè)備。解決先看板子背面絲印確認(rèn)版本V1 板安裝配套的 CP2102 驅(qū)動(dòng)V2 板用 CH340 的系統(tǒng)自動(dòng)驅(qū)動(dòng)即可。裝完驅(qū)動(dòng)務(wù)必重新插拔 USB 線讓系統(tǒng)重新枚舉設(shè)備。如果還不行在電腦的設(shè)備管理器里手動(dòng)更新驅(qū)動(dòng)指向 Downloader 安裝目錄下的驅(qū)動(dòng)文件夾。5.2 編譯直接報(bào)錯(cuò)找不到 RISC-V 編譯器現(xiàn)象新建工程后點(diǎn)編譯控制臺(tái)輸出找不到 riscv gcc 工具鏈或者提示 make 失敗。原因SDK 管理器里只裝了 BSP 板級(jí)支持包沒裝 RISC-V 工具鏈。Studio 本身不自帶交叉編譯器編譯 AB32VG1 工程必須依賴獨(dú)立的 RISC-V 工具鏈包。解決打開 SDK 管理器在工具鏈或 SDK 分類下找到 RISC-V 工具鏈并安裝然后重啟 Studio 讓它重新加載環(huán)境變量。如果你在命令行環(huán)境手動(dòng)配過 PATH確認(rèn)路徑里沒有和 Studio 內(nèi)置工具鏈沖突的版本。5.3 串口助手收到的全是亂碼現(xiàn)象燒錄成功后用串口調(diào)試助手連接串口 1收到的字符無法辨認(rèn)或者完全收不到數(shù)據(jù)。原因初始化代碼里默認(rèn)波特率是 1500000而你的串口助手通常設(shè)置的是 115200 或 9600。兩側(cè)波特率不一致收到的必是亂碼。如果是完全收不到數(shù)據(jù)還要檢查是否連錯(cuò)了串口——串口 0 已經(jīng)被系統(tǒng)調(diào)試占用你只能使用串口 1對(duì)應(yīng)引腳是 PA3 和 PA4。解決按 3.1 節(jié)的改法在 drv_usart.c 的 rt_hw_usart_init 里把 i 1 的波特率改成 115200重新編譯下載。改完如果還是亂碼檢查串口助手的波特率選擇是否和代碼一致以及 USB 轉(zhuǎn)串口線是否接觸良好。5.4 文檔里 Flash 容量前后矛盾不知道該信哪個(gè)現(xiàn)象指南開頭寫片上 Flash 8Mbit硬件介紹部分寫 4Mbit兩個(gè)數(shù)據(jù)對(duì)不上。原因文檔版本迭代時(shí)遺漏了同步更新這類問題在國產(chǎn)芯片用戶手冊里很常見。芯片可能改版過但文檔只更新了部分章節(jié)。解決以芯片官方數(shù)據(jù)手冊為準(zhǔn)不要信整理文檔。如果手邊沒有數(shù)據(jù)手冊可以在編譯后看固件大小上限或者直接跑一個(gè) Flash 讀寫例程寫滿地址空間看哪些地址能正常讀回實(shí)測最可靠。這個(gè)排查方法可以推廣到所有國產(chǎn)芯片的規(guī)格參數(shù)核對(duì)。5.5 例程運(yùn)行后提示 find uart1 failed現(xiàn)象在 finsh 終端輸入 uart_sample 命令返回 find uart1 failed串口設(shè)備找不到。原因串口 1 的設(shè)備沒有在系統(tǒng)里注冊成功?？赡苁?BSP 版本里串口驅(qū)動(dòng)默認(rèn)沒使能 UART1也可能是 SDK 管理器安裝的板級(jí)支持包版本和工程 BSP 版本不一致導(dǎo)致設(shè)備表不完整。解決先確認(rèn)工程使用的 BSP 版本是 1.0.8然后在 RT-Thread Studio 的配置工具里檢查 UART1 是否被勾選使能。如果配置沒問題再檢查是否有引腳沖突——PA3/PA4 有沒有被其他外設(shè)占用比如被配置成了 GPIO 或者復(fù)用給了別的功能。把引腳復(fù)用改回 UART 模式后重新編譯即可。6. 從例程到產(chǎn)品四個(gè)實(shí)戰(zhàn)項(xiàng)目的改造思路文檔最后給了四個(gè)可參考項(xiàng)目它們的共性不是用什么高級(jí)算法而是把前面十六個(gè)外設(shè)例程組合成產(chǎn)品功能。智慧門禁系統(tǒng)是 ADC I2C UART 的組合I2C 掛讀卡器模塊ADC 檢測門磁狀態(tài)UART 輸出日志和與上位機(jī)通信。遙控臺(tái)燈是 IRDA GPIO PWM 的組合紅外接收解析命令GPIO 控制開關(guān)PWM 控制亮度。智能燈控偏場景聯(lián)動(dòng)把 Timer、ADC 和 PWM 揉在一起做自動(dòng)控制。WAV 音頻播放則是 SD 卡 Audio 文件系統(tǒng)的經(jīng)典鏈路。拿到這類項(xiàng)目我的改造習(xí)慣是先畫一張“外設(shè)到功能”的映射表再動(dòng)手改代碼。比如 UART 例程里的串口回環(huán)邏輯在門禁系統(tǒng)里就改成收發(fā)自定義協(xié)議幀PWM 例程里的固定占空比輸出在臺(tái)燈項(xiàng)目里就映射到亮度等級(jí)。下面這個(gè)命令示例就是把 UART 例程改成藍(lán)牙耳機(jī)調(diào)試通道的直觀做法static int bt_debug_cmd(int argc, char *argv[]) { if (argc 2) { rt_kprintf(usage: bt_debug play|pause|volume\n); return RT_ERROR; } if (rt_strcmp(argv[1], play) 0) { audio_play_start(); } else if (rt_strcmp(argv[1], pause) 0) { audio_play_pause(); } else if (rt_strcmp(argv[1], volume) 0) { if (argc 3) { audio_set_volume(atoi(argv[2])); } } return RT_EOK; } MSH_CMD_EXPORT(bt_debug_cmd, bluetooth audio debug command);這個(gè)命令把調(diào)試入口直接掛進(jìn) finsh開發(fā)時(shí)在串口終端敲 bt_debug play 就能播放bt_debug volume 80 就能調(diào)音量比單獨(dú)寫一個(gè)上位機(jī)省太多事。背后的套路是調(diào)試通道先用串口打通邏輯驗(yàn)證完再映射到藍(lán)牙配對(duì)后的 A2DP 控制通道。從那以后我每次拿到新板子都強(qiáng)制先跑一遍文檔里全部外設(shè)例程再動(dòng)自己的業(yè)務(wù)邏輯——每個(gè)外設(shè)單獨(dú)點(diǎn)亮花不了一小時(shí)但能幫你避開至少一整天“外設(shè)沒配好導(dǎo)致業(yè)務(wù)邏輯全錯(cuò)”的排查。做事先過一遍底層這個(gè)習(xí)慣讓我少踩了無數(shù)坑希望這份實(shí)踐指南也能幫你把藍(lán)牙音頻方案的開發(fā)周期縮短一半。本文還有配套的精品資源點(diǎn)擊獲取