workin' code & example

Author: ladyada

adafruit_us100.py

@@ -41,3 +41,39 @@
 
 __version__ = "0.0.0-auto.0"
 __repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_US100.git"
+
+class US100:
+    """Control a US-100 ultrasonic range sensor."""
+
+    def __init__(self, uart):
+        self._uart = uart
+
+    @property
+    def distance(self):
+        """Return the distance measured by the sensor in cm.
+        This is the function that will be called most often in user code.
+        If no signal is received, we'll throw a RuntimeError exception. This means
+        either the sensor was moving too fast to be pointing in the right
+        direction to pick up the ultrasonic signal when it bounced back (less
+        likely), or the object off of which the signal bounced is too far away
+        for the sensor to handle. In my experience, the sensor can detect
+        objects over 460 cm away.
+        :return: Distance in centimeters.
+        :rtype: float
+        """
+        self._uart.write(bytes([0x55]))
+        data = self._uart.read(2)  # 2 bytes return for distance
+        if len(data) != 2:
+            raise RuntimeError("Did not receive distance response")
+        dist = (data[1] + (data[0] << 8)) / 10
+        return dist
+
+    @property
+    def temperature(self):
+        """Return the on-chip temperature, in Celsius"""
+        self._uart.write(bytes([0x50]))
+        data = self._uart.read(1)  # 1 byte return for temp
+        if len(data) != 1:
+            raise RuntimeError("Did not receive temperature response")
+        temp = data[0] - 45
+        return temp

examples/us100_simpletest.py

@@ -0,0 +1,14 @@
+import time
+import board
+import busio
+import adafruit_us100
+
+uart = busio.UART(board.TX, board.RX, baudrate=9600)
+# Create a US-100 module instance.
+us100 = adafruit_us100.US100(uart)
+
+while True:
+    print("-----")
+    print("Temperature: ", us100.temperature)
+    print("Distance: ", us100.distance)
+    time.sleep(0.5)