python-mobius 0.8.2__tar.gz → 0.8.3__tar.gz

{python_mobius-0.8.2 → python_mobius-0.8.3}/CHANGELOG.md

@@ -1,5 +1,11 @@
 # Changelog
 
+## 0.8.3
+
+- Added `set_lunar_enabled(enabled)`. Confirmed byte-for-byte against
+  the app's own compiled bytecode: exactly what its "Lunar" chip (top
+  of the light schedule editor) writes when toggled.
+
 ## 0.8.2
 
 - Added `LightPollResult.schedule_intensity`: the device's own raw

{python_mobius-0.8.2 → python_mobius-0.8.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.5
 Name: python-mobius
-Version: 0.8.2
+Version: 0.8.3
 Summary: Reverse-engineered Python client for the Mobius BLE protocol (EcoTech Marine VorTech/Radion, AquaIllumination, Neptune Systems, NYOS)
 Project-URL: Homepage, https://code.r3pek.org/r3pek/python-mobius
 Project-URL: Documentation, https://code.r3pek.org/r3pek/python-mobius/src/branch/main/documentation

{python_mobius-0.8.2 → python_mobius-0.8.3}/pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "python-mobius"
-version = "0.8.2"
+version = "0.8.3"
 description = "Reverse-engineered Python client for the Mobius BLE protocol (EcoTech Marine VorTech/Radion, AquaIllumination, Neptune Systems, NYOS)"
 readme = "README.md"
 license = { text = "GPL-2.0-only" }

{python_mobius-0.8.2 → python_mobius-0.8.3}/src/mobius/__init__.py

@@ -82,7 +82,7 @@ from .mob import (
     MAX_PUMP_PRIMITIVE_SIZE,
 )
 
-__version__ = "0.8.2"
+__version__ = "0.8.3"
 
 __all__ = [
     "__version__",

{python_mobius-0.8.2 → python_mobius-0.8.3}/src/mobius/device.py

@@ -3463,6 +3463,35 @@ class MobiusDevice:
             return False
         return decode_lunar_enabled(raw)
 
+    async def set_lunar_enabled(self, enabled: bool) -> None:
+        """Writes LunarPhasesEnabled (907) -- confirmed byte-for-byte
+        against the app's own compiled bytecode (LunarInfo.smali's own
+        save() method): a single byte, the boolean enabled field stored
+        directly as 0 or 1, via the exact same SetC2AttrFsciRequest.
+        addAttribute() mechanism this library's own set_attribute()
+        uses. This is exactly what the app's own "Lunar" chip (top of
+        the light schedule editor) toggles: clicking it turns
+        lunar-phase night-time dimming on/off, and while enabled that
+        same chip also displays the current moon phase.
+
+        No group/broadcast involved -- confirmed by tracing
+        LightingFragment's own saveLunar(), which loops over every
+        light device in the tank and calls this same per-device,
+        ungrouped write on EACH one individually (not a single
+        mesh-wide broadcast the way set_time_to_now() works). The
+        app's own UI applies the same new value to every light in the
+        tank with that one tap, but the underlying wire mechanism is
+        still one ordinary, targeted write per device -- this method
+        only ever writes to the single device it's called on, matching
+        every other attribute write in this library.
+
+        No which/schedule parameter -- unlike Schedule1Intensity/
+        Schedule2Intensity, there's only ever a single
+        LunarPhasesEnabled attribute (confirmed: no LunarPhasesEnabled2
+        exists), so this applies to the light as a whole rather than to
+        either schedule individually."""
+        await self.set_attribute(C2Attribute.LunarPhasesEnabled, bytes([1 if enabled else 0]))
+
     async def get_acclimation_info(self) -> Optional[AcclimationInfo]:
         """
         Fetches all 4 acclimation attributes (AcclimationEnabled/Period/

{python_mobius-0.8.2 → python_mobius-0.8.3}/tests/test_device_control.py

@@ -64,6 +64,39 @@ async def test_reboot_propagates_a_write_failure():
         await device.reboot()
 
 
+async def test_set_lunar_enabled_writes_a_single_byte():
+    """Confirmed directly against the app's own behavior: LunarPhasesEnabled
+    (907) is exactly what the app's own "Lunar" chip (top of the light
+    schedule editor) toggles."""
+    device = MobiusDevice(_fake_ble_device())
+    captured = {}
+
+    async def fake_set_attribute(attr_id, value, index=0, reserved=b"\x00\x00"):
+        captured["attr_id"] = attr_id
+        captured["value"] = value
+
+    device.set_attribute = fake_set_attribute
+
+    await device.set_lunar_enabled(True)
+    assert captured["attr_id"] == C2Attribute.LunarPhasesEnabled
+    assert captured["value"] == bytes([1])
+
+    await device.set_lunar_enabled(False)
+    assert captured["value"] == bytes([0])
+
+
+async def test_set_lunar_enabled_propagates_a_write_failure():
+    device = MobiusDevice(_fake_ble_device())
+
+    async def fake_set_attribute(attr_id, value, index=0, reserved=b"\x00\x00"):
+        raise IOError("device returned FSCI status Failed setting attribute 907")
+
+    device.set_attribute = fake_set_attribute
+
+    with pytest.raises(IOError, match="Failed setting attribute 907"):
+        await device.set_lunar_enabled(True)
+
+
 @pytest.mark.asyncio
 async def test_reboot_all_writes_reset_soft_with_group_1_reserved_byte():
     """Confirmed via the app's own SettingsFragment.reboot() (the