Austin Blackstone / Mbed 2 deprecated BLE_EvothingsExample_GATT

This is an mbed side application meant to demonstrate how to create a custom GATT service/characteristic with Evothings.

Dependencies:   BLE_API mbed nRF51822

Intro

This code is meant to be run on an mbed enabled BLE board and paired with the mbed-evothings-customGATT smartphone application.

Details

This code is a demonstration of how to create a custom service (UUID=0xA0000) with two characteristics, a read only characteristic (UUID=0xA001) and a write characteristic (UUID=0xA002). What is written to the write characteristic will be copied across to the read characteristic and broadcast out. If a single byte is written it will be used to toggle the on board LED, if more than 1 byte is written the data will be written out to the terminal. The default max size is 10bytes.

Viewing Data

You can use either the LightBlue app on iOS or the nRF Master Control Panel application on Android to view the advertising data. Alternatively you can use a custom Evothings App to view the data.

Evothings?

Evothings is a rapid prototyping environment that uses cordova to enable you to rapidly develop smartphone applications in Javascript. Please download the Evothings workbench to your computer and the Evothings client to your smartphone. Then grab the code from the github page, drag and drop the index.htm file into Evothings workbench and run it on the Evothings client.

Reference

main.cpp@13:62b1d32745ac, 2015-03-17 (annotated)

Committer:
mbedAustin
Date:
Tue Mar 17 20:40:52 2015 +0000
Revision:
13:62b1d32745ac
Parent:
12:6d1f77d0cb37
Child:
16:feee85aefb34
minor prettification fixes

Who changed what in which revision?

UserRevisionLine numberNew contents of line
mbedAustin 0:cd5b6733aeb1 1 #include "mbed.h"
mbedAustin 0:cd5b6733aeb1 2 #include "BLEDevice.h"
mbedAustin 1:94152e7d8b5c 3
mbedAustin 1:94152e7d8b5c 4 BLEDevice ble;
mbedAustin 1:94152e7d8b5c 5 DigitalOut led(LED1);
mbedAustin 9:b33f42191584 6 uint16_t customServiceUUID = 0xA000;
mbedAustin 13:62b1d32745ac 7 uint16_t readCharUUID = 0xA001;
mbedAustin 9:b33f42191584 8 uint16_t writeCharUUID = 0xA002;
mbedAustin 1:94152e7d8b5c 9
mbedAustin 7:f6814152873c 10 const static char DEVICE_NAME[] = "ChangeMe!!"; // change this
mbedAustin 8:60ede963dfe2 11 static const uint16_t uuid16_list[] = {0xFFFF}; //Custom UUID, FFFF is reserved for development
mbedAustin 1:94152e7d8b5c 12
mbedAustin 10:6acaa9f0ef85 13 // Set Up custom Characteristics
mbedAustin 9:b33f42191584 14 static uint8_t readValue[10] = {0};
mbedAustin 12:6d1f77d0cb37 15 ReadOnlyArrayGattCharacteristic<uint8_t, sizeof(readValue)> readChar(readCharUUID, readValue);
mbedAustin 2:e84c13abc479 16
mbedAustin 9:b33f42191584 17 static uint8_t writeValue[10] = {0};
mbedAustin 12:6d1f77d0cb37 18 WriteOnlyArrayGattCharacteristic<uint8_t, sizeof(writeValue)> writeChar(writeCharUUID, writeValue);
mbedAustin 2:e84c13abc479 19
mbedAustin 2:e84c13abc479 20 // Set up custom service
mbedAustin 8:60ede963dfe2 21 GattCharacteristic *characteristics[] = {&readChar, &writeChar};
mbedAustin 9:b33f42191584 22 GattService customService(customServiceUUID, characteristics, sizeof(characteristics) / sizeof(GattCharacteristic *));
mbedAustin 2:e84c13abc479 23
mbedAustin 2:e84c13abc479 24
mbedAustin 8:60ede963dfe2 25 /*
mbedAustin 8:60ede963dfe2 26 * Restart advertising when phone app disconnects
mbedAustin 8:60ede963dfe2 27 */
mbedAustin 1:94152e7d8b5c 28 void disconnectionCallback(Gap::Handle_t handle, Gap::DisconnectionReason_t reason)
mbedAustin 1:94152e7d8b5c 29 {
mbedAustin 8:60ede963dfe2 30 ble.startAdvertising();
mbedAustin 1:94152e7d8b5c 31 }
mbedAustin 0:cd5b6733aeb1 32
mbedAustin 8:60ede963dfe2 33 /*
mbedAustin 8:60ede963dfe2 34 * handle writes to writeCharacteristic
mbedAustin 8:60ede963dfe2 35 */
mbedAustin 4:7ef90665b399 36 void writeCharCallback(const GattCharacteristicWriteCBParams *params)
mbedAustin 3:0fb60f81f693 37 {
mbedAustin 8:60ede963dfe2 38 // check to see what characteristic was written, by handle
mbedAustin 8:60ede963dfe2 39 if(params->charHandle == writeChar.getValueHandle()) {
mbedAustin 8:60ede963dfe2 40 // toggle LED if only 1 byte is written
mbedAustin 8:60ede963dfe2 41 if(params->len == 1) {
mbedAustin 8:60ede963dfe2 42 led = params->data[0];
mbedAustin 11:b59226338001 43 (params->data[0] == 0x00) ? printf("\n\rled on ") : printf("\n\rled off "); // print led toggle
mbedAustin 8:60ede963dfe2 44 }
mbedAustin 8:60ede963dfe2 45 // print the data if more than 1 byte is written
mbedAustin 8:60ede963dfe2 46 else {
mbedAustin 11:b59226338001 47 printf("\n\r Data received: length = %d, data = 0x",params->len);
mbedAustin 8:60ede963dfe2 48 for(int x=0; x < params->len; x++) {
mbedAustin 8:60ede963dfe2 49 printf("%x",params->data[x]);
mbedAustin 8:60ede963dfe2 50 }
mbedAustin 8:60ede963dfe2 51 }
mbedAustin 8:60ede963dfe2 52 // update the readChar with the value of writeChar
mbedAustin 8:60ede963dfe2 53 ble.updateCharacteristicValue(readChar.getValueHandle(),params->data,params->len);
mbedAustin 8:60ede963dfe2 54 }
mbedAustin 3:0fb60f81f693 55 }
mbedAustin 0:cd5b6733aeb1 56
mbedAustin 8:60ede963dfe2 57 /*
mbedAustin 8:60ede963dfe2 58 * main loop
mbedAustin 8:60ede963dfe2 59 */
mbedAustin 0:cd5b6733aeb1 60 int
mbedAustin 0:cd5b6733aeb1 61 main(void)
mbedAustin 0:cd5b6733aeb1 62 {
mbedAustin 8:60ede963dfe2 63 /* initialize stuff */
mbedAustin 8:60ede963dfe2 64 printf("\n\r********* Starting Main Loop *********\n\r");
mbedAustin 2:e84c13abc479 65 ble.init();
mbedAustin 2:e84c13abc479 66 ble.onDisconnection(disconnectionCallback);
mbedAustin 10:6acaa9f0ef85 67 ble.onDataWritten(writeCharCallback);
mbedAustin 2:e84c13abc479 68
mbedAustin 2:e84c13abc479 69 /* setup advertising */
mbedAustin 7:f6814152873c 70 ble.accumulateAdvertisingPayload(GapAdvertisingData::BREDR_NOT_SUPPORTED | GapAdvertisingData::LE_GENERAL_DISCOVERABLE); // BLE only, no classic BT
mbedAustin 7:f6814152873c 71 ble.setAdvertisingType(GapAdvertisingParams::ADV_CONNECTABLE_UNDIRECTED); // advertising type
mbedAustin 7:f6814152873c 72 ble.accumulateAdvertisingPayload(GapAdvertisingData::COMPLETE_LOCAL_NAME, (uint8_t *)DEVICE_NAME, sizeof(DEVICE_NAME)); // add name
mbedAustin 7:f6814152873c 73 ble.accumulateAdvertisingPayload(GapAdvertisingData::COMPLETE_LIST_16BIT_SERVICE_IDS, (uint8_t *)uuid16_list, sizeof(uuid16_list)); // UUID's broadcast in advertising packet
mbedAustin 2:e84c13abc479 74 ble.setAdvertisingInterval(160); /* 100ms; in multiples of 0.625ms. */
mbedAustin 2:e84c13abc479 75
mbedAustin 8:60ede963dfe2 76 // add our custom service
mbedAustin 13:62b1d32745ac 77 ble.addService(customService);
mbedAustin 2:e84c13abc479 78
mbedAustin 13:62b1d32745ac 79 // start advertising
mbedAustin 13:62b1d32745ac 80 ble.startAdvertising();
mbedAustin 9:b33f42191584 81
mbedAustin 9:b33f42191584 82 // infinite loop waiting for BLE interrupt events
mbedAustin 2:e84c13abc479 83 while (true) {
mbedAustin 2:e84c13abc479 84 ble.waitForEvent(); //Save power
mbedAustin 2:e84c13abc479 85 }
mbedAustin 8:60ede963dfe2 86 }