Skip to content

kgstorm/ha-spa-card

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Spa Lovelace Card

Home Assistant Lovelace card to control a spa/hot tub.

Spa Card

This card is designed to work with any spa integration by entering your existing spa entities into the corresponding entries in the spa-card configuration.

HACS Install

Open your Home Assistant instance and show this repository in HACS

  1. Open HACS in Home Assistant.
  2. Add this repository as a custom repository with type Dashboard.
  3. Install Spa Card.
  4. Go to any dashboard, click Add Card, and search for Spa Card.

Manual Install

  1. Copy dist/spa-card.js to config/www/spa-card.js.
  2. Add dashboard resource:
    • URL: /local/spa-card.js
    • Type: JavaScript Module
  3. Go to any dashboard, click Add Card, and search for Spa Card.

Basic Card Config

type: custom:spa-card
title: Hot Tub
preset_hot: 103
preset_cold: 98

Entity Config

type: custom:spa-card
title: Spa
entity_temp_current: sensor.spa_water_temp
entity_temp_set: sensor.spa_set_temp
entity_heater_status: binary_sensor.spa_heater
entity_pump_status: binary_sensor.spa_pump
entity_lights_status: binary_sensor.spa_lights
entity_button_temp_up: button.spa_temp_up
entity_button_temp_down: button.spa_temp_down
entity_button_pump: button.spa_toggle_pump
entity_button_lights: button.spa_toggle_lights
preset_hot: 103
preset_cold: 98

One-Button Temperature Mode

For spas that only expose one temperature button, enable one-button mode and map the cycle button:

type: custom:spa-card
title: Spa
entity_temp_current: sensor.spa_water_temp
entity_temp_set: sensor.spa_set_temp
entity_heater_status: binary_sensor.spa_heater
entity_pump_status: binary_sensor.spa_pump
entity_lights_status: binary_sensor.spa_lights
entity_button_temp_cycle: button.spa_temp_cycle
entity_button_pump: button.spa_toggle_pump
entity_button_lights: button.spa_toggle_lights
temp_control_mode: one_button
temp_cycle_direction: up
temp_min: 80
temp_max: 104
preset_hot: 103
preset_cold: 98

One-button mode will keep pressing the cycle button until the target temperature is reached. It wraps at the limits (for example, max to min when cycling up).

Config Options

  • title: Optional title text
  • entity_temp_current: Optional current water temperature sensor entity id
  • entity_temp_set: Optional setpoint temperature sensor entity id
  • entity_heater_status: Optional heater status binary sensor entity id
  • entity_pump_status: Optional pump status binary sensor entity id
  • entity_lights_status: Optional lights status binary sensor entity id
  • entity_button_temp_up: Optional button entity id for temperature up
  • entity_button_temp_down: Optional button entity id for temperature down
  • entity_button_temp_cycle: Optional single cycle button entity id for one-button spas
  • entity_button_pump: Optional button entity id for pump toggle
  • entity_button_lights: Optional button entity id for lights toggle
  • preset_hot: Preset hot target
  • preset_cold: Preset cold target
  • show_presets: Show or hide preset buttons (default true)
  • temp_unit: Temperature unit to display and control ("C" or "F")
  • temp_control_mode: two_button (default) or one_button
  • temp_cycle_direction: up (default) or down for one-button cycling direction
  • temp_min: Minimum setpoint used for one-button wrap logic (default 80)
  • temp_max: Maximum setpoint used for one-button wrap logic (default 104)

About

Generic Home Assistant Lovelace card for spa/hot tub control

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors