conson-xp 1.16.0__tar.gz → 1.18.0__tar.gz

{conson_xp-1.16.0 → conson_xp-1.18.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: conson-xp
-Version: 1.16.0
+Version: 1.18.0
 Summary: XP Protocol Communication Tools
 Author-Email: ldvchosal <ldvchosal@github.com>
 License: MIT License
@@ -305,6 +305,10 @@ xp conbus datapoint query
 
 xp conbus discover
 
+xp conbus event
+xp conbus event raw
+
+
 xp conbus lightlevel
 xp conbus lightlevel get
 xp conbus lightlevel off

{conson_xp-1.16.0 → conson_xp-1.18.0}/README.md

@@ -253,6 +253,10 @@ xp conbus datapoint query
 
 xp conbus discover
 
+xp conbus event
+xp conbus event raw
+
+
 xp conbus lightlevel
 xp conbus lightlevel get
 xp conbus lightlevel off

{conson_xp-1.16.0 → conson_xp-1.18.0}/pyproject.toml

@@ -21,7 +21,7 @@ dependencies = [
 ]
 requires-python = ">=3.11"
 readme = "README.md"
-version = "1.16.0"
+version = "1.18.0"
 
 [project.license]
 file = "LICENSE"

{conson_xp-1.16.0 → conson_xp-1.18.0}/src/xp/__init__.py

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

{conson_xp-1.16.0 → conson_xp-1.18.0}/src/xp/cli/commands/__init__.py

@@ -37,6 +37,7 @@ from xp.cli.commands.conbus.conbus_datapoint_commands import (
     query_datapoint,
 )
 from xp.cli.commands.conbus.conbus_discover_commands import send_discover_telegram
+from xp.cli.commands.conbus.conbus_event_commands import conbus_event, send_event_raw
 from xp.cli.commands.conbus.conbus_lightlevel_commands import (
     xp_lightlevel_get,
     xp_lightlevel_off,
@@ -97,6 +98,7 @@ __all__ = [
     "conbus_lightlevel",
     "conbus_msactiontable",
     "conbus_actiontable",
+    "conbus_event",
     "file",
     "module",
     "reverse_proxy",
@@ -118,6 +120,7 @@ __all__ = [
     "show_config",
     "send_custom_telegram",
     "send_discover_telegram",
+    "send_event_raw",
     "xp_output_on",
     "xp_output_off",
     "xp_output_status",

conson_xp-1.18.0/src/xp/cli/commands/conbus/conbus_event_commands.py

@@ -0,0 +1,81 @@
+"""Conbus event operations CLI commands."""
+
+import json
+
+import click
+
+from xp.cli.commands.conbus.conbus import conbus
+from xp.cli.utils.decorators import connection_command
+from xp.cli.utils.module_type_choice import MODULE_TYPE
+from xp.models import ConbusEventRawResponse
+from xp.services.conbus.conbus_event_raw_service import ConbusEventRawService
+
+
+@click.group(name="event")
+def conbus_event() -> None:
+    """Send event telegrams to Conbus modules."""
+    pass
+
+
+@conbus_event.command("raw")
+@click.argument("module_type", type=MODULE_TYPE)
+@click.argument("link_number", type=click.IntRange(0, 99))
+@click.argument("input_number", type=click.IntRange(0, 9))
+@click.argument("time_ms", type=click.IntRange(min=1), default=1000)
+@click.pass_context
+@connection_command()
+def send_event_raw(
+    ctx: click.Context,
+    module_type: int,
+    link_number: int,
+    input_number: int,
+    time_ms: int,
+) -> None:
+    r"""Send raw event telegrams to simulate button presses.
+
+    Args:
+        ctx: Click context object.
+        module_type: Module type code (e.g., CP20, XP33).
+        link_number: Link number (0-99).
+        input_number: Input number (0-9).
+        time_ms: Delay between MAKE/BREAK events in milliseconds (default: 1000).
+
+    Examples:
+        \b
+        xp conbus event raw CP20 00 00
+        xp conbus event raw XP33 00 00 500
+    """
+
+    def on_finish(response: ConbusEventRawResponse) -> None:
+        """Handle successful completion of event raw operation.
+
+        Args:
+            response: Event raw response with sent and received telegrams.
+        """
+        click.echo(json.dumps(response.to_dict(), indent=2))
+
+    def on_progress(telegram: str) -> None:
+        """Handle progress updates during event operation.
+
+        Args:
+            telegram: Received telegram.
+        """
+        click.echo(json.dumps({"telegram": telegram}))
+
+    service: ConbusEventRawService = (
+        ctx.obj.get("container").get_container().resolve(ConbusEventRawService)
+    )
+    service.run(
+        module_type_code=module_type,
+        link_number=link_number,
+        input_number=input_number,
+        time_ms=time_ms,
+        progress_callback=on_progress,
+        finish_callback=on_finish,
+        timeout_seconds=5,
+    )
+    service.start_reactor()
+
+
+# Register the event command group with conbus
+conbus.add_command(conbus_event)

conson_xp-1.18.0/src/xp/cli/utils/module_type_choice.py

@@ -0,0 +1,56 @@
+"""Click parameter type for ModuleTypeCode enum validation."""
+
+from typing import Any, Optional
+
+import click
+
+from xp.models.telegram.module_type_code import ModuleTypeCode
+
+
+class ModuleTypeChoice(click.ParamType):
+    """Click parameter type for validating ModuleTypeCode enum values.
+
+    Attributes:
+        name: The parameter type name.
+        choices: List of valid choice strings.
+    """
+
+    name = "module_type"
+
+    def __init__(self) -> None:
+        """Initialize the ModuleTypeChoice parameter type."""
+        self.choices = [key for key in ModuleTypeCode.__members__.keys()]
+
+    def convert(
+        self, value: Any, param: Optional[click.Parameter], ctx: Optional[click.Context]
+    ) -> int:
+        """Convert and validate input to ModuleTypeCode value.
+
+        Args:
+            value: The input value to convert.
+            param: The Click parameter.
+            ctx: The Click context.
+
+        Returns:
+            Module type code integer value if valid.
+        """
+        if value is None:
+            self.fail("Module type is required", param, ctx)
+
+        # Convert to upper for comparison
+        normalized_value = value.upper()
+
+        if normalized_value in self.choices:
+            # Return the actual enum value (integer)
+            return ModuleTypeCode[normalized_value].value
+
+        # If not found, show error with available choices
+        choices_list = "\n".join(f" - {choice}" for choice in sorted(self.choices))
+        self.fail(
+            f"{value!r} is not a valid module type. " f"Choose from:\n{choices_list}",
+            param,
+            ctx,
+        )
+
+
+MODULE_TYPE = ModuleTypeChoice()

{conson_xp-1.16.0 → conson_xp-1.18.0}/src/xp/models/__init__.py

@@ -5,6 +5,7 @@ from xp.models.conbus.conbus_client_config import ConbusClientConfig
 from xp.models.conbus.conbus_connection_status import ConbusConnectionStatus
 from xp.models.conbus.conbus_datapoint import ConbusDatapointResponse
 from xp.models.conbus.conbus_discover import ConbusDiscoverResponse
+from xp.models.conbus.conbus_event_raw import ConbusEventRawResponse
 from xp.models.log_entry import LogEntry
 from xp.models.telegram.event_telegram import EventTelegram
 from xp.models.telegram.event_type import EventType
@@ -30,5 +31,6 @@ __all__ = [
     "ConbusResponse",
     "ConbusDatapointResponse",
     "ConbusDiscoverResponse",
+    "ConbusEventRawResponse",
     "ConbusConnectionStatus",
 ]

conson_xp-1.18.0/src/xp/models/conbus/conbus_event_raw.py

@@ -0,0 +1,47 @@
+"""Conbus event raw response model."""
+
+from dataclasses import dataclass
+from datetime import datetime
+from typing import Any, Dict, Optional
+
+
+@dataclass
+class ConbusEventRawResponse:
+    """Represents a response from Conbus event raw operation.
+
+    Attributes:
+        success: Whether the operation was successful.
+        sent_telegrams: List of event telegrams sent (MAKE and BREAK).
+        received_telegrams: List of all telegrams received.
+        error: Error message if operation failed.
+        timestamp: Timestamp of the response.
+    """
+
+    success: bool
+    sent_telegrams: Optional[list[str]] = None
+    received_telegrams: Optional[list[str]] = None
+    error: Optional[str] = None
+    timestamp: Optional[datetime] = None
+
+    def __post_init__(self) -> None:
+        """Initialize timestamp and telegram lists if not provided."""
+        if self.timestamp is None:
+            self.timestamp = datetime.now()
+        if self.sent_telegrams is None:
+            self.sent_telegrams = []
+        if self.received_telegrams is None:
+            self.received_telegrams = []
+
+    def to_dict(self) -> Dict[str, Any]:
+        """Convert to dictionary for JSON serialization.
+
+        Returns:
+            Dictionary representation of the response.
+        """
+        return {
+            "success": self.success,
+            "sent_telegrams": self.sent_telegrams,
+            "received_telegrams": self.received_telegrams,
+            "error": self.error,
+            "timestamp": self.timestamp.isoformat() if self.timestamp else None,
+        }

conson_xp-1.18.0/src/xp/services/conbus/conbus_event_raw_service.py

@@ -0,0 +1,181 @@
+"""Conbus Event Raw Service for sending raw event telegrams.
+
+This service implements a TCP client that connects to Conbus servers and sends
+raw event telegrams to simulate button presses on Conbus modules.
+"""
+
+import logging
+from typing import Callable, Optional
+
+from twisted.internet.base import DelayedCall
+
+from xp.models import ConbusEventRawResponse
+from xp.models.protocol.conbus_protocol import TelegramReceivedEvent
+from xp.services.protocol.conbus_event_protocol import ConbusEventProtocol
+
+
+class ConbusEventRawService:
+    """Service for sending raw event telegrams to Conbus servers.
+
+    Uses ConbusEventProtocol to send MAKE/BREAK event sequences to
+    simulate button presses on Conbus modules.
+
+    Attributes:
+        conbus_protocol: Protocol instance for Conbus communication.
+    """
+
+    conbus_protocol: ConbusEventProtocol
+
+    def __init__(self, conbus_protocol: ConbusEventProtocol) -> None:
+        """Initialize the Conbus event raw service.
+
+        Args:
+            conbus_protocol: ConbusEventProtocol instance.
+        """
+        self.progress_callback: Optional[Callable[[str], None]] = None
+        self.finish_callback: Optional[Callable[[ConbusEventRawResponse], None]] = None
+
+        self.conbus_protocol: ConbusEventProtocol = conbus_protocol
+        self.conbus_protocol.on_connection_made.connect(self.connection_made)
+        self.conbus_protocol.on_telegram_sent.connect(self.telegram_sent)
+        self.conbus_protocol.on_telegram_received.connect(self.telegram_received)
+        self.conbus_protocol.on_timeout.connect(self.timeout)
+        self.conbus_protocol.on_failed.connect(self.failed)
+
+        self.event_result = ConbusEventRawResponse(success=False)
+        self.logger = logging.getLogger(__name__)
+
+        # Event parameters
+        self.module_type_code: int = 0
+        self.link_number: int = 0
+        self.input_number: int = 0
+        self.time_ms: int = 1000
+        self.break_event_call: Optional[DelayedCall] = None
+
+    def connection_made(self) -> None:
+        """Handle connection established event."""
+        self.logger.debug("Connection established")
+        self.logger.debug("Sending MAKE event telegram")
+        self._send_make_event()
+
+    def _send_make_event(self) -> None:
+        """Send MAKE event telegram."""
+        payload = f"E{self.module_type_code:02d}L{self.link_number:02d}I{self.input_number:02d}M"
+        self.logger.debug(f"Sending MAKE event: {payload}")
+        self.conbus_protocol.telegram_queue.put_nowait(payload.encode())
+        self.conbus_protocol.call_later(0.0, self.conbus_protocol.start_queue_manager)
+
+        # Schedule BREAK event after delay
+        delay_seconds = self.time_ms / 1000.0
+        self.break_event_call = self.conbus_protocol.call_later(
+            delay_seconds, self._send_break_event
+        )
+
+    def _send_break_event(self) -> None:
+        """Send BREAK event telegram."""
+        payload = f"E{self.module_type_code:02d}L{self.link_number:02d}I{self.input_number:02d}B"
+        self.logger.debug(f"Sending BREAK event: {payload}")
+        self.conbus_protocol.telegram_queue.put_nowait(payload.encode())
+        self.conbus_protocol.call_later(0.0, self.conbus_protocol.start_queue_manager)
+
+    def telegram_sent(self, telegram_sent: str) -> None:
+        """Handle telegram sent event.
+
+        Args:
+            telegram_sent: The telegram that was sent.
+        """
+        self.logger.debug(f"Telegram sent: {telegram_sent}")
+        if self.event_result.sent_telegrams is None:
+            self.event_result.sent_telegrams = []
+        self.event_result.sent_telegrams.append(telegram_sent)
+
+    def telegram_received(self, telegram_received: TelegramReceivedEvent) -> None:
+        """Handle telegram received event.
+
+        Args:
+            telegram_received: The telegram received event.
+        """
+        self.logger.debug(f"Telegram received: {telegram_received.frame}")
+        if self.event_result.received_telegrams is None:
+            self.event_result.received_telegrams = []
+        self.event_result.received_telegrams.append(telegram_received.frame)
+
+        # Display progress - show ALL received telegrams
+        if self.progress_callback:
+            self.progress_callback(telegram_received.frame)
+
+    def timeout(self) -> None:
+        """Handle timeout event.
+
+        Timeout is the normal/expected way to finish this service.
+        """
+        timeout_seconds = self.conbus_protocol.timeout_seconds
+        self.logger.info("Event raw finished after timeout: %ss", timeout_seconds)
+        self.event_result.success = True
+        self.event_result.error = None
+        if self.finish_callback:
+            self.finish_callback(self.event_result)
+
+        self.stop_reactor()
+
+    def failed(self, message: str) -> None:
+        """Handle failed connection event.
+
+        Args:
+            message: Failure message.
+        """
+        self.logger.debug(f"Failed: {message}")
+        self.event_result.success = False
+        self.event_result.error = message
+        if self.finish_callback:
+            self.finish_callback(self.event_result)
+
+        self.stop_reactor()
+
+    def stop_reactor(self) -> None:
+        """Stop reactor."""
+        self.logger.info("Stopping reactor")
+        # Cancel break event call if it's still pending
+        if self.break_event_call and self.break_event_call.active():
+            self.break_event_call.cancel()
+        self.conbus_protocol.stop_reactor()
+
+    def start_reactor(self) -> None:
+        """Start reactor."""
+        self.logger.info("Starting reactor")
+        self.conbus_protocol.start_reactor()
+
+    def run(
+        self,
+        module_type_code: int,
+        link_number: int,
+        input_number: int,
+        time_ms: int,
+        progress_callback: Optional[Callable[[str], None]],
+        finish_callback: Callable[[ConbusEventRawResponse], None],
+        timeout_seconds: int = 5,
+    ) -> None:
+        """Run reactor in dedicated thread with its own event loop.
+
+        Args:
+            module_type_code: Module type code (numeric, e.g., 2 for CP20, 33 for XP33).
+            link_number: Link number (0-99).
+            input_number: Input number (0-9).
+            time_ms: Delay in milliseconds between MAKE and BREAK events.
+            progress_callback: Callback for progress updates (received telegrams).
+            finish_callback: Callback when operation completes.
+            timeout_seconds: Timeout in seconds (default: 5).
+        """
+        self.logger.info(
+            f"Starting event raw: module={module_type_code}, "
+            f"link={link_number}, input={input_number}, time={time_ms}ms"
+        )
+
+        self.module_type_code = module_type_code
+        self.link_number = link_number
+        self.input_number = input_number
+        self.time_ms = time_ms
+
+        self.conbus_protocol.timeout_seconds = timeout_seconds
+        self.progress_callback = progress_callback
+        self.finish_callback = finish_callback

{conson_xp-1.16.0 → conson_xp-1.18.0}/src/xp/services/protocol/conbus_event_protocol.py

@@ -7,7 +7,7 @@ import logging
 from queue import SimpleQueue
 from random import randint
 from threading import Lock
-from typing import Any, Optional
+from typing import Any, Callable, Optional
 
 from psygnal import Signal
 from twisted.internet import protocol
@@ -209,7 +209,27 @@ class ConbusEventProtocol(protocol.Protocol, protocol.ClientFactory):
             f"D{data_value}"
         )
         self.telegram_queue.put_nowait(payload.encode())
-        self._reactor.callLater(0.0, self.start_queue_manager)
+        self.call_later(0.0, self.start_queue_manager)
+
+    def call_later(
+        self,
+        delay: float,
+        callable_action: Callable[..., Any],
+        *args: object,
+        **kw: object,
+    ) -> DelayedCall:
+        """Schedule a callable to be called later.
+
+        Args:
+            delay: Delay in seconds before calling.
+            callable_action: The callable to execute.
+            args: Positional arguments to pass to callable.
+            kw: Keyword arguments to pass to callable.
+
+        Returns:
+            DelayedCall object that can be cancelled.
+        """
+        return self._reactor.callLater(delay, callable_action, *args, **kw)
 
     def buildProtocol(self, addr: IAddress) -> protocol.Protocol:
         """Build protocol instance for connection.
@@ -264,9 +284,7 @@ class ConbusEventProtocol(protocol.Protocol, protocol.ClientFactory):
     def _reset_timeout(self) -> None:
         """Reset the inactivity timeout."""
         self._cancel_timeout()
-        self.timeout_call = self._reactor.callLater(
-            self.timeout_seconds, self._on_timeout
-        )
+        self.timeout_call = self.call_later(self.timeout_seconds, self._on_timeout)
 
     def _cancel_timeout(self) -> None:
         """Cancel the inactivity timeout."""
@@ -320,7 +338,7 @@ class ConbusEventProtocol(protocol.Protocol, protocol.ClientFactory):
         telegram = self.telegram_queue.get_nowait()
         self.sendFrame(telegram)
         later = randint(10, 80) / 100
-        self._reactor.callLater(later, self.process_telegram_queue)
+        self.call_later(later, self.process_telegram_queue)
 
     def __enter__(self) -> "ConbusEventProtocol":
         """Enter context manager.

{conson_xp-1.16.0 → conson_xp-1.18.0}/src/xp/utils/dependencies.py

@@ -43,6 +43,7 @@ from xp.services.conbus.conbus_datapoint_service import (
     ConbusDatapointService,
 )
 from xp.services.conbus.conbus_discover_service import ConbusDiscoverService
+from xp.services.conbus.conbus_event_raw_service import ConbusEventRawService
 from xp.services.conbus.conbus_output_service import ConbusOutputService
 from xp.services.conbus.conbus_raw_service import ConbusRawService
 from xp.services.conbus.conbus_receive_service import ConbusReceiveService
@@ -180,6 +181,14 @@ class ServiceContainer:
             scope=punq.Scope.singleton,
         )
 
+        self.container.register(
+            ConbusEventRawService,
+            factory=lambda: ConbusEventRawService(
+                conbus_protocol=self.container.resolve(ConbusEventProtocol)
+            ),
+            scope=punq.Scope.singleton,
+        )
+
         self.container.register(
             ConbusBlinkService,
             factory=lambda: ConbusBlinkService(