2.6 KiB

title, description, ha_category, ha_release, ha_iot_class, ha_domain, ha_platforms
title description ha_category ha_release ha_iot_class ha_domain ha_platforms
Venstar Instructions for how to integrate Venstar WiFi thermostats within Home Assistant.
Climate
0.62 Local Polling venstar
climate

The venstar climate platform allows you to control Venstar thermostats from Home Assistant. Venstar thermostats feature a local API that allows for automation without the need for their Skyport cloud service.

Currently supported and tested thermostats:

  • ColorTouch T7900
  • ColorTouch T7850 (No Humidity control)
  • Explorer Mini T2000

Currently supported functionality:

  • Setting heat/cool temperature when the thermostat is in the appropriate mode.
  • Changing the operation mode of the thermostat (heat/cool/off/auto)
  • Turning the fan on/off
  • Reading and setting the humidity level and limits (T7900 only)
  • Turning on away preset
  • Turning on hold mode preset

The following values are supported for the preset_mode state attribute:

  • none: Enables the scheduling functionality.
  • temperature: Disables the schedule and holds the set temperature indefinitely.
  • away: Places the thermostat in away mode

Note - Please ensure that you update your thermostat to the latest firmware. Initially tested on firmware 5.10 and currently VH6.79.

Local API mode needs to be enabled via the thermostat's Menu > WiFi > Local API Options > Local API - ON

To set it up, add the following information to your configuration.yaml file:

# Example configuration.yaml entry
climate:
  - platform: venstar
    host: IP_OR_HOSTNAME_OF_THERMOSTAT

{% configuration %} host: description: Address of your thermostat, e.g., 192.168.1.32. required: true type: string username: description: Username for the thermostat. required: false type: string password: description: Password for the thermostat. required: false type: string pin: description: Pin for Lockscreen (required if lock screen enabled) required: false type: string ssl: description: Whether to use SSL or not when communicating. required: false type: boolean default: false timeout: description: Number of seconds for API timeout. required: false type: integer default: 5 humidifier: description: Report humidity and expose humidifier setpoints. required: false type: boolean default: true {% endconfiguration %}

Full configuration sample

# Example configuration.yaml entry
climate:
  - platform: venstar
    host: IP_OR_HOSTNAME_OF_THERMOSTAT
    ssl: true
    username: OPTIONAL_AUTH_USER_HERE
    password: OPTIONAL_AUTH_PASS_HERE
    pin: LOCKSCREEN_PIN
    timeout: 5
    humidifier: false