From c0527c2e5476b13185b5c276498212a3041c5107 Mon Sep 17 00:00:00 2001 From: shbatm Date: Fri, 13 Jan 2023 13:19:29 -0600 Subject: [PATCH] Remove manual configuration details from ISY994 (#25718) Co-authored-by: J. Nick Koston --- source/_integrations/isy994.markdown | 60 +++++----------------------- 1 file changed, 9 insertions(+), 51 deletions(-) diff --git a/source/_integrations/isy994.markdown b/source/_integrations/isy994.markdown index 33bc50fcf4e..d09479cd1d0 100644 --- a/source/_integrations/isy994.markdown +++ b/source/_integrations/isy994.markdown @@ -59,59 +59,17 @@ ISY Networking Module Resources can be executed using the buttons created. {% include integrations/config_flow.md %} -## Manual configuration - -You may also configure the integration manually by adding the following section to your `configuration.yaml` file: - -```yaml -# Example configuration.yaml entry -isy994: - host: ISY_ADDRESS - username: ISY_USERNAME - password: ISY_PASSWORD -``` - -{% configuration %} -host: - description: The host entry should be in full URL format, e.g., `http://192.168.10.100:80` - required: true - type: string -username: - description: The username that is used to access the ISY interface. - required: true - type: string -password: - description: The password that is used to access the ISY interface. - required: true - type: string -sensor_string: - description: This is the string that is used to identify which devices are to be assumed to be sensors instead of lights or switches. If this string is found in the device name or folder, Home Assistant will assume it is a sensor or binary sensor (if the device has on/off or true/false states). This is only necessary for nodes that are not automatically detected as sensors by Home Assistant. Insteon door, window, motion and leak sensors should all be detected automatically. - required: false - type: string - default: sensor -variable_sensor_string: - description: This is the string that is used to identify which Integer or State Variables are to be added as sensors. If this string is found in the device name, Home Assistant will assume it is a sensor. - required: false - type: string - default: sensor -ignore_string: - description: Any devices that contain this string in their name (or folder path) will be ignored by Home Assistant. They will not become entities at all and will not fire `control_events`. - required: false - type: string - default: {IGNORE ME} -tls: - description: This entry should reflect the version of TLS that the ISY controller is using for HTTPS encryption. This value can be either 1.1 or 1.2. If this value is not set, it is assumed to be version 1.1. This is the default for most users. ISY994 Pro users may likely be using 1.2. When using HTTPS in the host entry, it is best practice to set this value. - required: false - type: string -restore_light_state: - description: If disabled (default behavior), lights turned ON from Home Assistant without a `brightness` parameter set, will turn on to the `on_level` set within the physical device. For example, on Insteon devices this would be the same brightness as if the switch/device was turned ON. If this setting is enabled, lights that are turned on from Home Assistant will go to the last known brightness value. Both the `on_level` and `last_brightness` values are available as attributes if needed for device-specific customization. - required: false - type: boolean - default: false -{% endconfiguration %} - Once the ISY controller is configured, it will automatically import any binary sensors, covers, fans, lights, locks, sensors and switches it can locate. +### Configuration Options + +There are several options available to further customize what is imported from the ISY controller and entity behavior. + +- Sensor String: This is the string that is used to identify which devices are to be assumed to be sensors instead of lights or switches. If this string is found in the device name or folder, Home Assistant will consider it a sensor or binary sensor (if the device has on/off or true/false states). This is only necessary for nodes that are not automatically detected as sensors by Home Assistant. Insteon door, window, motion, and leak sensors should all be detected automatically. +- Variable Sensor String: This is the string that is used to identify which Integer or State Variables are to be enabled by default as `number` entities. If this string is found in the device name, Home Assistant will assume it is a sensor. The default is `"HA."`. +- Ignore String: Any devices that contain this string in their name (or folder path) will be ignored by Home Assistant. They will not become entities and will not fire `control_events`. The default is `"{IGNORE ME}"`. +- Restore Light State: If disabled (default behavior), lights turned ON from Home Assistant without a `brightness` parameter set will turn on to the `on_level` set within the physical device. For example, on Insteon devices, this would be the same brightness as if the switch/device was turned ON. If this setting is enabled, lights that are turned on from Home Assistant will go to the last known brightness value. Both the `on_level` and `last_brightness` values are available as attributes if needed for device-specific customization. + ### Sensors An Insteon door/window sensor will show up as a single Binary Sensor rather than two discrete devices like it does in the ISY Admin Console. Note that when in "Two Nodes" mode, the sensor will have an UNKNOWN state until the sensor changes for the first time since the last Home Assistant reboot. If you do not use Insteon scenes that are controlled directly from the door sensor, you may prefer to set the sensor to "One Node" mode using the ISY Admin Panel.