Add Json Characteristic examples

Author: mraleson

examples/ble_json_central.py

@@ -0,0 +1,32 @@
+# SPDX-FileCopyrightText: 2020 Mark Raleson
+#
+# SPDX-License-Identifier: MIT
+
+# Read sensor readings from peripheral BLE device using JSON characteristic.
+
+from adafruit_ble import BLERadio
+from adafruit_ble.advertising.standard import ProvideServicesAdvertisement
+from ble_json_service import SensorService
+
+
+ble = BLERadio()
+connection = None
+
+while True:
+
+    if not connection:
+        print("Scanning for BLE device advertising our sensor service...")
+        for adv in ble.start_scan(ProvideServicesAdvertisement):
+            if SensorService in adv.services:
+                connection = ble.connect(adv)
+                print("Connected")
+                break
+        ble.stop_scan()
+
+    if connection and connection.connected:
+        service = connection[SensorService]
+        service.settings = {
+            'unit': 'celsius' #  'fahrenheit'
+        }
+        while connection.connected:
+            print('Sensors: ', service.sensors)

examples/ble_json_peripheral.py

@@ -0,0 +1,49 @@
+# SPDX-FileCopyrightText: 2020 Mark Raleson
+#
+# SPDX-License-Identifier: MIT
+
+# Provide readable sensor values and writable settings to connected devices via Json characteristic.
+
+import time
+import random
+from adafruit_ble import BLERadio
+from adafruit_ble.advertising.standard import ProvideServicesAdvertisement
+from ble_json_service import SensorService
+
+
+# Create BLE radio, custom service, and advertisement.
+ble = BLERadio()
+service = SensorService()
+advertisement = ProvideServicesAdvertisement(service)
+
+# Function to get some fake weather sensor readings for this example in the desired unit.
+def measure(unit):
+    temperature = random.uniform(0.0, 10.0)
+    humidity = random.uniform(0.0, 100.0)
+    if unit == 'fahrenheit':
+        temperature = (temperature * 9.0 / 5.0) + 32.0
+    return {
+        'temperature': temperature,
+        'humidity': humidity
+    }
+
+# Advertise until another device connects, when a device connects, provide sensor data.
+while True:
+    print('Advertise services')
+    ble.stop_advertising() # you need to do this to stop any persistent old advertisement
+    ble.start_advertising(advertisement)
+
+    print("Waiting for connection...")
+    while not ble.connected:
+        pass
+
+    print("Connected")
+    while ble.connected:
+        settings = service.settings
+        measurement = measure(settings.get('unit', 'celsius'))
+        service.sensors = measurement
+        print('Settings: ', settings)
+        print('Sensors: ', measurement)
+        time.sleep(.25)
+
+    print('Disconnected')

examples/ble_json_service.py

@@ -0,0 +1,30 @@
+from adafruit_ble.uuid import VendorUUID
+from adafruit_ble.services import Service
+from adafruit_ble.characteristics import Characteristic
+from adafruit_ble.characteristics.json import JsonCharacteristic
+
+
+# A custom service with two Json characteristics for this device.  The "sensors" characteristic
+# provides updated sensor values for any connected device to read.  The "settings" characteristic
+# can be changed by any connected device to update the peripheral's settings.  The UUID of your
+# service can be any valid random uuid (some BLE UUID's are reserved).
+# NOTE: Json data is limited by characteristic max_length of 512 byes.
+class SensorService(Service):
+    uuid = VendorUUID("51ad213f-e568-4e35-84e4-67af89c79ef0")
+
+    settings = JsonCharacteristic(
+        uuid=VendorUUID("e077bdec-f18b-4944-9e9e-8b3a815162b4"),
+        properties=Characteristic.READ | Characteristic.WRITE,
+        initial_value={
+            'unit': 'celsius'
+        }
+    )
+
+    sensors = JsonCharacteristic(
+        uuid=VendorUUID("528ff74b-fdb8-444c-9c64-3dd5da4135ae"),
+        properties=Characteristic.READ,
+    )
+
+    def __init__(self, service=None):
+        super().__init__(service=service)
+        self.connectable = True