Home Assistant 中文网

Insteon PLM

This component adds “local push” support for INSTEON PowerLinc Modems allowing linked INSTEON devices to be used within Home Assistant as lights, switches, and binary sensors. Device support is provided by the underlying insteonplm package. It is known to work with both the 2413U USB and 2412S RS242 flavors of PLM. This component does not work with the IP-based hub products. For that, you’ll want the “Insteon (Local)” component instead.

# insteon_plm supported configuration variables
insteon_plm:
  port: SERIAL_PORT
  device_override:
     - address: INSTEON_ADDRESS
       platform: DEVICE_PLATFORM

Configuration variables:

  • port (Required): The port for your device, e.g. /dev/ttyUSB0
  • device_override (Optional): Override the default device platform

Customization

The only configuration item that is absolutely necessary is the port so that Home Assistant can connect to the PLM. This will expose all the supported INSTEON devices which exist in the modem’s ALL-Link database. However, devices will only be shown by their INSTEON hex address (e.g. “1A.2B.3C”) which can be a bit unwieldy. As you link and unlink devices using the ‘Set’ buttons, they’ll be added and removed from Home Assistant automatically.

You can use the normal Home Assistant device customization section of your configuration to assign friendly names and special icons to your devices. This is especially useful for setting device_class on your binary_sensor INSTEON devices.

Device Overrides

INSTEON devices are added to Home Assistant using the platform(s) that make the most sense given the model and features of the hardware. In most cases this is unambiguous, but sometimes the component will not be able to guess the actual usage of the device. For example, there might be a table lamp plugged into an INSTEON appliance relay module. By default, this will show as a ‘switch’ device in Home Assistant, but it really should be a ‘light’ device. For exceptions like this, the component supports a device plaform override. You can set any device (by address) to explicitly use a specific platform if the default is not correct.

Example Configuration with Options

# Full example of insteon_plm configuration with customizations and overrides

homeassistant:
  customize:
    light.a1b2c3:
      friendly_name: Bedside Lamp
    binary_sensor.a2b3c4:
      friendly_name: Garage Door
      device_class: opening

insteon_plm:
  port: /dev/ttyUSB0
  device_override:
    - address: a1b2c3  # Icon Appliance Module for bedside lamp
      platform: light  # make it a light instead of a switch