fp-soother-lib 1.0.0__tar.gz

fp_soother_lib-1.0.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Donald Patrick Seal
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

fp_soother_lib-1.0.0/PKG-INFO

@@ -0,0 +1,81 @@
+Metadata-Version: 2.4
+Name: fp-soother-lib
+Version: 1.0.0
+Summary: Python BLE library for Fisher-Price Smart Connect Deluxe Soother
+Keywords: ble,bluetooth,fisher-price,smart connect,soother
+Author: Patrick Seal
+Author-email: Patrick Seal <code@plasticrake.com>
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 3 - Alpha
+Classifier: Intended Audience :: Developers
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3 :: Only
+Classifier: Programming Language :: Python :: 3.14
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Topic :: System :: Hardware :: Hardware Drivers
+Classifier: Topic :: System :: Hardware
+Classifier: Typing :: Typed
+Requires-Dist: bleak>=3.0.2
+Requires-Dist: bleak-retry-connector>=4.6.0
+Requires-Dist: cryptography>=48.0.1
+Requires-Python: >=3.14.7
+Project-URL: homepage, https://github.com/plasticrake/fp-soother
+Project-URL: repository, https://github.com/plasticrake/fp-soother
+Description-Content-Type: text/markdown
+
+# fp-soother-lib
+
+A Python BLE library for the **Fisher-Price Smart Connect Deluxe Soother** (model DYW47).
+
+The official app was discontinued in 2024, leaving many users with a device that could no longer be fully controlled. This library gives you direct BLE control from Python.
+
+## Usage
+
+### Standalone (scans/connects by address)
+
+```python
+import asyncio
+from fp_soother_lib import SootherClient
+
+
+async def main():
+    async with SootherClient.connect("AA:BB:CC:DD:EE:FF", session_key=key) as soother:
+        if not soother.is_paired:
+            await soother.pair()  # device must already be in pairing mode
+        await soother.set_nightlight(True)
+        print(soother.state)
+
+
+asyncio.run(main())
+```
+
+If `address` is omitted, `SootherClient.connect()` scans for the first soother found.
+
+### Host-managed discovery (e.g. Home Assistant)
+
+A host that owns its own BLE scanner (Home Assistant's `bluetooth` integration
+is the main example) should resolve `BLEDevice` objects itself rather than
+letting this library run its own scan. Pass `ble_device`/`ble_device_callback`
+to `SootherClient` instead of relying on address-based discovery:
+
+```python
+from fp_soother_lib import SootherClient
+
+client = SootherClient(address, session_key=key, ble_device_callback=my_resolver)
+await client.open()
+...
+await client.close()
+```
+
+`my_resolver` is a zero-arg callable returning the host's current best
+`BLEDevice` for `address` (e.g. Home Assistant's
+`bluetooth.async_ble_device_from_address`), called fresh on every
+(re)connect. See `AGENTS.md` in the repository root for the full rationale.
+
+## Legal / Disclaimer
+
+This is an independent, open-source project not affiliated with Fisher-Price or Mattel. Reverse engineering for interoperability purposes is generally permitted under applicable law (e.g. EU Software Directive, US DMCA §1201(f)). This project does not redistribute any Fisher-Price code or assets. Use at your own risk. "Fisher-Price" and "Deluxe Soother" are trademarks of their respective owners.

fp_soother_lib-1.0.0/README.md

@@ -0,0 +1,52 @@
+# fp-soother-lib
+
+A Python BLE library for the **Fisher-Price Smart Connect Deluxe Soother** (model DYW47).
+
+The official app was discontinued in 2024, leaving many users with a device that could no longer be fully controlled. This library gives you direct BLE control from Python.
+
+## Usage
+
+### Standalone (scans/connects by address)
+
+```python
+import asyncio
+from fp_soother_lib import SootherClient
+
+
+async def main():
+    async with SootherClient.connect("AA:BB:CC:DD:EE:FF", session_key=key) as soother:
+        if not soother.is_paired:
+            await soother.pair()  # device must already be in pairing mode
+        await soother.set_nightlight(True)
+        print(soother.state)
+
+
+asyncio.run(main())
+```
+
+If `address` is omitted, `SootherClient.connect()` scans for the first soother found.
+
+### Host-managed discovery (e.g. Home Assistant)
+
+A host that owns its own BLE scanner (Home Assistant's `bluetooth` integration
+is the main example) should resolve `BLEDevice` objects itself rather than
+letting this library run its own scan. Pass `ble_device`/`ble_device_callback`
+to `SootherClient` instead of relying on address-based discovery:
+
+```python
+from fp_soother_lib import SootherClient
+
+client = SootherClient(address, session_key=key, ble_device_callback=my_resolver)
+await client.open()
+...
+await client.close()
+```
+
+`my_resolver` is a zero-arg callable returning the host's current best
+`BLEDevice` for `address` (e.g. Home Assistant's
+`bluetooth.async_ble_device_from_address`), called fresh on every
+(re)connect. See `AGENTS.md` in the repository root for the full rationale.
+
+## Legal / Disclaimer
+
+This is an independent, open-source project not affiliated with Fisher-Price or Mattel. Reverse engineering for interoperability purposes is generally permitted under applicable law (e.g. EU Software Directive, US DMCA §1201(f)). This project does not redistribute any Fisher-Price code or assets. Use at your own risk. "Fisher-Price" and "Deluxe Soother" are trademarks of their respective owners.

fp_soother_lib-1.0.0/pyproject.toml

@@ -0,0 +1,68 @@
+[project]
+name = "fp-soother-lib"
+version = "1.0.0"
+description = "Python BLE library for Fisher-Price Smart Connect Deluxe Soother"
+readme = "README.md"
+requires-python = ">=3.14.7"
+dependencies = [
+    "bleak>=3.0.2",
+    "bleak-retry-connector>=4.6.0",
+    "cryptography>=48.0.1",
+]
+keywords = [
+    "ble",
+    "bluetooth",
+    "fisher-price",
+    "smart connect",
+    "soother",
+]
+classifiers = [
+    "Development Status :: 3 - Alpha",
+    "Intended Audience :: Developers",
+    "Operating System :: OS Independent",
+    "Programming Language :: Python :: 3 :: Only",
+    "Programming Language :: Python :: 3.14",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python",
+    "Topic :: Software Development :: Libraries :: Python Modules",
+    "Topic :: Software Development :: Libraries",
+    "Topic :: System :: Hardware :: Hardware Drivers",
+    "Topic :: System :: Hardware",
+    "Typing :: Typed",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+
+[[project.authors]]
+name = "Patrick Seal"
+email = "code@plasticrake.com"
+
+[project.urls]
+homepage = "https://github.com/plasticrake/fp-soother"
+repository = "https://github.com/plasticrake/fp-soother"
+
+[build-system]
+requires = ["uv_build>=0.12.13,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = [
+    "ruff>=0.16.6",
+    "ty>=0.0.79",
+    "pytest>=8.3",
+    "pytest-asyncio>=0.24",
+]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.ruff.lint]
+preview = true
+select = [
+    "correctness",
+    "suspicious",
+    "complexity",
+    "performance",
+    "style",
+    "security",
+]

fp_soother_lib-1.0.0/pyproject.toml.orig

@@ -0,0 +1,54 @@
+[project]
+name = "fp-soother-lib"
+version = "1.0.0"
+description = "Python BLE library for Fisher-Price Smart Connect Deluxe Soother"
+readme = "README.md"
+authors = [{ name = "Patrick Seal", email = "code@plasticrake.com" }]
+requires-python = ">=3.14.7"
+dependencies = [
+  "bleak>=3.0.2",
+  "bleak-retry-connector>=4.6.0",
+  "cryptography>=48.0.1",
+]
+keywords = ["ble", "bluetooth", "fisher-price", "smart connect", "soother"]
+classifiers = [
+  "Development Status :: 3 - Alpha",
+  "Intended Audience :: Developers",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3 :: Only",
+  "Programming Language :: Python :: 3.14",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python",
+  "Topic :: Software Development :: Libraries :: Python Modules",
+  "Topic :: Software Development :: Libraries",
+  "Topic :: System :: Hardware :: Hardware Drivers",
+  "Topic :: System :: Hardware",
+  "Typing :: Typed",
+]
+license = "MIT"
+license-files = ["LICEN[CS]E*"]
+
+[project.urls]
+homepage = "https://github.com/plasticrake/fp-soother"
+repository = "https://github.com/plasticrake/fp-soother"
+
+[build-system]
+requires = ["uv_build>=0.12.13,<0.13.0"]
+build-backend = "uv_build"
+
+[dependency-groups]
+dev = ["ruff>=0.16.6", "ty>=0.0.79", "pytest>=8.3", "pytest-asyncio>=0.24"]
+
+[tool.pytest.ini_options]
+asyncio_mode = "auto"
+
+[tool.ruff.lint]
+preview = true
+select = [
+  "correctness",
+  "suspicious",
+  "complexity",
+  "performance",
+  "style",
+  "security",
+]

fp_soother_lib-1.0.0/src/fp_soother_lib/__init__.py

@@ -0,0 +1,61 @@
+"""
+Fisher-Price Smart Connect Deluxe Soother — Python BLE Library
+==============================================================
+
+Pairs and controls the device over raw BLE -- no official app or cloud
+account needed.
+
+Quick start
+-----------
+import asyncio
+from fp_soother_lib import SootherClient
+
+async def main():
+    async with SootherClient.connect("AA:BB:CC:DD:EE:FF") as soother:
+        if not soother.is_paired:
+            await soother.pair()  # device must already be in pairing mode
+        await soother.set_nightlight(True)
+        print(soother.state)
+
+asyncio.run(main())
+
+Package layout
+--------------
+fp_soother_lib/
+  constants.py    ← UUIDs, command IDs, state bit-layout tables
+  encryption.py   ← real AES-128-CBC crypto + key derivation
+  protocol.py     ← SootherState + command-frame construction
+  pairing.py      ← the from-scratch pairing handshake
+  client.py       ← high-level async client (the main entry point)
+  scanner.py      ← BLE discovery & GATT-dump helpers
+  exceptions.py   ← library-specific exceptions
+"""
+
+from importlib.metadata import version
+
+from bleak.backends.device import BLEDevice
+
+from .client import SootherClient
+from .exceptions import (
+    SootherCommandError,
+    SootherConnectionError,
+    SootherError,
+    SootherNotFoundError,
+)
+from .protocol import SootherState
+from .scanner import dump_gatt, find_soother, scan
+
+__all__ = [
+    "BLEDevice",
+    "SootherClient",
+    "SootherCommandError",
+    "SootherConnectionError",
+    "SootherError",
+    "SootherNotFoundError",
+    "SootherState",
+    "dump_gatt",
+    "find_soother",
+    "scan",
+]
+
+__version__ = version("fp-soother-lib")