簡(jiǎn)介EmbeddedBuilder-v1.3.5.21587 是專(zhuān)為 GD32F 系列 MCU 打造的集成開(kāi)發(fā)工具面向從事工業(yè)控制、智能家居、物聯(lián)網(wǎng)等嵌入式方向的開(kāi)發(fā)者無(wú)論入門(mén)新手還是資深工程師都能借助它完成代碼編寫(xiě)、編譯、調(diào)試與項(xiàng)目管理。該版本為最新穩(wěn)定版內(nèi)建針對(duì) GD32F 優(yōu)化的 GCC 編譯器支持 C/C并集成 SWD、JTAG 在線調(diào)試能力可設(shè)置斷點(diǎn)、查看變量與讀寫(xiě)內(nèi)存。壓縮包為 7z 格式體積約 321.37MB內(nèi)含示例工程與輔助工具等模塊覆蓋基礎(chǔ)外設(shè)驅(qū)動(dòng)、RTOS 演示、網(wǎng)絡(luò)通信等場(chǎng)景便于快速上手與移植。目前已有 1553 人學(xué)習(xí)下載適合需要一站式搭建 GD32F 開(kāi)發(fā)環(huán)境、對(duì)照示例工程理解外設(shè)與庫(kù)用法的讀者參考使用。1. 從一次 Keil 工程遷移翻車(chē)說(shuō)起這套 GD32 工具鏈到底能不能接上周幫一個(gè)做工業(yè)控制的朋友處理老項(xiàng)目遷移他們?cè)居?Keil MDK 維護(hù)一套 GD32F303 的電機(jī)控制代碼結(jié)果新來(lái)的同事把工程文件路徑改成了中文編譯直接報(bào)找不到啟動(dòng)文件。折騰了一下午最后換用 EmbeddedBuilder-v1.3.5.21587 重新建工程才把問(wèn)題繞過(guò)去。這件事讓我意識(shí)到很多做嵌入式開(kāi)發(fā)的人對(duì) GD32 的官方工具鏈其實(shí)處于「聽(tīng)說(shuō)過(guò)但沒(méi)真用過(guò)」的狀態(tài)——知道有這么個(gè)東西但不確定它跟 Keil、IAR 到底什么關(guān)系能不能直接吃現(xiàn)有的源碼換過(guò)去要改多少東西。EmbeddedBuilder-v1.3.5.21587 是 GD32F 系列 MCU 的官方嵌入式開(kāi)發(fā)工具定位上屬于「配置 代碼生成 工程管理」三合一的 IDE 環(huán)境。它解決的核心問(wèn)題不是編譯本身而是 GD32F 系列芯片的外設(shè)初始化配置和工程框架搭建。適合兩類(lèi)人一是剛接觸 GD32F 系列、不想從零手寫(xiě)寄存器配置的開(kāi)發(fā)者二是手里有 GD32F 項(xiàng)目、想從 Keil/IAR 遷移到官方工具鏈的團(tuán)隊(duì)。如果你只是偶爾點(diǎn)個(gè)燈用 Keil 加標(biāo)準(zhǔn)庫(kù)也能跑但一旦涉及多外設(shè)協(xié)同、時(shí)鐘樹(shù)配置、中斷優(yōu)先級(jí)管理這套工具的圖形化配置優(yōu)勢(shì)就體現(xiàn)出來(lái)了。2. 工具鏈拆解EmbeddedBuilder 的工程結(jié)構(gòu)與 GD32F 固件庫(kù)依賴2.1 安裝包里到底裝了什么拿到 EmbeddedBuilder-v1.3.5.21587 的安裝包后先別急著雙擊下一步。我習(xí)慣先把安裝目錄結(jié)構(gòu)摸清楚因?yàn)楹竺娼üこ獭⑴渎窂?、調(diào)編譯器都跟這個(gè)有關(guān)。安裝完成后根目錄下通常有這么幾個(gè)關(guān)鍵文件夾目錄/文件作用是否必須保留eclipse/IDE 主體基于 Eclipse 框架是toolchain/集成的 GCC 工具鏈arm-none-eabi是plugins/GD32 芯片支持包和配置插件是workspace/默認(rèn)工作空間存放用戶工程可改路徑GD32FirmwareLib/GD32F 系列固件庫(kù)源碼建工程時(shí)引用這里有個(gè)容易忽略的點(diǎn)EmbeddedBuilder 本質(zhì)上是 Eclipse 加了一組 GD32 專(zhuān)用插件所以它的工程管理邏輯跟標(biāo)準(zhǔn) Eclipse 項(xiàng)目是一致的。這意味著你可以用 Eclipse 的那套快捷鍵、視圖布局、斷點(diǎn)管理但同時(shí)也意味著它的編譯系統(tǒng)走的是 GCC Makefile 那套跟 Keil 的 ARMCC 編譯鏈不是一回事。2.2 固件庫(kù)版本與芯片型號(hào)的對(duì)應(yīng)關(guān)系GD32F 系列固件庫(kù)分了好幾個(gè)分支F1、F3、F4、F5 各有一套。EmbeddedBuilder-v1.3.5.21587 安裝包里自帶的固件庫(kù)版本通常是 GD32F10x_Firmware_Library、GD32F30x_Firmware_Library 等。建工程時(shí)如果選錯(cuò)了固件庫(kù)版本編譯能過(guò)但運(yùn)行會(huì)出玄學(xué)問(wèn)題——比如串口波特率對(duì)不上、定時(shí)器周期差一倍。常見(jiàn)做法是先確認(rèn)你手上芯片的具體型號(hào)比如 GD32F303RCT6然后去安裝目錄的GD32FirmwareLib/下找對(duì)應(yīng)的文件夾。如果找不到完全匹配的選同系列同 Flash 容量的版本再手動(dòng)替換啟動(dòng)文件和鏈接腳本。# 查看安裝目錄下自帶的固件庫(kù)版本 ls -d $EMBEDDED_BUILDER_HOME/GD32FirmwareLib/GD32F* # 輸出示例 # GD32F10x_Firmware_Library GD32F30x_Firmware_Library # GD32F4xx_Firmware_Library GD32F5xx_Firmware_Library這段命令的作用是快速列出安裝包自帶的固件庫(kù)分支。$EMBEDDED_BUILDER_HOME需要替換成你的實(shí)際安裝路徑。如果輸出里沒(méi)有你需要的系列說(shuō)明這個(gè)版本的 EmbeddedBuilder 可能不帶該系列支持需要單獨(dú)下載固件庫(kù)包再手動(dòng)掛載。2.3 新建工程的正確姿勢(shì)很多人第一次用 EmbeddedBuilder 建工程習(xí)慣性地點(diǎn)「File → New → Project」然后選個(gè)空工程就開(kāi)始寫(xiě)代碼。這樣建出來(lái)的工程沒(méi)有芯片初始化代碼也沒(méi)有鏈接腳本編譯能過(guò)但燒進(jìn)去不跑。正確的流程是走「GD32 Project」向?qū)ile → New → GD32 Project → 選擇芯片系列如 GD32F30x → 選擇具體型號(hào)如 GD32F303RC → 選擇固件庫(kù)版本如 GD32F30x_Firmware_Library_V2.1.0 → 勾選需要的外設(shè)GPIO、USART、TIMER 等 → 設(shè)置時(shí)鐘源HXTAL 頻率、PLL 倍頻 → Finish向?qū)ё咄旰驣DE 會(huì)自動(dòng)生成main.c、gd32f30x_it.c、system_gd32f30x.c以及對(duì)應(yīng)的鏈接腳本.ld文件。這里的關(guān)鍵參數(shù)是時(shí)鐘源配置——HXTAL 頻率填錯(cuò)后面所有外設(shè)的時(shí)鐘都會(huì)跟著錯(cuò)。我一般會(huì)在生成后立刻打開(kāi)system_gd32f30x.c確認(rèn)__SYSTEM_CLOCK宏定義的值跟實(shí)際晶振匹配。注意向?qū)Ю锕催x的外設(shè)只是幫你生成初始化框架代碼具體的引腳復(fù)用、中斷優(yōu)先級(jí)、DMA 通道這些還是要在代碼里手動(dòng)配。別指望圖形化界面能一鍵搞定所有事。3. 從 Keil 遷移到 EmbeddedBuilder源碼兼容性與編譯鏈切換3.1 源碼層面的兼容性判斷Keil 工程里的源碼能不能直接搬到 EmbeddedBuilder 里用取決于你原來(lái)用的是標(biāo)準(zhǔn)外設(shè)庫(kù)還是寄存器直接操作。如果是標(biāo)準(zhǔn)外設(shè)庫(kù)gd32f30x_gpio.c、gd32f30x_usart.c這些基本可以原樣搬因?yàn)?EmbeddedBuilder 自帶的固件庫(kù)跟 Keil 下用的標(biāo)準(zhǔn)庫(kù)是同一套源碼只是編譯鏈不同。但如果你原來(lái)用的是寄存器直接賦值比如GPIOA_CTL0 0x...那就要注意 GD32 的寄存器定義在 GCC 和 ARMCC 下可能有細(xì)微差異常見(jiàn)的是位域結(jié)構(gòu)體的對(duì)齊方式不同。我一般會(huì)先做一次「空編譯」測(cè)試把 Keil 工程里的.c和.h文件全部拷到 EmbeddedBuilder 新建的工程里不急著改代碼先點(diǎn)編譯?？磮?bào)錯(cuò)類(lèi)型——如果是「undefined reference」說(shuō)明缺源文件或庫(kù)文件如果是「conflicting types」說(shuō)明頭文件包含順序有問(wèn)題如果是「section overflow」說(shuō)明鏈接腳本的 Flash/RAM 分配跟實(shí)際芯片不匹配。3.2 鏈接腳本的修改要點(diǎn)EmbeddedBuilder 生成的鏈接腳本.ld文件里Flash 起始地址和大小是按向?qū)Ю镞x的芯片型號(hào)自動(dòng)填的。但如果你從 Keil 遷移過(guò)來(lái)Keil 的分散加載文件.sct里的地址分配可能跟這個(gè)不一樣。常見(jiàn)的情況是Keil 工程里把 Bootloader 和 App 分成了兩個(gè)區(qū)App 從0x08004000開(kāi)始而 EmbeddedBuilder 默認(rèn)從0x08000000開(kāi)始。/* gd32f30x_flash.ld 片段 */ MEMORY { FLASH (rx) : ORIGIN 0x08000000, LENGTH 256K RAM (rwx) : ORIGIN 0x20000000, LENGTH 48K }上面是默認(rèn)配置。如果你需要把 App 放到0x08004000就把ORIGIN改成0x08004000同時(shí)LENGTH減去 16K。改完鏈接腳本后還要確認(rèn)system_gd32f30x.c里的VECT_TAB_OFFSET宏定義也跟著改否則中斷向量表偏移不對(duì)一進(jìn)中斷就跑飛。3.3 編譯鏈差異導(dǎo)致的坑Keil 用 ARMCCEmbeddedBuilder 用 GCC兩者對(duì) C 標(biāo)準(zhǔn)的支持程度和默認(rèn)行為有差異。最常見(jiàn)的翻車(chē)場(chǎng)景是printf重定向——Keil 下你可能用了#pragma import(__use_no_semihosting)和自定義fputc搬到 GCC 下這套不管用要改用_write或_write_r。/* GCC 下的 printf 重定向?qū)懛?*/ #include sys/stat.h #include unistd.h int _write(int file, char *ptr, int len) { int i; for (i 0; i len; i) { while (USART_CTL0(USART0) USART_CTL0_TBE) 0); USART_DATA(USART0) (uint8_t)ptr[i]; } return len; }這段代碼把標(biāo)準(zhǔn)庫(kù)的_write函數(shù)重定向到 USART0 上這樣printf就能通過(guò)串口輸出。注意USART_CTL0_TBE是發(fā)送緩沖區(qū)空標(biāo)志不同系列的 GD32 這個(gè)宏名字可能略有不同F(xiàn)30x 系列是USART_CTL0_TBEF10x 系列可能是USART_FLAG_TBE具體查對(duì)應(yīng)固件庫(kù)的頭文件。提示如果編譯時(shí)報(bào)_write重復(fù)定義檢查鏈接選項(xiàng)里有沒(méi)有加-specsnosys.specs或-specsnano.specs這兩個(gè)參數(shù)會(huì)影響標(biāo)準(zhǔn)庫(kù)的鏈接行為。4. 外設(shè)配置實(shí)戰(zhàn)用圖形化界面配 GPIO 和 USART 的邊界條件4.1 GPIO 配置的隱藏參數(shù)EmbeddedBuilder 的圖形化 GPIO 配置界面看起來(lái)很簡(jiǎn)單選引腳、選模式、選上下拉、選輸出速度。但有幾個(gè)參數(shù)在界面上不顯眼卻直接影響功能。比如「輸出速度」這一項(xiàng)默認(rèn)是 50MHz如果你驅(qū)動(dòng)的是低速外設(shè)比如繼電器用 50MHz 的翻轉(zhuǎn)速率反而會(huì)引入振鈴和 EMI 問(wèn)題。我一般會(huì)根據(jù)實(shí)際負(fù)載把速度降到 2MHz 或 10MHz。另一個(gè)容易忽略的是「復(fù)用功能重映射」。GD32F 系列的 USART、SPI、I2C 引腳很多都有重映射選項(xiàng)圖形化界面里如果只選了「USART0_TX」但沒(méi)選重映射生成的代碼里就不會(huì)調(diào)gpio_pin_remap_config()。結(jié)果就是引腳配置對(duì)了但功能出不來(lái)。/* 重映射配置示例把 USART0 映射到 PB6/PB7 */ gpio_pin_remap_config(GPIO_USART0_REMAP, ENABLE); gpio_init(GPIOB, GPIO_MODE_AF_PP, GPIO_OSPEED_50MHZ, GPIO_PIN_6); gpio_init(GPIOB, GPIO_MODE_IN_FLOATING, GPIO_OSPEED_50MHZ, GPIO_PIN_7);這段代碼先使能 USART0 的重映射然后把 PB6 配成復(fù)用推挽輸出TXPB7 配成浮空輸入RX。注意GPIO_MODE_AF_PP這個(gè)模式在 F30x 固件庫(kù)里叫GPIO_MODE_AF_PP在 F10x 里可能叫GPIO_MODE_AF_OD或別的建工程時(shí)選對(duì)固件庫(kù)版本很重要。4.2 USART 波特率計(jì)算的精度問(wèn)題圖形化界面里填波特率比如 115200它會(huì)自動(dòng)算分頻系數(shù)。但 GD32 的 USART 波特率計(jì)算公式是baud fCK / (16 * USARTDIV)其中USARTDIV是一個(gè)定點(diǎn)數(shù)整數(shù)部分 12 位小數(shù)部分 4 位。當(dāng)fCK不是 16 的整數(shù)倍時(shí)算出來(lái)的實(shí)際波特率會(huì)有誤差。誤差超過(guò) 2% 就可能出現(xiàn)亂碼。我一般會(huì)在生成代碼后手動(dòng)驗(yàn)算一遍/* 驗(yàn)算 USART0 波特率PCLK2 120MHz目標(biāo) 115200 */ /* USARTDIV 120000000 / (16 * 115200) 65.104 */ /* 整數(shù)部分 65 0x41小數(shù)部分 0.104 * 16 ≈ 1.67 → 取 2 */ /* 實(shí)際波特率 120000000 / (16 * (65 2/16)) 115107.9 */ /* 誤差 (115107.9 - 115200) / 115200 ≈ -0.08%可接受 */如果誤差超過(guò) 2%常見(jiàn)做法是換一個(gè)更接近的 PCLK2 分頻值或者降低波特率到 57600。有些 GD32F 型號(hào)支持波特率自動(dòng)檢測(cè)但那個(gè)功能在標(biāo)準(zhǔn)庫(kù)里的配置比較繞新手不建議一上來(lái)就用。4.3 中斷優(yōu)先級(jí)配置的坑GD32F 系列的中斷優(yōu)先級(jí)分組跟 STM32 類(lèi)似有 NVIC_PRIORITY_GROUP_0 到 GROUP_4 五種分組方式。EmbeddedBuilder 的圖形化界面里默認(rèn)用的是 GROUP_4也就是 4 位搶占優(yōu)先級(jí)、0 位響應(yīng)優(yōu)先級(jí)。如果你從 Keil 工程遷移過(guò)來(lái)原來(lái)用的是 GROUP_2那中斷嵌套行為會(huì)完全不一樣。/* 設(shè)置中斷優(yōu)先級(jí)分組為 GROUP_22 位搶占2 位響應(yīng) */ nvic_priority_group_set(NVIC_PRORITY_GROUP_2); /* 配置 USART0 中斷搶占優(yōu)先級(jí) 1響應(yīng)優(yōu)先級(jí) 0 */ nvic_irq_enable(USART0_IRQn, 1, 0);這段代碼先把優(yōu)先級(jí)分組設(shè)為 GROUP_2然后給 USART0 中斷分配搶占優(yōu)先級(jí) 1、響應(yīng)優(yōu)先級(jí) 0。注意nvic_irq_enable的第二個(gè)參數(shù)是搶占優(yōu)先級(jí)第三個(gè)是響應(yīng)優(yōu)先級(jí)順序別搞反。如果分組設(shè)成 GROUP_4那第二個(gè)參數(shù)的有效范圍是 0-15第三個(gè)參數(shù)無(wú)效。注意中斷優(yōu)先級(jí)分組一旦設(shè)定整個(gè)工程里所有中斷都按這個(gè)規(guī)則來(lái)。如果中途改了分組之前配好的中斷優(yōu)先級(jí)全部要重新算。5. 避坑與排查GD32F 工具鏈遷移中的五個(gè)血淚教訓(xùn)5.1 編譯通過(guò)但程序不跑現(xiàn)象EmbeddedBuilder 里編譯零報(bào)錯(cuò)燒錄也成功但板子上電后沒(méi)反應(yīng)串口無(wú)輸出。原因最常見(jiàn)的是啟動(dòng)文件選錯(cuò)了。GD32F303 的啟動(dòng)文件有startup_gd32f30x_hd.s高密度、startup_gd32f30x_xd.s超高密度、startup_gd32f30x_cl.s互聯(lián)型之分。如果芯片是 256K Flash 的 HD 型號(hào)但工程里鏈接的是 CL 的啟動(dòng)文件中斷向量表就對(duì)不上。解決打開(kāi)工程屬性 → C/C Build → Settings → Tool Settings → Assembler → Includes確認(rèn)啟動(dòng)文件路徑指向正確的.s文件。同時(shí)檢查鏈接腳本里的LENGTH是否跟芯片實(shí)際 Flash 容量一致。5.2 串口輸出亂碼現(xiàn)象串口助手收到數(shù)據(jù)但全是亂碼換波特率也不行。原因除了前面說(shuō)的波特率計(jì)算誤差還有一個(gè)常見(jiàn)原因是系統(tǒng)時(shí)鐘配置錯(cuò)誤。比如板子上焊的是 8MHz 晶振但system_gd32f30x.c里__SYSTEM_CLOCK配的是 108MHz而實(shí)際 PLL 倍頻是按 8MHz 算的結(jié)果系統(tǒng)時(shí)鐘跑到了 72MHzUSART 分頻系數(shù)全錯(cuò)。解決用示波器測(cè)一下 MCO 引腳輸出的時(shí)鐘頻率或者直接在main里翻轉(zhuǎn)一個(gè) GPIO用示波器看周期。確認(rèn)系統(tǒng)時(shí)鐘正確后再重新算 USART 波特率。5.3 中斷進(jìn)不去現(xiàn)象外設(shè)中斷使能了NVIC 也配了但中斷服務(wù)函數(shù)就是不執(zhí)行。原因EmbeddedBuilder 生成的gd32f30x_it.c里中斷服務(wù)函數(shù)的名稱(chēng)必須跟啟動(dòng)文件里的向量表名稱(chēng)完全一致。比如 USART0 的中斷函數(shù)名是USART0_IRQHandler如果你寫(xiě)成了USART0_Handler鏈接器不會(huì)報(bào)錯(cuò)但向量表里填的是默認(rèn)的無(wú)限循環(huán)。解決打開(kāi)啟動(dòng)文件.s搜索IRQHandler確認(rèn)你用的中斷函數(shù)名跟向量表里的一致。常見(jiàn)的中斷函數(shù)名在固件庫(kù)的gd32f30x_it.h里有聲明直接對(duì)照著寫(xiě)。5.4 燒錄后需要手動(dòng)復(fù)位現(xiàn)象每次燒錄完程序必須按一下復(fù)位鍵才運(yùn)行否則沒(méi)反應(yīng)。原因EmbeddedBuilder 的燒錄配置里默認(rèn)可能沒(méi)有勾選「Reset after programming」。另外如果你用的是 SWD 接口燒錄器的復(fù)位引腳沒(méi)接也會(huì)導(dǎo)致燒錄后芯片不復(fù)位。解決在 Debug Configuration → Startup 里勾選「Reset and Delay」和「Halt」或者在燒錄器設(shè)置里把「Reset after programming」打開(kāi)。如果硬件上復(fù)位引腳沒(méi)接可以在代碼里加一句N(xiāo)VIC_SystemReset()在main開(kāi)頭但這不是長(zhǎng)久之計(jì)。5.5 浮點(diǎn)運(yùn)算結(jié)果不對(duì)現(xiàn)象同樣的浮點(diǎn)計(jì)算代碼Keil 下結(jié)果正確EmbeddedBuilder 下結(jié)果偏差很大。原因GCC 和 ARMCC 對(duì)浮點(diǎn)數(shù)的處理方式不同。GD32F303 沒(méi)有硬件 FPU浮點(diǎn)運(yùn)算靠軟件模擬。GCC 默認(rèn)可能用了-mfloat-abihard或-mfloat-abisoftfp而芯片不支持硬件浮點(diǎn)導(dǎo)致結(jié)果異常。解決在工程屬性的 C/C Build → Settings → Tool Settings → Target Processor 里把 Float ABI 改成soft或者直接在編譯選項(xiàng)里加-mfloat-abisoft。同時(shí)確認(rèn)鏈接選項(xiàng)里沒(méi)有引入硬件浮點(diǎn)的庫(kù)。6. 進(jìn)階技巧用 EmbeddedBuilder 做多工程管理和版本回退6.1 多工程工作空間的隔離EmbeddedBuilder 基于 Eclipse天然支持多工程工作空間。我一般會(huì)按芯片系列建不同的 workspaceworkspace_f30x、workspace_f10x、workspace_f4xx。這樣切換項(xiàng)目時(shí)不用反復(fù)改編譯器路徑和固件庫(kù)引用。具體做法是啟動(dòng)時(shí)加-data參數(shù)指定工作空間路徑# 啟動(dòng)時(shí)指定工作空間 ./eclipse/embeddedbuilder -data /path/to/workspace_f30x如果不想每次敲命令可以在桌面快捷方式的目標(biāo)里加上這個(gè)參數(shù)。工作空間隔離的好處是每個(gè)空間里的工程配置、編譯器設(shè)置、調(diào)試配置互不干擾。壞處是占硬盤(pán)空間一個(gè)工作空間動(dòng)輒幾百 MB。6.2 固件庫(kù)版本的手動(dòng)切換有時(shí)候項(xiàng)目需要用到特定版本的固件庫(kù)而 EmbeddedBuilder 自帶的版本不匹配。這時(shí)候可以手動(dòng)把固件庫(kù)源碼拷到工程目錄下然后在工程屬性里把 include 路徑指向新拷進(jìn)來(lái)的目錄。具體步驟步驟操作注意點(diǎn)1下載目標(biāo)版本的 GD32F 固件庫(kù)確認(rèn)跟芯片系列匹配2解壓到工程目錄下的firmware/文件夾不要覆蓋 IDE 安裝目錄3工程屬性 → C/C General → Paths and Symbols刪掉舊的固件庫(kù)路徑4添加新路徑調(diào)整包含順序新路徑放在最前面5重新編譯檢查是否有重復(fù)定義舊路徑?jīng)]刪干凈會(huì)報(bào)錯(cuò)這個(gè)操作的風(fēng)險(xiǎn)在于不同版本的固件庫(kù) API 可能有變化比如某個(gè)宏定義改名了、某個(gè)函數(shù)參數(shù)變了。切換后要全量編譯一次看有沒(méi)有undefined reference或implicit declaration警告。6.3 用 Git 管理 EmbeddedBuilder 工程EmbeddedBuilder 的工程目錄里有一堆 Eclipse 自動(dòng)生成的文件比如.project、.cproject、.settings/文件夾。這些文件如果直接提交到 Git換一臺(tái)機(jī)器拉下來(lái)可能因?yàn)槁窂讲煌鴪?bào)錯(cuò)。我一般會(huì)寫(xiě)一個(gè).gitignore把跟機(jī)器相關(guān)的配置排除掉# Eclipse 自動(dòng)生成跟機(jī)器相關(guān) .settings/ .cproject .project .metadata/ # 編譯輸出 Debug/ Release/ *.o *.d *.elf *.bin *.hex # 保留源碼和鏈接腳本 !*.c !*.h !*.ld !*.s這個(gè).gitignore的作用是只提交源碼、頭文件、鏈接腳本和啟動(dòng)文件不提交 IDE 的元數(shù)據(jù)和編譯產(chǎn)物。這樣換機(jī)器拉下來(lái)后重新建一個(gè)空工程把源碼拷進(jìn)去再配一次編譯選項(xiàng)就行。雖然多了一步但避免了路徑?jīng)_突的玄學(xué)問(wèn)題。6.4 一個(gè)驗(yàn)證編譯鏈?zhǔn)欠裾５募记擅看涡陆üこ袒蛘咔袚Q固件庫(kù)版本后我習(xí)慣先跑一個(gè)「最小驗(yàn)證」只點(diǎn)一個(gè) LED用定時(shí)器中斷翻轉(zhuǎn)同時(shí)串口輸出一句固定字符串。這個(gè)最小系統(tǒng)能跑通說(shuō)明啟動(dòng)文件、時(shí)鐘配置、中斷向量表、鏈接腳本、串口重定向都沒(méi)問(wèn)題。后面再加外設(shè)就是增量調(diào)試出了問(wèn)題也好定位。/* 最小驗(yàn)證代碼片段 */ int main(void) { /* 系統(tǒng)時(shí)鐘初始化確認(rèn) __SYSTEM_CLOCK 跟晶振匹配 */ systick_config(); /* GPIO 初始化LED 推挽輸出 */ gpio_init(GPIOB, GPIO_MODE_OUT_PP, GPIO_OSPEED_2MHZ, GPIO_PIN_0); /* USART0 初始化115200-8-N-1 */ usart_deinit(USART0); usart_baudrate_set(USART0, 115200); usart_word_length_set(USART0, USART_WL_8BIT); usart_stop_bit_set(USART0, USART_STB_1BIT); usart_parity_config(USART0, USART_PM_NONE); usart_transmit_config(USART0, USART_TRANSMIT_ENABLE); usart_enable(USART0); while (1) { gpio_bit_set(GPIOB, GPIO_PIN_0); delay_1ms(500); gpio_bit_reset(GPIOB, GPIO_PIN_0); delay_1ms(500); printf(minimal system running\r\n); } }這段代碼跑通后串口助手應(yīng)該每 500ms 收到一行minimal system running同時(shí) LED 閃爍。如果串口有輸出但 LED 不閃檢查 GPIO 時(shí)鐘是否使能如果 LED 閃但串口無(wú)輸出檢查 USART 引腳重映射和波特率。從那以后我每次拿到新的 GD32 工程或者切換工具鏈版本都強(qiáng)制先跑一遍這個(gè)最小驗(yàn)證確認(rèn)底層沒(méi)問(wèn)題再往上加業(yè)務(wù)代碼。希望幫到你。本文還有配套的精品資源點(diǎn)擊獲取