diff --git a/source/_integrations/insteon.markdown b/source/_integrations/insteon.markdown index 1854ac59a16..082d5a1dd18 100644 --- a/source/_integrations/insteon.markdown +++ b/source/_integrations/insteon.markdown @@ -25,9 +25,9 @@ There is currently support for the following device types within Home Assistant: - Sensor - Switch -Device support is provided by the underlying [insteonplm] package. It is known to work with the [2413U] USB and [2412S] RS242 flavors of PLM and the [2448A7] USB stick. It has also been tested to work with the [2242] and [2245] Hubs. +Device support is provided by the underlying [pyinsteon] package. It is known to work with the [2413U] USB and [2412S] RS242 flavors of PLM and the [2448A7] USB stick. It has also been tested to work with the [2242] and [2245] Hubs. -[insteonplm]: https://github.com/nugget/python-insteonplm +[pyinsteon]: https://github.com/pyinsteon/pyinsteon [2413U]: https://www.insteon.com/powerlinc-modem-usb [2412S]: https://www.insteon.com/powerlinc-modem-serial [2448A7]: https://www.smarthome.com/insteon-2448a7-portable-usb-adapter.html @@ -81,9 +81,6 @@ insteon: unitcode: UNITCODE platform: PLATFORM steps: STEPS - x10_all_units_off: HOUSECODE - x10_all_lights_on: HOUSECODE - x10_all_lights_off: HOUSECODE ``` {% configuration %} @@ -159,23 +156,11 @@ x10_devices: required: false default: 22 type: integer -x10_all_units_off: - description: Creates a binary_sensor that responds to the X10 standard command for All Units Off. - required: false - type: string -x10_all_lights_on: - description: Creates a binary_sensor that responds to the X10 standard command for All Lights On - required: false - type: string -x10_all_lights_off: - description: Creates a binary_sensor that responds to the X10 standard command for All Lights Off - required: false - type: string {% endconfiguration %} ### Autodiscovery -The first time autodiscovery runs, the duration may require up to 20 seconds per device. Subsequent startups will occur much quicker using cached device information. If a device is not recognized during autodiscovery, you can add the device to the **device_override** configuration. +The first time autodiscovery runs, the duration may require up to 60 seconds per device. Subsequent startups will occur much quicker using cached device information. If a device is not recognized during autodiscovery, trigger the device, such as toggling a button, to force the device to send a message to the modem. The device will then be discovered. You may need to trigger the device a few times. If for any reason this approach does not work, you can add the device to the **device_override** configuration. In order for a device to be discovered, it must be linked to the INSTEON Modem as either a responder or a controller. @@ -189,13 +174,13 @@ In order for any two Insteon devices to talk with one another, they must be link - **insteon.print_all_link_database**: Print the All-Link Database for a device. Requires that the All-Link Database is loaded first. - **insteon.print_im_all_link_database**: Print the All-Link Database for the INSTEON Modem (IM). -If you are looking for more advanced options, you can use the [insteonplm_interactive] command line tool that is distributed with the [insteonplm] Python module. Please see the documentation on the [insteonplm] GitHub site. Alternatively, you can download [HouseLinc] which runs on any Windows PC, or you can use [Insteon Terminal] which is open source and runs on most platforms. SmartHome no longer supports HouseLinc, but it still works. Insteon Terminal is a very useful tool but please read the disclaimers carefully, they are important. +If you are looking for more advanced options, you can use the [insteon_tools] command line tool that is distributed with the [pyinsteon] Python module. Please see the documentation on the [pyinsteon] GitHub site. Alternatively, you can download [HouseLinc] which runs on any Windows PC, or you can use [Insteon Terminal] which is open source and runs on most platforms. SmartHome no longer supports HouseLinc, but it still works. Insteon Terminal is a very useful tool but please read the disclaimers carefully, they are important. [understanding linking]: https://www.insteon.com/support-knowledgebase/2015/1/28/understanding-linking [Development Tools]: /docs/tools/dev-tools/ [HouseLinc]: https://www.smarthome.com/houselinc.html [Insteon Terminal]: https://github.com/pfrommerd/insteon-terminal -[insteonplm_interactive]: https://github.com/nugget/python-insteonplm#command-line-interface +[insteon_tools]: https://github.com/pyinsteon/pyinsteon ### Customization @@ -211,21 +196,13 @@ INSTEON devices are added to Home Assistant using the platform(s) that make the There are two primary uses for the **device_override** feature: -- Devices that do not respond during autodiscovery. This is common for battery operated devices. +- Devices that do not respond during autodiscovery. This is common for battery operated devices. Before using a device override, please trigger the device a few times and it will likely be discovered by Home Assistant. - Devices that have not been fully developed. This allows an unknown device to be mapped to a device that operates similarly to another device. ### Example Configuration with Options ```yaml -# Full example of Insteon configuration with customizations and overrides - -homeassistant: - customize: - light.a1b2c3: - friendly_name: Bedside Lamp - binary_sensor.a2b3c4: - friendly_name: Garage Door - device_class: opening +# Full example of Insteon configuration with a device override insteon: port: /dev/ttyUSB0 @@ -311,14 +288,4 @@ automation: action: - service: light.turn_on entity_id: light.some_light -``` - -### Known Issues with the INSTEON Hub - -The INSTEON Hub has three known issues that are inherent to the design of the Hub: - -1. If you see multiple error messages in the log file stating the Hub connection is closed, and reconnection has failed, this generally requires the Hub to be restarted to reconnect. - -2. You cannot use both Home Assistant and the INSTEON app. If you do, the changes made in the app will not appear in Home Assistant. Changes made in Home Assistant will appear in the app after a period of time, however. - -3. The Hub response times can be very slow. This is due to the Hub polling devices frequently. Since only one INSTEON message can be broadcast at a time, messages to and from Home Assistant can be delayed. +```