2018年7月19日(2018年8月2日更新)
學(xué)習(xí)使用nrf52832,感覺(jué)坑真大,看起來(lái)實(shí)在是要好好閱讀一下提供的例程源碼了.
SDK版本:nRF5_SDK_15.0.0_a53641a
SoftDevice版本:s132_nrf52_6.0.0
例程:nRF5_SDK_15.0.0_a53641a\examples\ble_peripheral\ble_app_blinky
主函數(shù)開(kāi)始:
主函數(shù):
/**@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();
}
}
沒(méi)什么好說(shuō)的,主要看藍(lán)牙初始化部分吧
藍(lán)牙初始化部分:
藍(lán)牙:協(xié)議棧內(nèi)存初始化
ble_stack_init初始化協(xié)議棧的內(nèi)存分配,設(shè)置回調(diào)函數(shù)為ble_evt_handler
static void ble_stack_init(void)
{
ret_code_t err_code;
//使能SoftDevice,能理解,所有藍(lán)牙有關(guān)的都在SoftDevice中,所以首先必須使能SoftDevice
err_code = nrf_sdh_enable_request();
APP_ERROR_CHECK(err_code);
// Configure the BLE stack using the default settings.
// Fetch the start address of the application 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.
err_code = nrf_sdh_ble_enable(&ram_start);
APP_ERROR_CHECK(err_code);
// Register a handler for BLE events.
NRF_SDH_BLE_OBSERVER(m_ble_observer, APP_BLE_OBSERVER_PRIO, ble_evt_handler, NULL);
}
藍(lán)牙:GAP初始化
藍(lán)牙BLE建立GATT連接前,必須經(jīng)過(guò)GAP協(xié)議,GAP用來(lái)控制設(shè)備的連接廣播等,GAP使設(shè)備廣播或可別發(fā)現(xiàn)、可被連接等.
gap_params_init就是進(jìn)行GAP初始化,設(shè)定連接參數(shù)
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);//加密級(jí)別為Security Mode 1 Level 1
//設(shè)置藍(lán)牙名稱
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.
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四種廣播:
通用廣播:通用廣播是用途最廣的廣播方式。進(jìn)行通用廣播的設(shè)備能夠被掃描設(shè)備掃描到,或者在接收到連接請(qǐng)求時(shí)作為從設(shè)備進(jìn)入一個(gè)連接。通用廣播可以在沒(méi)有連接的情況下發(fā)出,換句話說(shuō),沒(méi)有主從設(shè)備之分。
定向廣播:為了盡可能快的建立連接。這種報(bào)文包含兩個(gè)地址:廣播者的地址和發(fā)起者的地址。發(fā)起設(shè)備收到發(fā)紿自己的定向廣播報(bào)文后,可以立即發(fā)送連接請(qǐng)求作為回應(yīng)。
不可連接廣播:只廣播數(shù)據(jù),不能被掃描或者連接。只能根據(jù)主機(jī)的要求在廣播態(tài)和就緒態(tài)之間切換。
可發(fā)現(xiàn)廣播:不能用于發(fā)起連接,但允許其他設(shè)備掃描該廣播設(shè)備。設(shè)備可以被發(fā)現(xiàn),既可以廣播數(shù)據(jù),又可以響應(yīng)掃描,但不能建立連接。這是一種適用于廣播數(shù)據(jù)的廣播形式,動(dòng)態(tài)數(shù)據(jù)可以包含于廣播數(shù)據(jù)之中,而靜態(tài)數(shù)據(jù)可以包含于掃描響應(yīng)數(shù)據(jù)之中??砂l(fā)現(xiàn)廣播不會(huì)進(jìn)入連接態(tài),而只能在停止后回到就緒態(tài)。
藍(lán)牙: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);
}
這就沒(méi)什么說(shuō)的了,根本就是直接調(diào)用了SDK中的ret_code_t nrf_ble_gatt_init(nrf_ble_gatt_t * p_gatt,nrf_ble_gatt_evt_handler_t evt_handler ),很好理解,問(wèn)題是,m_gatt的定義并不是簡(jiǎn)單的nrf_ble_gatt_t m_gatt;,而是使用宏:NRF_BLE_GATT_DEF(m_gatt);進(jìn)行定義
/**@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中也說(shuō)明了此宏目的是Macro for defining a nrf_ble_gatt instance.
關(guān)鍵在此宏中調(diào)用的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.
主機(jī)(手機(jī))通過(guò)需要藍(lán)牙寫(xiě)入,必須使用此宏注冊(cè)處理處理函數(shù)!如果不使用,導(dǎo)致寫(xiě)入數(shù)據(jù)后SOC無(wú)法處理寫(xiě)入的數(shù)據(jù).
吐槽下,sdk中根本沒(méi)有說(shuō)明處理流程,必須看到某個(gè)函數(shù)內(nèi)容才說(shuō)明此函數(shù)必須調(diào)用,卻不說(shuō)明此函數(shù)相關(guān)的函數(shù)必須也要使用,所以很容易漏掉一些重要內(nèi)容,必須要將所有的api都看一遍才行.難道是Datasheet中有寫(xiě)?還是我漏掉了什么必看的文檔?
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);
}
暫時(shí)不看nrf_ble_qwr_init函數(shù)~
主要來(lái)看ble_lbs_init,此函數(shù)目的是增加led及button的相關(guān)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;
}
不做詳細(xì)解析,后續(xù)一篇專門來(lái)看GATT的service部分:簡(jiǎn)書(shū) nRF52832 GATT 自定義Service/Characteristic
廣播配置
廣播初始化,設(shè)定廣播周期,廣播超時(shí)時(shí)間等參數(shù),其中還會(huì)配置廣播的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);
}
涉及很多藍(lán)牙的內(nèi)容,最好配合藍(lán)牙的資料來(lái)看
簡(jiǎn)書(shū) nRF52832 廣播相關(guān)配置
連接參數(shù)配置
藍(lán)牙連接的一些參數(shù)配置信息,詳細(xì)需要參考藍(lán)牙文檔了
/**@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);
}
啟動(dòng)廣播
調(diào)用sd_ble_gap_adv_start開(kāi)始廣播,同時(shí)點(diǎn)亮LED表示廣播狀態(tài)
/**@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);
}