縱使生活虐我千百遍，可我還是需要微笑面對。記錄被毒打的瞬間從main開始。。。
從分析例程開始
例程:nRF5_SDK_15.0.0_a53641a\examples\ble_peripheral\ble_app_blinky
主函數
/**@brief Function for application main entry.
*/
int main(void)
{
// Initialize.
log_init();
leds_init();
timers_init();
buttons_init();
power_management_init();
ble_stack_init();
gap_params_init();
gatt_init();
services_init();
advertising_init();
conn_params_init();
// Start execution.
NRF_LOG_INFO("Blinky example started.");
advertising_start();
// Enter main loop.
for (;;)
{
idle_state_handle();
}
}
一些函數的使用，似乎沒啥好看的，那就開始看藍牙趴
藍牙初始化部分入手
藍牙：協議棧內存初始化
ble_stack_init初始化協議棧的內存分配，設置回調函數爲ble_evt_handler
static void ble_stack_init(void)
{
ret_code_t err_code;
//使能SoftDevice,所有藍牙有關的都在SoftDevice中,所以首先必須使能SoftDevice
err_code = nrf_sdh_enable_request();
APP_ERROR_CHECK(err_code);
// Configure the BLE stack using the default settings.大意：使用默認設置配置BLE堆棧。
// Fetch the start address of the application RAM.獲取應用程序RAM的起始地址。
uint32_t ram_start = 0;
err_code = nrf_sdh_ble_default_cfg_set(APP_BLE_CONN_CFG_TAG, &ram_start);
APP_ERROR_CHECK(err_code);
// Enable BLE stack.啓用BLE堆棧
err_code = nrf_sdh_ble_enable(&ram_start);
APP_ERROR_CHECK(err_code);
// Register a handler for BLE events.爲BLE事件註冊處理程序。
NRF_SDH_BLE_OBSERVER(m_ble_observer, APP_BLE_OBSERVER_PRIO, ble_evt_handler, NULL);
}
藍牙：GAP初始化
藍牙BLE建立GATT連接前，必須經過GAP協議，GAP用來控制設備的連接廣播等，GAP使設備廣播或可別發現、可被連接等。
gap_params_init就是進行GAP初始化，設定連接參數
static void gap_params_init(void)
{
ret_code_t err_code;
ble_gap_conn_params_t gap_conn_params;
ble_gap_conn_sec_mode_t sec_mode;
BLE_GAP_CONN_SEC_MODE_SET_OPEN(&sec_mode);//加密級別爲Security Mode 1 Level 1
//設置藍牙名稱
err_code = sd_ble_gap_device_name_set(&sec_mode,(const uint8_t *)DEVICE_NAME,strlen(DEVICE_NAME));
APP_ERROR_CHECK(err_code);
//Set GAP Peripheral Preferred Connection Parameters.設置GAP外圍設備首選連接參數。
memset(&gap_conn_params, 0, sizeof(gap_conn_params));
gap_conn_params.min_conn_interval = MIN_CONN_INTERVAL;
gap_conn_params.max_conn_interval = MAX_CONN_INTERVAL;
gap_conn_params.slave_latency = SLAVE_LATENCY;
gap_conn_params.conn_sup_timeout = CONN_SUP_TIMEOUT;
err_code = sd_ble_gap_ppcp_set(&gap_conn_params);
APP_ERROR_CHECK(err_code);
}
GAP四種廣播:
通用廣播：通用廣播是用途最廣的廣播方式。進行通用廣播的設備能夠被掃描設備掃描到，或者在接收到連接請求時作爲從設備進入一個連接。通用廣播可以在沒有連接的情況下發出，換句話說，沒有主從設備之分。
定向廣播：爲了儘可能快的建立連接。這種報文包含兩個地址：廣播者的地址和發起者的地址。發起設備收到發紿自己的定向廣播報文後，可以立即發送連接請求作爲迴應。
不可連接廣播：只廣播數據，不能被掃描或者連接。只能根據主機的要求在廣播態和就緒態之間切換。
可發現廣播：不能用於發起連接，但允許其他設備掃描該廣播設備。設備可以被發現，既可以廣播數據，又可以響應掃描，但不能建立連接。這是一種適用於廣播數據的廣播形式，動態數據可以包含於廣播數據之中，而靜態數據可以包含於掃描響應數據之中。可發現廣播不會進入連接態，而只能在停止後回到就緒態。
藍牙:GATT初始化
GATT纔是真正BLE的部分了.
/**@brief Function for initializing the GATT module.
*/
static void gatt_init(void)
{
ret_code_t err_code = nrf_ble_gatt_init(&m_gatt, NULL);
APP_ERROR_CHECK(err_code);
}
這就沒什麼說的了,根本就是直接調用了SDK中的ret_code_t nrf_ble_gatt_init(nrf_ble_gatt_t * p_gatt,nrf_ble_gatt_evt_handler_t evt_handler ),很好理解,問題是,m_gatt的定義並不是簡單的nrf_ble_gatt_t m_gatt;,而是使用宏:NRF_BLE_GATT_DEF(m_gatt);進行定義
/**@brief Macro for defining a nrf_ble_gatt instance.
*
* @param _name Name of the instance.
* @hideinitializer
*/
#define NRF_BLE_GATT_DEF(_name) \
static nrf_ble_gatt_t _name; \
NRF_SDH_BLE_OBSERVER(_name ## _obs, \
NRF_BLE_GATT_BLE_OBSERVER_PRIO, \
nrf_ble_gatt_on_ble_evt, &_name)
SDK中也說明了此宏目的是Macro for defining a nrf_ble_gatt instance.
關鍵在此宏中調用的NRF_SDH_BLE_OBSERVER,
Macro for registering nrf_sdh_soc_evt_observer_t. Modules that want to be notified about SoC events must register the handler using this macro.
主機(手機)通過需要藍牙寫入,必須使用此宏註冊處理處理函數!如果不使用,導致寫入數據後SOC無法處理寫入的數據.
吐槽下,sdk中根本沒有說明處理流程,必須看到某個函數內容才說明此函數必須調用,卻不說明此函數相關的函數必須也要使用,所以很容易漏掉一些重要內容,必須要將所有的api都看一遍才行.難道是Datasheet中有寫?還是我漏掉了什麼必看的文檔?
Services初始化
/**@brief Function for initializing services that will be used by the application.
*/
static void services_init(void)
{
ret_code_t err_code;
ble_lbs_init_t init = {0};
nrf_ble_qwr_init_t qwr_init = {0};
// Initialize Queued Write Module.
qwr_init.error_handler = nrf_qwr_error_handler;
err_code = nrf_ble_qwr_init(&m_qwr, &qwr_init);
APP_ERROR_CHECK(err_code);
// Initialize LBS.
init.led_write_handler = led_write_handler;
err_code = ble_lbs_init(&m_lbs, &init);
APP_ERROR_CHECK(err_code);
}
暫時不看nrf_ble_qwr_init函數~
主要來看ble_lbs_init,此函數目的是增加led及button的相關Service Characteristic等
uint32_t ble_lbs_init(ble_lbs_t * p_lbs, const ble_lbs_init_t * p_lbs_init)
{
uint32_t err_code;
ble_uuid_t ble_uuid;
// Initialize service structure.
p_lbs->led_write_handler = p_lbs_init->led_write_handler;
// Add service.
ble_uuid128_t base_uuid = {LBS_UUID_BASE};
err_code = sd_ble_uuid_vs_add(&base_uuid, &p_lbs->uuid_type);
VERIFY_SUCCESS(err_code);
ble_uuid.type = p_lbs->uuid_type;
ble_uuid.uuid = LBS_UUID_SERVICE;
err_code = sd_ble_gatts_service_add(BLE_GATTS_SRVC_TYPE_PRIMARY, &ble_uuid, &p_lbs->service_handle);
VERIFY_SUCCESS(err_code);
// Add characteristics.
err_code = button_char_add(p_lbs, p_lbs_init);
VERIFY_SUCCESS(err_code);
err_code = led_char_add(p_lbs, p_lbs_init);
VERIFY_SUCCESS(err_code);
return NRF_SUCCESS;
}
具體詳解見nRF52832 GATT 自定義Service/Characteristic
廣播配置
廣播初始化,設定廣播週期,廣播超時時間等參數,其中還會配置廣播的uuid信息
/**@brief Function for initializing the Advertising functionality.
*
* @details Encodes the required advertising data and passes it to the stack.
* Also builds a structure to be passed to the stack when starting advertising.
*/
static void advertising_init(void)
{
ret_code_t err_code;
ble_advdata_t advdata;
ble_advdata_t srdata;
ble_uuid_t adv_uuids[] = {{LBS_UUID_SERVICE, m_lbs.uuid_type}};
// Build and set advertising data.
memset(&advdata, 0, sizeof(advdata));
advdata.name_type = BLE_ADVDATA_FULL_NAME;
advdata.include_appearance = true;
advdata.flags = BLE_GAP_ADV_FLAGS_LE_ONLY_GENERAL_DISC_MODE;
memset(&srdata, 0, sizeof(srdata));
srdata.uuids_complete.uuid_cnt = sizeof(adv_uuids) / sizeof(adv_uuids[0]);
srdata.uuids_complete.p_uuids = adv_uuids;
err_code = ble_advdata_encode(&advdata, m_adv_data.adv_data.p_data, &m_adv_data.adv_data.len);
APP_ERROR_CHECK(err_code);
err_code = ble_advdata_encode(&srdata, m_adv_data.scan_rsp_data.p_data, &m_adv_data.scan_rsp_data.len);
APP_ERROR_CHECK(err_code);
ble_gap_adv_params_t adv_params;
// Set advertising parameters.
memset(&adv_params, 0, sizeof(adv_params));
adv_params.primary_phy = BLE_GAP_PHY_1MBPS;
adv_params.duration = APP_ADV_DURATION;
adv_params.properties.type = BLE_GAP_ADV_TYPE_CONNECTABLE_SCANNABLE_UNDIRECTED;
adv_params.p_peer_addr = NULL;
adv_params.filter_policy = BLE_GAP_ADV_FP_ANY;
adv_params.interval = APP_ADV_INTERVAL;
err_code = sd_ble_gap_adv_set_configure(&m_adv_handle, &m_adv_data, &adv_params);
APP_ERROR_CHECK(err_code);
}
連接參數配置
藍牙連接的一些參數配置信息,詳細需要參考藍牙文檔了
/**@brief Function for initializing the Connection Parameters module.
*/
static void conn_params_init(void)
{
ret_code_t err_code;
ble_conn_params_init_t cp_init;
memset(&cp_init, 0, sizeof(cp_init));
cp_init.p_conn_params = NULL;
cp_init.first_conn_params_update_delay = FIRST_CONN_PARAMS_UPDATE_DELAY;
cp_init.next_conn_params_update_delay = NEXT_CONN_PARAMS_UPDATE_DELAY;
cp_init.max_conn_params_update_count = MAX_CONN_PARAMS_UPDATE_COUNT;
cp_init.start_on_notify_cccd_handle = BLE_GATT_HANDLE_INVALID;
cp_init.disconnect_on_fail = false;
cp_init.evt_handler = on_conn_params_evt;
cp_init.error_handler = conn_params_error_handler;
err_code = ble_conn_params_init(&cp_init);
APP_ERROR_CHECK(err_code);
}
啓動廣播
調用sd_ble_gap_adv_start開始廣播，同時點亮LED表示廣播狀態
/**@brief Function for starting advertising.
*/
static void advertising_start(void)
{
ret_code_t err_code;
err_code = sd_ble_gap_adv_start(m_adv_handle, APP_BLE_CONN_CFG_TAG);
APP_ERROR_CHECK(err_code);
bsp_board_led_on(ADVERTISING_LED);
}