conson-xp 1.8.0__tar.gz → 1.14.0__tar.gz

{conson_xp-1.8.0 → conson_xp-1.14.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: conson-xp
-Version: 1.8.0
+Version: 1.14.0
 Summary: XP Protocol Communication Tools
 Author-Email: ldvchosal <ldvchosal@github.com>
 License: MIT License
@@ -276,6 +276,9 @@ xp conbus
 
 xp conbus actiontable
 xp conbus actiontable download
+xp conbus actiontable list
+xp conbus actiontable show
+xp conbus actiontable upload
 
 
 xp conbus autoreport
@@ -313,6 +316,11 @@ xp conbus linknumber get
 xp conbus linknumber set
 
 
+xp conbus modulenumber
+xp conbus modulenumber get
+xp conbus modulenumber set
+
+
 xp conbus msactiontable
 xp conbus msactiontable download
 

{conson_xp-1.8.0 → conson_xp-1.14.0}/README.md

@@ -225,6 +225,9 @@ xp conbus
 
 xp conbus actiontable
 xp conbus actiontable download
+xp conbus actiontable list
+xp conbus actiontable show
+xp conbus actiontable upload
 
 
 xp conbus autoreport
@@ -262,6 +265,11 @@ xp conbus linknumber get
 xp conbus linknumber set
 
 
+xp conbus modulenumber
+xp conbus modulenumber get
+xp conbus modulenumber set
+
+
 xp conbus msactiontable
 xp conbus msactiontable download
 

{conson_xp-1.8.0 → conson_xp-1.14.0}/pyproject.toml

@@ -20,7 +20,7 @@ dependencies = [
 ]
 requires-python = ">=3.11"
 readme = "README.md"
-version = "1.8.0"
+version = "1.14.0"
 
 [project.license]
 file = "LICENSE"

{conson_xp-1.8.0 → conson_xp-1.14.0}/src/xp/__init__.py

@@ -3,7 +3,7 @@
 conson-xp package.
 """
 
-__version__ = "1.8.0"
+__version__ = "1.14.0"
 __manufacturer__ = "salchichon"
 __model__ = "xp.cli"
 __serial__ = "2025.09.23.000"

{conson_xp-1.8.0 → conson_xp-1.14.0}/src/xp/cli/commands/__init__.py

@@ -10,6 +10,7 @@ from xp.cli.commands.conbus.conbus import (
     conbus_datapoint,
     conbus_lightlevel,
     conbus_linknumber,
+    conbus_modulenumber,
     conbus_msactiontable,
     conbus_output,
 )
@@ -46,6 +47,10 @@ from xp.cli.commands.conbus.conbus_linknumber_commands import (
     get_linknumber_command,
     set_linknumber_command,
 )
+from xp.cli.commands.conbus.conbus_modulenumber_commands import (
+    get_modulenumber_command,
+    set_modulenumber_command,
+)
 from xp.cli.commands.conbus.conbus_msactiontable_commands import (
     conbus_download_msactiontable,
 )
@@ -87,6 +92,7 @@ __all__ = [
     "conbus_output",
     "conbus_datapoint",
     "conbus_linknumber",
+    "conbus_modulenumber",
     "conbus_autoreport",
     "conbus_lightlevel",
     "conbus_msactiontable",
@@ -123,6 +129,8 @@ __all__ = [
     "receive_telegrams",
     "set_linknumber_command",
     "get_linknumber_command",
+    "set_modulenumber_command",
+    "get_modulenumber_command",
     "get_autoreport_command",
     "set_autoreport_command",
     "xp_lightlevel_set",

{conson_xp-1.8.0 → conson_xp-1.14.0}/src/xp/cli/commands/conbus/conbus.py

@@ -57,6 +57,18 @@ def conbus_linknumber() -> None:
     pass
 
 
+@click.group(
+    "modulenumber",
+    cls=HelpColorsGroup,
+    help_headers_color="yellow",
+    help_options_color="green",
+    short_help="Module number operations",
+)
+def conbus_modulenumber() -> None:
+    """Set or get the module number for specific modules."""
+    pass
+
+
 @click.group(
     "autoreport",
     cls=HelpColorsGroup,
@@ -109,6 +121,7 @@ conbus.add_command(conbus_blink)
 conbus.add_command(conbus_output)
 conbus.add_command(conbus_datapoint)
 conbus.add_command(conbus_linknumber)
+conbus.add_command(conbus_modulenumber)
 conbus.add_command(conbus_autoreport)
 conbus.add_command(conbus_lightlevel)
 conbus.add_command(conbus_msactiontable)

conson_xp-1.14.0/src/xp/cli/commands/conbus/conbus_actiontable_commands.py

@@ -0,0 +1,233 @@
+"""ActionTable CLI commands."""
+
+import json
+from contextlib import suppress
+from pathlib import Path
+from typing import Any
+
+import click
+from click import Context
+
+from xp.cli.commands.conbus.conbus import conbus_actiontable
+from xp.cli.utils.decorators import (
+    connection_command,
+)
+from xp.cli.utils.serial_number_type import SERIAL
+from xp.models.actiontable.actiontable import ActionTable
+from xp.models.homekit.homekit_conson_config import (
+    ConsonModuleConfig,
+    ConsonModuleListConfig,
+)
+from xp.services.conbus.actiontable.actiontable_download_service import (
+    ActionTableService,
+)
+from xp.services.conbus.actiontable.actiontable_list_service import (
+    ActionTableListService,
+)
+from xp.services.conbus.actiontable.actiontable_show_service import (
+    ActionTableShowService,
+)
+from xp.services.conbus.actiontable.actiontable_upload_service import (
+    ActionTableUploadService,
+)
+
+
+class ActionTableError(Exception):
+    """Raised when ActionTable operations fail."""
+
+    pass
+
+
+@conbus_actiontable.command("download", short_help="Download ActionTable")
+@click.argument("serial_number", type=SERIAL)
+@click.pass_context
+@connection_command()
+def conbus_download_actiontable(ctx: Context, serial_number: str) -> None:
+    """Download action table from XP module.
+
+    Args:
+        ctx: Click context object.
+        serial_number: 10-digit module serial number.
+    """
+    service: ActionTableService = (
+        ctx.obj.get("container").get_container().resolve(ActionTableService)
+    )
+
+    def progress_callback(progress: str) -> None:
+        """Handle progress updates during action table download.
+
+        Args:
+            progress: Progress message string.
+        """
+        click.echo(progress)
+
+    def on_finish(
+        _actiontable: ActionTable,
+        actiontable_dict: dict[str, Any],
+        actiontable_short: list[str],
+    ) -> None:
+        """Handle successful completion of action table download.
+
+        Args:
+            _actiontable: Downloaded action table object.
+            actiontable_dict: Dictionary representation of action table.
+            actiontable_short: List of textual format strings.
+        """
+        output = {
+            "serial_number": serial_number,
+            "actiontable_short": actiontable_short,
+            "actiontable": actiontable_dict,
+        }
+        click.echo(json.dumps(output, indent=2, default=str))
+
+    def error_callback(error: str) -> None:
+        """Handle errors during action table download.
+
+        Args:
+            error: Error message string.
+        """
+        click.echo(error)
+
+    with service:
+        service.start(
+            serial_number=serial_number,
+            progress_callback=progress_callback,
+            finish_callback=on_finish,
+            error_callback=error_callback,
+        )
+
+
+@conbus_actiontable.command("upload", short_help="Upload ActionTable")
+@click.argument("serial_number", type=SERIAL)
+@click.pass_context
+@connection_command()
+def conbus_upload_actiontable(ctx: Context, serial_number: str) -> None:
+    """Upload action table from conson.yml to XP module.
+
+    Args:
+        ctx: Click context object.
+        serial_number: 10-digit module serial number.
+    """
+    service: ActionTableUploadService = (
+        ctx.obj.get("container").get_container().resolve(ActionTableUploadService)
+    )
+
+    click.echo(f"Uploading action table to {serial_number}...")
+
+    # Track number of entries for success message
+    entries_count = 0
+
+    def progress_callback(progress: str) -> None:
+        """Handle progress updates during action table upload.
+
+        Args:
+            progress: Progress message string.
+        """
+        click.echo(progress, nl=False)
+
+    def success_callback() -> None:
+        """Handle successful completion of action table upload."""
+        click.echo("\nAction table uploaded successfully")
+        if entries_count > 0:
+            click.echo(f"{entries_count} entries written")
+
+    def error_callback(error: str) -> None:
+        """Handle errors during action table upload.
+
+        Args:
+            error: Error message string.
+
+        Raises:
+            ActionTableError: Always raised with upload failure message.
+        """
+        raise ActionTableError(f"Upload failed: {error}")
+
+    with service:
+        # Load config to get entry count for success message
+        config_path = Path.cwd() / "conson.yml"
+        if config_path.exists():
+            with suppress(Exception):
+                config = ConsonModuleListConfig.from_yaml(str(config_path))
+                module = config.find_module(serial_number)
+                if module and module.action_table:
+                    entries_count = len(module.action_table)
+
+        service.start(
+            serial_number=serial_number,
+            progress_callback=progress_callback,
+            success_callback=success_callback,
+            error_callback=error_callback,
+        )
+
+
+@conbus_actiontable.command("list", short_help="List modules with ActionTable")
+@click.pass_context
+def conbus_list_actiontable(ctx: Context) -> None:
+    """List all modules with action table configurations from conson.yml.
+
+    Args:
+        ctx: Click context object.
+    """
+    service: ActionTableListService = (
+        ctx.obj.get("container").get_container().resolve(ActionTableListService)
+    )
+
+    def on_finish(module_list: dict) -> None:
+        """Handle successful completion of action table list.
+
+        Args:
+            module_list: Dictionary containing modules and total count.
+        """
+        click.echo(json.dumps(module_list, indent=2, default=str))
+
+    def error_callback(error: str) -> None:
+        """Handle errors during action table list.
+
+        Args:
+            error: Error message string.
+        """
+        click.echo(error)
+
+    with service:
+        service.start(
+            finish_callback=on_finish,
+            error_callback=error_callback,
+        )
+
+
+@conbus_actiontable.command("show", short_help="Show ActionTable configuration")
+@click.argument("serial_number", type=SERIAL)
+@click.pass_context
+def conbus_show_actiontable(ctx: Context, serial_number: str) -> None:
+    """Show action table configuration for a specific module from conson.yml.
+
+    Args:
+        ctx: Click context object.
+        serial_number: 10-digit module serial number.
+    """
+    service: ActionTableShowService = (
+        ctx.obj.get("container").get_container().resolve(ActionTableShowService)
+    )
+
+    def on_finish(module: ConsonModuleConfig) -> None:
+        """Handle successful completion of action table show.
+
+        Args:
+            module: Dictionary containing module configuration.
+        """
+        click.echo(json.dumps(module.model_dump(), indent=2, default=str))
+
+    def error_callback(error: str) -> None:
+        """Handle errors during action table show.
+
+        Args:
+            error: Error message string.
+        """
+        click.echo(error)
+
+    with service:
+        service.start(
+            serial_number=serial_number,
+            finish_callback=on_finish,
+            error_callback=error_callback,
+        )

{conson_xp-1.8.0 → conson_xp-1.14.0}/src/xp/cli/commands/conbus/conbus_linknumber_commands.py

@@ -49,7 +49,7 @@ def set_linknumber_command(
         ctx.obj.get("container").get_container().resolve(WriteConfigService)
     )
 
-    data_value = f"{link_number: 02d}"
+    data_value = f"{link_number:02d}"
     with service:
         service.write_config(
             serial_number=serial_number,

conson_xp-1.14.0/src/xp/cli/commands/conbus/conbus_modulenumber_commands.py

@@ -0,0 +1,104 @@
+"""Conbus module number CLI commands."""
+
+import json
+
+import click
+
+from xp.cli.commands.conbus.conbus import conbus_modulenumber
+from xp.cli.utils.decorators import (
+    connection_command,
+)
+from xp.cli.utils.serial_number_type import SERIAL
+from xp.models import ConbusDatapointResponse
+from xp.models.conbus.conbus_writeconfig import ConbusWriteConfigResponse
+from xp.models.telegram.datapoint_type import DataPointType
+from xp.services.conbus.conbus_datapoint_service import ConbusDatapointService
+from xp.services.conbus.write_config_service import WriteConfigService
+from xp.services.telegram.telegram_datapoint_service import TelegramDatapointService
+
+
+@conbus_modulenumber.command("set", short_help="Set module number for a module")
+@click.argument("serial_number", type=SERIAL)
+@click.argument("module_number", type=click.IntRange(0, 99))
+@click.pass_context
+@connection_command()
+def set_modulenumber_command(
+    ctx: click.Context, serial_number: str, module_number: int
+) -> None:
+    r"""Set the module number for a specific module.
+
+    Args:
+        ctx: Click context object.
+        serial_number: 10-digit module serial number.
+        module_number: Module number to set (0-99).
+
+    Examples:
+        \b
+        xp conbus modulenumber set 0123450001 25
+    """
+
+    def on_finish(response: "ConbusWriteConfigResponse") -> None:
+        """Handle successful completion of light level on command.
+
+        Args:
+            response: Light level response object.
+        """
+        click.echo(json.dumps(response.to_dict(), indent=2))
+
+    service: WriteConfigService = (
+        ctx.obj.get("container").get_container().resolve(WriteConfigService)
+    )
+
+    data_value = f"{module_number:02d}"
+    with service:
+        service.write_config(
+            serial_number=serial_number,
+            datapoint_type=DataPointType.MODULE_NUMBER,
+            data_value=data_value,
+            finish_callback=on_finish,
+            timeout_seconds=0.5,
+        )
+
+
+@conbus_modulenumber.command("get", short_help="Get module number for a module")
+@click.argument("serial_number", type=SERIAL)
+@click.pass_context
+@connection_command()
+def get_modulenumber_command(ctx: click.Context, serial_number: str) -> None:
+    r"""Get the current module number for a specific module.
+
+    Args:
+        ctx: Click context object.
+        serial_number: 10-digit module serial number.
+
+    Examples:
+        \b
+        xp conbus modulenumber get 0123450001
+    """
+    service: ConbusDatapointService = (
+        ctx.obj.get("container").get_container().resolve(ConbusDatapointService)
+    )
+    telegram_service: TelegramDatapointService = (
+        ctx.obj.get("container").get_container().resolve(TelegramDatapointService)
+    )
+
+    def on_finish(service_response: ConbusDatapointResponse) -> None:
+        """Handle successful completion of module number get command.
+
+        Args:
+            service_response: Module number response object.
+        """
+        modulenumber_value = telegram_service.get_modulenumber(
+            service_response.data_value
+        )
+        result = service_response.to_dict()
+        result["modulenumber_value"] = modulenumber_value
+        click.echo(json.dumps(result, indent=2))
+
+    with service:
+        service.query_datapoint(
+            serial_number=serial_number,
+            datapoint_type=DataPointType.MODULE_NUMBER,
+            finish_callback=on_finish,
+            timeout_seconds=0.5,
+        )

{conson_xp-1.8.0 → conson_xp-1.14.0}/src/xp/models/actiontable/actiontable.py

@@ -27,7 +27,7 @@ class ActionTableEntry:
     link_number: int = 0
     module_input: int = 0
     module_output: int = 1
-    command: InputActionType = InputActionType.TURNOFF
+    command: InputActionType = InputActionType.OFF
     parameter: TimeParam = TimeParam.NONE
     inverted: bool = False
 

{conson_xp-1.8.0 → conson_xp-1.14.0}/src/xp/models/actiontable/msactiontable_xp24.py

@@ -23,7 +23,7 @@ class InputAction:
 class Xp24MsActionTable:
     """XP24 Action Table for managing input actions and settings.
 
-    Each input has an action type (TOGGLE, TURNON, LEVELSET, etc.)
+    Each input has an action type (TOGGLE, ON, LEVELSET, etc.)
     with an optional parameter string.
 
     Attributes:

{conson_xp-1.8.0 → conson_xp-1.14.0}/src/xp/models/homekit/homekit_conson_config.py

@@ -22,6 +22,8 @@ class ConsonModuleConfig(BaseModel):
         conbus_port: Optional Conbus port number.
         sw_version: Optional software version.
         hw_version: Optional hardware version.
+        action_table: Optional action table configuration.
+        auto_report_status: Optional auto report status.
     """
 
     name: str
@@ -35,6 +37,8 @@ class ConsonModuleConfig(BaseModel):
     conbus_port: Optional[int] = None
     sw_version: Optional[str] = None
     hw_version: Optional[str] = None
+    action_table: Optional[List[str]] = None
+    auto_report_status: Optional[str] = None
 
 
 class ConsonModuleListConfig(BaseModel):
@@ -66,3 +70,17 @@ class ConsonModuleListConfig(BaseModel):
         with Path(file_path).open("r") as file:
             data = yaml.safe_load(file)
         return cls(root=data)
+
+    def find_module(self, serial_number: str) -> Optional[ConsonModuleConfig]:
+        """Find a module by serial number.
+
+        Args:
+            serial_number: Module serial number to search for.
+
+        Returns:
+            ConsonModuleConfig if found, None otherwise.
+        """
+        for module in self.root:
+            if module.serial_number == serial_number:
+                return module
+        return None

{conson_xp-1.8.0 → conson_xp-1.14.0}/src/xp/models/telegram/input_action_type.py

@@ -8,8 +8,8 @@ class InputActionType(Enum):
 
     Attributes:
         VOID: No action.
-        TURNON: Turn on action.
-        TURNOFF: Turn off action.
+        ON: Turn on action.
+        OFF: Turn off action.
         TOGGLE: Toggle action.
         BLOCK: Block action.
         AUXRELAY: Auxiliary relay action.
@@ -39,8 +39,8 @@ class InputActionType(Enum):
     """
 
     VOID = 0
-    TURNON = 1
-    TURNOFF = 2
+    ON = 1
+    OFF = 2
     TOGGLE = 3
     BLOCK = 4
     AUXRELAY = 5

{conson_xp-1.8.0 → conson_xp-1.14.0}/src/xp/models/telegram/system_function.py

@@ -15,35 +15,65 @@ class SystemFunction(str, Enum):
         WRITE_CONFIG: Write configuration.
         BLINK: Blink LED function.
         UNBLINK: Unblink LED function.
-        DOWNLOAD_MSACTIONTABLE: Download module specific action table.
+        UPLOAD_FIRMWARE_START: Start upload firmware.
+        UPLOAD_FIRMWARE_STOP: Stop upload firmware.
+        UPLOAD_FIRMWARE: Upload firmware.
+        UPLOAD_ACTIONTABLE: Upload ActionTable to module.
         DOWNLOAD_ACTIONTABLE: Download ActionTable.
+        UPLOAD_MSACTIONTABLE: Upload module specific action table to module.
+        DOWNLOAD_MSACTIONTABLE: Download module specific action table.
+        TELEGRAM_WRITE_START: Start writing telegram.
+        TELEGRAM_READ_START: Start reading telegram.
         EOF: End of msactiontable response.
+        TELEGRAM: Module specific telegram response.
         MSACTIONTABLE: Module specific action table response.
         ACTIONTABLE: Module specific action table response.
         ACK: Acknowledge response.
         NAK: Not acknowledge response.
+        UPLOAD_TOP_FIRMWARE_START: Start upload firmware (TOP).
+        UPLOAD_TOP_FIRMWARE_STOP: Stop upload firmware (TOP).
+        UPLOAD_TOP_FIRMWARE: Upload firmware (TOP).
+        ROTATE_ENABLE: Enable rotate.
+        ROTATE_DISABLE: Disable rotate.
         UNKNOWN_26: Used after discover, unknown purpose.
         ACTION: Action function.
     """
 
-    NONE = "00"  # Undefined
-    DISCOVERY = "01"  # Discover function
-    READ_DATAPOINT = "02"  # Read datapoint
-    READ_CONFIG = "03"  # Read configuration
-    WRITE_CONFIG = "04"  # Write configuration
-    BLINK = "05"  # Blink LED function
-    UNBLINK = "06"  # Unblink LED function
-    DOWNLOAD_MSACTIONTABLE = (
-        "13"  # Download the module specific action table (MsActionTable)
-    )
-    DOWNLOAD_ACTIONTABLE = "11D"  # Download ActionTable
-    EOF = "16"  # End of msactiontable response
-    MSACTIONTABLE = "17"  # module specific action table (MsActionTable) response
-    ACTIONTABLE = "17"  # module specific action table (MsActionTable) response
-    ACK = "18"  # Acknowledge response
-    NAK = "19"  # Not acknowledge response
-    UNKNOWN_26 = "26"  # Used after discover, but don't know what it is
-    ACTION = "27"  # Action function
+    NONE = "00"  # F00D Undefined
+    DISCOVERY = "01"  # F01D Discover function
+    READ_DATAPOINT = "02"  # F02D Read datapoint
+    READ_CONFIG = "03"  # F03D Read configuration
+    WRITE_CONFIG = "04"  # F04D Write configuration
+    BLINK = "05"  # F05D Blink LED function
+    UNBLINK = "06"  # F06D Unblink LED function
+
+    UPLOAD_FIRMWARE_START = "07"  # F07D Start Upload firmware
+    UPLOAD_FIRMWARE_STOP = "08"  # F08D Stop Upload firmware
+    UPLOAD_FIRMWARE = "09"  # F09D Upload firmware
+
+    UPLOAD_ACTIONTABLE = "10"  # F10D Upload ActionTable
+    DOWNLOAD_ACTIONTABLE = "11"  # F11D Download ActionTable
+    UPLOAD_MSACTIONTABLE = "12"  # F12D Upload MsActionTable to module
+    DOWNLOAD_MSACTIONTABLE = "13"  # F13D Download MsActionTable
+
+    TELEGRAM_WRITE_START = "14"  # F14D Start writing telegram
+    TELEGRAM_READ_START = "15"  # F15D Start reading telegram
+    EOF = "16"  # F16D End of msactiontable response
+    TELEGRAM = "17"  # F17D module specific Telegram response
+    MSACTIONTABLE = "17"  # F17D module specific ms action table (Telegram) response
+    ACTIONTABLE = "17"  # F17D module specific action table (Telegram) response
+    ACK = "18"  # F18D Acknowledge / continue response
+    NAK = "19"  # F19D Not acknowledge response
+
+    UPLOAD_TOP_FIRMWARE_START = "20"  # F20D Start Upload firmware (TOP)
+    UPLOAD_TOP_FIRMWARE_STOP = "21"  # F21D Stop Upload firmware (TOP)
+    UPLOAD_TOP_FIRMWARE = "22"  # F22D Upload firmware (TOP)
+
+    ROTATE_ENABLE = "23"  # F23D Enable rotate
+    ROTATE_DISABLE = "24"  # F24D Disable rotate
+
+    UNKNOWN_26 = "26"  # F26D Used after discover, but don't know what it is
+    ACTION = "27"  # F27D Action function
 
     def get_description(self) -> str:
         """Get the description of the SystemFunction.