CubeIDE Note 02: Start A New Project

教學

如何使用 CubeIDE 開啟新專案，並使用 CubeMX 做基礎設定

環境

本文使用
OS: Windows x64
STM32CubeIDE Version: 1.6.1
開發板: Nucleo — F334R8（STM32F334R8）

教學文章列表

CubeIDE Note Context | CubeIDE 教學系列目錄

還沒安裝CubeIDE的同學可以先參考Note1教學

CubeIDE Note 01: Installation Teaching (1.6.1 for win64)

開新專案

Step1.

開啟CubeIDE
第一個畫面可以設置所有的專案存放路徑，沒有特別需求，維持預設即可

設定工作區路徑（所有專案存放的根目錄）

按下 Launch
第一次進來，都會是這樣的歡迎畫面
新增專案之後再進來，基本上是直接開啟上一次使用的專案

歡迎畫面

Step2.

新增專案有兩種方式，第二種較常用：
第一種：歡迎畫面點 Start new STM32 Project
第二種：從左上角 File >> New 新增，如下圖

因為是開啟新專案，所以選STM32 Project即可
（會含CubeMX創建ioc功能，可使用Generate Code功能）
之後跳出來視窗在 MCU/MPU Selector 選取要使用的MCU
筆者這邊使用的是 STM32F334R8

MCU/MPU Selector 開出來的專案，ioc檔案是最乾淨的
但IO與時脈之類的設定，通通需要自己從頭設置
為了自定義方便，筆者通常是使用MCU/MPU Selector 從頭配置
本文也以此做為教學

若是使用開發板，也可使用 Board Selector
它會載入已配置好的ioc檔案，有開發板的IO相關與時脈等等設定

小技巧：按星號可以把常用的型號加入最愛，方便下次選取

MCU/MPU Selector

Board Selector

選取後按下Next
輸入專案名稱，其餘維持預設，即可按下Finish開新專案

輸入專案名

如果是第一次使用的開發板，會出現以下畫面下載必要檔案

未使用過的型號，會出現以下畫面下載必要檔案

專案新增中

之後專案就新增完成了，下一步我們將開啟CubeMX來進行設定

配置 CubeMX

Step 1.

這就是 CubeMX 的初始畫面，如果沒有這個畫面了話
請點選左邊的 Project Explore >> 專案名 >> 專案名.ioc 點兩下
就會打開這個畫面了

CubeMX 的初始畫面

Step. 2 配置Clock

Clock 最好是先配置好，之後再各項設定中會比較方便，
尤其是與計時器有關的設定

首先，展開 System Core 選擇 RCC，修改 HSE (High Speed Clock)設定
將 HSE 設置為 Crystal / Ceramic Resonator （使用板子上的晶振）

System Core >> RCC 修改 HSE 設定

之後，切換到 Clock Configuration，可以看到整個系統之 Clock Tree
就可以開始設定了，以下是針對 STM32F334R8 做的設定

設定前的 Clock Tree

PLL Source Mux 切換為 HSE
*PLLMul 設為 X9

PLL 設定

這邊我們可以看到 HSE 輸入的預設頻率為 8 MHz，就是配合開發板上的石英晶體震盪器（Crystal Oscillator），CubeMX 已經內建好了，對應首段提到的RCC設定

開發板上的 X1（Crystal Oscillator） 為 8 MHz

System Clock Mux 切換為 PLLCLK

System Clock Mux 設定

APB1 Prescaler 設為 /2

APB1 Prescaler 設定

基本上Clock Tree到這邊就設定完成了，其餘維持預設即可
其他部分會在以後用到時做修改

設定完後的 Clock Tree

Step 3. 設定 Debug 模式

展開 System Core 選擇 RCC
Debug 設為 Serial Wire (SWD)

System Core >> RCC 修改 Debug 設定

SWD 與 ST-Link的參考資料

浅论各种调试接口（SWD、JTAG、Jlink、Ulink、STlink）的区别_不积跬步，无以至千里！-CSDN博客_swd接口

到這邊基本上起手式就完成了
之後的教學也都會基於此設定再做額外設定，請操作熟練

Step. 4 Generate Code

按下 Project >> Gernate Code 即可產生一份
基於剛剛設定產生出來的Code了
記得每次修改完設定都要重新產生一次Code，設定才會更新喔

附錄

參考手冊官方下載連結

Datasheet. STM32F334x4 STM32F334x6 STM32F334x8

https://www.st.com/resource/en/datasheet/stm32f334k4.pdf

RM0364. STM32F334xx advanced Arm®-based 32-bit MCUs

https://www.st.com/resource/en/reference_manual/dm00093941-stm32f334xx-advanced-armbased-32bit-mcus-stmicroelectronics.pdf

UM1735. Discovery kit for STM32F3 series with STM32F334C8 MCU

https://www.st.com/resource/en/user_manual/dm00108524--discovery-kit-for-stm32f3-series-with-stm32f334c8-mcu-stmicroelectronics.pdf

UM2609. STM32CubeIDE user guide

https://www.st.com/resource/en/user_manual/dm00629856-stm32cubeide-user-guide-stmicroelectronics.pdf

UM1718. STM32CubeMX for STM32 configuration and initialization C code generation

https://www.st.com/resource/en/user_manual/dm00104712-stm32cubemx-for-stm32-configuration-and-initialization-c-code-generation-stmicroelectronics.pdf

UM2570. Description of STM32G4 HAL and low-layer drivers

https://www.st.com/resource/en/user_manual/dm00610707-description-of-stm32g4-hal-and-lowlayer-drivers--stmicroelectronics.pdf