8、nRF52xx蓝牙学习（boards.h文件学习）

news2025/4/18 2:48:32

boards.h文件的代码如下：

#ifndef BOARDS_H
#define BOARDS_H

#include "nrf_gpio.h"
#include "nordic_common.h"

#if defined(BOARD_NRF6310)
  #include "nrf6310.h"
#elif defined(BOARD_PCA10000)
  #include "pca10000.h"
#elif defined(BOARD_PCA10001)
  #include "pca10001.h"
#elif defined(BOARD_PCA10002)
  #include "pca10000.h"
#elif defined(BOARD_PCA10003)
  #include "pca10003.h"
#elif defined(BOARD_PCA20006)
  #include "pca20006.h"
#elif defined(BOARD_PCA10028)
  #include "pca10028.h"
#elif defined(BOARD_PCA10031)
  #include "pca10031.h"
#elif defined(BOARD_PCA10036)
  #include "pca10036.h"
#elif defined(BOARD_PCA10040)
  #include "pca10040.h"
#elif defined(BOARD_PCA10056)
  #include "pca10056.h"
#elif defined(BOARD_PCA10100)
  #include "pca10100.h"
#elif defined(BOARD_PCA10112)
  #include "pca10112.h"  
#elif defined(BOARD_PCA20020)
  #include "pca20020.h"
#elif defined(BOARD_PCA10059)
  #include "pca10059.h"
#elif defined(BOARD_WT51822)
  #include "wt51822.h"
#elif defined(BOARD_N5DK1)
  #include "n5_starterkit.h"
#elif defined (BOARD_D52DK1)
  #include "d52_starterkit.h"
#elif defined (BOARD_ARDUINO_PRIMO)
  #include "arduino_primo.h"
#elif defined (CUSTOM_BOARD_INC)
  #include STRINGIFY(CUSTOM_BOARD_INC.h)
#elif defined(BOARD_CUSTOM)
  #include "custom_board.h"
#else
#error "Board is not defined"

#endif

#if defined (SHIELD_BSP_INC)
  #include STRINGIFY(SHIELD_BSP_INC.h)
#endif

#ifdef __cplusplus
extern "C" {
#endif

/**@defgroup BSP_BOARD_INIT_FLAGS Board initialization flags.
 * @{ */
#define BSP_INIT_NONE    0        /**< No initialization of LEDs or buttons (@ref bsp_board_init).*/
#define BSP_INIT_LEDS    (1 << 0) /**< Enable LEDs during initialization (@ref bsp_board_init).*/
#define BSP_INIT_BUTTONS (1 << 1) /**< Enable buttons during initialization (@ref bsp_board_init).*/
/**@} */

/**
 * Function for returning the state of an LED.
 *
 * @param led_idx LED index (starting from 0), as defined in the board-specific header.
 *
 * @return True if the LED is turned on.
 */
bool bsp_board_led_state_get(uint32_t led_idx);

/**
 * Function for turning on an LED.
 *
 * @param led_idx LED index (starting from 0), as defined in the board-specific header.
 */
void bsp_board_led_on(uint32_t led_idx);

/**
 * Function for turning off an LED.
 *
 * @param led_idx LED index (starting from 0), as defined in the board-specific header.
 */
void bsp_board_led_off(uint32_t led_idx);

/**
 * Function for inverting the state of an LED.
 *
 * @param led_idx LED index (starting from 0), as defined in the board-specific header.
 */
void bsp_board_led_invert(uint32_t led_idx);
/**
 * Function for turning off all LEDs.
 */
void bsp_board_leds_off(void);

/**
 * Function for turning on all LEDs.
 */
void bsp_board_leds_on(void);

/**
 * Function for initializing the BSP handling for the board.
 *
 * @note This also initializes the USB DFU trigger library if @ref BOARDS_WITH_USB_DFU_TRIGGER is 1.
 *
 * @param[in]  init_flags  Flags specifying what to initialize (LEDs/buttons).
 *                         See @ref BSP_BOARD_INIT_FLAGS.
 */
void bsp_board_init(uint32_t init_flags);

/**
 * Function for converting pin number to LED index.
 *
 * @param pin_number Pin number.
 *
 * @return LED index of the given pin or 0xFFFFFFFF if invalid pin provided.
 */
uint32_t bsp_board_pin_to_led_idx(uint32_t pin_number);

/**
 * Function for converting LED index to pin number.
 *
 * @param led_idx LED index.
 *
 * @return Pin number.
 */
uint32_t bsp_board_led_idx_to_pin(uint32_t led_idx);

/**
 * Function for returning the state of a button.
 *
 * @param button_idx Button index (starting from 0), as defined in the board-specific header.
 *
 * @return True if the button is pressed.
 */
bool bsp_board_button_state_get(uint32_t button_idx);

/**
 * Function for converting pin number to button index.
 *
 * @param pin_number Pin number.
 *
 * @return Button index of the given pin or 0xFFFFFFFF if invalid pin provided.
 */
uint32_t bsp_board_pin_to_button_idx(uint32_t pin_number);


/**
 * Function for converting button index to pin number.
 *
 * @param button_idx Button index.
 *
 * @return Pin number.
 */
uint32_t bsp_board_button_idx_to_pin(uint32_t button_idx);

#define BSP_BOARD_LED_0 0
#define BSP_BOARD_LED_1 1
#define BSP_BOARD_LED_2 2
#define BSP_BOARD_LED_3 3
#define BSP_BOARD_LED_4 4
#define BSP_BOARD_LED_5 5
#define BSP_BOARD_LED_6 6
#define BSP_BOARD_LED_7 7

#define PIN_MASK(_pin)  /*lint -save -e504 */                     \
                        (1u << (uint32_t)((_pin) & (~P0_PIN_NUM))) \
                        /*lint -restore    */

#define PIN_PORT(_pin) (((_pin) >= P0_PIN_NUM) ? NRF_P1 : NRF_GPIO)

#ifdef BSP_LED_0
#define BSP_LED_0_MASK PIN_MASK(BSP_LED_0)
#define BSP_LED_0_PORT PIN_PORT(BSP_LED_0)
#else
#define BSP_LED_0_MASK 0
#define BSP_LED_0_PORT 0
#endif
#ifdef BSP_LED_1
#define BSP_LED_1_MASK PIN_MASK(BSP_LED_1)
#define BSP_LED_1_PORT PIN_PORT(BSP_LED_1)
#else
#define BSP_LED_1_MASK 0
#define BSP_LED_1_PORT 0
#endif
#ifdef BSP_LED_2
#define BSP_LED_2_MASK PIN_MASK(BSP_LED_2)
#define BSP_LED_2_PORT PIN_PORT(BSP_LED_2)
#else
#define BSP_LED_2_MASK 0
#define BSP_LED_2_PORT 0
#endif
#ifdef BSP_LED_3
#define BSP_LED_3_MASK PIN_MASK(BSP_LED_3)
#define BSP_LED_3_PORT PIN_PORT(BSP_LED_3)
#else
#define BSP_LED_3_MASK 0
#define BSP_LED_3_PORT 0
#endif
#ifdef BSP_LED_4
#define BSP_LED_4_MASK PIN_MASK(BSP_LED_4)
#define BSP_LED_4_PORT PIN_PORT(BSP_LED_4)
#else
#define BSP_LED_4_MASK 0
#define BSP_LED_4_PORT 0
#endif
#ifdef BSP_LED_5
#define BSP_LED_5_MASK PIN_MASK(BSP_LED_5)
#define BSP_LED_5_PORT PIN_PORT(BSP_LED_5)
#else
#define BSP_LED_5_MASK 0
#define BSP_LED_5_PORT 0
#endif
#ifdef BSP_LED_6
#define BSP_LED_6_MASK PIN_MASK(BSP_LED_6)
#define BSP_LED_6_PORT PIN_PORT(BSP_LED_6)
#else
#define BSP_LED_6_MASK 0
#define BSP_LED_6_PORT 0
#endif
#ifdef BSP_LED_7
#define BSP_LED_7_MASK PIN_MASK(BSP_LED_7)
#define BSP_LED_7_PORT PIN_PORT(BSP_LED_7)
#else
#define BSP_LED_7_MASK 0
#define BSP_LED_7_PORT 0
#endif


#define LEDS_MASK      (BSP_LED_0_MASK | BSP_LED_1_MASK | \
                        BSP_LED_2_MASK | BSP_LED_3_MASK | \
                        BSP_LED_4_MASK | BSP_LED_5_MASK | \
                        BSP_LED_6_MASK | BSP_LED_7_MASK)

#define BSP_BOARD_BUTTON_0 0
#define BSP_BOARD_BUTTON_1 1
#define BSP_BOARD_BUTTON_2 2
#define BSP_BOARD_BUTTON_3 3
#define BSP_BOARD_BUTTON_4 4
#define BSP_BOARD_BUTTON_5 5
#define BSP_BOARD_BUTTON_6 6
#define BSP_BOARD_BUTTON_7 7


#ifdef BSP_BUTTON_0
#define BSP_BUTTON_0_MASK (1<<BSP_BUTTON_0)
#else
#define BSP_BUTTON_0_MASK 0
#endif
#ifdef BSP_BUTTON_1
#define BSP_BUTTON_1_MASK (1<<BSP_BUTTON_1)
#else
#define BSP_BUTTON_1_MASK 0
#endif
#ifdef BSP_BUTTON_2
#define BSP_BUTTON_2_MASK (1<<BSP_BUTTON_2)
#else
#define BSP_BUTTON_2_MASK 0
#endif
#ifdef BSP_BUTTON_3
#define BSP_BUTTON_3_MASK (1<<BSP_BUTTON_3)
#else
#define BSP_BUTTON_3_MASK 0
#endif
#ifdef BSP_BUTTON_4
#define BSP_BUTTON_4_MASK (1<<BSP_BUTTON_4)
#else
#define BSP_BUTTON_4_MASK 0
#endif
#ifdef BSP_BUTTON_5
#define BSP_BUTTON_5_MASK (1<<BSP_BUTTON_5)
#else
#define BSP_BUTTON_5_MASK 0
#endif
#ifdef BSP_BUTTON_6
#define BSP_BUTTON_6_MASK (1<<BSP_BUTTON_6)
#else
#define BSP_BUTTON_6_MASK 0
#endif
#ifdef BSP_BUTTON_7
#define BSP_BUTTON_7_MASK (1<<BSP_BUTTON_7)
#else
#define BSP_BUTTON_7_MASK 0
#endif

#define BUTTONS_MASK   (BSP_BUTTON_0_MASK | BSP_BUTTON_1_MASK | \
                        BSP_BUTTON_2_MASK | BSP_BUTTON_3_MASK | \
                        BSP_BUTTON_4_MASK | BSP_BUTTON_5_MASK | \
                        BSP_BUTTON_6_MASK | BSP_BUTTON_7_MASK)


/* This macro is supporting only P0 and should not be used if LEDs are on other ports. */
#define LEDS_OFF(leds_mask) do {  ASSERT(sizeof(leds_mask) == 4);                     \
                        NRF_GPIO->OUTSET = (leds_mask) & (LEDS_MASK & LEDS_INV_MASK); \
                        NRF_GPIO->OUTCLR = (leds_mask) & (LEDS_MASK & ~LEDS_INV_MASK); } while (0)

/* This macro is supporting only P0 and should not be used if LEDs are on other ports. */
#define LEDS_ON(leds_mask) do {  ASSERT(sizeof(leds_mask) == 4);                     \
                       NRF_GPIO->OUTCLR = (leds_mask) & (LEDS_MASK & LEDS_INV_MASK); \
                       NRF_GPIO->OUTSET = (leds_mask) & (LEDS_MASK & ~LEDS_INV_MASK); } while (0)

/* This macro is supporting only P0 and should not be used if LEDs are on other ports. */
#define LED_IS_ON(leds_mask) ((leds_mask) & (NRF_GPIO->OUT ^ LEDS_INV_MASK) )

/* This macro is supporting only P0 and should not be used if LEDs are on other ports. */
#define LEDS_INVERT(leds_mask) do { uint32_t gpio_state = NRF_GPIO->OUT;      \
                              ASSERT(sizeof(leds_mask) == 4);                 \
                              NRF_GPIO->OUTSET = ((leds_mask) & ~gpio_state); \
                              NRF_GPIO->OUTCLR = ((leds_mask) & gpio_state); } while (0)

/* This macro is supporting only P0 and should not be used if LEDs are on other ports. */
#define LEDS_CONFIGURE(leds_mask) do { uint32_t pin;                  \
                                  ASSERT(sizeof(leds_mask) == 4);     \
                                  for (pin = 0; pin < 32; pin++)      \
                                      if ( (leds_mask) & (1 << pin) ) \
                                          nrf_gpio_cfg_output(pin); } while (0)

#ifdef __cplusplus
}
#endif

#endif

代码理解如下：

这是一个名为 BOARDS_H 的头文件代码，主要用于定义与开发板相关的配置、引脚操作函数声明以及一些常用的宏定义。

下面对其进行详细解释：

1. 头文件保护

 #ifndef BOARDS_H
#define BOARDS_H


   这是头文件保护宏，防止该头文件被重复包含，确保头文件中的内容在一个编译单元中只被处理一次。

2. 包含其他头文件

#include "nrf_gpio.h"
#include "nordic_common.h"


   包含了 nrf_gpio.h 和 nordic_common.h 头文件，前者可能提供了与 Nordic 芯片 GPIO 操作相关的定义和函数声明，后者可能包含了 Nordic 相关的通用定义和工具函数。

3. 根据不同开发板包含对应头文件

 #if defined(BOARD_NRF6310)
  #include "nrf6310.h"
#elif defined(BOARD_PCA10000)
  #include "pca10000.h"
#elif defined(BOARD_PCA10001)
  #include "pca10001.h"
#elif defined(BOARD_PCA10002)
  #include "pca10000.h"
#elif defined(BOARD_PCA10003)
  #include "pca10003.h"
#elif defined(BOARD_PCA20006)
  #include "pca20006.h"
#elif defined(BOARD_PCA10028)
  #include "pca10028.h"
#elif defined(BOARD_PCA10031)
  #include "pca10031.h"
#elif defined(BOARD_PCA10036)
  #include "pca10036.h"
#elif defined(BOARD_PCA10040)
  #include "pca10040.h"
#elif defined(BOARD_PCA10056)
  #include "pca10056.h"
#elif defined(BOARD_PCA10100)
  #include "pca10100.h"
#elif defined(BOARD_PCA10112)
  #include "pca10112.h"  
#elif defined(BOARD_PCA20020)
  #include "pca20020.h"
#elif defined(BOARD_PCA10059)
  #include "pca10059.h"
#elif defined(BOARD_WT51822)
  #include "wt51822.h"
#elif defined(BOARD_N5DK1)
  #include "n5_starterkit.h"
#elif defined (BOARD_D52DK1)
  #include "d52_starterkit.h"
#elif defined (BOARD_ARDUINO_PRIMO)
  #include "arduino_primo.h"
#elif defined (CUSTOM_BOARD_INC)
  #include STRINGIFY(CUSTOM_BOARD_INC.h)
#elif defined(BOARD_CUSTOM)
  #include "custom_board.h"
#else
#error "Board is not defined"
#endif
   

根据不同的 BOARD_* 宏定义，包含相应开发板的特定头文件。如果没有定义任何一个已知的开发板宏，则会产生编译错误，提示 Board is not defined。

4. 包含扩展板相关头文件

 #if defined (SHIELD_BSP_INC)
 #include STRINGIFY(SHIELD_BSP_INC.h)
#endif


   如果定义了 SHIELD_BSP_INC 宏，则包含相应的扩展板头文件。

5. C++ 兼容声明

 #ifdef __cplusplus
extern "C" {
#endif
   

如果是 C++ 编译环境，使用 extern "C" 声明，确保 C 语言风格的函数声明在 C++ 中具有正确的链接属性，以便 C++ 代码可以调用这些函数。

6. 开发板初始化标志宏定义

 #define BSP_INIT_NONE    0        /**< No initialization of LEDs or buttons (@ref bsp_board_init).*/
#define BSP_INIT_LEDS    (1 << 0) /**< Enable LEDs during initialization (@ref bsp_board_init).*/
#define BSP_INIT_BUTTONS (1 << 1) /**< Enable buttons during initialization (@ref bsp_board_init).*/
 

 定义了三个宏，用于表示开发板初始化时的不同标志：

• BSP_INIT_NONE：表示不初始化 LED 和按键。

• BSP_INIT_LEDS：表示初始化时启用 LED。

• BSP_INIT_BUTTONS：表示初始化时启用按键。

 7. LED 操作函数声明

bool bsp_board_led_state_get(uint32_t led_idx);
void bsp_board_led_on(uint32_t led_idx);
void bsp_board_led_off(uint32_t led_idx);
void bsp_board_led_invert(uint32_t led_idx);
void bsp_board_leds_off(void);
void bsp_board_leds_on(void);
   

声明了一系列与 LED 操作相关的函数：

• bsp_board_led_state_get：获取指定 LED 的状态（是否点亮）。

• bsp_board_led_on：点亮指定的 LED。

• bsp_board_led_off：熄灭指定的 LED。

• bsp_board_led_invert：反转指定 LED 的状态。

• bsp_board_leds_off：熄灭所有 LED。

• bsp_board_leds_on：点亮所有 LED。  

8. 开发板初始化函数声明

  void bsp_board_init(uint32_t init_flags);


   声明了开发板初始化函数 bsp_board_init，接受一个 init_flags 参数，根据传入的标志决定初始化哪些部分（如 LED 和按键）。

9. 引脚与 LED 索引转换函数声明

 uint32_t bsp_board_pin_to_led_idx(uint32_t pin_number);
uint32_t bsp_board_led_idx_to_pin(uint32_t led_idx);
 

 声明了两个函数用于在引脚编号和 LED 索引之间进行转换：

• bsp_board_pin_to_led_idx：将引脚编号转换为 LED 索引。

• bsp_board_led_idx_to_pin：将 LED 索引转换为引脚编号。  

10. 按键操作函数声明

 bool bsp_board_button_state_get(uint32_t button_idx);
uint32_t bsp_board_pin_to_button_idx(uint32_t pin_number);
uint32_t bsp_board_button_idx_to_pin(uint32_t button_idx);
   

声明了一系列与按键操作相关的函数：

• bsp_board_button_state_get：获取指定按键的状态（是否按下）。 • bsp_board_pin_to_button_idx：将引脚编号转换为按键索引。

• bsp_board_button_idx_to_pin：将按键索引转换为引脚编号。  

11. LED 和按键编号宏定义

 #define BSP_BOARD_LED_0 0
#define BSP_BOARD_LED_1 1
#define BSP_BOARD_LED_2 2
#define BSP_BOARD_LED_3 3
#define BSP_BOARD_LED_4 4
#define BSP_BOARD_LED_5 5
#define BSP_BOARD_LED_6 6
#define BSP_BOARD_LED_7 7

#define BSP_BOARD_BUTTON_0 0
#define BSP_BOARD_BUTTON_1 1
#define BSP_BOARD_BUTTON_2 2
#define BSP_BOARD_BUTTON_3 3
#define BSP_BOARD_BUTTON_4 4
#define BSP_BOARD_BUTTON_5 5
#define BSP_BOARD_BUTTON_6 6
#define BSP_BOARD_BUTTON_7 7
   定义了 LED 和按键的编号宏，从 0 到 7，用于标识不同的 LED 和按键。

12. 引脚掩码和端口宏定义

  #define PIN_MASK(_pin)  /*lint -save -e504 */                     \
                        (1u << (uint32_t)((_pin) & (~P0_PIN_NUM))) \
                        /*lint -restore    */

#define PIN_PORT(_pin) (((_pin) >= P0_PIN_NUM) ? NRF_P1 : NRF_GPIO)


   • PIN_MASK：根据引脚编号生成引脚掩码，用于后续对引脚的操作。

• PIN_PORT：根据引脚编号判断引脚所属的端口（NRF_P1 或 NRF_GPIO）。  

13. 每个 LED 的掩码和端口定义

 #ifdef BSP_LED_0
#define BSP_LED_0_MASK PIN_MASK(BSP_LED_0)
#define BSP_LED_0_PORT PIN_PORT(BSP_LED_0)
#else
#define BSP_LED_0_MASK 0
#define BSP_LED_0_PORT 0
#endif
// 其他 LED 类似
   根据是否定义了相应的 BSP_LED_X 宏，为每个 LED 生成掩码和端口定义。如果未定义，则掩码和端口都设为 0。

14. 所有 LED 和按键的总掩码宏定义

  #define LEDS_MASK      (BSP_LED_0_MASK | BSP_LED_1_MASK | \
                        BSP_LED_2_MASK | BSP_LED_3_MASK | \
                        BSP_LED_4_MASK | BSP_LED_5_MASK | \
                        BSP_LED_6_MASK | BSP_LED_7_MASK)

#define BUTTONS_MASK   (BSP_BUTTON_0_MASK | BSP_BUTTON_1_MASK | \
                        BSP_BUTTON_2_MASK | BSP_BUTTON_3_MASK | \
                        BSP_BUTTON_4_MASK | BSP_BUTTON_5_MASK | \
                        BSP_BUTTON_6_MASK | BSP_BUTTON_7_MASK)
   

分别将所有 LED 和按键的掩码进行按位或操作，得到所有 LED 和按键的总掩码。

15. LED 控制宏定义

 #define LEDS_OFF(leds_mask) do {  ASSERT(sizeof(leds_mask) == 4);                     \
                        NRF_GPIO->OUTSET = (leds_mask) & (LEDS_MASK & LEDS_INV_MASK); \
                        NRF_GPIO->OUTCLR = (leds_mask) & (LEDS_MASK & ~LEDS_INV_MASK); } while (0)

#define LEDS_ON(leds_mask) do {  ASSERT(sizeof(leds_mask) == 4);                     \
                       NRF_GPIO->OUTCLR = (leds_mask) & (LEDS_MASK & LEDS_INV_MASK); \
                       NRF_GPIO->OUTSET = (leds_mask) & (LEDS_MASK & ~LEDS_INV_MASK); } while (0)

#define LED_IS_ON(leds_mask) ((leds_mask) & (NRF_GPIO->OUT ^ LEDS_INV_MASK) )

#define LEDS_INVERT(leds_mask) do { uint32_t gpio_state = NRF_GPIO->OUT;      \
                              ASSERT(sizeof(leds_mask) == 4);                 \
                              NRF_GPIO->OUTSET = ((leds_mask) & ~gpio_state); \
                              NRF_GPIO->OUTCLR = ((leds_mask) & gpio_state); } while (0)

#define LEDS_CONFIGURE(leds_mask) do { uint32_t pin;                  \
                                  ASSERT(sizeof(leds_mask) == 4);     \
                                  for (pin = 0; pin < 32; pin++)      \
                                      if ( (leds_mask) & (1 << pin) ) \
                                          nrf_gpio_cfg_output(pin); } while (0)


   定义了一系列用于控制 LED 的宏：

• LEDS_OFF：熄灭指定的 LED。

• LEDS_ON：点亮指定的 LED。

• LED_IS_ON：判断指定的 LED 是否点亮。

• LEDS_INVERT：反转指定 LED 的状态。

• LEDS_CONFIGURE：将指定的引脚配置为输出模式，用于控制 LED。  

16. C++ 兼容结束声明

  #ifdef __cplusplus
}
#endif
   如果是 C++ 编译环境，结束 extern "C" 声明。

17. 头文件保护宏结束

#endif
   结束头文件保护宏，确保头文件内容只被包含一次。 总的来说，这个头文件为开发板的 GPIO 操作，特别是 LED 和按键的控制，提供了统一的接口和配置方式，方便在不同的开发板上进行应用开发。

以下是对 BOARDS_H 头文件中定义的函数和宏的功能详细说明：

函数 1. LED 操作函数

• bool bsp_board_led_state_get(uint32_t led_idx); ◦

功能：获取指定索引的 LED 当前状态。若 LED 处于点亮状态则返回 true，反之返回 false。 ◦ 参数：led_idx 是 LED 的索引，从 0 开始计数。  

• void bsp_board_led_on(uint32_t led_idx); ◦

功能：点亮指定索引的 LED。 ◦ 参数：led_idx 是 LED 的索引，从 0 开始计数。  

• void bsp_board_led_off(uint32_t led_idx); ◦

功能：熄灭指定索引的 LED。 ◦ 参数：led_idx 是 LED 的索引，从 0 开始计数。  

• void bsp_board_led_invert(uint32_t led_idx); ◦

功能：反转指定索引 LED 的状态，即若 LED 点亮则熄灭，若熄灭则点亮。 ◦

参数：led_idx 是 LED 的索引，从 0 开始计数。  

• void bsp_board_leds_off(void); ◦

功能：熄灭开发板上的所有 LED。  

• void bsp_board_leds_on(void); ◦

功能：点亮开发板上的所有 LED。    

2. 开发板初始化函数

• void bsp_board_init(uint32_t init_flags); ◦

功能：对开发板进行初始化操作，依据传入的 init_flags 参数来决定初始化哪些部分（如 LED 和按键）。 

参数：init_flags 是初始化标志，可通过 BSP_INIT_NONE、BSP_INIT_LEDS、BSP_INIT_BUTTONS 等宏进行组合。    

3. 引脚与 LED 索引转换函数

• uint32_t bsp_board_pin_to_led_idx(uint32_t pin_number); ◦

功能：把引脚编号转换为对应的 LED 索引。若传入的引脚编号无效，则返回 0xFFFFFFFF。 ◦

参数：pin_number 是引脚编号。  

• uint32_t bsp_board_led_idx_to_pin(uint32_t led_idx); ◦

功能：将 LED 索引转换为对应的引脚编号。 ◦

参数：led_idx 是 LED 的索引，从 0 开始计数。    

4. 按键操作函数

• bool bsp_board_button_state_get(uint32_t button_idx); ◦

功能：获取指定索引的按键当前状态。若按键被按下则返回 true，反之返回 false。 ◦

参数：button_idx 是按键的索引，从 0 开始计数。  

• uint32_t bsp_board_pin_to_button_idx(uint32_t pin_number); ◦

功能：把引脚编号转换为对应的按键索引。若传入的引脚编号无效，则返回 0xFFFFFFFF。 ◦

参数：pin_number 是引脚编号。  

• uint32_t bsp_board_button_idx_to_pin(uint32_t button_idx); ◦

功能：将按键索引转换为对应的引脚编号。 ◦

参数：button_idx 是按键的索引，从 0 开始计数。    

宏 1. 开发板初始化标志宏

• #define BSP_INIT_NONE 0 ◦

功能：表示在初始化时不初始化 LED 和按键。  

• #define BSP_INIT_LEDS (1 << 0) ◦

功能：表示在初始化时启用 LED。  

• #define BSP_INIT_BUTTONS (1 << 1) ◦

功能：表示在初始化时启用按键。    

2. 引脚掩码和端口宏

• #define PIN_MASK(_pin) (1u << (uint32_t)((_pin) & (~P0_PIN_NUM))) ◦

功能：根据传入的引脚编号 _pin 生成对应的引脚掩码，用于后续对引脚的操作。  

• #define PIN_PORT(_pin) (((_pin) >= P0_PIN_NUM) ? NRF_P1 : NRF_GPIO) ◦

功能：依据传入的引脚编号 _pin 判断该引脚所属的端口，若引脚编号大于等于 P0_PIN_NUM 则属于 NRF_P1 端口，否则属于 NRF_GPIO 端口。    

3. LED 和按键掩码宏

• #define LEDS_MASK (BSP_LED_0_MASK | BSP_LED_1_MASK | ... | BSP_LED_7_MASK) ◦ 功能：将所有 LED 的掩码进行按位或操作，得到所有 LED 的总掩码，用于对所有 LED 进行统一操作。  

• #define BUTTONS_MASK (BSP_BUTTON_0_MASK | BSP_BUTTON_1_MASK | ... | BSP_BUTTON_7_MASK) ◦

功能：将所有按键的掩码进行按位或操作，得到所有按键的总掩码，用于对所有按键进行统一操作。    

4. LED 控制宏

• #define LEDS_OFF(leds_mask) ◦

功能：熄灭由 leds_mask 指定的 LED。此宏仅支持 P0 端口，若 LED 位于其他端口则不适用。  

• #define LEDS_ON(leds_mask) ◦

功能：点亮由 leds_mask 指定的 LED。此宏仅支持 P0 端口，若 LED 位于其他端口则不适用。  

• #define LED_IS_ON(leds_mask) ◦

功能：判断由 leds_mask 指定的 LED 是否点亮。此宏仅支持 P0 端口，若 LED 位于其他端口则不适用。  

• #define LEDS_INVERT(leds_mask) ◦

功能：反转由 leds_mask 指定的 LED 的状态。此宏仅支持 P0 端口，若 LED 位于其他端口则不适用。  

• #define LEDS_CONFIGURE(leds_mask) ◦

功能：将由 leds_mask 指定的引脚配置为输出模式，用于控制 LED。此宏仅支持 P0 端口，若 LED 位于其他端口则不适用。

除了上述函数，BOARDS_H中还定义了哪些有用的功能？  

 除了前面提到的函数，BOARDS_H 头文件中还定义了很多其他有用的功能，主要通过宏定义和条件编译来实现，下面为你详细介绍：

1. 开发板特定头文件的包含

#if defined(BOARD_NRF6310)
  #include "nrf6310.h"
#elif defined(BOARD_PCA10000)
  #include "pca10000.h"
# ... 其他类似条件编译
#else
#error "Board is not defined"
#endif
   • 功能：根据不同的 BOARD_* 宏定义，包含相应开发板的特定头文件。若未定义任何已知的开发板宏，会产生编译错误，提示用户需要定义开发板类型。这使得代码能够适配不同的硬件开发板，增强了代码的可移植性。  

2. 扩展板头文件的包含 c       #if defined (SHIELD_BSP_INC)
  #include STRINGIFY(SHIELD_BSP_INC.h)
#endif
   • 功能：如果定义了 SHIELD_BSP_INC 宏，就会包含对应的扩展板头文件。这为开发板添加扩展功能提供了便利，用户可以根据需要启用不同的扩展板。  

3. 开发板初始化标志宏定义 c       #define BSP_INIT_NONE    0
#define BSP_INIT_LEDS    (1 << 0)
#define BSP_INIT_BUTTONS (1 << 1)
   • 功能：这些宏用于表示开发板初始化时的不同标志。BSP_INIT_NONE 表示不初始化 LED 和按键；BSP_INIT_LEDS 表示初始化时启用 LED；BSP_INIT_BUTTONS 表示初始化时启用按键。可以通过位运算组合这些标志，灵活控制开发板的初始化过程。  

4. LED 和按键编号宏定义 c       #define BSP_BOARD_LED_0 0
#define BSP_BOARD_LED_1 1
# ... 其他 LED 编号宏

#define BSP_BOARD_BUTTON_0 0
#define BSP_BOARD_BUTTON_1 1
# ... 其他按键编号宏
   • 功能：为开发板上的 LED 和按键定义了统一的编号，从 0 开始计数。这些编号可用于后续的 LED 和按键操作函数，提高了代码的可读性和可维护性。  

5. 引脚掩码和端口宏定义 c       #define PIN_MASK(_pin)  (1u << (uint32_t)((_pin) & (~P0_PIN_NUM)))
#define PIN_PORT(_pin) (((_pin) >= P0_PIN_NUM) ? NRF_P1 : NRF_GPIO)
   • PIN_MASK(_pin)：根据传入的引脚编号 _pin 生成对应的引脚掩码。引脚掩码可用于位操作，方便对特定引脚进行控制。 • PIN_PORT(_pin)：根据引脚编号判断引脚所属的端口。如果引脚编号大于等于 P0_PIN_NUM，则认为该引脚属于 NRF_P1 端口，否则属于 NRF_GPIO 端口。

 6. 每个 LED 和按键的掩码和端口定义 c       #ifdef BSP_LED_0
#define BSP_LED_0_MASK PIN_MASK(BSP_LED_0)
#define BSP_LED_0_PORT PIN_PORT(BSP_LED_0)
#else
#define BSP_LED_0_MASK 0
#define BSP_LED_0_PORT 0
#endif
# ... 其他 LED 类似

#ifdef BSP_BUTTON_0
#define BSP_BUTTON_0_MASK (1<<BSP_BUTTON_0)
#else
#define BSP_BUTTON_0_MASK 0
#endif
# ... 其他按键类似
   • 功能：对于每个 LED 和按键，如果对应的宏（如 BSP_LED_0、BSP_BUTTON_0）被定义，则使用 PIN_MASK 和 PIN_PORT 宏生成对应的掩码和端口；否则，将掩码和端口都定义为 0。这为每个 LED 和按键提供了独立的掩码和端口信息，方便对单个元件进行操作。  

7. 所有 LED 和按键的总掩码宏定义 c       #define LEDS_MASK      (BSP_LED_0_MASK | BSP_LED_1_MASK | ... | BSP_LED_7_MASK)
#define BUTTONS_MASK   (BSP_BUTTON_0_MASK | BSP_BUTTON_1_MASK | ... | BSP_BUTTON_7_MASK)
   • 功能：将所有 LED 和按键的掩码进行按位或操作，得到所有 LED 和按键的总掩码。这些总掩码可用于对所有 LED 或按键进行统一操作，例如同时点亮所有 LED 或检测所有按键的状态。  

8. LED 控制宏定义 c       #define LEDS_OFF(leds_mask) ...
#define LEDS_ON(leds_mask) ...
#define LED_IS_ON(leds_mask) ...
#define LEDS_INVERT(leds_mask) ...
#define LEDS_CONFIGURE(leds_mask) ...
   • LEDS_OFF(leds_mask)：熄灭由 leds_mask 指定的 LED。 • LEDS_ON(leds_mask)：点亮由 leds_mask 指定的 LED。 • LED_IS_ON(leds_mask)：判断由 leds_mask 指定的 LED 是否点亮。 • LEDS_INVERT(leds_mask)：反转由 leds_mask 指定的 LED 的状态。 • LEDS_CONFIGURE(leds_mask)：将由 leds_mask 指定的引脚配置为输出模式，用于控制 LED。  这些宏提供了便捷的方式来控制 LED 的状态，并且使用掩码进行操作，使得可以同时控制多个 LED。需要注意的是，这些宏仅支持 P0 端口，如果 LED 位于其他端口，则不适用。

本文来自互联网用户投稿，该文观点仅代表作者本人，不代表本站立场。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如若转载，请注明出处：http://www.coloradmin.cn/o/2331216.html

如若内容造成侵权/违法违规/事实不符，请联系多彩编程网进行投诉反馈，一经查实，立即删除！

相关文章

2025年常见渗透测试面试题-sql（题目+回答）

2025年常见渗透测试面试题-sql（题目+回答）

网络安全领域各种资源&#xff0c;学习文档&#xff0c;以及工具分享、前沿信息分享、POC、EXP分享。不定期分享各种好玩的项目及好用的工具&#xff0c;欢迎关注。 目录 SQLi 一、发现test.jsp?cid150 注入点的5种WebShell获取思路 1. 文件写入攻击 2. 日志文件劫持 3.…
阅读更多...
【RabbitMQ】队列模型

【RabbitMQ】队列模型

1.概述 RabbitMQ作为消息队列&#xff0c;有6种队列模型&#xff0c;分别在不同的场景进行使用&#xff0c;分别是Hello World&#xff0c;Work queues&#xff0c;Publish/Subscribe&#xff0c;Routing&#xff0c;Topics&#xff0c;RPC。 下面就分别对几个模型进行讲述。…
阅读更多...
StarRocks 助力首汽约车精细化运营

StarRocks 助力首汽约车精细化运营

作者&#xff1a;任智红&#xff0c;首汽约车大数据负责人 更多交流&#xff0c;联系我们&#xff1a;https://wx.focussend.com/weComLink/mobileQrCodeLink/334%201%202/ffbe5 导读&#xff1a; 本文整理自首汽约车大数据负责人任智红在 StarRocks 年度峰会上的演讲&#xf…
阅读更多...
痉挛性斜颈康复助力：饮食调养指南

痉挛性斜颈康复助力：饮食调养指南

痉挛性斜颈患者除了积极治疗&#xff0c;合理饮食也能辅助缓解症状&#xff0c;提升生活质量。其健康饮食可从以下方面着手&#xff1a; 高蛋白质食物助力肌肉修复 痉挛性斜颈会导致颈部肌肉异常收缩&#xff0c;消耗较多能量&#xff0c;蛋白质有助于肌肉的修复与维持。日常可…
阅读更多...
mysql镜像创建docker容器，及其可能遇到的问题

mysql镜像创建docker容器，及其可能遇到的问题

前提&#xff0c;已经弄好基本的docker服务了。 一、基本流程 1、目录准备 我自己的资料喜欢放在 /data 目录下&#xff0c;所以老规矩&#xff1a; 先进入 /data 目录&#xff1a; cd /data 创建 mysql 目录并进入&#xff1a; mkdir mysql cd mysql 2、镜像查找 docke…
阅读更多...
JavaEE——线程的状态

JavaEE——线程的状态

目录 前言1. NEW2. TERMINATED3. RUNNABLE4. 三种阻塞状态总结 前言 本篇文章来讲解线程的几种状态。在Java中&#xff0c;线程的状态是一个枚举类型&#xff0c;Thread.State。其中一共分为了六个状态。分别为&#xff1a;NEW,RUNNABLE,BLOCKED,WAITING,TIMED_WAITING, TERMI…
阅读更多...
RuntimeError: Error(s) in loading state_dict for ChartParser

RuntimeError: Error(s) in loading state_dict for ChartParser

一 bug错误 最近使用千问大模型有一个bug&#xff0c;报错信息如下 raise RuntimeError(Error(s) in loading state_dict for {}:\n\t{}.format( RuntimeError: Error(s) in loading state_dict for ChartParser:Unexpected key(s) in state_dict: "pretrained_model.em…
阅读更多...
2025 年安徽交安安全员考试：利用记忆宫殿强化记忆​

2025 年安徽交安安全员考试：利用记忆宫殿强化记忆​

安徽考生在面对交安安全员考试繁杂的知识点时&#xff0c;记忆宫殿是强大的记忆工具。选择一个熟悉且空间结构清晰的场所作为记忆宫殿&#xff0c;如自己居住的房屋。将房屋的不同区域&#xff0c;如客厅、卧室、厨房等&#xff0c;分别对应不同知识板块&#xff0c;像客厅对应…
阅读更多...
安全编码课程 实验6 整数安全

安全编码课程 实验6 整数安全

实验项目 实现安全计数器&#xff1a;实现 Counter 结构&#xff0c;确保计数范围为 0~100。 实验要求&#xff1a; 1、使用 struct 封装计数值value&#xff1b; 2、计数器初值为 0&#xff1b; 3、increment() 方法增加计数&#xff0c;但不能超过 100&#xff1b; 4、decrem…
阅读更多...
解决上传PDF、视频、音频等格式文件到FTP站点时报错“将文件复制到FTP服务器时发生错误。请检查是否有权限将文件放到该服务器上”问题

解决上传PDF、视频、音频等格式文件到FTP站点时报错“将文件复制到FTP服务器时发生错误。请检查是否有权限将文件放到该服务器上”问题

一、问题描述 可以将文本文件（.txt格式），图像文件(.jpg、.png等格式)上传到我们的FTP服务器上；但是上传一些PDF文件、视频等文件时就会报错“ 将文件复制到FTP服务器时发生错误。请检查是否有权限将文件放到该服务器上。 详细信息： 200 Type set to l. 227 Entering Pas…
阅读更多...
【Linux操作系统】：信号

【Linux操作系统】：信号

Linux操作系统下的信号 一、引言 首先我们可以简单理解一下信号的概念&#xff0c;信号&#xff0c;顾名思义&#xff0c;就是我们操作系统发送给进程的消息。举个简单的例子&#xff0c;我们在写C/C程序的时候&#xff0c;当执行a / 0类似的操作的时候&#xff0c;程序直接就挂…
阅读更多...
经典频域分析法（Bode图、Nyquist判据） —— 理论、案例与交互式 GUI 实现

经典频域分析法（Bode图、Nyquist判据） —— 理论、案例与交互式 GUI 实现

目录 经典频域分析法（Bode图、Nyquist判据） —— 理论、案例与交互式 GUI 实现一、引言二、经典频域分析方法的基本原理2.1 Bode 图分析2.2 Nyquist 判据三、数学建模与公式推导3.1 一阶系统的频域响应3.2 多极系统的 Bode 图绘制3.3 Nyquist 判据的数学描述四、经典频域分析…
阅读更多...
使用scoop一键下载jdk和实现版本切换

使用scoop一键下载jdk和实现版本切换

安装 在 PowerShell 中输入下面内容&#xff0c;保证允许本地脚本的执行&#xff1a; set-executionpolicy remotesigned -scope currentuser然后执行下面的命令安装 Scoop&#xff1a; iwr -useb get.scoop.sh | iex国内用户可以使用镜像源安装&#xff1a;powershell iwr -us…
阅读更多...
对状态模式的理解

对状态模式的理解

对状态模式的理解 一、场景二、不采用状态模式1、代码2、缺点 三、采用状态模式1、代码1.1 状态类1.2 上下文&#xff08;这里指&#xff1a;媒体播放器&#xff09;1.3 客户端 2、优点 一、场景 同一个东西&#xff08;例如&#xff1a;媒体播放器&#xff09;&#xff0c;有一…
阅读更多...
vue2（webpack）集成electron和 electron 打包

vue2（webpack）集成electron和 electron 打包

前言 之前发过一篇vue集成electron的文章&#xff0c;但是用vue3vite实现的&#xff0c;在vue2webpack工程可能不适用&#xff0c;所以这篇文章就主要介绍vue2webpack集成electron方法 创建项目 vue create vue-electron-demo目录架构 vue-electron-demo/ ├── src/ …
阅读更多...
C++内存管理优化实战：提升应用性能与效率

C++内存管理优化实战：提升应用性能与效率

&#x1f9d1; 博主简介&#xff1a;CSDN博客专家、CSDN平台优质创作者&#xff0c;高级开发工程师&#xff0c;数学专业&#xff0c;拥有高级工程师证书&#xff1b;擅长C/C、C#等开发语言&#xff0c;熟悉Java常用开发技术&#xff0c;能熟练应用常用数据库SQL server,Oracle…
阅读更多...
redis数据迁移之通过redis-dump镜像

redis数据迁移之通过redis-dump镜像

这里写目录标题 一、redis-dump 镜像打包1.1 安装windows docker1.2 idea项目创建1.3 idea镜像打包 二、redis数据迁移2.1 数据导出2.2 数据导入 一、redis-dump 镜像打包 没有找到可用的redis-dump镜像&#xff0c;需要自己打包一下&#xff0c;这里我是在idea直接打包的 1.…
阅读更多...
redis导入成功，缺不显示数据

redis导入成功，缺不显示数据

SpringBootTest class SecurityApplicationTests {AutowiredStringRedisTemplate template; //添加这句代码&#xff0c;自动装载&#xff0c;即可解决文章三处代码报错Testvoid contextLoads() {String compact Jwts.builder().signWith(Jwts.SIG.HS512.key().build()).subj…
阅读更多...
从表格到序列：Swift 如何优雅地解 LeetCode 251 展开二维向量

从表格到序列：Swift 如何优雅地解 LeetCode 251 展开二维向量

文章目录 摘要描述题解答案题解代码分析示例测试及结果时间复杂度空间复杂度总结 摘要 在这篇文章中&#xff0c;我们将深入探讨 LeetCode 第 251 题——“展开二维向量”的问题。通过 Swift 语言&#xff0c;我们不仅会提供可运行的示例代码&#xff0c;还会结合实际场景进行…
阅读更多...
小型园区网实验

小型园区网实验

划分VLAN SW3 [sw3]vlan batch 2 3 20 30 [sw3]interface GigabitEthernet 0/0/1 [sw3-GigabitEthernet0/0/1]port link-type access [sw3-GigabitEthernet0/0/1]port default vlan 2 [sw3-GigabitEthernet0/0/1]int g0/0/2 [sw3-GigabitEthernet0/0/2]port link-type acces…
阅读更多...
推荐文章
最新文章

Copyright @ 2022~2023