{"id":398,"date":"2015-08-04T21:36:24","date_gmt":"2015-08-05T04:36:24","guid":{"rendered":"http:\/\/visualgdb.com\/w\/?p=398"},"modified":"2015-08-04T21:39:19","modified_gmt":"2015-08-05T04:39:19","slug":"creating-a-bluetooth-le-beacon-with-nrf51-and-visual-studio","status":"publish","type":"post","link":"https:\/\/visualgdb.com\/tutorials\/arm\/nrf51\/beacon\/","title":{"rendered":"Creating a Bluetooth LE Beacon with nRF51 and Visual Studio"},"content":{"rendered":"

This tutorial shows how to create a Bluetooth LE Beacon using the Nordic nRF51-DK board and VisualGDB. Before you begin, install VisualGDB 5.0 and get a Bluetooth LE-capable Android Phone. It is also recommended to follow the basic nRF51 tutorial<\/a> to ensure that your board hardware and drivers work without any problems.<\/p>\n

    \n
  1. Open the VisualGDB Embedded Project wizard in Visual Studio and specify the name and location for your project:\"01-beaconprj\"<\/a><\/li>\n
  2. Proceed with the default settings on the first page (New Project -> Embedded Binary):\"02-binprj\"<\/a><\/li>\n
  3. On the Device Selection page select your Nordic device and specify a softdevice supporting the Bluetooth LE Peripheral role:\"03-device\"<\/a><\/li>\n
  4. On the Sample Selection page select the Bluetooth LE Beacon sample and specify your board type below (the board type is printed on a sticker on your board):\"04-beacon\"<\/a><\/li>\n
  5. Finally select a debug method. The nRF51-DK board comes with an on-board Segger J-Link, so in this tutorial we will use the Segger debug method. Ensure that you select the “Reset device after programming” checkbox, as otherwise the softdevice initialization code will be bypassed resulting in random crashes:\"05-debug\"<\/a><\/li>\n
  6. Press “Finish” to create the project. Then build it with Ctrl-Shift-B: \"06-build\"<\/a><\/li>\n
  7. Start debugging the firmware with F5. Then install and open the nRF Toolbox app on your Android device:\"07-beacons\"<\/a><\/li>\n
  8. Click the “Beacons” item. If you have not added any beacons before, the list will be empty. Click the “+” sign to add the beacon:\"08-addbeacon\"<\/a><\/li>\n
  9. Click the left arrow near the “Beacon Config” text to return to the beacon list:\"09-beacon\"<\/a>If the beacon parameters window never appears, try closing all Bluetooth-related apps and if that does not help, restart your phone.<\/li>\n
  10. Ensure that the beacon list now shows your beacon.\"10-beaconlist\"<\/a><\/li>\n
  11. Now we will modify the beacon example to emulate 2 different beacons alternating between them when button #1 is pressed. The beacon information is contained in the advertisement packet that is stored in the m_beacon_info<\/strong> variable:\n
    static uint8_t m_beacon_info[APP_BEACON_INFO_LENGTH] =\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 \/**< Information advertised by the Beacon. *\/\r\n{\r\n\u00a0\u00a0\u00a0 APP_DEVICE_TYPE,\u00a0\u00a0\u00a0\u00a0 \/\/ Manufacturer specific information. Specifies the device type in this \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 \/\/ implementation. \r\n\u00a0\u00a0\u00a0 APP_ADV_DATA_LENGTH, \/\/ Manufacturer specific information. Specifies the length of the \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 \/\/ manufacturer specific data in this implementation.\r\n\u00a0\u00a0\u00a0 APP_BEACON_UUID,\u00a0\u00a0\u00a0\u00a0 \/\/ 128 bit UUID value. \r\n\u00a0\u00a0\u00a0 APP_MAJOR_VALUE,\u00a0\u00a0\u00a0\u00a0 \/\/ Major arbitrary value that can be used to distinguish between Beacons. \r\n\u00a0\u00a0\u00a0 APP_MINOR_VALUE,\u00a0\u00a0\u00a0\u00a0 \/\/ Minor arbitrary value that can be used to distinguish between Beacons. \r\n\u00a0\u00a0\u00a0 APP_MEASURED_RSSI\u00a0\u00a0\u00a0 \/\/ Manufacturer specific information. The Beacon's measured TX power in \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 \/\/ this implementation. \r\n};<\/pre>\n<\/li>\n
  12. The contents of the advertisement packet is passed to the softdevice by the advertising_init()<\/strong> function:\"11-adv\"<\/a><\/li>\n
  13. You can use the code map to visualize the functions involved in the initialization:\"14-codemap\"<\/a><\/li>\n
  14. To add the necessary modifications we will first need to enable button initialization in the call to bsp_init(). Modify the line calling bsp_init() from main() to include the button initialization:\n
    \u00a0\u00a0\u00a0 err_code = bsp_init(BSP_INIT_LED | BSP_INIT_BUTTONS, APP_TIMER_TICKS(100, APP_TIMER_PRESCALER), NULL);<\/pre>\n
    Then include the “nrf_delay.h” file and replace the loop inside main() with the following:<\/p>\n
    \u00a0\u00a0\u00a0 for (;; )\r\n\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 power_manage();\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0 bool state;\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0 if (bsp_button_is_pressed(0, &state) == NRF_SUCCESS && state)\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0 {\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0 m_beacon_info[21] ^= 1;\u00a0\u00a0 \u00a0\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0 advertising_init();\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0 nrf_delay_ms(1000);\r\n\u00a0\u00a0 \u00a0\u00a0\u00a0\u00a0 }\r\n\u00a0\u00a0\u00a0 }<\/pre>\n<\/li>\n
  15. Now each time the button #1 is pressed, the least-significant bit in the beacon minor ID will change. The delay after a call to advertising_init()<\/strong> ensures that the same button press won’t be handled twice. Press F5 to start debugging and rapidly press the button #1:\"button1\"<\/a><\/li>\n
  16. Observe how the beacon disappears from the list. Click the “+” button again and notice how the beacon ID has changed by 1:\"12-beacon2\"<\/a><\/li>\n
  17. Return to the beacon list and observe how pressing the button #1 causes another beacon to appear and the previous one to disappear soon after:\"13-2beacons\"<\/a><\/li>\n<\/ol>\n
     <\/p>\n","protected":false},"excerpt":{"rendered":"
    This tutorial shows how to create a Bluetooth LE Beacon using the Nordic nRF51-DK board and VisualGDB. Before you begin,<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[18],"tags":[53,96,56,95],"_links":{"self":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/398"}],"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=398"}],"version-history":[{"count":3,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/398\/revisions"}],"predecessor-version":[{"id":442,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/posts\/398\/revisions\/442"}],"wp:attachment":[{"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/media?parent=398"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/categories?post=398"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/visualgdb.com\/w\/wp-json\/wp\/v2\/tags?post=398"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}