add examples

Author: dhalbert

adafruit_ble/uart.py

@@ -62,9 +62,11 @@ def connected(self):
         return self._periph.connected
 
     def read(self):
-        """Read the next available byte from the buffered input. Return None if nothing is available."""
+        """Read the next available byte from the buffered input.
+        Return None if nothing is available.
+        """
         return self._rx_buffer.read()
 
-    def write(self, char):
-        """TEMP"""
-        self._nus_tx_char.value = char
+    def write(self, bytes_to_write):
+        """Write a buffer of bytes."""
+        self._nus_tx_char.value = bytes_to_write

docs/conf.py

@@ -20,7 +20,7 @@
 # Uncomment the below if you use native CircuitPython modules such as
 # digitalio, micropython and busio. List the modules you use. Without it, the
 # autodoc module docs will fail to generate with a warning.
-# autodoc_mock_imports = ["digitalio", "busio"]
+autodoc_mock_imports = ["bleio"]
 
 
 intersphinx_mapping = {'python': ('https://docs.python.org/3.4', None),'CircuitPython': ('https://circuitpython.readthedocs.io/en/latest/', None)}

examples/ble_eddystone_test.py

@@ -0,0 +1,4 @@
+from adafruit_ble.beacon import EddystoneURLBeacon
+
+beacon = EddystoneURLBeacon('https://adafru.it/4062')
+beacon.start()

examples/ble_uart_echo_test.py

@@ -0,0 +1,10 @@
+from adafruit_ble.uart import UARTService
+
+# Starts advertising automatically. That may change in later versions.
+uart = UARTService()
+
+while True:
+    # Returns one if nothing was read.
+    one_byte = uart.read()
+    if one_byte:
+        uart.write(bytes([one_byte]))