GD32開發板 使用教學 LED Blink

建立新專案

首先我們要先建立一個新的專案,在PIO(PlatformIO的簡稱)頁面中點選”Project Examples”開啟專案範例。

匯入範例程式

選擇”arduino-blink”並點選”Import”匯入範例。

檢視程式碼

左方的檔案瀏覽器可以看到這個範例程式碼的所有檔案。

其中:

  • .pio 是PIO環境設定資料
  • include 是header檔案資料夾
  • lib 是第三方程式庫資料
  • src 是c或cpp原始碼檔案
  • test 是測試檔案夾
  • platformio.ini 是專案環境設定檔

而下方的”打勾”符號則是編譯,”箭頭”符號是上傳。

修改專案環境設定檔

先將預設的專案環境設定程式碼清空,並輸入下列程式碼:

 

[env:sipeed-longan-nano]
platform = gd32v          ;Platform, choose gd32v
framework = arduino       ;Optional gd32vf103-sdk or arduino
board = sipeed-longan-nano ; Development board
monitor_speed = 115200     ; Serial monitor baudrate
upload_protocol = serial       ; Download tool Default serial port, optional jlink, gd-link, dfu, etc.
debug_tool = jlink         ; Debugging tool default jlink, optional sipeed-rv-debugger, etc.

編譯專案

修改完成後,點擊下方藍色工具列的”V”符號進行編譯。

將連接開發板連接到電腦

T-GD32V開發板提供以下三種連接方式連接到個人電腦進行燒錄:

  1. USB DFU 燒錄:使用USB Type-C線進行燒錄
  2. Serial ISP 燒錄:使用USB-TTL轉接器進行燒錄
  3. JTAG 燒錄:使用JTAG或者相容JTAG的產品進行燒錄與除錯
  1. 使用USB DFU上傳程式碼

DFU是Development Firmware Upgrade 的簡稱,可以讓使用者透過USB界面進行裝置韌體升級。

首先要準備好一條具有資料傳輸功能的USB Type-C連接線。

在T-GD32V開發板中,要進入DFU模式的方法為:

  1. 按住BOOT鍵
  2. 按下RESET鍵後放開
  3. 放開BOOT鍵

進入DFU模式的開發板不會有任何動作,包含GPIO的亮滅以及顯示器的亮滅。

1.1 修改platformio.ini設定檔

將platformio.ini檔案中新增以下程式碼:

upload_protocol = dfu

讓系統知道我們要以DFU上傳韌體到開發板,否則預設是以Serial串列埠進行上傳

程式修改完成後,就可以按下下方藍色工具列的箭頭鈕進行燒錄。

終端視窗會顯示上傳的進度條以及上傳成功的通知

若出現如圖的錯誤訊息:

“dfu-util:Error during download get_status”

***[upload]Error 74

請忽略它,因為上傳已經在上一個步驟完成。

1.2 Linux系統所需之額外設定

在使用linux系統進行開發時,需要額外把platformIO所支援硬體平台匯入到作業系統內。

PlatformIO官方教學:https://docs.platformio.org/en/latest/faq.html#faq-udev-rules

首先請先打開系統的終端視窗,請先安裝curl插件:
$ sudo apt install curl
完成後將rule檔案下載到電腦的特定資料夾中:
$ curl -fsSL https://raw.githubusercontent.com/platformio/platformio-core/master/scripts/99-platformio-udev.rules | sudo tee /etc/udev/rules.d/99-platformio-udev.rules
完成後重新啟動udev管理程式:
$ sudo service udev restart

Ubuntu/Debian的使用者若使用者群組不在”root內”,則需要把使用者權限納入”root”內:
$ sudo usermod -a -G dialog $USER
$ sudo userbod -a -G plugdev $USER


完成後,將開發板重新連接,就可以正常使用dfu燒錄開發板。

2. 使用ISP下載器上傳

首先準備好USB轉串列埠(Serial)的轉換器,並將開發板與轉換器連接。

修改platformio.ini檔案中的upload_protocol:

uploadprotocol = serial

將開發板上的BOOT鍵按住後,按下RESET鍵後放開,再放開BOOT鍵,進入上傳模式。(與進入DFU模式一樣)

3. 使用JTAG或相容硬體上傳

準備好J-Link 或者Sipeed RV Debugger(RV-Link),並將除錯器連接到開發板。

修改platfornio.ini中的upload_protocol:

upload_protocol = jlink

or

upload_protocol = sipeed-rv-debugger