From 447661c9cb74010e5556691ed1f0ead65c3a886d Mon Sep 17 00:00:00 2001
From: gijsio <67470426+gijsio@users.noreply.github.com>
Date: Fri, 23 Apr 2021 16:10:28 +0200
Subject: [PATCH] Ble callback example (#413)

* BLE callback example

* add example

* fixed typo

* rewrote description

* compatible client example
---
 config.toml                                   |   6 ++
 .../networks/{ble.md => ble/_index.md}        |   2 +-
 content/tutorials/networks/ble/callback.md    | 100 ++++++++++++++++++
 3 files changed, 107 insertions(+), 1 deletion(-)
 rename content/tutorials/networks/{ble.md => ble/_index.md} (99%)
 create mode 100644 content/tutorials/networks/ble/callback.md

diff --git a/config.toml b/config.toml
index ea3b4e7..b350d45 100644
--- a/config.toml
+++ b/config.toml
@@ -253,6 +253,12 @@ theme = "doc-theme"
     identifier = "tutorials@networks@ble"
     parent = "tutorials@networks"
     weight = 15
+[[menu.main]]
+    name = "Callback"
+    url= "/tutorials/networks/ble/callback/"
+    identifier = "tutorials@networks@ble@callback"
+    parent = "tutorials@networks@ble"
+    weight=10
 [[menu.main]]
     name = "SigFox"
     url = "/tutorials/networks/sigfox/"
diff --git a/content/tutorials/networks/ble.md b/content/tutorials/networks/ble/_index.md
similarity index 99%
rename from content/tutorials/networks/ble.md
rename to content/tutorials/networks/ble/_index.md
index 43bab6f..73d0f98 100644
--- a/content/tutorials/networks/ble.md
+++ b/content/tutorials/networks/ble/_index.md
@@ -1,5 +1,5 @@
 ---
-title: "Bluetooth"
+title: "Bluetooth Low Energy"
 aliases:
     - tutorials/all/ble.html
     - tutorials/all/ble.md
diff --git a/content/tutorials/networks/ble/callback.md b/content/tutorials/networks/ble/callback.md
new file mode 100644
index 0000000..7906611
--- /dev/null
+++ b/content/tutorials/networks/ble/callback.md
@@ -0,0 +1,100 @@
+---
+title: "BLE Callback"
+---
+
+In the following examples, we'll explain how to use the callback functionality of the Bluetooth module on both the server and client side. This can be used to detect when nodes connect and disconnect from the device, and when they get subscribed and read data. 
+
+## BLE Server
+This example will create a BLE server named `FiPy 45`, which publishes 'battery levels' over a service every second, starting at 100 and going down to 0. The example will also notify you in the REPL of any BLE events.
+
+```python
+from network import Bluetooth
+from machine import Timer
+
+battery = 100
+update = False
+def conn_cb(chr):
+    events = chr.events()
+    if events & Bluetooth.CLIENT_CONNECTED:
+        print('client connected')
+    elif events & Bluetooth.CLIENT_DISCONNECTED:
+        print('client disconnected')
+        update = False
+
+def chr1_handler(chr, data):
+    global battery
+    global update
+    events = chr.events()
+    print("events: ",events)
+    if events & (Bluetooth.CHAR_READ_EVENT | Bluetooth.CHAR_SUBSCRIBE_EVENT):
+        chr.value(battery)
+        print("transmitted :", battery)
+        if (events & Bluetooth.CHAR_SUBSCRIBE_EVENT):
+            update = True
+
+bluetooth = Bluetooth()
+bluetooth.set_advertisement(name='FiPy 45', manufacturer_data="Pycom", service_uuid=0xec00)
+
+bluetooth.callback(trigger=Bluetooth.CLIENT_CONNECTED | Bluetooth.CLIENT_DISCONNECTED, handler=conn_cb)
+bluetooth.advertise(True)
+
+srv1 = bluetooth.service(uuid=0xec00, isprimary=True,nbr_chars=1)
+
+chr1 = srv1.characteristic(uuid=0xec0e, value='read_from_here') #client reads from here
+
+chr1.callback(trigger=(Bluetooth.CHAR_READ_EVENT | Bluetooth.CHAR_SUBSCRIBE_EVENT), handler=chr1_handler)
+print('Start BLE service')
+def update_handler(update_alarm):
+    global battery
+    global update
+    battery-=1
+    if battery == 1:
+        battery = 100
+    if update:
+        chr1.value(str(battery))
+
+update_alarm = Timer.Alarm(update_handler, 1, periodic=True)
+
+```
+## BLE Client
+This example will create a BLE Client, which is able to the server example above. 
+
+```python
+from network import Bluetooth
+from machine import Timer
+
+def char_notify_callback(char, arg):
+    char_value = (char.value())
+    print("New value: {}".format(char_value))
+
+bt = Bluetooth()
+print('Start scanning for BLE services')
+bt.start_scan(-1)
+adv = None
+while(True):
+    adv = bt.get_adv()
+    if adv:
+        try:
+            if bt.resolve_adv_data(adv.data, Bluetooth.ADV_NAME_CMPL)=="FiPy 45":
+                conn = bt.connect(adv.mac)
+                print("Connected to FiPy 45")
+                try:
+                    services = conn.services()
+                    for service in services:
+                        chars = service.characteristics()
+                        for char in chars:
+                            c_uuid = char.uuid()
+                            if c_uuid == 0xec0e:
+                                if (char.properties() & Bluetooth.PROP_NOTIFY):
+                                    char.callback(trigger=Bluetooth.CHAR_NOTIFY_EVENT, handler=char_notify_callback)
+                                    print(c_uuid)
+                                    break
+                except:
+                    continue
+        except:
+            continue
+
+bt.stop_scan()
+bt.disconnect_client()
+
+```
\ No newline at end of file