Skip to main content

Home Automation Setup

This page provides the Electrolama-specific details needed to connect a supported radio to home-automation software. It starts after coordinator firmware is installed and the host can see the radio's serial port. Use the Radio Sticks guide or Radio HATs guide first.

Use the project's own documentation

Zigbee2MQTT, Home Assistant ZHA and Zigbee for Domoticz change independently of Electrolama hardware. Their documentation is the source of truth for installation, supported platforms, current configuration fields, UI steps, backups, migrations and application-specific troubleshooting:

Use this page to identify the correct Electrolama serial path, radio family and adapter settings, then follow the chosen project's current guide for everything above that boundary. If an upstream guide differs from an example here, follow the upstream guide.

Serial port​

  • USB sticks on Linux: prefer /dev/serial/by-id/... rather than /dev/ttyUSB0.
  • Radio HATs: use /dev/serial0 after disabling the Linux serial console.
  • Windows: use the COM port shown in Device Manager.

Only one application can own the port at a time. Stop flashing tools, serial monitors and other Zigbee services before starting the chosen application.

Zigbee2MQTT​

Start with the current Zigbee2MQTT installation guide for your operating system or deployment method. Zigbee2MQTT can automatically discover many USB adapters, in which case no serial section is needed. If discovery fails, or when using a HAT, configure the serial path explicitly. The current Zigbee2MQTT adapter value for Electrolama's TI CC13x2/CC26x2 radios is zstack:

serial:
  port: /dev/serial/by-id/YOUR_ELECTROLAMA_RADIO
  adapter: zstack

For a zoe/zoe2 HAT, change the port to /dev/serial0.

The omitted serial defaults are 115200 baud and hardware flow control disabled, which are correct for these radios. Zigbee2MQTT still supports the optional baudrate and rtscts fields, but repeating default values adds noise and can make an example look more prescriptive than it is.

The current Zigbee2MQTT adapter settings and TI zStack adapter pages are the source of truth for configuration fields, supported firmware and any platform-specific requirements. The ezsp to ember adapter-name change applies to Silicon Labs radios; it does not rename the zstack value used by these TI radios.

Home Assistant ZHA​

Follow the current Home Assistant ZHA documentation for installation, supported deployment types and the latest interface. For an Electrolama TI CC13x2/CC26x2 radio, the essential choices are its serial path and the ZNP radio type.

  1. Connect the radio and restart Home Assistant so hardware discovery runs.
  2. Go to Settings → Devices & services.
  3. Accept the discovered radio, or select Add Integration → Zigbee Home Automation.
  4. Choose the radio's serial path.
  5. If automatic radio detection fails, select znp for TI CC13x2/CC26x2 hardware.

Use the upstream documentation—not this summary—for container device mapping, backups, coordinator migration, channel changes and recovery.

Zigbee for Domoticz​

Zigbee for Domoticz uses the zigpy radio libraries and supports TI ZNP coordinators. Follow its current installation and configuration pages; the steps below identify only the Electrolama-specific connection choices.

  1. Confirm that Domoticz has permission to open the serial device.
  2. Install the plugin using its current documentation.
  3. Select the TI/ZNP transport and the correct serial path.

Gateway host recommendations​

  • Use a dedicated host or appliance image when practical.
  • Keep current backups of the application and Zigbee coordinator state.
  • Prefer wired Ethernet for a fixed gateway.
  • Put a USB radio on a shielded extension cable, away from the host and USB 3 storage.
  • Do not run two coordinator applications against the same serial port.

For software startup and network problems, continue with Zigbee Troubleshooting. For USB, UART, firmware or bootloader problems, use TI CC Series Radios Troubleshooting.

Last updated on