Merge branch 'main' of https://github.com/SolderedElectronics/Soldered-Micropython-modules

Author: JosipKuci

UltrasonicSensor/UltrasonicSensor/Examples/UltrasonicSensor-readDistanceNative.py

@@ -1,8 +1,8 @@
-# FILE: UltrasonicSensor-readDistanceNative.py 
+# FILE: UltrasonicSensor-readDistanceNative.py
 # AUTHOR: Josip Šimun Kuči @ Soldered
 # BRIEF:  An example showing how to read the distance of the Native Ultrasonic sensor
 # WORKS WITH: Ultrasonic module HC-SR04: www.solde.red/101202
-# LAST UPDATED: 2025-06-12 
+# LAST UPDATED: 2025-06-12
 
 from machine import I2C, Pin
 from UltrasonicSensor import UltrasonicSensor
@@ -27,4 +27,4 @@
     print(f"Distance: {distance:.2f} cm")
     print(f"Time it took: {duration:.2f} us\n")
 
-    time.sleep(0.25)  # Delay between readings
+    time.sleep(0.25)  # Delay between readings

UltrasonicSensor/UltrasonicSensor/Examples/UltrasonicSensor-readDistanceQwiic.py

@@ -1,9 +1,9 @@
-# FILE: UltrasonicSensor-readDistanceQwiic.py 
+# FILE: UltrasonicSensor-readDistanceQwiic.py
 # AUTHOR: Josip Šimun Kuči @ Soldered
-# BRIEF:  An example showing how to read the distance of the  Qwiic compatible 
+# BRIEF:  An example showing how to read the distance of the  Qwiic compatible
 #         Ultrasonic sensor from an object
 # WORKS WITH: Ultrasonic sensor with Qwiic: www.solde.red/333001
-# LAST UPDATED: 2025-06-12 
+# LAST UPDATED: 2025-06-12
 
 from machine import I2C, Pin
 from UltrasonicSensor import UltrasonicSensor
@@ -15,18 +15,17 @@
 while True:
     sensor.takeMeasure()
     time.sleep(0.1)  # Small delay for measurement
-    
-    #The sensor sends a pulse through the trigger pin, which is deflected
-    #By a surface in front of it and picked up by the echo pin, we then use the
-    #time it took the impulse to reflect to calculate the distance
+
+    # The sensor sends a pulse through the trigger pin, which is deflected
+    # By a surface in front of it and picked up by the echo pin, we then use the
+    # time it took the impulse to reflect to calculate the distance
     distance = sensor.getDistance()
-    
-    #How long did it take for the pulse to reflect
+
+    # How long did it take for the pulse to reflect
     duration = sensor.getDuration()
-    
-    #Print out the distance and duration to the user
+
+    # Print out the distance and duration to the user
     print(f"Distance: {distance:.2f} cm")
     print(f"Time it took: {duration:.2f} us\n")
-    
-    
-    time.sleep(0.25)  # Delay between readings
+
+    time.sleep(0.25)  # Delay between readings

UltrasonicSensor/UltrasonicSensor/UltrasonicSensor.py

@@ -1,29 +1,34 @@
-# FILE: UltrasonicSensor.py 
+# FILE: UltrasonicSensor.py
 # AUTHOR: Josip Šimun Kuči @ Soldered
 # BRIEF: A MicroPython module for the HC-SR04 UltraSonic sensor. Supports both the Native and Qwiic version
-# LAST UPDATED: 2025-06-12 
+# LAST UPDATED: 2025-06-12
 
 
 # Import Qwiic base class for I2C devices
 from Qwiic import Qwiic
+
 # Import Pin and I2C classes for GPIO and I2C operations
 from machine import I2C, Pin
+
 # Used to detect the board type (ESP32, ESP8266, etc.)
 from os import uname
+
 # Time module used for precise delays and measuring pulse duration
 import time
 
 # Register addresses for I2C communication with a supported ultrasonic module
-TAKE_MEAS_REG = 0       # Command register to start measurement
-DISTANCE_REG = 1        # Register where distance in cm is stored (from external sensor)
-DURATION_REG = 2        # Register where echo pulse duration is stored (from external sensor)
+TAKE_MEAS_REG = 0  # Command register to start measurement
+DISTANCE_REG = 1  # Register where distance in cm is stored (from external sensor)
+DURATION_REG = 2  # Register where echo pulse duration is stored (from external sensor)
+
 
 class UltrasonicSensor(Qwiic):
     """
     Ultrasonic sensor class that supports both native (GPIO) and I2C-based operation.
     In native mode, it uses GPIO pins to trigger and read echo.
     In I2C mode, it uses a pre-programmed I2C-based ultrasonic sensor.
     """
+
     def __init__(self, i2c=None, address=0x30, echo_pin=None, trig_pin=None):
         """
         Initializes the sensor either in native GPIO mode or I2C mode.
@@ -124,4 +129,3 @@ def getDistance(self):
             # Read distance from I2C register
             data = self.read_register(DISTANCE_REG, 2)
             return data[1] << 8 | data[0]
-