actual code

Author: dhalbert

README.rst

@@ -25,19 +25,14 @@ Dependencies
 This driver depends on:
 
 * `Adafruit CircuitPython <https://github.com/adafruit/circuitpython>`_
+* `adafruit_ble <https://github.com/adafruit/Adafruit_CircuitPython_BLE>`_
 
 Please ensure all dependencies are available on the CircuitPython filesystem.
 This is easily achieved by downloading
 `the Adafruit library and driver bundle <https://circuitpython.org/libraries>`_.
 
 Installing from PyPI
 =====================
-.. note:: This library is not available on PyPI yet. Install documentation is included
-   as a standard element. Stay tuned for PyPI availability!
-
-.. todo:: Remove the above note if PyPI version is/will be available at time of release.
-   If the library is not planned for PyPI, remove the entire 'Installing from PyPI' section.
-
 On supported GNU/Linux systems like the Raspberry Pi, you can install the driver locally `from
 PyPI <https://pypi.org/project/adafruit-circuitpython-ble_lywsd03mmc/>`_. To install for current user:
 
@@ -60,11 +55,6 @@ To install in a virtual environment in your current project:
     source .env/bin/activate
     pip3 install adafruit-circuitpython-ble-lywsd03mmc
 
-Usage Example
-=============
-
-.. todo:: Add a quick, simple example. It and other examples should live in the examples folder and be included in docs/examples.rst.
-
 Contributing
 ============
 

adafruit_ble_lywsd03mmc.py

@@ -16,21 +16,69 @@
 
 **Hardware:**
 
-.. todo:: Add links to any specific hardware product page(s), or category page(s). Use unordered list & hyperlink rST
-   inline format: "* `Link Text <url>`_"
-
 **Software and Dependencies:**
 
 * Adafruit CircuitPython firmware for the supported boards:
   https://github.com/adafruit/circuitpython/releases
-
-.. todo:: Uncomment or remove the Bus Device and/or the Register library dependencies based on the library's use of either.
-
-# * Adafruit's Bus Device library: https://github.com/adafruit/Adafruit_CircuitPython_BusDevice
-# * Adafruit's Register library: https://github.com/adafruit/Adafruit_CircuitPython_Register
 """
 
-# imports
+import struct
+
+import _bleio
+from adafruit_ble.attributes import Attribute
+from adafruit_ble.services import Service
+from adafruit_ble.uuid import VendorUUID
+from adafruit_ble.characteristics import Characteristic, ComplexCharacteristic
 
 __version__ = "0.0.0-auto.0"
 __repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_BLE_LYWSD03MMC.git"
+
+
+class _Readings(ComplexCharacteristic):
+    """Notify-only characteristic of temperature/humidity"""
+
+    uuid = VendorUUID("ebe0ccc1-7a0a-4b0c-8a1a-6ff2997da3a6")
+
+    def __init__(self):
+        super().__init__(properties=Characteristic.NOTIFY)
+
+    def bind(self, service):
+        """Bind to an LYWSD03MMCService."""
+        bound_characteristic = super().bind(service)
+        bound_characteristic.set_cccd(notify=True)
+        # Use a PacketBuffer that can store one packet to receive the data.
+        return _bleio.PacketBuffer(bound_characteristic, buffer_size=1)
+
+
+class LYWSD03MMCService(Service):
+    """Service for reading from an LYWSD03MMC sensor."""
+
+    def __init__(self, service=None):
+        super().__init__(service=service)
+        # Defer creating buffers until needed, since MTU is not known yet.
+        self._settings_result_buf = None
+        self._readings_buf = None
+
+    uuid = VendorUUID("ebe0ccb0-7a0a-4b0c-8a1a-6ff2997da3a6")
+
+    readings = _Readings()
+
+    @property
+    def temperature_humidity(self):
+        """Return a tuple of (temperature, humidity)."""
+        if self._readings_buf is None:
+            self._readings_buf = bytearray(
+                self.readings.packet_size  # pylint: disable=no-member
+            )
+        data = self._readings_buf
+        length = self.readings.readinto(data)  # pylint: disable=no-member
+        if length > 0:
+            low_temp, high_temp, hum = struct.unpack_from("<BBB", data)
+            sign = high_temp & 0x80
+            temp = ((high_temp & 0x7F) << 8) | low_temp
+            if sign:
+                temp = temp - 32767
+            temp = temp / 100
+            return (temp, hum)
+        # No data.
+        return None

docs/api.rst

@@ -1,8 +1,2 @@
-
-.. If you created a package, create one automodule per module in the package.
-
-.. If your library file(s) are nested in a directory (e.g. /adafruit_foo/foo.py)
-.. use this format as the module name: "adafruit_foo.foo"
-
 .. automodule:: adafruit_ble_lywsd03mmc
    :members:

docs/index.rst

@@ -23,15 +23,9 @@ Table of Contents
 .. toctree::
     :caption: Tutorials
 
-.. todo:: Add any Learn guide links here. If there are none, then simply delete this todo and leave
-    the toctree above for use later.
-
 .. toctree::
     :caption: Related Products
 
-.. todo:: Add any product links here. If there are none, then simply delete this todo and leave
-    the toctree above for use later.
-
 .. toctree::
     :caption: Other Links
 

examples/ble_lywsd03mmc_simpletest.py

@@ -1,3 +1,38 @@
 # SPDX-FileCopyrightText: 2021 Dan Halbert, written for Adafruit Industries
 #
 # SPDX-License-Identifier: Unlicense
+
+import time
+
+import adafruit_ble
+from adafruit_ble.advertising.standard import (
+    Advertisement,
+    ProvideServicesAdvertisement,
+)
+from adafruit_ble_lywsd03mmc import LYWSD03MMCService
+
+# PyLint can't find BLERadio for some reason so special case it here.
+ble = adafruit_ble.BLERadio()  # pylint: disable=no-member
+
+connection = None
+
+while True:
+    print("Scanning...")
+    for adv in ble.start_scan(Advertisement, timeout=5):
+        if adv.complete_name == "LYWSD03MMC":
+            connection = ble.connect(adv)
+            print("Connected")
+            break
+
+    # Stop scanning whether or not we are connected.
+    ble.stop_scan()
+
+    if connection and connection.connected:
+        service = connection[LYWSD03MMCService]
+        while connection.connected:
+
+            print(
+                "Temperature, Humidity",
+                service.temperature_humidity,
+            )
+            time.sleep(5)

setup.py

@@ -53,7 +53,7 @@
     ],
     # What does your project relate to?
     keywords="adafruit blinka circuitpython micropython ble_lywsd03mmc ble lywsd03mmc xiaomi "
-             "mijia thermometer hygrometer",
+    "mijia thermometer hygrometer",
     # You can just specify the packages manually here if your project is
     # simple. Or you can use find_packages().
     # TODO: IF LIBRARY FILES ARE A PACKAGE FOLDER,