{"id":418,"date":"2015-08-10T08:21:17","date_gmt":"2015-08-10T15:21:17","guid":{"rendered":"http:\/\/visualgdb.com\/w\/?p=418"},"modified":"2015-08-10T08:21:32","modified_gmt":"2015-08-10T15:21:32","slug":"using-nrf51-device-in-a-bluetooth-le-central-role","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/arm\/nrf51\/central\/","title":{"rendered":"Using the nRF51 device in a Bluetooth LE Central role"},"content":{"rendered":"

This tutorial shows how to use the nRF51 devices in the Bluetooth LE Central role, communicating to the peripheral devices. We will create a simple firmware that will query the button state from the TI CC2650 SensorTag<\/a> and display it using the on-board LEDs.<\/p>\n

We will show how to extract the relevant data from the SensorTag attribute table and how to modify the Nordic examples to communicate with a previously unsupported device like the SensorTag. Before you begin, install VisualGDB 5.0, get a CC2650 SensorTag and follow the basic nRF51 tutorial<\/a> to ensure you can program your board.<\/p>\n

    \n
  1. Begin with launching the VisualGDB Embedded Project Wizard and specifying the project name and path:\"01-wizard\"<\/a><\/li>\n
  2. By default, the wizard will create an embedded binary from a sample. Continue with that setting:\"02-binary\"<\/a><\/li>\n
  3. On the next page select your nRF51 device from the list:\"03-device\"<\/a><\/li>\n
  4. On the Sample page select the Bluetooth LE Heart Rate Service Client<\/strong> sample (don’t confuse it with the Heart Rate Service Device) and specify your board type that can be found on a sticker on the board:\"04-sample\"<\/a><\/li>\n
  5. Select a debugging method for your board. In this example we will use the on-board Segger J-Link with the Segger software package. Enable the “reset device after programming” checkbox, as otherwise the softdevice initialization code will be skipped resulting in strange crashes:\"05-debug\"<\/a><\/li>\n
  6. Press “Finish” to create the project. As stopping the Bluetooth-enabled nRF51 firmware on a breakpoint would result in loss of packets and a reset, we will use debug logging to report various events happening in the firmware. Find the uart_init() function to see the UART parameters used by the sample. By default the baud rate is 38400 and the hardware flow control is enabled. \"06-uart\"<\/a><\/li>\n
  7. Open VisualGDB Project Properties and enable the Raw Terminal on the COM port connected to your board. In this tutorial we will use the port provided by the on-board Segger J-Link. Follow this tutorial<\/a> for more details:\"07-terminal\"<\/a><\/li>\n
  8. The HRS client sample registers clients for 2 Bluetooth LE services: heart rate service and battery level service. As the Nordic Bluetooth LE framework has a limit on the maximum client count, remove the calls to brs_c_init()<\/strong> and bas_c_init()<\/strong> from main() before adding a new client. You can also update the welcome message to indicate the new function of the example. Then press F5 to ensure that the firmware is successfully programmed into nRF51 and started: \"08-log\"<\/a><\/li>\n
  9. We will now modify the sample to report information about all nearby Bluetooth LE devices. First of all, change the scan_start() function to scan without white lists:\n
    static void scan_start(void)\r\n{\r\n\u00a0\u00a0\u00a0 uint32_t\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 err_code;\r\n\u00a0\u00a0\u00a0 m_scan_param.active\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 = 0;\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/\/ Active scanning set.\r\n\u00a0\u00a0\u00a0 m_scan_param.selective\u00a0\u00a0\u00a0 = 0;\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/\/ Selective scanning not set.\r\n\u00a0\u00a0\u00a0 m_scan_param.interval\u00a0\u00a0\u00a0\u00a0 = SCAN_INTERVAL;\/\/ Scan interval.\r\n\u00a0\u00a0\u00a0 m_scan_param.window\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 = SCAN_WINDOW;\u00a0 \/\/ Scan window.\r\n\u00a0\u00a0\u00a0 m_scan_param.p_whitelist\u00a0 = NULL;\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/\/ No whitelist provided.\r\n\u00a0\u00a0\u00a0 m_scan_param.timeout\u00a0\u00a0\u00a0\u00a0\u00a0 = 0x0000;\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/\/ No timeout.\r\n\r\n\u00a0\u00a0 \u00a0err_code = sd_ble_gap_scan_start(&m_scan_param);\r\n\u00a0\u00a0\u00a0 APP_ERROR_CHECK(err_code);\r\n\r\n\u00a0\u00a0\u00a0 err_code = bsp_indication_set(BSP_INDICATE_SCANNING);\r\n\u00a0\u00a0\u00a0 APP_ERROR_CHECK(err_code);\r\n}<\/pre>\n<\/li>\n
  10. Also replace the BLE_GAP_EVT_ADV_REPORT handler in on_ble_evt()<\/strong> with the code that prints the contents of the advertising packet:\n
    \u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 printf(\"ADV report: (size=%d)\\n\", p_gap_evt->params.adv_report.dlen);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 for (int i = 0; i < p_gap_evt->params.adv_report.dlen; i++)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 printf(\"%02x \", p_gap_evt->params.adv_report.data[i]);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 printf(\"\\n\");\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 for (int i = 0; i < p_gap_evt->params.adv_report.dlen; i++)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 printf(\"%c\u00a0 \", p_gap_evt->params.adv_report.data[i]);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 printf(\"\\n\");\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 break;<\/pre>\n<\/li>\n
  11. Press F5 to build the code and start debugging. Insert the battery into the CC2650 SensorTag or press the power button on it if the battery is already inserted:\"09-button\"<\/a><\/li>\n
  12. Observe the output in the COMx window in Visual Studio. It should show the advertising packets received from the SensorTag:\"10-adv\"<\/a><\/li>\n
  13. A typical advertising packet contains one or more fields in the following format: <field length> <field type><field data>. The list of field types can be found here<\/a> and the field length includes the field type field. The advertising packet in the example contains 2 fields: “Flags = 0x05” and “Incomplete UUID List = 0xAA10 (accelerometer service)”. To see more details from the SensorTag, we need to actively request them by sending scan requests. This is done by setting m_scan_param.active = 1<\/strong> in scan_start().<\/strong> Update the scan_start accordingly() and start the new firmware:\"11-advex\"<\/a><\/li>\n
  14. The extended advertisement packet send in response to our active scan requests contains the SensorTag name in the LOCAL_NAME field (type=09). We will now change the BLE_GAP_EVT_ADV_REPORT handling code to connect to the devices that report their name as “CC2650 SensorTag”:\n
    \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 data_t adv_data;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 data_t type_data;\r\n\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 adv_data.p_data = (uint8_t *)p_gap_evt->params.adv_report.data;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 adv_data.data_len = p_gap_evt->params.adv_report.dlen;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 err_code = adv_report_parse(BLE_GAP_AD_TYPE_COMPLETE_LOCAL_NAME,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 &adv_data,\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 &type_data);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 const char expectedName[] = \"CC2650 SensorTag\";\r\n\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 if (err_code != NRF_SUCCESS || \r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 type_data.data_len != sizeof(expectedName) - 1 ||\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 strncmp((const char *)type_data.p_data, expectedName, sizeof(expectedName) - 1))\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 printf(\"Unknown device\\n\");\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 break;\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 }\r\n\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 err_code = sd_ble_gap_scan_stop();\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 APP_ERROR_CHECK(err_code);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 err_code = bsp_indication_set(BSP_INDICATE_IDLE);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 APP_ERROR_CHECK(err_code);\r\n\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 err_code = sd_ble_gap_connect(&p_gap_evt->params.adv_report.peer_addr,\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 &m_scan_param,\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 &m_connection_param);\r\n\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 APP_ERROR_CHECK(err_code);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 printf(\"Connected to device, status %d\\n\", (int)err_code);\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 break;\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 }<\/pre>\n<\/li>\n
  15. If you start the new firmware, you will see that it is constantly resetting itself because we have not registered any clients:\"12-reset\"<\/a><\/li>\n
  16. To register a client to the Simple Keys service (see the SensorTag profile<\/a> for details) we need to call the ble_db_discovery_evt_register()<\/strong> function for the service with a UUID of 0xFFE0 (which is a shortcut for 0000FFE0<\/strong><\/span>-0000-1000-8000 00805F9B34FB as defined by the Bluetooth LE specification):\n
    static void button_service_client_init()\r\n{\r\n\u00a0\u00a0 \u00a0ble_uuid_t btn_uuid;\r\n\r\n\u00a0\u00a0 \u00a0btn_uuid.type = BLE_UUID_TYPE_BLE;\r\n\u00a0\u00a0 \u00a0btn_uuid.uuid = 0xFFE0;\r\n\r\n\u00a0\u00a0 \u00a0ble_db_discovery_evt_register(&btn_uuid, btnsrv_discover_handler);\r\n}<\/pre>\n<\/li>\n
  17. Create an empty btnserv_discover_handler() function and set a breakpoint inside it:\n
    static void btnsrv_discover_handler(ble_db_discovery_evt_t * p_evt)\r\n{\r\n    asm(\"nop\");\r\n}<\/pre>\n<\/li>\n
  18. Finally call button_service_client_init() from main() after the call todb_discovery_init() and run the new firmware. Once the breakpoint is hit, use the Watch window to explore the contents of p_evt<\/strong>:\"13-service\"<\/a><\/li>\n
  19. The contents of p_evt shows that the discovery logic has discovered a service with a UUID of 0xffe0<\/strong> with 1 characteristic (UUID=0xffe1<\/strong>) and the characteristic configuration descriptor value is 0x4a<\/strong>. This matches the information from the SensorTag profile<\/a>:\"14-table\"<\/a><\/li>\n
  20. To start receiving notifications when a button is pressed, we need to write the values of 01:00 to the CCCD register. This is done by modifying the btnsrv_discover_handler() as follows:\n
    void btnsrv_discover_handler(ble_db_discovery_evt_t * p_evt)\r\n{\r\n\u00a0\u00a0 \u00a0static uint8_t enable_notifications[2] = { 1, 0 };\r\n\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0ble_gattc_write_params_t wparams;\r\n\u00a0\u00a0 \u00a0wparams.handle\u00a0\u00a0 = p_evt->params.discovered_db.charateristics[0].cccd_handle;\r\n\u00a0\u00a0 \u00a0wparams.len\u00a0\u00a0\u00a0\u00a0\u00a0 = sizeof(enable_notifications);\r\n\u00a0\u00a0 \u00a0wparams.p_value\u00a0 = enable_notifications;\r\n\u00a0\u00a0 \u00a0wparams.offset\u00a0\u00a0 = 0;\r\n\u00a0\u00a0 \u00a0wparams.write_op = BLE_GATT_OP_WRITE_REQ;\r\n\r\n\u00a0\u00a0 \u00a0int rc = sd_ble_gattc_write(p_evt->conn_handle, &wparams);\r\n\u00a0\u00a0 \u00a0if (rc != NRF_SUCCESS)\r\n\u00a0\u00a0 \u00a0{\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0asm(\"bkpt 255\");\r\n\u00a0\u00a0 \u00a0}\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\r\n}<\/pre>\n<\/li>\n
  21. Finally we need to handle the HVX notifications that the CC2650 SensorTag will send. Create the following function and call it from ble_evt_dispatch()<\/strong> after all other calls:\n
    static void btnsrv_on_ble_evt(ble_evt_t * p_ble_evt)\r\n{\r\n\u00a0\u00a0 \u00a0switch (p_ble_evt->header.evt_id)\r\n\u00a0\u00a0 \u00a0{\r\n\u00a0\u00a0 \u00a0case BLE_GATTC_EVT_HVX:\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0if (p_ble_evt->evt.gattc_evt.params.hvx.len == 1)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0{\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0int data = p_ble_evt->evt.gattc_evt.params.hvx.data[0];\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0printf(\"Status %02x\\n\", data);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0if (data & 1)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0LEDS_ON(1 << LED_1);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0else\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0LEDS_OFF(1 << LED_1);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0if (data & 2)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0LEDS_ON(1 << LED_2);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0else\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0LEDS_OFF(1 << LED_2);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0}\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0break;\r\n\u00a0\u00a0 \u00a0}\r\n}<\/pre>\n<\/li>\n
  22. Build and start the new firmware and see how pressing buttons on the SensorTag turns on the LEDs on nRF51:\"2boards\"<\/a><\/li>\n
  23. The COMx window in Visual Studio should show the “Button HVX” messages produced by the HVX event handler:\"15-log\"<\/a><\/li>\n
  24. You can use the “Show on Code Map” and “Find All References” commands to find the code in the Nordic Bluetooth LE stack that accesses certain variables. E.g. search for references to the cccd_handle<\/strong> field:\"16-cccd\"<\/a><\/li>\n
  25. By putting a breakpoint on the line that assigns it and checking the values of the related variables you can see that the cccd_handle<\/strong> gets the handle to a descriptor with a UUID of 0x2902 that matches the Client Characteristics Configuration Descriptor mentioned in the SensorTag Profile<\/a>:\"17-desc\"<\/a><\/li>\n<\/ol>\n","protected":false},"excerpt":{"rendered":"
    This tutorial shows how to use the nRF51 devices in the Bluetooth LE Central role, communicating to the peripheral devices.<\/p>\n","protected":false},"author":1,"featured_media":441,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[18],"tags":[53,97,56,95],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/418"}],"collection":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/comments?post=418"}],"version-history":[{"count":3,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/418\/revisions"}],"predecessor-version":[{"id":502,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/418\/revisions\/502"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media\/441"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=418"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=418"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=418"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}