Skip to content

Update failed read check. #8

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 2 commits into from
Nov 23, 2019
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 35 additions & 13 deletions adafruit_us100.py
Original file line number Diff line number Diff line change
Expand Up @@ -40,6 +40,8 @@
__version__ = "0.0.0-auto.0"
__repo__ = "https://github.com/adafruit/Adafruit_CircuitPython_US100.git"

import time


class US100:
"""Control a US-100 ultrasonic range sensor."""
Expand All @@ -51,34 +53,54 @@ def __init__(self, uart):
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
If no signal is received, return ``None``. This can happen when the
object in front of the sensor is too close, the wiring is incorrect or the
sensor is not found. If the signal received is not 2 bytes, return ``None``.
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
for the sensor to handle. In my experience, the sensor can not 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 not data:
raise RuntimeError("Sensor not found. Check your wiring!")
for _ in range(2): # Attempt to read twice.
self._uart.write(bytes([0x55]))
time.sleep(0.1)
data = self._uart.read(2) # 2 byte return for distance.
if data: # If there is a reading, exit the loop.
break
time.sleep(0.1) # You need to wait between readings, so delay is included.
else:
# Loop exited normally, so read failed twice.
# This can happen when the object in front of the sensor is too close, if the wiring
# is incorrect or the sensor is not found.
return None

if len(data) != 2:
raise RuntimeError("Did not receive distance response")
return None

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 not data:
raise RuntimeError("Sensor not found. Check your wiring!")
for _ in range(2): # Attempt to read twice.
self._uart.write(bytes([0x50]))
time.sleep(0.1)
data = self._uart.read(1) # 1 byte return for temp
if data: # If there is a reading, exit the loop.
break
time.sleep(0.1) # You need to wait between readings, so delay is included.
else:
# Loop exited normally, so read failed twice.
# This can happen when the object in front of the sensor is too close, if the wiring
# is incorrect or the sensor is not found.
return None

if len(data) != 1:
raise RuntimeError("Did not receive temperature response")
return None

temp = data[0] - 45
return temp