7、nRF52xx藍牙學習（nrf_gpiote.c庫函數學習）

續前一篇文章。

3、nrfx_gpiote_in_event_enable

void nrfx_gpiote_in_event_enable(nrfx_gpiote_pin_t pin, bool int_enable)
{NRFX_ASSERT(nrf_gpio_pin_present_check(pin));NRFX_ASSERT(pin_in_use_by_gpiote(pin));if (pin_in_use_by_port(pin)){nrf_gpiote_polarity_t polarity =port_handler_polarity_get(channel_port_get(pin) - GPIOTE_CH_NUM);nrf_gpio_pin_sense_t sense;if (polarity == NRF_GPIOTE_POLARITY_TOGGLE){/* read current pin state and set for next sense to oposit */sense = (nrf_gpio_pin_read(pin)) ?NRF_GPIO_PIN_SENSE_LOW : NRF_GPIO_PIN_SENSE_HIGH;}else{sense = (polarity == NRF_GPIOTE_POLARITY_LOTOHI) ?NRF_GPIO_PIN_SENSE_HIGH : NRF_GPIO_PIN_SENSE_LOW;}nrf_gpio_cfg_sense_set(pin, sense);}else if (pin_in_use_by_te(pin)){int32_t             channel = (int32_t)channel_port_get(pin);nrf_gpiote_events_t event   = TE_IDX_TO_EVENT_ADDR((uint32_t)channel);nrf_gpiote_event_enable((uint32_t)channel);nrf_gpiote_event_clear(event);if (int_enable){nrfx_gpiote_evt_handler_t handler = channel_handler_get((uint32_t)channel_port_get(pin));// Enable the interrupt only if event handler was provided.if (handler){nrf_gpiote_int_enable(1 << channel);}}}
}

一、函數概述
nrfx_gpiote_in_event_enable 函數的主要功能是為指定的 GPIO 引腳啟用 GPIOTE（通用外設中斷和事件）輸入事件。
該函數會根據引腳的使用情況（是由端口處理還是由定時器事件處理）來配置相應的引腳感應和事件中斷。?
函數參數
pin：類型為 nrfx_gpiote_pin_t，表示要啟用事件的 GPIO 引腳編號。?
int_enable：布爾類型，用于決定是否啟用該引腳的中斷功能。 ?
二、函數實現步驟
1. 斷言檢查

NRFX_ASSERT(nrf_gpio_pin_present_check(pin));
NRFX_ASSERT(pin_in_use_by_gpiote(pin));

?NRFX_ASSERT(nrf_gpio_pin_present_check(pin))：使用斷言確保傳入的引腳 pin 是有效的，nrf_gpio_pin_present_check 函數用于檢查該引腳是否存在于硬件中。如果檢查失敗，程序會觸發斷言錯誤。
NRFX_ASSERT(pin_in_use_by_gpiote(pin))：確保該引腳已經被 GPIOTE 使用，如果未被使用，程序會觸發斷言錯誤。 ?
2. 處理引腳由端口使用的情況

?if (pin_in_use_by_port(pin))
{
? ? nrf_gpiote_polarity_t polarity =
? ? ? ? port_handler_polarity_get(channel_port_get(pin) - GPIOTE_CH_NUM);
? ? nrf_gpio_pin_sense_t sense;
? ? if (polarity == NRF_GPIOTE_POLARITY_TOGGLE)
? ? {
? ? ? ? sense = (nrf_gpio_pin_read(pin)) ?
? ? ? ? ? ? ? ? NRF_GPIO_PIN_SENSE_LOW : NRF_GPIO_PIN_SENSE_HIGH;
? ? }
? ? else
? ? {
? ? ? ? sense = (polarity == NRF_GPIOTE_POLARITY_LOTOHI) ?
? ? ? ? ? ? ? ? NRF_GPIO_PIN_SENSE_HIGH : NRF_GPIO_PIN_SENSE_LOW;
? ? }
? ? nrf_gpio_cfg_sense_set(pin, sense);
}

（1）nrf_gpiote_polarity_t是一個枚舉類型，定義如下：

typedef enum
{NRF_GPIOTE_POLARITY_LOTOHI = GPIOTE_CONFIG_POLARITY_LoToHi,       ///<  Low to high.NRF_GPIOTE_POLARITY_HITOLO = GPIOTE_CONFIG_POLARITY_HiToLo,       ///<  High to low.NRF_GPIOTE_POLARITY_TOGGLE = GPIOTE_CONFIG_POLARITY_Toggle        ///<  Toggle.
} nrf_gpiote_polarity_t;

（2）port_handler_polarity_get函數定義如下：

static nrf_gpiote_polarity_t port_handler_polarity_get(uint32_t handler_idx)
{uint8_t pin_and_polarity = (uint8_t)m_cb.port_handlers_pins[handler_idx];return (nrf_gpiote_polarity_t)((pin_and_polarity & POLARITY_FIELD_MASK) >> POLARITY_FIELD_POS);
}

（3）m_cb是一個靜態變量，定義如下：

static gpiote_control_block_t m_cb;

其類型為結構體類型gpiote_control_block_t，該類型是在nrfx_gpiote.c中定義的：

typedef struct
{nrfx_gpiote_evt_handler_t handlers[GPIOTE_CH_NUM + NRFX_GPIOTE_CONFIG_NUM_OF_LOW_POWER_EVENTS];int8_t                    pin_assignments[MAX_PIN_NUMBER];int8_t                    port_handlers_pins[NRFX_GPIOTE_CONFIG_NUM_OF_LOW_POWER_EVENTS];uint8_t                   configured_pins[((MAX_PIN_NUMBER)+7) / 8];nrfx_drv_state_t          state;
} gpiote_control_block_t;

此結構體的解釋如下：

，它用于管理和控制通用外設中斷和事件（GPIOTE）模塊。

下面詳細解釋結構體中的每個成員：

整體用途 gpiote_control_block_t 結構體作為 GPIOTE 模塊的控制塊，負責存儲和管理與 GPIOTE 操作相關的各種信息，包括事件處理函數、引腳分配、端口處理狀態、引腳配置狀態以及驅動程序的整體狀態。

結構體成員解釋

1. nrfx_gpiote_evt_handler_t handlers[GPIOTE_CH_NUM + NRFX_GPIOTE_CONFIG_NUM_OF_LOW_POWER_EVENTS];

? 類型：nrfx_gpiote_evt_handler_t 是一個函數指針類型，它指向處理 GPIOTE 事件的函數。該數組存儲了所有 GPIOTE 通道（包括普通通道和低功耗事件通道）對應的事件處理函數。

? 用途：當特定的 GPIOTE 通道發生事件時，系統會調用該通道對應的事件處理函數來處理事件。GPIOTE_CH_NUM 代表普通 GPIOTE 通道的數量，NRFX_GPIOTE_CONFIG_NUM_OF_LOW_POWER_EVENTS 表示低功耗事件通道的數量。 ?

2. int8_t pin_assignments[MAX_PIN_NUMBER];

? 類型：int8_t 類型的數組，每個元素存儲一個 8 位有符號整數。

? 用途：該數組用于記錄每個 GPIO 引腳所分配的 GPIOTE 通道編號。MAX_PIN_NUMBER 是系統中可用的最大 GPIO 引腳數量。數組的索引對應引腳編號，數組元素的值為該引腳分配的 GPIOTE 通道編號。如果某個引腳未分配通道，通常用一個特殊值（如 -1）表示。 ?

3. int8_t port_handlers_pins[NRFX_GPIOTE_CONFIG_NUM_OF_LOW_POWER_EVENTS];

? 類型：int8_t 類型的數組。

? 用途：此數組用于存儲與低功耗事件通道相關的引腳信息。每個元素對應一個低功耗事件通道，可能存儲該通道所關聯的引腳編號或其他相關信息。 ?

4. uint8_t configured_pins[((MAX_PIN_NUMBER)+7) / 8];

? 類型：uint8_t 類型的數組，即無符號 8 位整數數組。

? 用途：這是一個位圖數組，用于記錄哪些 GPIO 引腳已經被配置為 GPIOTE 功能。通過使用位圖，每個字節可以表示 8 個引腳的配置狀態。((MAX_PIN_NUMBER)+7) / 8 確保數組大小足夠存儲所有引腳的狀態。例如，如果某個引腳已配置，則對應位圖中的相應位被設置為 1；否則為 0。 ?5. nrfx_drv_state_t state;

? 類型：nrfx_drv_state_t 是一個自定義的枚舉類型，用于表示 GPIOTE 驅動程序的狀態。

? 用途：該成員變量記錄了 GPIOTE 驅動程序的當前狀態，如初始化、運行、停止等。通過檢查這個狀態變量，系統可以了解 GPIOTE 模塊的工作狀態，并根據需要進行相應的操作。 ?總結 gpiote_control_block_t 結構體整合了管理 GPIOTE 模塊所需的關鍵信息，通過這些成員變量，系統可以有效地分配通道、處理事件、跟蹤引腳配置狀態以及管理驅動程序的整體狀態。

（4） pin_in_use_by_port(pin)：

檢查該引腳是否由端口處理。
?port_handler_polarity_get(channel_port_get(pin) - GPIOTE_CH_NUM)：獲取該引腳對應的端口處理極性。?
?極性判斷：?
?如果極性為 NRF_GPIOTE_POLARITY_TOGGLE，則讀取當前引腳的狀態，根據狀態設置感應為相反的電平（如果當前引腳為高電平，則感應設置為低電平；反之亦然）。?
?如果極性為 NRF_GPIOTE_POLARITY_LOTOHI，則感應設置為高電平；如果極性為其他值（可理解為 NRF_GPIOTE_POLARITY_HITOLO），則感應設置為低電平。 ??
?nrf_gpio_cfg_sense_set(pin, sense)：將計算得到的感應設置應用到該引腳上。

?
（5）. 處理引腳由定時器事件使用的情況
? else if (pin_in_use_by_te(pin))
{
? ? int32_t ? ? ? ? ? ? channel = (int32_t)channel_port_get(pin);
? ? nrf_gpiote_events_t event ? = TE_IDX_TO_EVENT_ADDR((uint32_t)channel);

? ? nrf_gpiote_event_enable((uint32_t)channel);

? ? nrf_gpiote_event_clear(event);
? ? if (int_enable)
? ? {
? ? ? ? nrfx_gpiote_evt_handler_t handler = channel_handler_get((uint32_t)channel_port_get(pin));
? ? ? ? // Enable the interrupt only if event handler was provided.
? ? ? ? if (handler)
? ? ? ? {
? ? ? ? ? ? nrf_gpiote_int_enable(1 << channel);
? ? ? ? }
? ? }
}

?pin_in_use_by_te(pin)：檢查該引腳是否由定時器事件處理。?
?channel_port_get(pin)：獲取該引腳對應的通道編號。
?TE_IDX_TO_EVENT_ADDR((uint32_t)channel)：將通道編號轉換為對應的 GPIOTE 事件地址。?
?nrf_gpiote_event_enable((uint32_t)channel)：啟用該通道的 GPIOTE 事件。?
?nrf_gpiote_event_clear(event)：清除該事件的狀態標志。?
?中斷啟用判斷：?
?如果 int_enable 為 true，則獲取該通道對應的事件處理函數 handler。?
?只有當事件處理函數存在時，才調用 nrf_gpiote_int_enable(1 << channel) 啟用該通道的中斷。 ? ?
?總結該函數的核心是根據引腳的使用情況（端口處理或定時器事件處理）來配置引腳的感應和事件中斷。
?對于端口處理的引腳，根據極性設置感應；對于定時器事件處理的引腳，啟用事件、清除事件標志，并根據需要啟用中斷。通過這些步驟，確保指定引腳的 GPIOTE 輸入事件能夠正常工作。

void nrfx_gpiote_in_event_enablevoid nrfx_gpiote_in_event_enable