In the realm of smart home automation, Comelit stands out as a provider of sophisticated and integrated systems. For professionals and advanced users managing these systems, efficiency and direct control are paramount. This is where the Comelit Scan Tool, embodied in the form of a Command Line Interface (CLI), becomes an indispensable asset. While not a traditional scan tool in the automotive sense, this CLI provides a powerful text-based interface to diagnose, configure, and control your Comelit smart home ecosystem.
This article delves into the functionalities of the Comelit CLI, exploring how it acts as a comprehensive Comelit scan tool for various Comelit devices, including the HUB, Serial Bridge, and Vedo Alarm systems. We will guide you through its installation, basic usage, and the range of commands available to effectively manage and troubleshoot your Comelit setup.
Understanding the Comelit CLI as a Diagnostic Tool
The term “scan tool” often evokes images of devices used in automotive diagnostics to read error codes and system data. The Comelit CLI, while operating through commands rather than a graphical interface, serves a similar purpose for your smart home. It allows you to “scan” your Comelit system, retrieving configuration details, device statuses, and enabling direct interventions for troubleshooting or system adjustments.
Think of the Comelit CLI as a professional-grade Comelit scan tool that empowers you to:
- Diagnose system issues: Quickly check the status of various devices and identify potential problems.
- Configure devices: Manage settings and configurations directly through text commands.
- Control your smart home: Activate devices, adjust settings, and automate tasks via command-line instructions.
- Gain deeper insights: Access detailed system information not always readily available through standard user interfaces.
This tool is especially valuable for installers, system integrators, and technically inclined users who require precise control and detailed feedback from their Comelit systems.
Installation: Setting up Your Comelit Scan Tool Environment
Before you can leverage the Comelit CLI as your go-to Comelit scan tool, you need to install it. The process is straightforward using npm, the package manager for Node.js.
To install the Comelit CLI, open your terminal or command prompt and execute the following command:
npm install -g comelit-client@latestThis command globally installs the comelit-client package, providing you with access to the comelit, vedo, and comelit-sb commands, each tailored to interact with different Comelit components.
Exploring the Comelit CLI Commands: Your Diagnostic Toolkit
The Comelit CLI suite comprises several specialized commands, each acting as a specific Comelit scan tool module for different parts of your system. Let’s explore the key commands and their functionalities:
1. comelit: Interacting with the Comelit HUB
The comelit command is your primary Comelit scan tool interface for the Comelit HUB, the central brain of modern Comelit smart home systems. This HUB utilizes MQTT for real-time updates and communication.
Basic Usage:
To start using the comelit tool, simply type comelit in your terminal. The CLI can often automatically discover your HUB on the network. However, you can also specify the HUB’s IP address using the -h option:
comelit -h HUB_IPKey comelit Commands:
comelit rooms --list: This command acts as a room scanner, listing all configured rooms within your Comelit system. This is useful for verifying your system’s structure and device organization.
comelit rooms --listGEN#PL#0 - root GEN#PL#1 - Living room GEN#PL#2 - Kitchen GEN#PL#3 - Hallway GEN#PL#4 - Room 1 GEN#PL#5 - Room 2 GEN#PL#6 - Bedroom GEN#PL#7 - Bathroom 1 GEN#PL#8 - Bathroom 2 GEN#PL#9 - Terracecomelit lights --list: This command functions as a light scanner, providing a list of all lights integrated into your Comelit HUB, along with their current status (ON or OFF). This allows for quick diagnostics of lighting devices.
comelit lights --listDOM#LT#0 - Entrance spotlights (status ON) DOM#LT#1 - Main entrance (status OFF) DOM#LT#2 - Kitchen (status OFF) DOM#LT#3 - Main living room (status OFF) DOM#LT#4 - Spotlights living room (status OFF) DOM#LT#5 - Bedroom left (status OFF) DOM#LT#6 - Bedroom right (status OFF) DOM#LT#7 - Bathroom 1 (status OFF) DOM#LT#8 - Bathroom 2 (status OFF) DOM#LT#9 - Terrace (status OFF)comelit lights --toggle DOM#LT#3: Acting as a light control tool, this command toggles the state of a specific light. ReplaceDOM#LT#3with the ID of the light you wish to control, obtained from thelights --listcommand.
comelit lights --toggle DOM#LT#3comelit shutters --list: A shutter scanner, this command lists all configured shutters or blinds connected to your Comelit system.
comelit shutters --listcomelit shutters --toggle DOM#BL#0: This acts as a shutter control tool, toggling the open/close state of a shutter. ReplaceDOM#BL#0with the appropriate shutter ID.
comelit shutters --toggle DOM#BL#0comelit outlets --list: This command serves as an outlet scanner, displaying a list of controllable outlets in your Comelit setup.
comelit outlets --listcomelit outlets --toggle DOM#LC#0: Functioning as an outlet control tool, this command toggles the power state of a specific outlet. ReplaceDOM#LC#0with the outlet ID.
comelit outlets --toggle DOM#LC#0comelit clima --list: As a climate control scanner, this command lists thermostats and dehumidifiers integrated with your Comelit HUB.
comelit clima --listcomelit clima --toggle DOM#CL#0: A thermostat control tool, this command toggles the on/off state of a thermostat. ReplaceDOM#CL#0with the thermostat ID.
comelit clima --toggle DOM#CL#0comelit clima --toggle DOM#CL#0 --temp 21.5: This command allows you to adjust thermostat temperature, setting the desired temperature in Celsius.
comelit clima --toggle DOM#CL#0 --temp 21.5comelit clima --toggle DOM#CL#0 --season [summer|winter]: A season setting tool for thermostats, allowing you to switch between summer and winter modes.
comelit clima --toggle DOM#CL#0 --season [summer|winter]2. comelit-sb: Managing the Comelit Serial Bridge
The comelit-sb command is your Comelit scan tool for interacting with older Comelit Serial Bridge models. These bridges utilize polling for status updates.
Basic Usage:
To use the comelit-sb command, you typically need to specify the Serial Bridge’s IP address and port (default port is 80).
comelit-sb -h SERIAL_BRIDGE_IP -p PORTKey comelit-sb Commands:
Many commands mirror the comelit command but are adapted for the Serial Bridge.
comelit-sb rooms --list: Lists rooms configured in the Serial Bridge system.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT rooms --listGEN#PL#0 - root GEN#PL#1 - Living room GEN#PL#2 - Kitchen GEN#PL#3 - Hallway GEN#PL#4 - Room 1 GEN#PL#5 - Room 2 GEN#PL#6 - Bedroom GEN#PL#7 - Bathroom 1 GEN#PL#8 - Bathroom 2 GEN#PL#9 - Terracecomelit-sb lights --list: Lists lights connected to the Serial Bridge.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT lights --list0 - Entrance spotlights (status ON) 1 - Main entrance (status OFF) 2 - Kitchen (status OFF) 3 - Main living room (status OFF) 4 - Spotlights living room (status OFF) 5 - Bedroom left (status OFF) 6 - Bedroom right (status OFF) 7 - Bathroom 1 (status OFF) 8 - Bathroom 2 (status OFF) 9 - Terrace (status OFF)comelit-sb lights --toggle 3: Toggles the state of a light, using the numerical index from thelights --listoutput.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT lights --toggle 3comelit-sb shutters --list: Lists shutters connected to the Serial Bridge.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT shutters --listcomelit-sb shutters --toggle 0: Toggles the state of a shutter, using its numerical index.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT shutters --toggle 0comelit-sb outlets --list: Lists outlets connected to the Serial Bridge.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT outlets --listcomelit-sb outlets --toggle 0: Toggles the state of an outlet, using its numerical index.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT outlets --toggle 0comelit-sb clima --list: Lists thermostats and dehumidifiers connected to the Serial Bridge.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT clima --listcomelit-sb clima --toggle 0: Toggles the state of a thermostat, using its numerical index.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT clima --toggle 0comelit-sb clima --toggle 0 --temp 21.5: Sets the temperature of a thermostat.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT clima --toggle 0 --temp 21.5comelit-sb clima --toggle 0 --season [summer|winter]: Sets the season mode of a thermostat.
comelit-sb -h SERIAL_BRIDGE_IP -p PORT clima --toggle 0 --season [summer|winter]3. vedo: Controlling Comelit Vedo Alarm Systems
The vedo command provides Comelit scan tool capabilities specifically for Comelit Vedo Alarm systems.
Basic Usage:
When using the vedo command, you must provide the IP address and port of the VEDO Web UI.
vedo -h VEDO_IP -p PORTKey vedo Commands:
vedo area --desc --code: Retrieves descriptions of configured areas in your Vedo alarm system, acting as an area description scanner.
vedo -h VEDO_IP -p PORT area --desc --codevedo area --status --code: Checks the status of all areas, functioning as an area status scanner.
vedo -h VEDO_IP -p PORT area --status --codevedo area --active --code: Lists active areas within the Vedo system, acting as an active area scanner.
vedo -h VEDO_IP -p PORT area --active --codevedo area --arm 32 --code: Arms the entire Vedo system (area 32), serving as an alarm arming tool.
vedo -h VEDO_IP -p PORT area --arm 32 --codevedo area --arm 32 --shortcut p1 --code: Arms the system using a specific shortcut (p1 in this example), providing shortcut-based arming.
vedo -h VEDO_IP -p PORT area --arm 32 --shortcut p1 --codevedo area --disarm 32 --code: Disarms the entire Vedo system, functioning as an alarm disarming tool.
vedo -h VEDO_IP -p PORT area --disarm 32 --codevedo zone --desc --code: Retrieves descriptions of configured zones, acting as a zone description scanner.
vedo -h VEDO_IP -p PORT zone --desc --codevedo zone --status --code: Checks the status of zones within the Vedo system, working as a zone status scanner.
vedo -h VEDO_IP -p PORT zone --status --code4. icona: Alpha Support for ICONA Manager
The icona command offers preliminary support for Comelit ICONA Manager integration.
Basic Usage:
Using icona requires obtaining a secret token as described in the Comelit Client Wiki.
icona -t SECRET_TOKEN -h BRIDGE_HOST -p BRIDGE_PORTKey icona Commands:
icona get-config all: Retrieves the entire system configuration via ICONA, acting as a configuration scanner.
icona -t SECRET_TOKEN -h BRIDGE_HOST -p BRIDGE_PORT get-config allicona list-doors: Lists manageable doors and gates within the ICONA system, serving as a door scanner.
icona -t SECRET_TOKEN -h BRIDGE_HOST -p BRIDGE_PORT list-doors[INFO] out - Available doors: [INFO] out - - id: 0 name: CANCELLO apt-address: '00000100' output-index: 2 secure-mode: false [INFO] out - Available actuators: [INFO] out - - id: 0 name: Actuator apt-address: SBIO0255 module-index: 255 output-index: 1icona open-door CANCELLO: Opens a specific door or gate, acting as a door control tool.
icona -t SECRET_TOKEN -h BRIDGE_HOST -p BRIDGE_PORT open-door CANCELLOicona open-door Actuator --type actuator: Opens an actuator, providing actuator control.
icona -t SECRET_TOKEN -h BRIDGE_HOST -p BRIDGE_PORT open-door Actuator --type actuatorConclusion: Comelit CLI – Your Essential Smart Home Scan Tool
The Comelit CLI, while technically a command-line interface, functions effectively as a Comelit scan tool, offering a powerful and versatile method for managing, diagnosing, and controlling your Comelit smart home system. Whether you are an installer configuring a new system, a technician troubleshooting issues, or an advanced user seeking granular control, the CLI provides the tools you need.
By mastering these commands, you gain a deeper level of access and insight into your Comelit ecosystem, empowering you to optimize performance and ensure seamless smart home operation. Embrace the power of the Comelit CLI and unlock the full potential of your Comelit smart home.
