drivers: Standardize continuous and one-shot mode method naming.

Author: nedseb

README.md

@@ -477,6 +477,7 @@ lib/<component>/
 - **Power methods**: `power_on()` / `power_off()`. All drivers must implement both.
 - **Status methods**: `_status()` returns the raw status register as an int (private), `data_ready()` returns True when all channels have new data, `<measurement>_ready()` for per-channel readiness (e.g. `temperature_ready()`, `pressure_ready()`).
 - **Measurement methods**: bare noun without unit suffix only for `temperature()` (°C) and `humidity()` (%RH). All others include the unit: `pressure_hpa()`, `distance_mm()`, `voltage_mv()`, `acceleration_g()`, etc. `read()` for combined reading returning a tuple, `<measurement>_raw()` for raw register values.
+- **Mode methods**: `set_continuous(odr)` to start continuous measurements, `trigger_one_shot()` for a single conversion, `read_one_shot()` for trigger + wait + return data.
 
 ### Linting
 

lib/hts221/hts221/device.py

@@ -91,6 +91,10 @@ def set_odr(self, odr=0):
         t = self._read_reg(HTS221_CTRL_REG1) & 0xFC
         self._write_reg(HTS221_CTRL_REG1, t | odr)
 
+    def set_continuous(self, odr=1):
+        self.power_on()
+        self.set_odr(odr)
+
     # get/set Humidity and temperature average configuration
     def get_av(self):
         return self._read_reg(HTS221_AV_CONF)
@@ -117,6 +121,10 @@ def trigger_one_shot(self):
         self._write_reg(HTS221_CTRL_REG2, ctrl2 | HTS221_CTRL2_ONE_SHOT)
         sleep_ms(15)
 
+    def read_one_shot(self):
+        self.trigger_one_shot()
+        return self.read()
+
     def reboot(self):
         ctrl2 = self._read_reg(HTS221_CTRL_REG2)
         self._write_reg(HTS221_CTRL_REG2, ctrl2 | HTS221_CTRL2_BOOT)

lib/lis2mdl/lis2mdl/device.py

@@ -76,6 +76,17 @@ def set_odr(self, hz: int):
         reg = (reg & ~(0b11 << 2)) | (odr_bits << 2)
         self._write_reg(LIS2MDL_CFG_REG_A, reg)
 
+    def set_continuous(self, hz=10):
+        self.set_odr(hz)
+        self.set_mode("continuous")
+
+    def trigger_one_shot(self):
+        self.set_mode("single")
+
+    def read_one_shot(self):
+        self.trigger_one_shot()
+        return self.magnetic_field()
+
     def set_low_power(self, enabled: bool):
         # LP bit (bit4) : 0=High-Res, 1=Low-Power
         reg = self._read_reg(LIS2MDL_CFG_REG_A)

lib/wsen-hids/examples/continuous_mode.py

@@ -7,7 +7,7 @@
 
 sensor = WSEN_HIDS(i2c)
 
-sensor.set_continuous_mode(WSEN_HIDS.ODR_1_HZ)
+sensor.set_continuous(WSEN_HIDS.ODR_1_HZ)
 
 for _ in range(10):
     humidity, temperature = sensor.read()

lib/wsen-hids/examples/full_test.py

@@ -211,13 +211,13 @@ def test_continuous_mode(sensor, odr, label, wait_ms=1500, loops=5, delay_s=0.5)
     print_header("7) Continuous mode - {}".format(label))
 
     try:
-        sensor.set_continuous_mode(odr=odr)
+        sensor.set_continuous(odr=odr)
 
         ctrl1 = read_reg(sensor, REG_CTRL_1)
         pd_ok = bool(ctrl1 & CTRL_1_PD)
         odr_ok = (ctrl1 & CTRL_1_ODR_MASK) == odr
 
-        print("CTRL_1 after set_continuous_mode = 0x{:02X}".format(ctrl1))
+        print("CTRL_1 after set_continuous = 0x{:02X}".format(ctrl1))
 
         if pd_ok:
             print_pass("PD bit set")
@@ -283,7 +283,7 @@ def test_status_helpers(sensor):
     print_header("8) STATUS helpers")
 
     try:
-        sensor.set_continuous_mode(odr=ODR_1_HZ)
+        sensor.set_continuous(odr=ODR_1_HZ)
         sleep(1.5)
 
         h_avail = sensor.humidity_ready()
@@ -312,7 +312,7 @@ def test_unitary_methods(sensor):
     print_header("9) humidity() and temperature()")
 
     try:
-        sensor.set_continuous_mode(odr=ODR_1_HZ)
+        sensor.set_continuous(odr=ODR_1_HZ)
         sleep(1.2)
 
         humidity_rh = sensor.humidity()

lib/wsen-hids/wsen_hids/device.py

@@ -18,7 +18,7 @@ class WSEN_HIDS(object):
         - humidity()
         - temperature()
         - read_one_shot()
-        - set_continuous_mode()
+        - set_continuous()
         - set_one_shot_mode()
         - enable_bdu()
         - enable_heater()
@@ -182,7 +182,7 @@ def set_one_shot_mode(self):
         ctrl1 &= ~CTRL_1_ODR_MASK   # ODR = 00 => one-shot
         self._write_reg(REG_CTRL_1, ctrl1)
 
-    def set_continuous_mode(self, odr=ODR_1_HZ):
+    def set_continuous(self, odr=ODR_1_HZ):
         if odr not in (ODR_1_HZ, ODR_7_HZ, ODR_12_5_HZ):
             raise ValueError("Invalid ODR for continuous mode")