2022 iThome 鐵人賽

DAY 4

自我挑戰組

簡單入門 LibOpenCM3 STM32 嵌入式系統開發系列第 4 篇

[Day 4] STM32 LibOpenCM3：GPIO 輸出

14th鐵人賽 stm32 嵌入式系統

ZiTe

2022-09-17 13:29:58

1927 瀏覽

分享至

前言

終於要開始實際寫程式了，接續上一篇的內容，這次要教最基本的 LibOpenCM3 的 GPIO 輸出用法，會控制一個 LED 燈使其閃爍。

正文

先以 Nucleo-F446RE 做示範。

首先建立一個 PIO 的專案，選擇 Framework 爲「libopencm3」，並在 src/ 資料夾中新增並開啓 main.c 檔案。

完整程式

先把完整的程式打出來：

/**
 * @file   main.c
 * @brief  Blinking LED example for STM32 Nucleo-F446RE.
 */

#include <libopencm3/stm32/rcc.h>
#include <libopencm3/stm32/gpio.h>

/* User LED (LD2) connected to Arduino-D13 pin. */
#define RCC_LED_GPIO (RCC_GPIOA)
#define GPIO_LED_PORT (GPIOA)
#define GPIO_LED_PIN (GPIO5)

static void delay(uint32_t value)
{
  for (uint32_t i = 0; i < value; i++)
  {
    __asm__("nop"); /* Do nothing. */
  }
}

int main(void)
{
  /* Enable clock. */
  rcc_periph_clock_enable(RCC_LED_GPIO);

  /* Set LED pin to output push-pull. */
  gpio_mode_setup(GPIO_LED_PORT,
                  GPIO_MODE_OUTPUT,
                  GPIO_PUPD_NONE,
                  GPIO_LED_PIN);

  gpio_set_output_options(GPIO_LED_PORT,
                          GPIO_OTYPE_PP,
                          GPIO_OSPEED_2MHZ,
                          GPIO_LED_PIN);

  /* Start blinking. */
  while (1)
  {
    gpio_toggle(GPIO_LED_PORT, GPIO_LED_PIN); /* LED on/off. */
    delay(500000);
  }

  return 0;
}

分段說明

Include

#include <libopencm3/stm32/rcc.h>
#include <libopencm3/stm32/gpio.h>

如同其它的程式，首先要將需要用到的功能 Include 進來。本例中有兩個檔案要引入：

rcc.h：RCC 是 Reset and Clock Controller 的意思，由於基本上所有的 STM32 功能都需要 Clock，因此 RCC 通常是一定會用到的。
gpio.h：如如同它的名字，這就是包含了 GPIO 的各種功能。

LibOpenCM3 的這些檔案 PIO 都會幫我們處理好，所以不用另外下載或設定路徑，直接 #include 就可以了。

定義腳位

/* User LED (LD2) connected to Arduino-D13 pin. */
#define RCC_LED_GPIO (RCC_GPIOA)
#define GPIO_LED_PORT (GPIOA)
#define GPIO_LED_PIN (GPIO5)

因爲每個 STM32 Nucleo 開發板的 LED 腳位可能不同，因此使用 #define 來定義腳位比較方便程式的撰寫與修改。

根據資料手冊 UM1724，Nucleo-F446RE 的板載 LED（LD2）所在的腳位是 PA5（對應 Arduino 的 D13 腳位），也就是 GPIO Port-A 的 5 號腳，因此我們定義 GPIO_LED_PORT 爲 GPIOA，GPIO_LED_PIN 爲 GPIO5。

此外 RCC 也會需要依照 GPIO Port 進行設定，所以也定義一個 RCC_LED_GPIO 爲 RCC_GPIOA。

Delay 函式

static void delay(uint32_t value)
{
  for (uint32_t i = 0; i < value; i++)
  {
    __asm__("nop"); /* Do nothing. */
  }
}

這是一個最簡單暴力的 Delay 寫法，幾乎無精度可言，但目前我們只要這樣就夠了。

其中的 __asm__("nop") 代表嵌入組合語言的「nop」指令，也就是無操作（No operation）。

主程式

int main(void)
{
  /* Enable clock. */
  rcc_periph_clock_enable(RCC_LED_GPIO);

  /* Set LED pin to output push-pull. */
  gpio_mode_setup(GPIO_LED_PORT,
                  GPIO_MODE_OUTPUT,
                  GPIO_PUPD_NONE,
                  GPIO_LED_PIN);

  gpio_set_output_options(GPIO_LED_PORT,
                          GPIO_OTYPE_PP,
                          GPIO_OSPEED_2MHZ,
                          GPIO_LED_PIN);

  /* Start blinking. */
  while (1)
  {
    gpio_toggle(GPIO_LED_PORT, GPIO_LED_PIN); /* LED on/off. */
    delay(500000);
  }

  return 0;
}

rcc_periph_clock_enable()：這個函式會致能指定功能的 Clock。在這裡我們要啓用 LED 所在的 GPIO Port 的 Clock。
gpio_mode_setup()：爲指定的 GPIO 設定模式。
- GPIO_LED_PORT：要設定的 GPIO Port。
- GPIO_MODE_OUTPUT：設定爲「General Purpose Output」模式。
- GPIO_PUPD_NONE：設定爲不使用上下拉電阻。
- GPIO_LED_PIN：要設定的 GPIO Pin，若要在同一個 Port 中設定多個 Pin，各個 Pin 可以用 | 來複選。
gpio_set_output_options()：爲指定的 GPIO 設定輸出選項。
- GPIO_LED_PORT：要設定的 GPIO Port。
- GPIO_OTYPE_PP：設定輸出電路組態爲「Push-Pull（推挽）」。
- GPIO_OSPEED_2MHZ：設定速度。
- GPIO_LED_PIN：要設定的 GPIO Pin，若要在同一個 Port 中設定多個 Pin，各個 Pin 可以用 | 來複選。
gpio_toggle()：反轉該 GPIO 的輸出值。如果目前是輸出 High，那就變成輸出 Low，反之亦然。

編譯與燒錄/上傳

打完程式後，可以在 VS Code 左下方找到編譯（Build）和燒錄（Upload）的按鈕。也可以用快捷鍵「Ctrl+Alt+B」、「Ctrl+Alt+U」。

▲ PIO 的 Build 與 Upload 按鈕在 VS Code 的左下。

編譯完成後 PIO 會顯示佔用的資源：

RAM: 0.0% (used 0 bytes from 131072 bytes)
Flash: 0.1% (used 764 bytes from 524288 bytes)

記得燒錄前要用 USB 線接上 Nucleo，並安裝 ST-Link 的驅動程式，否則會報錯。

▲ 成果。

F103RB

STM32F1 系列的部分程式寫法不一樣，所以在此也提供 Nucleo-F103RB 的程式範例。主要差異只有 GPIO 的設定函式不同，STM32F1 用的是 gpio_set_mode()，而非 gpio_mode_setup() 與 gpio_set_output_options()。

/**
 * @file   main.c
 * @brief  Blinking LED example for STM32 Nucleo-F103RB.
 */

#include <libopencm3/stm32/rcc.h>
#include <libopencm3/stm32/gpio.h>

/* User LED (LD2) connected to Arduino-D13 pin. */
#define RCC_LED_GPIO (RCC_GPIOA)
#define GPIO_LED_PORT (GPIOA)
#define GPIO_LED_PIN (GPIO5)

static void delay(uint32_t value)
{
  for (uint32_t i = 0; i < value; i++)
  {
    __asm__("nop"); /* Do nothing. */
  }
}

int main(void)
{
  /* Enable clock. */
  rcc_periph_clock_enable(RCC_LED_GPIO);

  /* Set LED pin to output push-pull. */
  gpio_set_mode(GPIO_LED_PORT,
                GPIO_MODE_OUTPUT_2_MHZ,
                GPIO_CNF_OUTPUT_PUSHPULL,
                GPIO_LED_PIN);

  /* Start blinking. */
  while (1)
  {
    gpio_toggle(GPIO_LED_PORT, GPIO_LED_PIN); /* LED on/off. */
    delay(500000);
  }

  return 0;
}

PIO 環境

如果你的程式會需要在 F1 或 F4 等其它 STM32 系列上運作，那每次用 F1 時 GPIO 的寫法不同，或是有 Pin 腳不同的情況會很麻煩，所以這裡簡單介紹如何用 PIO 設定多個專案環境，方便切換。

▲ 設定好的環境可以在 VS Code 下方進行切換。

主程式

/**
 * @file   main.c
 * @brief  Blinking LED example for STM32 based on LibOpenCM3.
 */

#include <libopencm3/stm32/rcc.h>
#include <libopencm3/stm32/gpio.h>

/* User LED (LD2) connected to Arduino-D13 pin. */
#if defined(NUCLEO_F103RB) || defined(NUCLEO_F446RE)
  #define RCC_LED_GPIO (RCC_GPIOA)
  #define GPIO_LED_PORT (GPIOA)
  #define GPIO_LED_PIN (GPIO5)
#else
  #error "STM32 board not defined."
#endif

static void delay(uint32_t value)
{
  for (uint32_t i = 0; i < value; i++)
  {
    __asm__("nop"); /* Do nothing. */
  }
}

int main(void)
{
  /* Enable clock. */
  rcc_periph_clock_enable(RCC_LED_GPIO);

  /* Set LED pin to output push-pull. */
#if defined(STM32F1)
  gpio_set_mode(GPIO_LED_PORT,
                GPIO_MODE_OUTPUT_2_MHZ,
                GPIO_CNF_OUTPUT_PUSHPULL,
                GPIO_LED_PIN);
#else
  gpio_mode_setup(GPIO_LED_PORT,
                  GPIO_MODE_OUTPUT,
                  GPIO_PUPD_NONE,
                  GPIO_LED_PIN);

  gpio_set_output_options(GPIO_LED_PORT,
                          GPIO_OTYPE_PP,
                          GPIO_OSPEED_2MHZ,
                          GPIO_LED_PIN);
#endif

  /* Start blinking. */
  while (1)
  {
    gpio_toggle(GPIO_LED_PORT, GPIO_LED_PIN); /* LED on/off. */
    delay(500000);
  }

  return 0;
}

PIO 專案設定檔 `platformio.ini`：

[platformio]
default_envs = nucleo_f103rb

; Set/Override default options for each [env:XXX]
[env]
platform = ststm32
framework = libopencm3

[env:nucleo_f103rb]
board = nucleo_f103rb
build_flags = -D NUCLEO_F103RB

[env:nucleo_f446re]
board = nucleo_f446re
build_flags = -D NUCLEO_F446RE

小結

這次簡單介紹了 LibOpenCM3 的 GPIO 輸出用法，這部分只要有搞懂 STM32 的 GPIO 模式應該不會太難。

參考資料

本文的程式也都放在 GitHub 上。
本文同步發表於我的 Blog。

[Day 3] STM32 GPIO 簡介

[Day 5] STM32 LibOpenCM3：GPIO 輸入

系列文

簡單入門 LibOpenCM3 STM32 嵌入式系統開發共 30 篇

RSS系列文訂閱系列文

9 人訂閱

完整目錄

直播研討會

{{ item.channelVendor }} {{ item.webinarstarted }} |

直播中

尚未有邦友留言

立即登入留言

參賽組數

137 組

團體組數

1 組

累計文章數

224 篇

最後報名日

9/15

15th鐵人賽 13th鐵人賽 14th鐵人賽 12th鐵人賽 11th鐵人賽鐵人賽 2019鐵人賽 2018鐵人賽 javascript 2017鐵人賽 python windows php c# windows server linux css react 程式設計 vue.js

IT邦幫忙

簡單入門 LibOpenCM3 STM32 嵌入式系統開發系列 第 4 篇