PyPlumIO 0.6.8__tar.gz → 0.7.0__tar.gz

{pyplumio-0.6.8 → pyplumio-0.7.0}/.gitignore

@@ -113,5 +113,9 @@ dmypy.json
 # Pyre type checker
 .pyre/
 
-# setuptools-scm
-_version.py
+# Complexipy
+.complexipy_cache/
+
+# QLTY
+.qlty/results/
+.qlty/out/

{pyplumio-0.6.8 → pyplumio-0.7.0}/PKG-INFO

@@ -1,61 +1,39 @@
-Metadata-Version: 2.4
+Metadata-Version: 2.5
 Name: PyPlumIO
-Version: 0.6.8
+Version: 0.7.0
 Summary: PyPlumIO is a native ecoNET library for Plum ecoMAX controllers.
-Author-email: Denis Paavilainen <denpa@denpa.pro>
-License: MIT License
 Project-URL: Documentation, https://pyplumio.denpa.pro
 Project-URL: Source Code, https://github.com/denpamusic/PyPlumIO
 Project-URL: Bug Tracker, https://github.com/denpamusic/PyPlumIO/issues
-Keywords: home,automation,heating
-Platform: any
+Author-email: Denis Paavilainen <denpa@denpa.pro>
+License-Expression: MIT
+License-File: LICENSE
+Keywords: automation,heating,home
 Classifier: Development Status :: 4 - Beta
 Classifier: Intended Audience :: Developers
-Classifier: License :: OSI Approved :: MIT License
 Classifier: Operating System :: OS Independent
-Classifier: Programming Language :: Python :: 3.10
 Classifier: Programming Language :: Python :: 3.11
 Classifier: Programming Language :: Python :: 3.12
 Classifier: Programming Language :: Python :: 3.13
 Classifier: Programming Language :: Python :: 3.14
-Classifier: Topic :: Software Development :: Libraries
 Classifier: Topic :: Home Automation
-Requires-Python: >=3.10
+Classifier: Topic :: Software Development :: Libraries
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: serialx>=1.14.0
 Description-Content-Type: text/markdown
-License-File: LICENSE
-Requires-Dist: pyserial-asyncio-fast==0.16
-Provides-Extra: test
-Requires-Dist: codespell==2.4.1; extra == "test"
-Requires-Dist: coverage==7.13.0; extra == "test"
-Requires-Dist: freezegun==1.5.5; extra == "test"
-Requires-Dist: mypy==1.19.1; extra == "test"
-Requires-Dist: numpy<3.0.0,>=2.0.0; extra == "test"
-Requires-Dist: pyserial-asyncio-fast==0.16; extra == "test"
-Requires-Dist: pytest==9.0.2; extra == "test"
-Requires-Dist: pytest-asyncio==1.3.0; extra == "test"
-Requires-Dist: ruff==0.14.10; extra == "test"
-Requires-Dist: tox==4.32.0; extra == "test"
-Requires-Dist: types-pyserial==3.5.0.20251001; extra == "test"
-Provides-Extra: docs
-Requires-Dist: sphinx==8.1.3; extra == "docs"
-Requires-Dist: sphinx_rtd_theme==3.0.2; extra == "docs"
-Requires-Dist: readthedocs-sphinx-search==0.3.2; extra == "docs"
-Provides-Extra: dev
-Requires-Dist: pyplumio[docs,test]; extra == "dev"
-Requires-Dist: pre-commit==4.5.1; extra == "dev"
-Requires-Dist: tomli==2.3.0; extra == "dev"
-Dynamic: license-file
 
 # PyPlumIO is a native ecoNET library for Plum ecoMAX controllers
 
 [![PyPI version](https://badge.fury.io/py/PyPlumIO.svg)](https://badge.fury.io/py/PyPlumIO)
 [![PyPI Supported Python Versions](https://img.shields.io/pypi/pyversions/pyplumio.svg)](https://pypi.python.org/pypi/pyplumio/)
-[![PyPlumIO CI](https://github.com/denpamusic/PyPlumIO/actions/workflows/ci.yml/badge.svg)](https://github.com/denpamusic/PyPlumIO/actions/workflows/ci.yml)
 [![Maintainability](https://qlty.sh/gh/denpamusic/projects/PyPlumIO/maintainability.svg)](https://qlty.sh/gh/denpamusic/projects/PyPlumIO)
 [![Code Coverage](https://qlty.sh/gh/denpamusic/projects/PyPlumIO/coverage.svg)](https://qlty.sh/gh/denpamusic/projects/PyPlumIO)
 [![stability-release-candidate](https://img.shields.io/badge/stability-pre--release-48c9b0.svg)](https://guidelines.denpa.pro/stability#release-candidate)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
+---
+
 ## Overview
 
 This package aims to provide complete and easy to use solution for
@@ -89,16 +67,18 @@ through network by using RS-485 to Ethernet/WiFi converter.
 
 ## Quickstart
 
-1. To use PyPlumIO, first install it using pip:
+1. To use PyPlumIO, first install it using [uv](https://docs.astral.sh/uv/) or pip:
 
 ```bash
+uv add pyplumio
+# or
 pip install pyplumio
 ```
 
 2. Connect to the ecoMAX controller:
 
 ```python
->>> connection = pyplumio.open_serial_connection("/dev/ttyUSB0")
+>>> connection = pyplumio.serial_for_url("/dev/ttyUSB0")
 >>> await connection.connect()
 >>> ecomax = await connection.get("ecomax")
 ```
@@ -122,6 +102,54 @@ this package and depends on it. Click button below to check it out.
 
 [![Plum ecoMAX for Home Assistant](https://img.shields.io/badge/Plum%20ecoMAX%20for%20Home%20Assistant-41bdf5)](https://github.com/denpamusic/homeassistant-plum-ecomax)
 
+## Development
+
+This project uses [uv](https://docs.astral.sh/uv/) for project and dependency management, and [prek](https://github.com/j178/prek) for Git hooks.
+
+### Setup
+
+Install the project and development dependencies:
+
+```bash
+uv sync
+```
+
+### Running Tests
+
+Run the test suite with coverage enforcement (100% required):
+
+```bash
+uv run pytest
+```
+
+### Code Quality & Formatting
+
+Run linters, format checks, and cognitive complexity analysis:
+
+```bash
+uv run codespell
+uv run ruff check .
+uv run ruff format --check .
+uv run complexipy . --max-complexity-allowed 15
+```
+
+### Type Checking
+
+Run type checking with mypy:
+
+```bash
+uv run mypy pyplumio tests
+```
+
+### Git Hooks
+
+Install and run Git hooks via prek:
+
+```bash
+prek install
+prek run --all-files
+```
+
 ## Attribution
 
 Special thanks to [econetanalyze](https://github.com/twkrol/econetanalyze)

{pyplumio-0.6.8 → pyplumio-0.7.0}/README.md

@@ -2,12 +2,13 @@
 
 [![PyPI version](https://badge.fury.io/py/PyPlumIO.svg)](https://badge.fury.io/py/PyPlumIO)
 [![PyPI Supported Python Versions](https://img.shields.io/pypi/pyversions/pyplumio.svg)](https://pypi.python.org/pypi/pyplumio/)
-[![PyPlumIO CI](https://github.com/denpamusic/PyPlumIO/actions/workflows/ci.yml/badge.svg)](https://github.com/denpamusic/PyPlumIO/actions/workflows/ci.yml)
 [![Maintainability](https://qlty.sh/gh/denpamusic/projects/PyPlumIO/maintainability.svg)](https://qlty.sh/gh/denpamusic/projects/PyPlumIO)
 [![Code Coverage](https://qlty.sh/gh/denpamusic/projects/PyPlumIO/coverage.svg)](https://qlty.sh/gh/denpamusic/projects/PyPlumIO)
 [![stability-release-candidate](https://img.shields.io/badge/stability-pre--release-48c9b0.svg)](https://guidelines.denpa.pro/stability#release-candidate)
 [![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)
 
+---
+
 ## Overview
 
 This package aims to provide complete and easy to use solution for
@@ -41,16 +42,18 @@ through network by using RS-485 to Ethernet/WiFi converter.
 
 ## Quickstart
 
-1. To use PyPlumIO, first install it using pip:
+1. To use PyPlumIO, first install it using [uv](https://docs.astral.sh/uv/) or pip:
 
 ```bash
+uv add pyplumio
+# or
 pip install pyplumio
 ```
 
 2. Connect to the ecoMAX controller:
 
 ```python
->>> connection = pyplumio.open_serial_connection("/dev/ttyUSB0")
+>>> connection = pyplumio.serial_for_url("/dev/ttyUSB0")
 >>> await connection.connect()
 >>> ecomax = await connection.get("ecomax")
 ```
@@ -74,6 +77,54 @@ this package and depends on it. Click button below to check it out.
 
 [![Plum ecoMAX for Home Assistant](https://img.shields.io/badge/Plum%20ecoMAX%20for%20Home%20Assistant-41bdf5)](https://github.com/denpamusic/homeassistant-plum-ecomax)
 
+## Development
+
+This project uses [uv](https://docs.astral.sh/uv/) for project and dependency management, and [prek](https://github.com/j178/prek) for Git hooks.
+
+### Setup
+
+Install the project and development dependencies:
+
+```bash
+uv sync
+```
+
+### Running Tests
+
+Run the test suite with coverage enforcement (100% required):
+
+```bash
+uv run pytest
+```
+
+### Code Quality & Formatting
+
+Run linters, format checks, and cognitive complexity analysis:
+
+```bash
+uv run codespell
+uv run ruff check .
+uv run ruff format --check .
+uv run complexipy . --max-complexity-allowed 15
+```
+
+### Type Checking
+
+Run type checking with mypy:
+
+```bash
+uv run mypy pyplumio tests
+```
+
+### Git Hooks
+
+Install and run Git hooks via prek:
+
+```bash
+prek install
+prek run --all-files
+```
+
 ## Attribution
 
 Special thanks to [econetanalyze](https://github.com/twkrol/econetanalyze)

{pyplumio-0.6.8 → pyplumio-0.7.0}/docs/source/callbacks.rst

@@ -96,6 +96,10 @@ value is changed.
 This filter await the callback on signifacant changes only.
 Significance is defined by ``tolerance`` argument (i. e. tolerance=0.1
 will only await callback when value is changed by more that 0.1).
+For Number parameters a change of min or max value always awaits the
+callback; tolerance applies to the value only.
+The ``on_change``, ``debounce`` and ``delta`` filters also treat a min or
+max change as a change, so ``delta`` may await the callback with 0.
 
 .. code-block:: python
 
@@ -177,7 +181,7 @@ processing.
 
     async def main():
         """Subscribes callback to the current heating temperature."""
-        async with pyplumio.open_tcp_connection("localhost", 8899) as conn:
+        async with pyplumio.serial_for_url("socket://localhost:8899") as conn:
             async with conn.device("ecomax") as ecomax:
                 # Await the callback on value change but no faster than
                 # once per 5 seconds.
@@ -207,7 +211,7 @@ current heating temperature on every SensorDataMessage.
 
     async def main():
         """Subscribes callback to the current heating temperature."""
-        async with pyplumio.open_tcp_connection("localhost", 8899) as conn:
+        async with pyplumio.serial_for_url("socket://localhost:8899") as conn:
             async with conn.device("ecomax") as ecomax:
                 # Subscribe my_callback to heating_temp event.
                 ecomax.subscribe("heating_temp", my_callback)
@@ -240,7 +244,7 @@ when heating temperature will change more the 0.1 degrees Celsius.
 
     async def main():
         """Subscribes callback to the current heating temperature."""
-        async with pyplumio.open_tcp_connection("localhost", 8899) as conn:
+        async with pyplumio.serial_for_url("socket://localhost:8899") as conn:
             async with conn.device("ecomax") as ecomax:
                 # Subscribe my_callback to heating_target_temp event.
                 ecomax.subscribe_once("heating_target_temp", my_callback)

{pyplumio-0.6.8 → pyplumio-0.7.0}/docs/source/connecting.rst

@@ -4,41 +4,30 @@ Connecting
 Opening the connection
 ----------------------
 
-.. autofunction:: pyplumio.open_tcp_connection
+.. autofunction:: pyplumio.serial_for_url
 
-With this you can connect to the controller remotely via RS-485 to
-Ethernet/WiFi converters, which are readily available online or
-can be custom built using wired connection and ser2net software.
+You can connect to the ecoMAX controller via physical connection through
+RS-485 to USB or RS-485 to TTL adapters, that are connected directly
+to the device running PyPlumIO or wirelessly through tcp socket.
+
+You MUST not connect RS-485 lines directly to the UART outputs of your
+PC or you'll risk damaging your PC/controller or the ecoMAX controller itself.
 
 .. code-block:: python
     
     import pyplumio
 
-    async with pyplumio.open_tcp_connection("localhost", port=8899) as conn:
+    async with pyplumio.serial_for_url("/dev/ttyUSB0") as conn:
+        ...
+        
+    async with pyplumio.serial_for_url("socket://localhost:8899") as conn:
         ...
-
 
 .. note::
 
     Although **async with** syntax is preferred, you can initiate connection without it.
     See following :ref:`examples<Connection Examples>` for more information.
 
-.. autofunction:: pyplumio.open_serial_connection
-
-You can connect to the ecoMAX controller via wired connection through
-RS-485 to USB or RS-485 to TTL adapters, that are connected directly
-to the device running PyPlumIO.
-
-You MUST not connect RS-485 lines directly to the UART outputs of your
-PC or you'll risk damaging your PC/controller or the ecoMAX controller itself.
-
-.. code-block:: python
-    
-    import pyplumio
-
-    async with pyplumio.open_serial_connection("/dev/ttyUSB0", baudrate=115200) as conn:
-        ...
-
 Protocols
 ---------
 
@@ -62,14 +51,12 @@ working with device classes and queues.
     import asyncio
 
     import pyplumio
-    from pyplumio.const import DeviceType
-    from pyplumio.frames import requests, responses
+    from pyplumio import DeviceType, DummyProtocol, requests, responses
 
 
     async def main():
         """Open a connection and request alerts."""
-        async with pyplumio.open_tcp_connection(
-            host="localhost", port=8899, protocol=pyplumio.DummyProtocol()
+        async with pyplumio.serial_for_url("socket://localhost:8899", protocol=DummyProtocol()
         ) as conn:
             await conn.writer.write(
                 requests.AlertsRequest(recipient=DeviceType.ECOMAX, start=0, count=5)
@@ -116,21 +103,25 @@ In the example below, we'll set both ethernet and wireless parameters.
 .. code-block:: python
 
     import pyplumio
-    from pyplumio.const import EncryptionType
+    from pyplumio import (
+        AsyncProtocol,
+        EthernetParameters,
+        WirelessParameters,
+        EncryptionType
+    )
 
 
     async def main():
         """Initialize a connection with network parameters."""
-        async with pyplumio.open_tcp_connection(
-            host="localhost",
-            port=8899,
-            protocol=pyplumio.AsyncProtocol(
-                ethernet_parameters=pyplumio.EthernetParameters(
+        async with pyplumio.serial_for_url(
+            "socket://localhost:8899",
+            protocol=AsyncProtocol(
+                ethernet_parameters=EthernetParameters(
                     ip="10.10.1.100",
                     netmask="255.255.255.0",
                     gateway="10.10.1.1",
                 ),
-                wireless_parameters=pyplumio.WirelessParameters(
+                wireless_parameters=WirelessParameters(
                     ip="10.10.2.100",
                     netmask="255.255.255.0",
                     gateway="10.10.2.1",
@@ -176,7 +167,7 @@ connection.
 
     async def main():
         """Print connection statistics."""
-        async with pyplumio.open_tcp_connection("localhost", 8899) as conn:
+        async with pyplumio.serial_for_url("socket://localhost:8899") as conn:
             print(conn.statistics)
             ...
 
@@ -199,12 +190,12 @@ context manager.
 
     async def main():
         """Opens the connection and gets the ecoMAX device."""
-        async with pyplumio.open_tcp_connection("localhost", port=8899) as conn:
+        async with pyplumio.serial_for_url("socket://localhost:8899") as conn:
             try:
                 # Get the ecoMAX device within 10 seconds or timeout.
                 async with conn.device("ecomax", timeout=10) as ecomax:
                     ...
-            except asyncio.TimeoutError:
+            except TimeoutError:
                 # If device times out, log the error.
                 _LOGGER.error("Failed to get the device within 10 seconds")
         
@@ -228,7 +219,7 @@ using Python's context manager.
 
     async def main():
         """Opens the connection and gets the ecoMAX device."""
-        connection = pyplumio.open_tcp_connection("localhost", port=8899)
+        connection = pyplumio.serial_for_url("socket://localhost:8899")
 
         # Connect to the device.
         await connection.connect()
@@ -237,7 +228,7 @@ using Python's context manager.
             # Get the ecoMAX device within 10 seconds or timeout.
             async with conn.device("ecomax", timeout=10) as ecomax:
                 ...
-        except asyncio.TimeoutError:
+        except TimeoutError:
             # If device times out, log the error.
             _LOGGER.error("Failed to get the device within 10 seconds")
 

{pyplumio-0.6.8 → pyplumio-0.7.0}/docs/source/frames.rst

@@ -99,6 +99,60 @@ Handler
 
 .. autoclass:: pyplumio.structures.ecomax_parameters.EcomaxParametersStructure
 
+EcomaxExtendedParameters
+------------------------
+
+Get the ecoMAX controller editable parameters from the extended parameter
+table. Newer controllers, such as ecoMAX 860P4-NM TOUCH, keep part of their
+settings only in this table.
+
+PyPlumIO requests this table only if the controller announces frame type 97
+in the frame version table, and requests it again each time its version
+changes.
+
+Parameters are represented in the same way as in :ref:`ecomaxparameters`.
+Raw parameters are available under the ``ecomax_extended_parameters`` key.
+Parameters with known meaning are also available by name for verified
+products only.
+
+Request
+^^^^^^^
+
+.. autoattribute:: pyplumio.const.FrameType.REQUEST_ECOMAX_EXTENDED_PARAMETERS
+
+.. list-table::
+   :widths: 20 65 10
+   :header-rows: 1
+
+   * - Name
+     - Description
+     - Default
+   * - start
+     - Parameter index to start on.
+     - 0
+   * - count
+     - Number of parameters to request.
+     - 255
+
+Response
+^^^^^^^^
+
+.. autoattribute:: pyplumio.const.FrameType.RESPONSE_ECOMAX_EXTENDED_PARAMETERS
+
+.. list-table::
+   :widths: 50 50
+   :header-rows: 1
+
+   * - Name
+     - Description
+   * - ecomax_extended_parameters
+     - Contains a list of ecomax extended parameters.
+
+Handler
+^^^^^^^
+
+.. autoclass:: pyplumio.structures.ecomax_extended_parameters.EcomaxExtendedParametersStructure
+
 MixerParameters
 ---------------
 
@@ -174,6 +228,46 @@ Response
 
 .. autoattribute:: pyplumio.const.FrameType.RESPONSE_SET_ECOMAX_PARAMETER
 
+SetEcomaxExtendedParameter
+--------------------------
+
+Set the editable parameter value in the extended parameter table.
+
+The message is the number of values, the index of the first parameter and
+the new raw values for consecutive indexes. In a panel capture, a single
+write was ``01 <index> <value>`` and one frame ``05 3b 47 16 1e 0a 46`` set
+indexes 0x3b to 0x3f to 71, 22, 30, 10 and 70. PyPlumIO always sets one
+parameter per frame.
+
+In captures, after every panel write the controller increased the frame
+type 97 version in the regulator data frame version table within 1-3 seconds
+(6, 7, 8, 9, 10, 11 for five writes), so PyPlumIO re-reads the extended
+parameter table and confirms the set from it.
+
+Request
+^^^^^^^
+
+.. autoattribute:: pyplumio.const.FrameType.REQUEST_SET_ECOMAX_EXTENDED_PARAMETER
+
+.. list-table::
+   :widths: 20 65 10
+   :header-rows: 1
+
+   * - Name
+     - Description
+     - Default
+   * - index
+     - Parameter index.
+     - 
+   * - value
+     - Value to set parameter to.
+     - 
+
+Response
+^^^^^^^^
+
+.. autoattribute:: pyplumio.const.FrameType.RESPONSE_SET_ECOMAX_EXTENDED_PARAMETER
+
 SetMixerParameter
 -----------------
 

{pyplumio-0.6.8 → pyplumio-0.7.0}/docs/source/index.rst

@@ -19,15 +19,17 @@ RS-485 to Ethernet/WiFi converter.
 
 Quickstart
 ==========
-1. To use PyPlumIO, first install it using pip:
+1. To use PyPlumIO, first install it using uv or pip:
 
 .. code-block:: console
 
+    $ uv add pyplumio
+    # or
     (.venv) $ pip install pyplumio
 
 2. Connect to the ecoMAX controller:
 
->>> connection = pyplumio.open_serial_connection("/dev/ttyUSB0")
+>>> connection = pyplumio.serial_for_url("/dev/ttyUSB0")
 >>> await connection.connect()
 >>> ecomax = await connection.get("ecomax")
 

{pyplumio-0.6.8 → pyplumio-0.7.0}/docs/source/mixers_thermostats.rst

@@ -32,7 +32,7 @@ get it's current_temp property and set it's target temperature to
 
 .. code-block:: python
 
-    from pyplumio.devices import Mixer
+    from pyplumio import Mixer
 
     async with conn.device("ecomax") as ecomax:
         # Get connected mixers.
@@ -56,7 +56,7 @@ degrees Celsius.
 
 .. code-block:: python
 
-    from pyplumio.device import Thermostat
+    from pyplumio import Thermostat
 
     async with conn.device("ecomax") as ecomax:
         # Get connected thermostats.

{pyplumio-0.6.8 → pyplumio-0.7.0}/docs/source/reading.rst

@@ -34,7 +34,7 @@ and close the connection.
 
     async def main():
         """Read the current heating temperature."""
-        async with pyplumio.open_tcp_connection("localhost", 8899) as conn:
+        async with pyplumio.serial_for_url("socket://localhost:8899") as conn:
             # Get the ecoMAX device.
             async with conn.device("ecomax") as ecomax:
                 # Get the heating temperature.
@@ -119,7 +119,7 @@ to the terminal.
         """Read current temp, target temp and device state from
         the regdata.
         """
-        async with pyplumio.open_tcp_connection("localhost", 8899) as conn:
+        async with pyplumio.serial_for_url("socket://localhost:8899") as conn:
             # Get the ecoMAX device.
             async with conn.device("ecomax") as ecomax:
                 # Get heating temperature, if it's available otherwise

{pyplumio-0.6.8 → pyplumio-0.7.0}/docs/source/schedules.rst

@@ -60,11 +60,11 @@ switches back to daytime mode from 07:00 to 00:00.
     await heating_schedule.commit()
 
 For clarity sake, you might want to use ``STATE_OFF`` and
-``STATE_ON`` constants from ``pyplumio.const`` module.
+``STATE_ON`` constants.
 
 .. code-block:: python
 
-    from pyplumio.const import STATE_OFF
+    from pyplumio import STATE_OFF
 
     heating_schedule.monday["18:00"] = STATE_OFF
     heating_schedule.monday.set_state(STATE_OFF, "00:00", "07:00")
@@ -110,12 +110,12 @@ Schedule Examples
 .. code-block:: python
 
     import pyplumio
-    from pyplumio.const import STATE_ON, STATE_OFF
+    from pyplumio import STATE_ON, STATE_OFF
 
 
     async def main():
         """Set a device schedule."""
-        async with pyplumio.open_tcp_connection("localhost", 8899) as conn:
+        async with pyplumio.serial_for_url("socket://localhost:8899") as conn:
             async with conn.device("ecomax") as ecomax:
                 schedules = await ecomax.get("schedules")
                 heating_schedule = schedules["heating"]

{pyplumio-0.6.8 → pyplumio-0.7.0}/docs/source/writing.rst

@@ -45,7 +45,7 @@ Numbers are parameters that have numerical value associated with them.
 
 .. code-block:: python
 
-    from pyplumio.parameters import Number
+    from pyplumio import Number
 
     async with conn.device("ecomax") as ecomax:
         heating_target: Number = ecomax.get("heating_target_temp")
@@ -61,7 +61,7 @@ Please note, that both values are **inclusive**.
 
 .. code-block:: python
 
-    from pyplumio.parameters import Number
+    from pyplumio import Number
 
     async with conn.device("ecomax") as ecomax:
         target_temp: Number = await ecomax.get("heating_target_temp")
@@ -95,7 +95,7 @@ object.
 
 .. code-block:: python
 
-    from pyplumio.parameters import Switch
+    from pyplumio import Switch
 
     # Get an ecomax_control parameter and turn it on.
     ecomax_control: Switch = await ecomax.get("ecomax_control")
@@ -127,7 +127,7 @@ outputting the result to the terminal.
 
     async def main():
         """Turn on the controller and set target temperature."""
-        async with pyplumio.open_tcp_connection("localhost", 8899) as conn:
+        async with pyplumio.serial_for_url("socket://localhost:8899") as conn:
             # Get the ecoMAX device.
             async with conn.device("ecomax") as ecomax:
                 # Turn on controller without waiting for the result.