UARTService -> UARTServer; update and correct examples

Author: dhalbert

README.rst

@@ -30,12 +30,16 @@ Usage Example
 
 .. code-block:: python
 
-    from adafruit_ble.uart import UARTService
+    from adafruit_ble.uart import UARTServer
 
-    uart_service = UARTService()
-    uart_service.start_advertising()
+    uart_server = UARTServer()
+    uart_server.start_advertising()
 
-    uart_service.write('abc')
+    # Wait for a connection.
+    while not uart_server.connected:
+        pass
+
+    uart_server.write('abc')
 
 
 Contributing

adafruit_ble/uart.py

@@ -31,7 +31,7 @@
 from bleio import UUID, Characteristic, Service, Peripheral, CharacteristicBuffer
 
 
-class UARTService:
+class UARTServer:
     """
     Provide UART-like functionality via the Nordic NUS service.
 
@@ -42,8 +42,15 @@ class UARTService:
 
     Example::
 
-        from adafruit_ble.uart import UARTService()
-        uart = UARTService()    # Starts advertising immediately.
+        from adafruit_ble.uart import UARTServer
+        uart = UARTServer()
+        uart.start_advertising()
+
+        # Wait for a connection.
+        while not uart.connected:
+            pass
+
+        uart.write('abc')
     """
 
     NUS_SERVICE_UUID = UUID("6E400001-B5A3-F393-E0A9-E50E24DCCA9E")
@@ -76,7 +83,7 @@ def stop_advertising(self):
 
     @property
     def connected(self):
-        """True if someone connected to the service."""
+        """True if someone connected to the server."""
         return self._periph.connected
 
     def read(self, nbytes=None):

examples/ble_uart_echo_test.py

@@ -1,10 +1,14 @@
-from adafruit_ble.uart import UARTService
+from adafruit_ble.uart import UARTServer
 
-# Starts advertising automatically. That may change in later versions.
-uart = UARTService()
+uart = UARTServer()
+uart.start_advertising()
 
-while True:
-    # Returns one if nothing was read.
-    one_byte = uart.read()
+# Wait for a connection
+while not uart.connected:
+    pass
+
+while uart.connected:
+    # Returns b'' if nothing was read.
+    one_byte = uart.read(1)
     if one_byte:
         uart.write(bytes([one_byte]))