1.本文簡介

GD32F4xx 系列 MCU 是基于 Arm? Cortex?-M4 處理器的 32 位通用微控制器，與 STM32F4xx系列 MCU 保持高度兼容。本文主要從以下三個方面進(jìn)行介紹：硬件資源對比、外設(shè)及性能對比以及從 STM32F4xx 移植到 GD32F4xx 的移植步驟，旨在讓開發(fā)者能夠快速從 STM32F4xx移植到 GD32F4xx，縮短研發(fā)周期，加快產(chǎn)品開發(fā)進(jìn)度。

2.GD32F4xx vs STM32F4xx 硬件資源對比

GD32F4xx 和 STM32F4xx 硬件引腳對比如表 2-1. GD32F4xx 和 STM32F4xx pin 對比所示，由該表可知，GD32F4xx 與 STM32F4xx 完全硬件兼容。

表 2-1. GD32F4xx 和 STM32F4xx pin 對比

注意：

1. NC 代表可接高、可接地、可不接。

2. STM32F4xx 的 VCAP_1/2 引腳一般是通過阻容接地，若采用 GD32F4xx 替代，建議可直接通過電阻接地，電容可省略。

3. STM32F4xx 的 BYPASS_REG 引腳一般接地或接高，不影響替換。

4. 注意 PDR_ON 引腳需通過 10K 電阻上拉。

3.GD32F4xx vs STM32F4xx 外設(shè)及性能對比

GD32F4xx 外設(shè)資源豐富，可實現(xiàn)對 STM32F4xx 外設(shè)資源的覆蓋，具體系統(tǒng)及外設(shè)資源對比如表 3-1. GD32F4xx 和 STM32F4xx 系統(tǒng)及外設(shè)資源對比所示。

表 3-1. GD32F4xx 和 STM32F4xx 系統(tǒng)及外設(shè)資源對比

4.從 STM32F4xx 到 GD32F4xx 系列移植步驟

GD32F4xx 和 STM32F4xx 均基于 Arm? Cortex?-M4 內(nèi)核 MCU，可采用相同的集成開發(fā)環(huán)境和燒錄調(diào)試工具，一般集成開發(fā)環(huán)境為 IAR、Keil和Eclipse等，燒錄和調(diào)試工具可選用ULINK、J-Link、ST-LINK、GD-LINK 等。本節(jié)首先介紹使用 Keil 和 IAR 進(jìn)行集成開發(fā)環(huán)境選型及工程配置，之后介紹各個外設(shè)在移植時可能碰到的問題以及解決方法。

讀者進(jìn)行移植測試時可參考以下步驟進(jìn)行：

（1）集成開發(fā)環(huán)境選型及工程配置（或保持之前配置）；

（2）將編譯的工程代碼燒錄到芯片內(nèi)進(jìn)行測試；

（3）根據(jù)使用的外設(shè)以及測試的情況參考本節(jié)各外設(shè)移植問題及解決方法進(jìn)行修改測試。

4.1 集成開發(fā)環(huán)境選型及工程配置

4.1.1 使用 Keil5 開發(fā)

首先安裝選型 pack 包，選型 pack 包可通過 https://pan.baidu.com/s/1mhQsNpu 網(wǎng)盤或GD32MCU.com 官網(wǎng)下載，若采用 Keil5 開發(fā)，也可通過 Pack Installer 進(jìn)行在線更新（建議通過官網(wǎng)下載）。 下 載 后 解 壓 pack 包 如 圖 4-1. AddOn 選 型 安 裝 包 所示，其中

GigaDevice.GD32F4xx_Addon.3.0.0.exe為Keil4的選 型 安 裝包 、GigaDevice.GD32F4xx_DFP.3.0.0.pack 為 Keil5 的選型安裝包、IAR_GD32F4xx_ADDON.3.0.0.exe 為 IAR 的選型安裝包，在此選擇 GigaDevice.GD32F4xx_DFP.3.0.0.pack 進(jìn)行安裝，安裝路徑默認(rèn)選擇 Keil5 安裝路徑。

安裝選型安裝包后，打開具體軟件工程，點擊 Project->Option for Target 打開配置對話框，點擊 Device 進(jìn)行工程選型，如圖 4-2. Keil5 下選型配置所示可選擇對應(yīng) GD32F4xx 選型，點擊OK。

選型后，再次打開 Option for Target 配置對話框，點擊 Debug 選擇所使用的燒錄器，之后點擊Utilities->Setting，彈出如圖4-3. 下載算法選擇窗口對話框，點擊add選擇對應(yīng)的下載算法

之后可將修改的工程其他配置與原工程進(jìn)行對比，排查預(yù)定義宏、工程優(yōu)化、FPU 配置等是否一致，不同的地方可進(jìn)行修改調(diào)整，修改后可進(jìn)行燒錄測試。

4.1.2 使用 IAR 開發(fā)

首先安裝 IAR 選型包，如圖 4-1. AddOn 選型安裝包所示，AddOn 選型包中雙擊IAR_GD32F4xx_ADDON. 3.0.0.exe 選擇 IAR 安裝路徑默認(rèn)安裝即可。

安裝選型包后，打開應(yīng)用工程，打開 option 對話框，選擇 general options->Target，可進(jìn)行設(shè)備選型，如圖 4-4. IAR 工程選型所示。

選型之后，可以 check 下鏈接文件以及下載文件是否已更換，如圖 4-5. 鏈接文件選擇和圖 4-6.下載文件選擇所示，選擇 GD32 對應(yīng)鏈接文件以及下載文件。

圖 4-5. 鏈接文件選擇

圖 4-6. 下載文件選擇

配置完成后，即可進(jìn)行燒錄下載及調(diào)試測試。

注意：若原始工程選型 GD32 MCU 編譯異常，也可以選型 STM32 對應(yīng)型號進(jìn)行編譯下載測試。若希望調(diào)試時對應(yīng) GD32 寄存器或者使用 GD32 所有特有的外設(shè)或功能可以選擇 GD32對應(yīng)型號，切換選型后有關(guān)燒錄器選擇或其他工程配置需要參考之前的配置進(jìn)行修改。

4.2 SPI 模塊移植注意事項

4.2.1 SPI 重配異常處理

若用戶在使用時切換 SPI 配置，重配 SPI 后，SPI 時鐘改變，建議在重配 SPI 之前先關(guān)閉 SPI模塊，配置完成后，再使能 SPI。修改代碼如下所示。

4.3 ADC 模塊移植注意事項

4.3.1 ADC 8 位對齊模式處理

ADC 在設(shè)置為 8bit 模式右對齊時，GD32F4xx 是取 12bit 數(shù)據(jù)中的高 8bit，使用時請注意，如表 4-1. 右對齊時 ADC 采樣數(shù)據(jù)寄存器所示。可采用左對齊，讀取高字節(jié)數(shù)據(jù)，如表 4-2. 左對齊時 ADC 采樣數(shù)據(jù)寄存器所示

4.3.2 ADC 軟件觸發(fā)時機(jī)處理

在 ADC IDLE 的時候，軟件寫一下 swstart，硬件會檢測到 swstart 的上升沿，然后開始采樣，并在采樣開始的時候?qū)?swstart 清 0。如果在 ADC 正在轉(zhuǎn)換時寫 swstart，此時 ADC 無法檢測上升沿，當(dāng) ADC 轉(zhuǎn)換完當(dāng)前通道后，swstart 雖為高電平，但檢測不到上升沿， ADC 也無法啟動轉(zhuǎn)換，因此置位 swstart 之前需要等待 EOC 標(biāo)志置位，即 ADC 轉(zhuǎn)換完成。

4.3.3 ADC 規(guī)則組查詢 EOC 讀取數(shù)據(jù)異常處理

ADC 規(guī)則組采樣數(shù)據(jù)后先置位 EOC，然后在下個 ADCCLK 將數(shù)據(jù)填充到數(shù)據(jù)寄存器，如果ADC 時鐘較慢且主頻較高情況下，可能存在無法讀取 ADC 規(guī)則組采樣數(shù)據(jù)的情況，可以通過在 EOC 后延遲超過 1 個 ADCCLK 時間然后再讀取 ADC 規(guī)則組數(shù)據(jù)解決。

4.4 USART 模塊移植注意事項

4.4.1 串口 DMA 發(fā)送數(shù)據(jù)丟失處理

GD32F4xx MCU 的 USART 使用 DMA 發(fā)送，如果先使能 DMA，后使能串口的 Tx 功能，會導(dǎo)致由于 DMA 先于 USART 打開的時間差，造成在 USART 沒準(zhǔn)備好發(fā)送的情況下 DMA 事先傳輸數(shù)據(jù)，進(jìn)而導(dǎo)致數(shù)據(jù)丟失，軟件上可修改 DMA 和串口配置順序，先配置串口，然后配置DMA。

4.4.2 串口通信由于時鐘波特率誤差導(dǎo)致數(shù)據(jù)錯亂處理

本項適用于 GD32F405/407/450 系列。在一些存在波特率誤差（高低位時間偏差）的應(yīng)用場景下，比如 485 長距離通信、強(qiáng)干擾等，可能會存在串口 START 位檢測異常導(dǎo)致數(shù)據(jù)錯亂的情況，該情況下可通過以下方法進(jìn)行改善：

1. 將 16 倍過采樣配置為 8 倍過采樣，注意過采樣配置需要在波特率配置之前，可提高對波特率誤差的容錯能力；

2. 降低波特率；

3. 硬件整改，減少實際波形波特率偏差；

4. 更換 GD32F425/427/470 系列測試。

4.4.3 串口 DMA 接收不定長數(shù)據(jù) DMA 無法重配處理

串口 DMA 接收不定長數(shù)據(jù)一般在串口超時中斷或 IDLE 中斷中重新配置 DMA，以準(zhǔn)備接收下一幀數(shù)據(jù)，由于關(guān)閉 DMA 將會置位 DMA 傳輸完成標(biāo)志，進(jìn)而導(dǎo)致 DMA 無法重新配置，可以通過在關(guān)閉 DMA 后清除 DMA 傳輸完成標(biāo)志進(jìn)行解決。

4.5 ENET 模塊移植注意事項

4.5.1 以太網(wǎng) Ping 不通的相關(guān)處理

若出現(xiàn)以太網(wǎng) ping 不通的問題，若排除硬件問題，軟件有以下兩種可能：

（1）由于 GD32F4xx芯片主頻較高，在代碼端，應(yīng)該保證將 ENET_DMA_CTL 寄存器的第 20 位 FTF 置 1，清空發(fā)送 FIFO 后，必須軟件等待該位被硬件清 0 后適當(dāng)延遲再進(jìn)行其他操作。否則，有概率性導(dǎo)致ENET 發(fā)送異常，從而出現(xiàn) PING 不通的情況，修改代碼如下所示。

（2）若客戶以太網(wǎng)采用半雙工通信，若打開載波偵聽，會導(dǎo)致發(fā)送異常，按照 802.1 以太網(wǎng)協(xié)議，需關(guān)閉載波監(jiān)聽功能，修改代碼如下所示。

4.5.2 以太網(wǎng)硬件 checksum 異常處理

由于在 GD32F4 上硬件 checksum 使用更嚴(yán)格，可建議使用軟件 checksum，或軟件上使能ENET_DMA_CTL 里面的 FERF 位，并對錯誤幀進(jìn)行相應(yīng)處理。

4.6 USBFS 模塊移植注意事項

4.6.1 USB 發(fā)送數(shù)據(jù)偶爾出錯異常處理

若出現(xiàn) USB 端點發(fā)送數(shù)據(jù)偶爾出錯的情況，請排查 DCD_EP_Flush();函數(shù)使用情況，該函數(shù)僅需在 USB 初始化中端點緩沖區(qū)配置完成后，進(jìn)行 Flush，其他地方 Flush 緩沖區(qū)可能會造成USB緩沖區(qū)異常，因而建議只需在USB初始化時進(jìn)行一次緩沖區(qū)Flush操作，其他地方的Flush操作可屏蔽。

4.7 IIC 模塊移植注意事項

4.7.1 作為主機(jī)讀取 2 個字節(jié)數(shù)據(jù) IIC 總線卡死處理

該問題出現(xiàn)的原因是由于在設(shè)置 POS 之前被其他中斷打斷，導(dǎo)致 POS 控制異常，對緊接著的數(shù)據(jù)回復(fù)了 NACK 導(dǎo)致總線掛死，可以有以下兩種解決方法：

1、在地址發(fā)送之前禁用中斷，并在 POS 配置之后使能中斷；

2、修改配置流程，將 POS 配置放置在 Start 發(fā)送之前。

4.8 HXTAL 時鐘移植注意事項

4.8.1 HXTAL 超時等待宏定義配置較短導(dǎo)致溢出處理

在 stm32f4xx.h 中的 HSE_STARTUP_TIMEOUT 超時宏定義建議從 0x0500 改成 0xfffff，修改代碼如下所示。

4.9 CAN 模塊移植注意事項

4.9.1 CAN 連續(xù)發(fā)送概率性丟幀處理

若使用 STM32 Cube 庫，在連續(xù)發(fā)送且不判斷上一幀數(shù)據(jù)發(fā)送完成的情況下，可能存在概率性丟幀情況，該問題的原因在于 NUM[1:0]控制位 GD32 和 STM32 的行為不一致，在有 mailbox為空的情況下，STM32 的 Code 位為最小的那個空的 mailbox，而 GD32 的 NUM[1:0]位是正在處理的那個 mailbox。因而建議可通過判斷 TME0/1/2 來選擇郵箱，具體修改代碼如圖 4-7. 修改代碼示例所示。

4.9.2 CAN 無法接收異常處理

若使用 STM32 Cube 庫，建議將 CAN 初始化中 SlaveStartFilterBank 由 0 改成 14，否則會出現(xiàn) CAN0 沒有過濾器可用導(dǎo)致無法接收數(shù)據(jù)，具體修改如圖 4-8. 修改代碼示例所示。

本教程由GD32 MCU方案商聚沃科技原創(chuàng)發(fā)布，了解更多GD32 MCU教程，關(guān)注聚沃科技官網(wǎng)