Update examples

docs/examples.rst

@@ -7,8 +7,20 @@ Ensure your device works with this simple test.
     :caption: examples/bluefruitconnect_simpletest.py
     :linenos:
 
-This test demonstrates controlling an Adafruit Crickit board with Bluetooth.
+This example demonstrates receiving button presses from the Control Pad.
 
-.. literalinclude:: ../examples/bluefruitconnect_accelerometer_packet_test.py
-    :caption: examples/bluefruitconnect_accelerometer_packet_test.py
+.. literalinclude:: ../examples/bluefruitconnect_controlpad.py
+    :caption: examples/bluefruitconnect_controlpad.py
     :linenos:
+
+This example demonstrates receiving sensor data from the Controller.
+
+.. literalinclude:: ../examples/bluefruitconnect_sensors.py
+    :caption: examples/bluefruitconnect_sensors.py
+    :linenos:
+
+This example demonstrates receiving text from the UART interface.
+
+.. literalinclude:: ../examples/bluefruitconnect_uart.py
+    :caption: examples/bluefruitconnect_uart.py
+    :linenos:

examples/bluefruitconnect_controlpad.py

@@ -0,0 +1,56 @@
+# Basic structure example for using the BLE Connect Control Pad
+# To use, start this program, and start the Adafruit Bluefruit LE Connect app.
+# Connect, and then select Controller-> Control Pad.
+
+from adafruit_ble import BLERadio
+from adafruit_ble.advertising.standard import ProvideServicesAdvertisement
+from adafruit_ble.services.nordic import UARTService
+from adafruit_bluefruit_connect.packet import Packet
+# Only the packet classes that are imported will be known to Packet.
+from adafruit_bluefruit_connect.button_packet import ButtonPacket
+
+ble = BLERadio()
+uart_server = UARTService()
+advertisement = ProvideServicesAdvertisement(uart_server)
+
+while True:
+    print("WAITING...")
+    # Advertise when not connected.
+    ble.start_advertising(advertisement)
+    while not ble.connected:
+        pass
+
+    # Connected
+    ble.stop_advertising()
+    print("CONNECTED")
+
+    # Loop and read packets
+    while ble.connected:
+
+        # Keeping trying until a good packet is received
+        try:
+            packet = Packet.from_stream(uart_server)
+        except ValueError:
+            continue
+
+        # Only handle button packets
+        if isinstance(packet, ButtonPacket) and packet.pressed:
+            if packet.button == ButtonPacket.UP:
+                print("Button UP")
+            if packet.button == ButtonPacket.DOWN:
+                print("Button DOWN")
+            if packet.button == ButtonPacket.LEFT:
+                print("Button LEFT")
+            if packet.button == ButtonPacket.RIGHT:
+                print("Button RIGHT")
+            if packet.button == ButtonPacket.BUTTON_1:
+                print("Button 1")
+            if packet.button == ButtonPacket.BUTTON_2:
+                print("Button 2")
+            if packet.button == ButtonPacket.BUTTON_3:
+                print("Button 3")
+            if packet.button == ButtonPacket.BUTTON_4:
+                print("Button 4")
+
+    # Disconnected
+    print("DISCONNECTED")

examples/bluefruitconnect_sensors.py

@@ -0,0 +1,61 @@
+# Basic structure example for using the BLE Connect Controller sensors
+# To use, start this program, and start the Adafruit Bluefruit LE Connect app.
+# Connect, and then select Controller and enable the sensors
+
+from adafruit_ble import BLERadio
+from adafruit_ble.advertising.standard import ProvideServicesAdvertisement
+from adafruit_ble.services.nordic import UARTService
+from adafruit_bluefruit_connect.packet import Packet
+# Only the packet classes that are imported will be known to Packet.
+from adafruit_bluefruit_connect.accelerometer_packet import AccelerometerPacket
+from adafruit_bluefruit_connect.gyro_packet import GyroPacket
+from adafruit_bluefruit_connect.location_packet import LocationPacket
+from adafruit_bluefruit_connect.magnetometer_packet import MagnetometerPacket
+from adafruit_bluefruit_connect.quaternion_packet import QuaternionPacket
+
+ble = BLERadio()
+uart_server = UARTService()
+advertisement = ProvideServicesAdvertisement(uart_server)
+
+while True:
+    print("WAITING...")
+    # Advertise when not connected.
+    ble.start_advertising(advertisement)
+    while not ble.connected:
+        pass
+
+    # Connected
+    ble.stop_advertising()
+    print("CONNECTED")
+
+    # Loop and read packets
+    while ble.connected:
+
+        # Keeping trying until a good packet is received
+        try:
+            packet = Packet.from_stream(uart_server)
+        except ValueError:
+            continue
+
+        # Accelerometer
+        if isinstance(packet, AccelerometerPacket):
+            print("Accelerometer:", packet.x, packet.y, packet.z)
+
+        # Gyro
+        if isinstance(packet, GyroPacket):
+            print("Gyro:", packet.x, packet.y, packet.z)
+
+        # Location
+        if isinstance(packet, LocationPacket):
+            print("Location:", packet.latitude, packet.longitude, packet.altitude)
+
+        # Magnetometer
+        if isinstance(packet, MagnetometerPacket):
+            print("Magnetometer", packet.x, packet.y, packet.z)
+
+        # Quaternion
+        if isinstance(packet, QuaternionPacket):
+            print("Quaternion:", packet.x, packet.y, packet.z, packet.w)
+
+    # Disconnected
+    print("DISCONNECTED")

examples/bluefruitconnect_uart.py

@@ -0,0 +1,33 @@
+# Basic example for using the BLE Connect UART
+# To use, start this program, and start the Adafruit Bluefruit LE Connect app.
+# Connect, and then select UART
+
+from adafruit_ble import BLERadio
+from adafruit_ble.advertising.standard import ProvideServicesAdvertisement
+from adafruit_ble.services.nordic import UARTService
+
+ble = BLERadio()
+uart_server = UARTService()
+advertisement = ProvideServicesAdvertisement(uart_server)
+
+while True:
+    print("WAITING...")
+    # Advertise when not connected.
+    ble.start_advertising(advertisement)
+    while not ble.connected:
+        pass
+
+    # Connected
+    ble.stop_advertising()
+    print("CONNECTED")
+
+    # Loop and read packets
+    while ble.connected:
+        if uart_server.in_waiting:
+            raw_bytes = uart_server.read(uart_server.in_waiting)
+            text = raw_bytes.decode().strip()
+            print("raw bytes =", raw_bytes)
+            print("text =", text)
+
+    # Disconnected
+    print("DISCONNECTED")