Add and update examples

Author: dhalbert

adafruit_ble/uart_client.py

@@ -101,6 +101,9 @@ def scan(scanner=None, scan_time=2):
         :param float scan_time: scan for this many seconds.
         :return list of Address objects, or an empty list, if none found
         """
+        if not scanner:
+            scanner = Scanner()
+
         return [se.address for se in
                 ScanEntry.with_service_uuid(scanner.scan_unique(scan_time), NUS_SERVICE_UUID)]
 

examples/ble_demo_central.py

@@ -0,0 +1,48 @@
+"""
+Demonstration of a Bluefruit BLE Central. Connects to the first BLE UART peripheral it finds.
+Sends Bluefruit ColorPackets, read from three potentiometers, to the peripheral.
+"""
+
+import time
+
+import board
+from analogio import AnalogIn
+
+#from adafruit_bluefruit_connect.packet import Packet
+# Only the packet classes that are imported will be known to Packet.
+from adafruit_bluefruit_connect.color_packet import ColorPacket
+
+from adafruit_ble.scanner import Scanner
+from adafruit_ble.uart_client import UARTClient
+
+def scale(value):
+    """Scale an value from 0-65535 (AnalogIn range) to 0-255 (RGB range)"""
+    return int(value / 65535 * 255)
+
+scanner = Scanner()
+uart_client = UARTClient()
+uart_addresses = []
+
+# Keep trying to find a UART peripheral
+while not uart_addresses:
+    uart_addresses = uart_client.scan(scanner)
+
+a0 = AnalogIn(board.A0)
+a1 = AnalogIn(board.A1)
+a2 = AnalogIn(board.A2)
+
+while True:
+    uart_client.connect(uart_addresses[0], 5)
+    while uart_client.connected:
+        r = scale(a0.value)
+        g = scale(a1.value)
+        b = scale(a2.value)
+
+        color = (r, g, b)
+        print(color)
+        color_packet = ColorPacket(color)
+        try:
+            uart_client.write(color_packet.to_bytes())
+        except OSError:
+            pass
+        time.sleep(0.3)

examples/ble_demo_periph.py

@@ -0,0 +1,36 @@
+"""
+Used with ble_demo_central.py. Receives Bluefruit LE ColorPackets from a central,
+and updates a NeoPixel FeatherWing to show the history of the received packets.
+"""
+
+import board
+import neopixel
+
+from adafruit_ble.uart_server import UARTServer
+from adafruit_bluefruit_connect.packet import Packet
+# Only the packet classes that are imported will be known to Packet.
+from adafruit_bluefruit_connect.color_packet import ColorPacket
+
+uart_server = UARTServer()
+
+NUM_PIXELS = 32
+np = neopixel.NeoPixel(board.D10, NUM_PIXELS, brightness=0.1)
+next_pixel = 0
+
+def mod(i):
+    """Wrap i to modulus NUM_PIXELS."""
+    return i % NUM_PIXELS
+
+while True:
+    # Advertise when not connected.
+    uart_server.start_advertising()
+    while not uart_server.connected:
+        pass
+
+    while uart_server.connected:
+        packet = Packet.from_stream(uart_server)
+        if isinstance(packet, ColorPacket):
+            print(packet.color)
+            np[next_pixel] = packet.color
+            np[mod(next_pixel + 1)] = (0, 0, 0)
+        next_pixel = (next_pixel + 1) % NUM_PIXELS

examples/ble_uart_echo_test.py

@@ -1,4 +1,4 @@
-from adafruit_ble.uart import UARTServer
+from adafruit_ble.uart_server import UARTServer
 
 uart = UARTServer()