[STM32] 在 Windows 下使用 VSCode 架設 STM32 開發環境

-
1. 所需安裝的軟體 GNU Arm Embedded Toolchain : 下載壓縮檔，解壓到你想擺放的目錄。例如：c:\stm32\gcc-arm\ GNU MCU Eclipse Windows Build Tools : 這是 make 和相關的軟體，也可以使用 cygwin 或 mingw 內的工具，但我發現這包最簡潔。下載壓縮檔後將其解開，把裡面 bin 目錄下的執行檔複製到你想擺放的目錄。例如：c:\stm32\build tools\ OpenOCD : 這是燒 code 和 debug 的工具。下載壓縮檔，解壓到你想擺放的目錄。例如：c:\stm32\openocd\ VSCode : 這次的主角，編輯器和整合的操作介面。下載安裝程式執行，依指示安裝。安裝過程中有選項可將開啟檔案和開啟目錄加入滑鼠右鍵選單，建議打勾，以後開啟專案比較方便。 ST-Link Utility : STM32 原廠開發版的驅動程式和燒錄工具 STM32CubeMX (非必備): ST 提供的程式碼生成工具，利用它產生 makfile 的專案比較快 2. VSCode 的設定 由於 VSCode 的 Build 和 Debug 設定是存放在專案目錄下 .vscode/ 裡的 tasks.json 和 launch.json ，以下的操作必需是以 Folder 的方式開啟專案目錄才能用。你可以在檔案總管中，在專案的目錄上按右鍵，選"Open with Code"（安裝時必需有打開滑鼠右鍵選單功能）。或是在 VSCode 內用 "Open Folder" 打專案的目錄。 2.1 安裝 Extensions 第一次使用 VSCode 先從左側打開 Extensions 的側欄，安裝下列 Extensions。 C/C++ (Microsoft) Cortex-Debug 打開 settings，設定 cortex-debug 需要的路徑 "cortex-debug.openocdPath": "c:/stm32/openocd/bin/openocd.exe", "cortex-debug.armToolchainPat
1 則留言

[STM32] 2. 建立專案

-

2.1 建立樣板專案

STmicroelectronics 提供的標準函式庫中，已經有其他編譯器用的樣板專案。我們從裡面去修改成 gcc 用的樣板專案。一開始建立專案的步驟較為繁瑣，所以先建立一個空的專案當作樣板留下來，以後要寫程式就可以直接把樣板複製一份。
  1. 建立一個放置專案的目錄 stm32f466 ，並在裡面再建立子目錄 src 和 inc
  2. 將從 STmicroelectronics 下載的 stm32f4_dsp_stdperiph_lib.zip 解壓縮，放在自己習慣的目錄
  3. 進入 Project\STM32F4xx_StdPeriph_Templates\
  4. 將 main.c, stm32f4xx_it.c, system_stm32f4xx.c 複製到 stm32f466\src\ 下
  5. 將 main.h, stm32f4xx_conf.h, stm32f4xx_it.h 複製到 stm32f466\inc\ 下
  6. 再進入 TrueSTUDIO\STM32F446xx\
  7. 將 STM32F446ZETx_FLASH.ld 複製到 stm32f466\ 下
  8. 回到 stm32f4_dsp_stdperiph_lib 的最上層
  9. 進入 Libraries\CMSIS\Device\ST\STM32F4xx\Include\
  10. 將 stm32f4xx.h, system_stm32f4xx.h 複製到 stm32f466\inc\ 下
  11. 回到上一層，進入 Source\Templates\TrueSTUDIO\
  12. startup_stm32f446xx.s 複製到 stm32f466\src\ 下
  13. 回到 Libraries\CMSIS\ ，進入 Incluse\
  14. 將 core_cm4.h, core_cmFunc.h, core_cmInstr.h, core_cmSimd.h 複製到 stm32f466\inc\ 下
  15. 回到 Libraries\
  16. 將 STM32F4xx_StdPeriph_Driver 整個目錄複製一份到 stm32f466\src\ 下
  17. 根據 mcufreaks 的網頁打造 makefile 或是下載製作好的版本： makefile, common.mk。放到 stm32f466\ 下
接著就能進入 DOS 的開發環境，打 make 進行編譯。編譯完成的檔案會放在 stm32f446\bin 下。

目前專案中各檔案內容的簡單說明如下
  • core_cm4.h, core_cmFunc.h, core_cmInstr.h, core_cmSimd.h：CORTEX-M4 的標準介面
  • stm32f4xx_conf.h, stm32f4xx.h, system_stm32f4xx.h, system_stm32f4xx.c：STM32F4 週邊硬體的介面以及開機時的 clock 設定
  • startup_stm32f446xx.s：中斷向量表及 reset_handler ( reset 後進入 main() 之前的程式 )
  • stm32f4xx_it.h, stm32f4xx_it.c：中斷服務常式
  • STM32F4xx_StdPeriph_Driver：STM32F4 週邊硬體的標準函式庫
  • STM32F446ZETx_FLASH.ld：STM32F446 的 Linker Script，定義最後程式的記憶體配置。只需確認 FLASH 和 RAM 的大小是否正確，在弄懂 Linker Script 之前，不要去修改它
  • makefile, common.mk：定義編譯專案的流程。當專案增加檔案或是目錄結構變動時，就需要修改 makefile 內容
其中 makefile 是較需要注意的檔案，裡面分別設定了 .h 和 .c 檔的路徑和需要編譯的 .c 檔，如果新增加檔案或是改變目錄結構就需要修改內容。另外 makefile 裡面也有定義了一些常數名稱，-DUSE_STDPERIPH_DRIVER -DSTM32F446xx -D__FPU_PRESENT=1 ，這些都是 STM32F4 標準函式庫會用到的。

2.2 燒錄程式

2.2.1 使用 ST-LINK_CLI

ST-LINK_CLI.exe -c SWD -p "bin/STM32F446.hex" -Rst -Run

2.2.2 使用 OpenOCD

  1. 打開 dos 工作環境，進入專案目錄。輸入 openocd -f board/st_nucleo_f4.cfg ，成功後保留視窗不要關閉
  2. 打開 putty ，使用 telnet 連線 localhost ， port: 4444 ，即可連上 Open On-Chip Debugger
  3. 輸入 reset halt ，將 mcu 重新啟動後停止
  4. 輸入 load_image bin/STM32F446.elf 0 ，將 STM32F446.elf 檔載入 flash address 0x00000000 的位址
  5. 輸入 reset run ，將 mcu 重新啟動後，繼續執行
  6. 如果沒有要繼續使用 Open On-Chip Debugger 可輸入 shutdown 關閉 putty 和 openocd
除了燒錄程式碼外，Open On-Chip Debugger 的環境內還可以執行其他 debug 的命令，如讀寫記憶體等。詳細操作可參考 openocd 目錄下的 OpenOCD User’s Guide.pdf。若只是要單純燒錄程式碼，上述動作可結合成下面一行 dos 命令

  • openocd -f board/st_nucleo_f4.cfg -c "init" -c "reset halt" -c "load_image bin/STM32F446.elf 0" -c "reset run" -c "shutdown"

2.3 建立 eclipse 專案

2.3.1 設定 Workspace

進入 eclipse 時要要求選擇一個 Workspace 的目錄，這是 eclipse 存放工作環境設定的目錄，以後新建專案會放在這個目錄下。依個人習慣選擇一個放專案的目錄即可。如果不想每個打開 eclipse 都問一次，記得把 "Use this as the default and do not ask again" 打勾。
將 make 需要用到的程式路徑加入環境設定中。從上方的 Menu bar 點選 Window 再選 Preferences 打開設定視窗。選到 C/C++ -> Build -> Environment 分頁，點選 Add 加入一個新的環境變數。欄位 Name 填寫 PATH ，欄位 Value 填寫 d:\ARM-SDK\cygwin\;d:\ARM-SDK\gcc-arm\bin\;d:\ARM-SDK\gcc-arm\arm-none-eabi\bin\

修改將 eclipse 自動搜尋 Include Paths 。選到 C/C++ -> Build -> Setting。選到 Discovery 分頁，點 CDT Cross GCC Built-in Compiler Settings [Shared]。將下方 Command to get compiler specs: 中的 ${COMMAND} 改成 arm-none-eabi-gcc.exe

2.3.2 建立 Project

  1. 開啟 New 的視窗
  2. 選擇 C/C++ 裡的 Makefile Project with Existing Code
  3. 填寫 Project Name ，選擇 Existing Code Location
  4. Languages 要勾 C ，C++ 可勾可不勾
  5. Toolchain for Indexer Setting 選 Cross GCC
  6. 最後點選 Finish 按鈕，Project 就建好了

2.3.3 設定 Project Properties

eclipse 無法自動找到 makefile 中的 define ，因此需要手動加入。
  1. 打開 Project 選單，選擇 Properties 打開設定視窗
  2. 左邊選擇 C/C++ General 下的 Paths and Symbols
  3. 右邊選擇 Symbols 分頁，Langiages 選擇 GNU C
  4. 新增 USE_STDPERIPH_DRIVER 和 STM32F446xx
  5. 新增 __FPU_PRESENT ，值記得設定為 1
  6. 左邊選擇 Preprocessor Include Paths, Macros etc.
  7. 選擇 Providers 分頁，選擇 CDT Cross GCC Built-in Setting Entries [Shared]
  8. 將下方 Use global provider shared between projects 打勾
設定完成後，eclipse 的 indexer 就能正確解析程式碼內容了。若覺得每次設定 Symbols 很麻煩，可以利 Symbols 頁面的下方 Export Setting 按鈕將設定存成檔案，以後新的專案再利用 Import Settings 載入即可。

2.4 參考資料：

留言

  1. Unknown2016年7月25日 凌晨3:01

    您好，我目前也在使用STM32F446，之前都是使用 Keil MDK 做開發，日前發現 Keil 可以支援 GCC 編譯器，這幾天嘗試改成 GCC 來編譯，但對 __libc_init_array 的問題一直無法解決，因本身沒有碰過這種底層與 GNU 的相關經驗，想請教您是否在使用 GCC 編譯過程中也有遇到相同問題？


    在 Keil 中使用 GCC 編譯的方法大致與以下教學相同 http://eeontheway.com/1170.html
    xxx.ld 與 xxx.s 都是從 STM32F4_StdPeriph_Lib_V1.7.1/.../TrueSTUDIO 拉進來的


    以下是完整的錯誤訊息：

    linking...
    c:/program files (x86)/gnu tools arm embedded/5.4 2016q2/bin/../lib/gcc/arm-none-eabi/5.4.1/../../../../arm-none-eabi/lib/armv7e-m\libc.a(lib_a-init.o): In function `__libc_init_array':
    init.c:(.text.__libc_init_array+0x22): undefined reference to `_init'
    collect2.exe: error: ld returned 1 exit status


    希望可以給予解決方向或方法，非常謝謝：）

    回覆刪除
    回覆
    1. Dinow2016年7月27日 凌晨1:17

      幫你 google 了一下。根據下面這篇，應該是 Keil 使用的 link 參數 -nostartfiles 的關係，而一般是使用 --gc-sections。
      http://stackoverflow.com/questions/13734745/why-do-i-have-an-undefined-reference-to-init-in-libc-init-array

      刪除

張貼留言

這個網誌中的熱門文章

[STM32] 3. USART 的發送與接收

-
UART 是一般嵌入式系統最常用的 debug 介面，通常 PC 端必需要有接收的硬體。不過 neculeo 的電路版已經包含了一個 virtual com port 連接到 USART2。所以只要設定好 USART2 就能在 PC 上透過終端機程式(ex: putty )與 neculeo 連線了。 STM32 週邊的初始化包含下面的步驟 設定腳位：由於腳位的數量有限，所以有些週邊會共用接腳。而且為了使用上的彈性，週邊也可能有一組以上的腳位可選擇。所以使用前要將腳位設定為正確的模式。 設定週邊：設定週邊的硬體參數 設定中斷：如果週邊在應用上會使用到中斷，需要設定 NVIC 另外，STM32 的週邊預設 clock 是關閉的，所以使用任何的週邊都需先開啟該週邊的 clock ，包含 GPIO 也是要先開啟 clock 。 3.1 設定 GPIO USART2 使用的腳位是 GPIOA2 和 GPIOA3，先將這兩隻腳位設定給 USART 使用。 呼叫 RCC_AHB1PeriphClockCmd() 打開 GPIOA 的 clock 宣告一個 GPIO_InitTypeDef 的 struct 準備給 GPIO_Init() 使用 呼叫 GPIO_StructInit() 將 GPIO_InitTypeDef 的 struct 進行初始化。當然你也可以手動對 struct 內的 member 設定，但如果未來更新了 stm32 提供的 library ， GPIO_InitTypeDef 的 member 可能會改變，那這段程式碼可能就會出問題。使用第三方提供的 library 時，最好依它提供的方式使用 修改 GPIO_InitTypeDef struct 的內容 呼叫 GPIO_Init() 設定 GPIO ，目前只是將 GPIO_Mode 設定為週邊使用，但還沒指定給哪個週邊 呼叫 GPIO_PinAFConfig() 將 GPIOA2 和 GPIOA3 指定為 USART2 使用 詳細的程式碼如下： // Enable clock of GPIOA RCC_AHB1PeriphClockCmd(RCC_AHB1Periph_GPIOA, ENABLE); // Configure pin
閱讀完整內容

[STM32] 在 Windows 下使用 VSCode 架設 STM32 開發環境

-
1. 所需安裝的軟體 GNU Arm Embedded Toolchain : 下載壓縮檔，解壓到你想擺放的目錄。例如：c:\stm32\gcc-arm\ GNU MCU Eclipse Windows Build Tools : 這是 make 和相關的軟體，也可以使用 cygwin 或 mingw 內的工具，但我發現這包最簡潔。下載壓縮檔後將其解開，把裡面 bin 目錄下的執行檔複製到你想擺放的目錄。例如：c:\stm32\build tools\ OpenOCD : 這是燒 code 和 debug 的工具。下載壓縮檔，解壓到你想擺放的目錄。例如：c:\stm32\openocd\ VSCode : 這次的主角，編輯器和整合的操作介面。下載安裝程式執行，依指示安裝。安裝過程中有選項可將開啟檔案和開啟目錄加入滑鼠右鍵選單，建議打勾，以後開啟專案比較方便。 ST-Link Utility : STM32 原廠開發版的驅動程式和燒錄工具 STM32CubeMX (非必備): ST 提供的程式碼生成工具，利用它產生 makfile 的專案比較快 2. VSCode 的設定 由於 VSCode 的 Build 和 Debug 設定是存放在專案目錄下 .vscode/ 裡的 tasks.json 和 launch.json ，以下的操作必需是以 Folder 的方式開啟專案目錄才能用。你可以在檔案總管中，在專案的目錄上按右鍵，選"Open with Code"（安裝時必需有打開滑鼠右鍵選單功能）。或是在 VSCode 內用 "Open Folder" 打專案的目錄。 2.1 安裝 Extensions 第一次使用 VSCode 先從左側打開 Extensions 的側欄，安裝下列 Extensions。 C/C++ (Microsoft) Cortex-Debug 打開 settings，設定 cortex-debug 需要的路徑 "cortex-debug.openocdPath": "c:/stm32/openocd/bin/openocd.exe", "cortex-debug.armToolchainPat
閱讀完整內容

[STM32] 1. 在 Windows 下架設 gcc 開發環境

-
圖片
我的開發環境是在 Windows 下建立，以 DOS command line 為主，再搭配 eclipse 作為編輯器和整合開發工具。 1.1 編譯工具 GCC ARM Toolchain ( download page ): 下載最新 win32 版本的 zip 檔，解壓後放在自己習慣的目錄即可。我是建了一個 D:\ARM-SDK 目錄放 ARM 的開發工具，將 Toolchain 解壓縮到 D:\ARM-SDK\gcc-arm 中。 Cygwin : 需要裡面的 make, bash 和 shell 命令。將 view 切到 Category ，預設會裝 Base ，只要再增加 Devel 下的 make 就足夠了。 eclipse  ( download page  ): 下載  Eclipse IDE for C/C++ Developers 32bit 。雖然現在大家的 Windows 都是 64bit 的，但是 eclipse 是用 Java runtime environment (JRE) 上執行的，而大多數安裝的 JRE 都是 32bit 版本。為了必免不必要的麻煩，還是選擇 32bit 的就好。下載後解壓放在 D:\ARM-SDK\eclipse\ 中。 1.2 Debug 工具 OpenOCD ( download page ) : OpenOCD 是一款 On-Chip Debug 工具，能經由 JTAG 或 SWD 介面連上 ARM 進行 debug 工作，也具備燒錄程式的能力。支援不少 Adapter，包含 STM32 使用的 ST-LINK V2。重點是它是 Open source 的免費軟體，適合個人開發使用。下載後解壓到 D:\ARM-SDK 中。 Putty ( downlaod ) : Telnet 和 COM Port 的連線工具，用來連上 OpenOCD 和看 UART 的訊息。下蛓放在 D:\ARM-SDK 中。 1.3 STM32 開發板及相關工具 使用 NUCLEO-F446RE ( MCU : STM32F446RE ) 做為開發板，選擇 NUCLEO 系列有幾個原因： 自帶一個 SWD 和 Virtual Com Port ，不需再另外準備 ST-
閱讀完整內容