{"id":451,"date":"2017-04-18T12:07:22","date_gmt":"2017-04-18T10:07:22","guid":{"rendered":"http:\/\/systev.com\/?p=451"},"modified":"2020-04-27T08:26:18","modified_gmt":"2020-04-27T06:26:18","slug":"sodaq-explorer-and-bluetooth","status":"publish","type":"post","link":"https:\/\/systev.com\/sodaq-explorer-and-bluetooth\/","title":{"rendered":"SODAQ ExpLoRer and Bluetooth"},"content":{"rendered":"<p><a href=\"http:\/\/support.sodaq.com\/sodaq-one\/explorer\/\" target=\"_blank\" rel=\"noopener noreferrer\">SODAQ ExpLoRer board<\/a> includes a <a href=\"http:\/\/www.microchip.com\/wwwproducts\/en\/RN4871\" target=\"_blank\" rel=\"noopener noreferrer\">Microchip RN4871 Bluetooth module<\/a>. This post explains how to start using it.<\/p>\n<p><!--more--><\/p>\n<h2>Reference documentation<\/h2>\n<ul>\n<li><a href=\"http:\/\/www.microchip.com\/wwwproducts\/en\/RN4871#documents\" target=\"_blank\" rel=\"noopener noreferrer\">RN4871 documentation<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/SodaqMoja\/Microchip_RN487x\" target=\"_blank\" rel=\"noopener noreferrer\">source code of the Microchip_RN487x library<\/a><\/li>\n<li><a href=\"https:\/\/developer.android.com\/guide\/topics\/connectivity\/bluetooth-le.html\" target=\"_blank\" rel=\"noopener noreferrer\">Android Bluetooth LE API guide<\/a><\/li>\n<li><a href=\"https:\/\/learn.sparkfun.com\/tutorials\/bluetooth-basics\" target=\"_blank\" rel=\"noopener noreferrer\">Bluetooth basics<\/a>, on Sparkfun website<\/li>\n<li><a href=\"https:\/\/www.bluetooth.com\/\" target=\"_blank\" rel=\"noopener noreferrer\">Bluetooth website<\/a><\/li>\n<li><a href=\"https:\/\/www.arduino.cc\/en\/Reference\/Libraries\" target=\"_blank\" rel=\"noopener noreferrer\">Arduino libraries<\/a><\/li>\n<li><a href=\"https:\/\/github.com\/arduino\/ArduinoCore-samd\" target=\"_blank\" rel=\"noopener noreferrer\">source code of Arduino Core for SAMD21 CPU<\/a><\/li>\n<li><a href=\"http:\/\/monblocnotes.com\/node\/2036\" target=\"_blank\" rel=\"noopener noreferrer\">some C reference material<\/a><\/li>\n<\/ul>\n<h2>Getting started with ExpLoRer<\/h2>\n<p>Check <a href=\"http:\/\/systev.com\/connecting-sodaq-explorer-to-orange-live-objects\/\" target=\"_blank\" rel=\"noopener noreferrer\">this post<\/a>.<\/p>\n<h2>First test &#8211; get firmware version<\/h2>\n<p>Once the Microchip_RN487x library is installed, several sample applications are available (<strong>File \/ Examples \/ Microchip_RN487x-master<\/strong>), and can be used as references for some test code.<\/p>\n<p>Let&#8217;s try to write our first application, that will request and display RN4871 firmware version (that&#8217;s always a good idea to check versions of various software building blocks you are about to use).<\/p>\n<p>Source code is below:<\/p>\n<pre>#include &lt;RN487x_BLE.h&gt;\n\n#define debugSerial SerialUSB\n#define bleSerial Serial1\n\n#define SERIAL_TIMEOUT 10000&nbsp; \/\/ 10 s\n\nconst char* fwVersion;\n\nvoid setRgbColor(uint8_t red, uint8_t green, uint8_t blue)\n{\n&nbsp; red = 255 - red ;\n&nbsp; green = 255 - green ;\n&nbsp; blue = 255 - blue ;\n\n&nbsp; analogWrite(LED_RED, red) ;\n&nbsp; analogWrite(LED_GREEN, green) ;\n&nbsp; analogWrite(LED_BLUE, blue) ;\n}\n\nvoid setup() {\n\n&nbsp; \/\/ Wait for monitor window to be used, up to SERIAL_TIMEOUT.\n&nbsp; while ((!debugSerial) &amp;&amp; (millis() &lt; SERIAL_TIMEOUT));\n&nbsp; debugSerial.begin(115200); &nbsp;\n\n&nbsp; \/\/ Set the optional debug stream\n&nbsp; rn487xBle.setDiag(debugSerial) ;\n&nbsp; \/\/ Initialize the BLE hardware\n&nbsp; rn487xBle.hwInit() ;\n&nbsp; \/\/ Open the communication pipe with the BLE module\n&nbsp; bleSerial.begin(rn487xBle.getDefaultBaudRate()) ;\n&nbsp; \/\/ Assign the BLE serial port to the BLE library\n&nbsp; rn487xBle.initBleStream(&amp;bleSerial) ;\n&nbsp; \/\/ Finalize the init. process\n&nbsp; if (rn487xBle.swInit())\n&nbsp; {\n&nbsp;&nbsp;&nbsp; setRgbColor(0, 255, 0) ;\n&nbsp;&nbsp;&nbsp; debugSerial.println(\"Init. procedure done!\") ;\n&nbsp; }\n&nbsp; else\n&nbsp; {\n&nbsp;&nbsp;&nbsp; setRgbColor(255, 0, 0) ;\n&nbsp;&nbsp;&nbsp; debugSerial.println(\"Init. procedure failed!\") ;\n&nbsp;&nbsp;&nbsp; while(1) ;\n&nbsp; }\n\n}\n\nvoid loop() {\n\n&nbsp; \/\/ BT module must be put in command mode first.\n&nbsp; rn487xBle.enterCommandMode() ;\n  \/\/ Request firmware version.\n&nbsp; bool res = rn487xBle.getFirmwareVersion();\n&nbsp; if (!res) {\n&nbsp;&nbsp;&nbsp; debugSerial.println(\"Could not get firmware version. Stopping...\");\n&nbsp;&nbsp;&nbsp; while(1);\n&nbsp; }\n&nbsp; \/\/ At this stage, firmware version was returned by RN4871 module. Get it.\n&nbsp; fwVersion = rn487xBle.getLastResponse();\n&nbsp; if (fwVersion == NULL) {\n&nbsp;&nbsp;&nbsp; debugSerial.println(\"Firmware version can't be read. Stopping...\");\n&nbsp;&nbsp;&nbsp; while(1);\n&nbsp; }\n&nbsp; \/\/ At this stage, we should have the firmware version.\n&nbsp; debugSerial.print(\"Firmware version: \"); \n&nbsp; debugSerial.println(fwVersion);\n&nbsp; \/\/ Now, stop.\n&nbsp; while(1);\n\n}<\/pre>\n<p>Following result is displayed in the monitor window:<\/p>\n<pre>Init. procedure done!\nFirmware version: RN4871 V1.18.3 4\/14\/2016 (c)Microchip Technology Inc<\/pre>\n<p>According to <a href=\"http:\/\/www.microchip.com\/wwwproducts\/en\/RN4871#documents\" target=\"_blank\" rel=\"noopener noreferrer\">Microchip website<\/a>, that&#8217;s the latest version. Good!<\/p>\n<p>Before going farther, one good practice is to reset the configurations into factory default, to be sure the module will behave according to the documentation. That&#8217;s exactly what I had to do: I&#8217;m using a second-hand board, and it rapidly appeared that the RN4871 was reacting in an unexpected way to the commands I was sending it. A factory reset put things back in order. The source code is below:<\/p>\n<pre>#include &lt;RN487x_BLE.h&gt;\n\n#define debugSerial SerialUSB\n#define bleSerial Serial1\n#define SERIAL_TIMEOUT&nbsp; 10000\n\nvoid initLed()\n{\n&nbsp; pinMode(LED_RED, OUTPUT) ;\n&nbsp; pinMode(LED_GREEN, OUTPUT) ;\n&nbsp; pinMode(LED_BLUE, OUTPUT) ; &nbsp;\n}\n\nvoid setRgbColor(uint8_t red, uint8_t green, uint8_t blue)\n{\n&nbsp; red = 255 - red ;\n&nbsp; green = 255 - green ;\n&nbsp; blue = 255 - blue ;\n\n&nbsp; analogWrite(LED_RED, red) ;\n&nbsp; analogWrite(LED_GREEN, green) ;\n&nbsp; analogWrite(LED_BLUE, blue) ;\n}\n\nvoid setup()\n{\n&nbsp; while ((!debugSerial) &amp;&amp; (millis() &lt; SERIAL_TIMEOUT)) ;\n&nbsp; \n&nbsp; debugSerial.begin(115200) ;\n\n&nbsp; initLed() ;\n&nbsp; setRgbColor(127, 127, 127) ;\n\n&nbsp; \/\/ Set the optional debug stream\n&nbsp; rn487xBle.setDiag(debugSerial) ;\n&nbsp; \/\/ Initialize the BLE hardware\n&nbsp; rn487xBle.hwInit() ;\n&nbsp; \/\/ Open the communication pipe with the BLE module\n&nbsp; bleSerial.begin(rn487xBle.getDefaultBaudRate()) ;\n&nbsp; \/\/ Assign the BLE serial port to the BLE library\n&nbsp; rn487xBle.initBleStream(&amp;bleSerial) ;\n&nbsp; \/\/ Finalize the init. process\n&nbsp; if (!rn487xBle.swInit()) {\n&nbsp;&nbsp;&nbsp; setRgbColor(127, 0, 0) ;\n&nbsp;&nbsp;&nbsp; debugSerial.println(\"Init. procedure failed!\") ;\n&nbsp;&nbsp;&nbsp; while(1) ;&nbsp;&nbsp; &nbsp;\n&nbsp; }\n&nbsp; \/\/ At this stage, init. succeeded.\n&nbsp; setRgbColor(0, 127, 0) ;\n&nbsp; debugSerial.println(\"Init. procedure done!\") ;\n\n&nbsp; \/\/ Perform factory reset.\n&nbsp; rn487xBle.enterCommandMode();\n&nbsp; if (!rn487xBle.factoryReset()) {\n&nbsp;&nbsp;&nbsp; debugSerial.println(\"Couldn't perform factory reset\");\n&nbsp;&nbsp;&nbsp; setRgbColor(127, 0, 0);\n&nbsp;&nbsp;&nbsp; while(1);\n&nbsp; }\n&nbsp; setRgbColor(127, 127, 0);\n&nbsp; debugSerial.println(\"Factory reset done\") ;\n\n}\n\nvoid loop()\n{\n\n}<\/pre>\n<h2>Second test &#8211; GATT service<\/h2>\n<p>In this test, we configure the RN4871 so that it can be discovered by an Android smartphone, and that it provides one BLE GATT service, with one read characteristic and one write characteristic.<\/p>\n<p>First, install the <a href=\"https:\/\/play.google.com\/store\/apps\/details?id=com.microchip.bluetoothsmartdiscover\" target=\"_blank\" rel=\"noopener noreferrer\">Microchip <em>Bluetooth Smart Discover<\/em> application<\/a> on the smartphone.<\/p>\n<p>Then, load following program into the board:<\/p>\n<pre>\/\/ Derived from BLE_Peripheral.ino\n\n\/*\n&nbsp;&nbsp;&nbsp; (c) 2016 Microchip Technology Inc. and its subsidiaries. You may use this\n&nbsp;&nbsp;&nbsp; software and any derivatives exclusively with Microchip products.\n\n&nbsp;&nbsp;&nbsp; THIS SOFTWARE IS SUPPLIED BY MICROCHIP \"AS IS\". NO WARRANTIES, WHETHER\n&nbsp;&nbsp;&nbsp; EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE, INCLUDING ANY IMPLIED\n&nbsp;&nbsp;&nbsp; WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A\n&nbsp;&nbsp;&nbsp; PARTICULAR PURPOSE, OR ITS INTERACTION WITH MICROCHIP PRODUCTS, COMBINATION\n&nbsp;&nbsp;&nbsp; WITH ANY OTHER PRODUCTS, OR USE IN ANY APPLICATION.\n\n&nbsp;&nbsp;&nbsp; IN NO EVENT WILL MICROCHIP BE LIABLE FOR ANY INDIRECT, SPECIAL, PUNITIVE,\n&nbsp;&nbsp;&nbsp; INCIDENTAL OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE OF ANY KIND\n&nbsp;&nbsp;&nbsp; WHATSOEVER RELATED TO THE SOFTWARE, HOWEVER CAUSED, EVEN IF MICROCHIP HAS\n&nbsp;&nbsp;&nbsp; BEEN ADVISED OF THE POSSIBILITY OR THE DAMAGES ARE FORESEEABLE. TO THE\n&nbsp;&nbsp;&nbsp; FULLEST EXTENT ALLOWED BY LAW, MICROCHIP'S TOTAL LIABILITY ON ALL CLAIMS IN\n&nbsp;&nbsp;&nbsp; ANY WAY RELATED TO THIS SOFTWARE WILL NOT EXCEED THE AMOUNT OF FEES, IF ANY,\n&nbsp;&nbsp;&nbsp; THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR THIS SOFTWARE.\n\n&nbsp;&nbsp;&nbsp; MICROCHIP PROVIDES THIS SOFTWARE CONDITIONALLY UPON YOUR ACCEPTANCE OF THESE\n&nbsp;&nbsp;&nbsp; TERMS.\n*\/\n\n#include &lt;RN487x_BLE.h&gt;\n\n#define debugSerial SerialUSB\n#define bleSerial Serial1\n#define SERIAL_TIMEOUT&nbsp; 10000\n\nconst char* myDeviceName = \"testPeriph\" ;&nbsp; \/\/ Custom Device name\nconst char* myPrivateServiceUUID = \"AD11CF40063F11E5BE3E0002A5D5C51B\" ; \/\/ Custom private service UUID\nconst char* temperatureCharacteristicUUID = \"BF3FBD80063F11E59E690002A5D5C501\" ;&nbsp; \/\/ custom characteristic GATT\nconst uint8_t temperatureCharacteristicLen = 2 ;&nbsp; \/\/ data length (in bytes)\nconst uint16_t temperatureHandle = 0x72 ;\nchar temperaturePayload[temperatureCharacteristicLen*2] ;\nfloat temperature_s ;\nuint8_t newTempValue_u8 = 0 ;\nuint8_t prevTempValue_u8 = 0 ;\nconst char* ledCharacteristicUUID = \"BF3FBD80063F11E59E690002A5D5C503\" ;&nbsp; \/\/ custom characteristic GATT\nconst uint8_t ledCharacteristicLen = 6 ;\nuint16_t ledHandle = 0x75 ;\nconst char* ledPayload ;\n\nvoid initLed()\n{\n&nbsp; pinMode(LED_BUILTIN, OUTPUT) ;\n&nbsp; pinMode(LED_RED, OUTPUT) ;\n&nbsp; pinMode(LED_GREEN, OUTPUT) ;\n&nbsp; pinMode(LED_BLUE, OUTPUT) ; &nbsp;\n&nbsp; pinMode(BUTTON, INPUT_PULLUP) ;\n}\n\nvoid turnBlueLedOn()\n{\n&nbsp; digitalWrite(LED_BUILTIN, HIGH) ;\n}\n\nvoid turnBlueLedOff()\n{\n&nbsp; digitalWrite(LED_BUILTIN, LOW) ;\n}\n\nvoid setRgbColor(uint8_t red, uint8_t green, uint8_t blue)\n{\n&nbsp; red = 255 - red ;\n&nbsp; green = 255 - green ;\n&nbsp; blue = 255 - blue ;\n\n&nbsp; analogWrite(LED_RED, red) ;\n&nbsp; analogWrite(LED_GREEN, green) ;\n&nbsp; analogWrite(LED_BLUE, blue) ;\n}\n\nvoid initTemperature()\n{\n&nbsp; pinMode(TEMP_SENSOR, INPUT) ;\n&nbsp; \/\/Set ADC resolution to 12 bits\n&nbsp; analogReadResolution(12) ; &nbsp;\n}\n\nfloat getTemperature()\n{\n&nbsp; float mVolts = (float)analogRead(TEMP_SENSOR) * 3300.0 \/ 1023.0 ;\n&nbsp; float temp = (mVolts - 500.0) \/ 100.0 ;\n&nbsp; return temp ;\n}\n\nvoid setup()\n{\n&nbsp; while ((!debugSerial) &amp;&amp; (millis() &lt; SERIAL_TIMEOUT)) ;\n&nbsp; \n&nbsp;&nbsp; &nbsp;debugSerial.begin(115200) ;\n\n&nbsp; initLed() ;\n&nbsp; initTemperature() ;\n\n&nbsp; \/\/ Set the optional debug stream\n&nbsp; rn487xBle.setDiag(debugSerial) ;\n&nbsp; \/\/ Initialize the BLE hardware\n&nbsp; rn487xBle.hwInit() ;\n&nbsp; \/\/ Open the communication pipe with the BLE module\n&nbsp; bleSerial.begin(rn487xBle.getDefaultBaudRate()) ;\n&nbsp; \/\/ Assign the BLE serial port to the BLE library\n&nbsp; rn487xBle.initBleStream(&amp;bleSerial) ;\n&nbsp; \/\/ Finalize the init. process\n&nbsp; if (rn487xBle.swInit())\n&nbsp; {\n&nbsp;&nbsp;&nbsp; setRgbColor(0, 255, 0) ;\n&nbsp;&nbsp;&nbsp; debugSerial.println(\"Init. procedure done!\") ;\n&nbsp; }\n&nbsp; else\n&nbsp; {\n&nbsp;&nbsp;&nbsp; setRgbColor(255, 0, 0) ;\n&nbsp;&nbsp;&nbsp; debugSerial.println(\"Init. procedure failed!\") ;\n&nbsp;&nbsp;&nbsp; while(1) ;\n&nbsp; }\n\n&nbsp; \/\/ Fist, enter into command mode\n&nbsp; rn487xBle.enterCommandMode() ;\n&nbsp; \/\/ Stop advertising before starting the demo\n&nbsp; rn487xBle.stopAdvertising() ;\n&nbsp; \/\/ Set the advertising output power (range: min = 5, max = 0)\n&nbsp; rn487xBle.setAdvPower(3) ;\n&nbsp; \/\/ Set the serialized device name, i.e. device n,ame + 2 last bytes from MAC address.\n&nbsp; rn487xBle.setSerializedName(myDeviceName) ;\n&nbsp; rn487xBle.clearAllServices() ;\n&nbsp; rn487xBle.reboot() ;\n&nbsp; rn487xBle.enterCommandMode() ; &nbsp;\n&nbsp; \/\/ Set a private service ...\n&nbsp; rn487xBle.setServiceUUID(myPrivateServiceUUID) ;\n&nbsp; \/\/ which contains ...\n&nbsp; \/\/ ...a temperature characteristic; readable and can perform notification, 2-octets size\n&nbsp; rn487xBle.setCharactUUID(temperatureCharacteristicUUID, READ_PROPERTY | NOTIFY_PROPERTY, temperatureCharacteristicLen) ;\n&nbsp; \/\/ ...an LED characteristic; properties: writable\n&nbsp; rn487xBle.setCharactUUID(ledCharacteristicUUID, WRITE_PROPERTY, ledCharacteristicLen) ;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;\n&nbsp; \/\/ take into account the settings by issuing a reboot\n&nbsp; rn487xBle.reboot() ;\n&nbsp; rn487xBle.enterCommandMode() ;\n&nbsp; \/\/ Clear adv. packet\n&nbsp; rn487xBle.clearImmediateAdvertising() ;\n&nbsp; \/\/ Start adv.\n&nbsp; \/\/ The line below is required, to let an Android device discover the board. \n&nbsp; rn487xBle.startImmediateAdvertising(AD_TYPE_FLAGS, \"06\");\n&nbsp; rn487xBle.startImmediateAdvertising(AD_TYPE_MANUFACTURE_SPECIFIC_DATA, \"CD00FE14AD11CF40063F11E5BE3E0002A5D5C51B\") ;\n\n&nbsp; debugSerial.println(\"Starter Kit as a Peripheral with private service\") ;\n&nbsp; debugSerial.println(\"================================================\") ;\n&nbsp; debugSerial.print(\"Private service: \") ;\n  debugSerial.println(myPrivateServiceUUID) ;\n&nbsp; debugSerial.print(\"Private characteristic used for the Temperature: \") ;\n  debugSerial.println(temperatureCharacteristicUUID) ;\n&nbsp; debugSerial.print(\"Private characteristic used for the LED: \") ;\n  debugSerial.println(ledCharacteristicUUID) ;\n&nbsp; debugSerial.println(\"You can now establish a connection from the Microchip SmartDiscovery App\") ;\n&nbsp; debugSerial.print(\"with the starter kit: \") ;\n  debugSerial.println(rn487xBle.getDeviceName()) ;\n\n}\n\nvoid loop()\n{\n&nbsp; \/\/ Check the connection status\n&nbsp; if (rn487xBle.getConnectionStatus())\n&nbsp; {\n&nbsp;&nbsp;&nbsp; \/\/ Connected to a peer\n&nbsp;&nbsp;&nbsp; debugSerial.print(\"Connected to a peer central \") ;\n&nbsp;&nbsp;&nbsp; debugSerial.println(rn487xBle.getLastResponse()) ;\n\n&nbsp;&nbsp;&nbsp; \/\/ Temperature\n&nbsp;&nbsp;&nbsp; prevTempValue_u8 = newTempValue_u8 ;\n&nbsp;&nbsp;&nbsp; temperature_s = getTemperature() ;\n&nbsp;&nbsp;&nbsp; newTempValue_u8 = (int)temperature_s ;\n&nbsp;&nbsp;&nbsp; \/\/ Update the local characteristic only if value has changed\n&nbsp;&nbsp;&nbsp; if (newTempValue_u8 != prevTempValue_u8)\n&nbsp;&nbsp;&nbsp; {\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; uint8_t data = newTempValue_u8 ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; temperaturePayload[3] = '0' + (data % 10) ; \/\/ LSB\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; data \/= 10 ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; temperaturePayload[2] = '0' + (data % 10) ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; data \/= 10 ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; temperaturePayload[1] = '0' + (data % 10) ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; if (temperature_s &gt; 0)&nbsp; temperaturePayload[0] = '0' ; \/\/ MSB = 0, positive temp.\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; else&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; temperaturePayload[0] = '8' ; \/\/ MSB = 1, negative temp. &nbsp;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; if (rn487xBle.writeLocalCharacteristic(temperatureHandle, temperaturePayload))\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; {\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; debugSerial.print(\"Temperature characteristic has been updated with the value = \") ; debugSerial.println(newTempValue_u8) ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; }\n&nbsp;&nbsp;&nbsp; }\n\n&nbsp;&nbsp;&nbsp; \/\/ LED\n&nbsp;&nbsp;&nbsp; if (rn487xBle.readLocalCharacteristic(ledHandle))\n&nbsp;&nbsp;&nbsp; {\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ Read the local characteristic written by the client: smartphone\/tablet\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ The payload must follow the 6-bit RGB coded format:\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ [0] Red MSB\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ [1] Red LSB\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ [2] Green MSB\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ [3] Green LSB\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ [4] Blue MSB\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ [5] Blue LSB\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ Each color can be coded from range 0x00 to 0xFF\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; ledPayload = rn487xBle.getLastResponse() ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; if (ledPayload != NULL)\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; {\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; if (ledPayload[0] != 'N') \/\/ != \"N\/A\" response\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; {\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; debugSerial.println(ledPayload) ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; if (strlen(ledPayload) == ledCharacteristicLen)\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; {\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ Filter only the 6-digit len\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; \/\/ Convert ASCII to integer values\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; uint8_t r = (ledPayload[0] - '0') * 10 + (ledPayload[1] - '0') ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; uint8_t g = (ledPayload[2] - '0') * 10 + (ledPayload[3] - '0') ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; uint8_t b = (ledPayload[4] - '0') * 10 + (ledPayload[5] - '0') ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; setRgbColor(r, g, b) ;\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; }\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; }\n&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; }\n&nbsp;&nbsp;&nbsp; }&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp; &nbsp;\n&nbsp; }\n&nbsp; else\n&nbsp; {\n&nbsp;&nbsp;&nbsp; \/\/ Not connected to a peer device\n&nbsp;&nbsp;&nbsp; debugSerial.println(\"Not connected to a peer device\") ;\n&nbsp; }\n&nbsp; \/\/ Delay inter connection polling\n&nbsp; delay(3000) ;\n}<\/pre>\n<p>This code is derived from one of the samples provided with the library (that&#8217;s why I kept Microchip copyright notice). But there is one important difference: I added following line, for the advertisement configuration:<\/p>\n<pre>rn487xBle.startImmediateAdvertising(AD_TYPE_FLAGS, \"06\");<\/pre>\n<p>Without it, an Android device would not discover the board (source of information: section 4.3 of the <a href=\"http:\/\/ww1.microchip.com\/downloads\/en\/DeviceDoc\/RN487x%20Firmware%20v1.18.3%20Release%20Note%20-%20Sep20.pdf\" target=\"_blank\" rel=\"noopener noreferrer\">v1.18.3 release notes<\/a>. BTW, there is an error in this section, but quite easy to spot).<\/p>\n<p>On the smartphone, start the <em>Bluetooth Smart Discover<\/em> application. It must be granted following permissions:<\/p>\n<ul>\n<li><em>pair with Bluetooth devices<\/em><\/li>\n<li><em>access Bluetooth settings<\/em><\/li>\n<li><em>precise location<\/em> (or <em>approximate location<\/em>)<\/li>\n<\/ul>\n<p>Thanks to the application, you should be able to discover the board (named <tt>testPeriph_XXXX<\/tt>), connect to it and get the list of services it provides. The service created by the above sample code, the one with <tt>AD11CF40063F11E5BE3E0002A5D5C51B<\/tt> UUID, lets you read the temperature value generated by the board sensor, thanks to the read characteristic (<tt>BF3FBD80063F11E59E690002A5D5C501<\/tt> UUID). And it lets you modify LED color, thanks to the write characteristic (<tt>BF3FBD80063F11E59E690002A5D5C503<\/tt> UUID): send three bytes, e.g. <tt>00FF00<\/tt> to set green color at maximum intensity.<\/p>\n<h2>Your own Android app?<\/h2>\n<p>What now if you want to develop your own Android app, that you would be able to use with this Arduino code?<\/p>\n<p>The easiest way it to start from an existing sample code, the one of the <a href=\"https:\/\/developer.android.com\/samples\/BluetoothLeGatt\/index.html\" target=\"_blank\" rel=\"noopener noreferrer\">BluetoothLeGatt application<\/a>. Do not forget to grant above three permissions to your application, otherwise it won&#8217;t work&#8230;<\/p>\n","protected":false},"excerpt":{"rendered":"<p>SODAQ ExpLoRer board includes a Microchip RN4871 Bluetooth module. This post explains how to start using it.<\/p>\n","protected":false},"author":2,"featured_media":438,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2,17],"tags":[],"_links":{"self":[{"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/posts\/451"}],"collection":[{"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/comments?post=451"}],"version-history":[{"count":16,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/posts\/451\/revisions"}],"predecessor-version":[{"id":1092,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/posts\/451\/revisions\/1092"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/media\/438"}],"wp:attachment":[{"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/media?parent=451"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/categories?post=451"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/tags?post=451"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}