nRF52832 ble_app_blinky例程解析

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);
}
最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡(jiǎn)書(shū)系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • 因?yàn)樽约旱捻?xiàng)目中有用到了藍(lán)牙相關(guān)的功能,所以之前也斷斷續(xù)續(xù)地針對(duì)藍(lán)牙通信尤其是BLE通信進(jìn)行了一番探索,整理出了一...
    陳利健閱讀 119,570評(píng)論 172 300
  • 藍(lán)牙 藍(lán)牙的波段為2400-2483.5MHz(包括防護(hù)頻帶)。這是全球范圍內(nèi)無(wú)需取得執(zhí)照(但定不是無(wú)管制的)的工...
    蘇永茂閱讀 6,575評(píng)論 0 11
  • 前言: 本文主要描述Android BLE的一些基礎(chǔ)知識(shí)及相關(guān)操作流程,不牽扯具體的業(yè)務(wù)實(shí)現(xiàn),其中提供了針對(duì)廣播包...
    幻影宇寰閱讀 5,583評(píng)論 6 19
  • 轉(zhuǎn)載于http://blog.csdn.net/pig10086/article/details/65451510...
    默以太閱讀 1,038評(píng)論 0 1
  • 背景 藍(lán)牙歷史說(shuō)到藍(lán)牙,就不得不說(shuō)下藍(lán)牙技術(shù)聯(lián)盟(Bluetooth SIG),它負(fù)責(zé)藍(lán)牙規(guī)范制定和推廣的國(guó)際組織...
    徐正峰閱讀 13,020評(píng)論 6 33

友情鏈接更多精彩內(nèi)容