List all available serial ports on the system.

This tool scans the system for available serial ports and returns detailed information about each port including device path, manufacturer, and serial number.

Args: params (ListPortsInput): Validated input parameters containing: - response_format (ResponseFormat): Output format (default: 'markdown')

Returns: str: Formatted list of serial ports.

Success response format: For JSON: Array of port objects with path, manufacturer, serialNumber, etc. For Markdown: Formatted list with port details

Error response: "Error: "

Open a serial port connection.

Opens a new serial port connection with specified parameters. Returns a connection ID that must be used for subsequent operations on this port.

Args: params (OpenPortInput): Validated input parameters containing: - port (str): Serial port path (e.g., 'COM3', '/dev/ttyUSB0') - baud_rate (int): Baud rate (default: 9600) - data_bits (int): Data bits, 5-8 (default: 8) - stop_bits (float): Stop bits, 1.0-2.0 (default: 1.0) - parity (str): Parity: 'N', 'E', or 'O' (default: 'N')

Returns: str: Connection ID or error message.

Success response: "Connection opened: conn_1" Error response: "Error: "

Close a serial port connection.

Closes the specified serial port connection and releases resources. The connection ID becomes invalid after closing.

Args: params (ClosePortInput): Validated input parameters containing: - connection_id (str): Connection ID returned by serial_open

Returns: str: Success message or error message.

Success response: "Connection closed: conn_1" Error response: "Error: Connection 'conn_1' not found"

Write data to a serial port connection.

Writes the specified data string to the serial port using the specified encoding.

Args: params (WriteDataInput): Validated input parameters containing: - connection_id (str): Connection ID returned by serial_open - data (str): Data to write as a string - encoding (str): Text encoding (default: 'utf-8') - timeout (float): Write timeout in seconds (default: 5.0)

Returns: str: Success message with bytes written or error message.

Success response: "Wrote 12 bytes to conn_1" Error response: "Error: Connection 'conn_1' not found or not open"

Read data from a serial port connection.

Reads available data from the serial port up to the specified maximum bytes. Times out after the specified timeout period if no data is available.

Args: params (ReadDataInput): Validated input parameters containing: - connection_id (str): Connection ID returned by serial_open - max_bytes (int): Maximum bytes to read (default: 1024, max: 65536) - timeout (float): Read timeout in seconds (default: 1.0) - encoding (str): Text encoding (default: 'utf-8') - response_format (ResponseFormat): Output format (default: 'markdown')

Returns: str: Formatted data or error message.

Success format for JSON: { "connection_id": "conn_1", "bytes_read": 42, "hex": "48656c6c6f", "data": "Hello", "timestamp": "2024-01-15T10:30:00Z" }

Error response: "Error: Connection 'conn_1' not found or not open"

Set control signal states on a serial port connection.

Sets the DTR (Data Terminal Ready) and/or RTS (Request To Send) control signals.

Args: params (SetSignalsInput): Validated input parameters containing: - connection_id (str): Connection ID returned by serial_open - dtr (Optional[bool]): DTR signal state (True=HIGH, False=LOW, None=unchanged) - rts (Optional[bool]): RTS signal state (True=HIGH, False=LOW, None=unchanged)

Returns: str: Success message or error message.

Success response: "Signals set on conn_1: DTR=HIGH, RTS=LOW" Error response: "Error: Connection 'conn_1' not found or not open"

Read the current state of serial port signals.

Returns the current state of all control signals including input signals (CTS, DSR, DCD) and output signals (DTR, RTS).

Args: params (GetSignalsInput): Validated input parameters containing: - connection_id (str): Connection ID returned by serial_open - response_format (ResponseFormat): Output format (default: 'markdown')

Returns: str: Formatted signal states or error message.

Success format for JSON: { "connection_id": "conn_1", "dtr": true, "rts": false, "cts": true, "dsr": true, "dcd": false }

Error response: "Error: Connection 'conn_1' not found or not open"

List all active serial port connections.

Returns information about all currently open serial port connections.

Args: params (ListConnectionsInput): Validated input parameters containing: - response_format (ResponseFormat): Output format (default: 'markdown')

Returns: str: Formatted list of connections or empty message.

Success format for JSON: [ { "id": "conn_1", "port": "COM3", "baud_rate": 9600, "path": "COM3", "is_open": true, "created_at": "2024-01-15T10:30:00Z" } ]

Error response: "No active connections"