switcher-boiler-card

What is switcher-boiler-card ?

Custom Switcher Boiler Switch card for Home Assistant. Built to work with official Switcher Integration for Home Assistant. The card designed to look and feel similar to other Tile cards in HA.

Welcome to our Smart Home Israel Discord channel to discuss.

For any question, feel free to leave comment in my HA Community post.

Features

• Fully supports HA UI Editor (no need to edit YAML code).
• Displays remaining time in state field.
• Optional additional 2 sensors to display in state field. Sensor 1 to be displayed when Switcher is On. Sensor 2 to be displayed when Switcher is On and Off.
• Optional icon sensor, very useful to display water temperature (if you have it installed separatelly), instead if icon.
• Optional temperature color thresholds when icon sensor is being used.
• Optional, configurable color thresholds for Cold and Hot limits, when icon sensor is being used.
• The time selection button loops through configurable timer values in minutes, when clicked.
• Turn on with or without selected timer.
• Support editing in YAML as well (please see table below).

Installation

HACS

Switcher Boiler Card is available in HACS (Home Assistant Community Store).

Use this link to directly go to the repository in HACS

or

1. Install HACS if you don't have it already
2. Open HACS in Home Assistant
3. Search for "Switcher Boiler Card"
4. Click the download button.

Manual

1. Download switcher-boiler-card.js file from the latest release.
2. Put switcher-boiler-card.js file into your config/www/switcher-boiler-card folder.
3. Add reference to switcher-boiler-card.js in Dashboard. There's two way to do that:
   • Using UI: Settings → Dashboards → More Options icon → Resources → Add Resource → Set Url as /local/switcher-boiler-card/switcher-boiler-card.js → Set Resource type as JavaScript Module. Note: If you do not see the Resources menu, you will need to enable Advanced Mode in your User Profile
   • Using YAML: Add following code to lovelace section.

     resources:
         - url: /local/switcher-boiler-card/switcher-boiler-card.js
           type: module

Usage

UI Editor

The card can be fully configured from HA UI Editor.

YAML configuration

Name	Description	Required	Default
type	custom:switcher-boiler-card	yes
entity	Switcher switch entity	yes
name	Card name. Leave empty to take entity friendly name.	no	"Boiler"
icon	Card icon. Leave empty to take icon from entity.	no	"mdi:waves"
time_left	Time left sensor entity. Leave empty if you don't want it to be displayed.	no
sensor_1	Sensor 1 entity. Displayed only when Switcher is On.	no
sensor_2	Sensor 2 entity. Displayed when Switcher is On and Off.	no
icon_sensor	Icon Sensor entity. Displayed when Switcher is On and Off. Must be numeric.	no
color_thresholds	temperature color thresholds for icon sensor.	no	false
cold_threshold	Cold threshold upper limit.	no	20
hot_threshold	Hot threshold lower limit.	no	50
temp_resolution	Temperature resolution for decimal digits (0, 1 or 2).	no	1
timer_values	List of values for timer in minutes (from 1 to 150).	no	15, 30, 45, 60

Example:

type: custom:switcher-boiler-card
entity: switch.switcher_touch_d54f
name: Boiler
icon: mdi:waves
time_left: sensor.switcher_touch_d54f_remaining_time
sensor_1: sensor.switcher_touch_d54f_current
icon_sensor: sensor.switcher_water_temperature
color_thresholds: true
cold_threshold: 20
hot_threshold: 50
temp_resolution: 1
timer_values:
  - "15"
  - "30"
  - "45"
  - "60"

Development server

Home assistant container

You can run a Home Assistant with docker by running:

npm run start:hass

Once it's done, go to Home Assistant instance http://localhost:8123 and start configuration.

Windows Users

npm run start:hass-cmd

Development

In another terminal, install dependencies and run development server:

npm install
npm run watch

Server will start on port 4000.

Build

You can build the switcher-boiler-card.js file in dist folder without server by running the build command.

npm run build

Optional

Remaning Time Sensor

You can use the below Template Sensor in HA to display the Remeaning Time sesnor in more user frinedly way.
Just replace switch.switcher_touch_d54f and sensor.switcher_touch_d54f_remaining_time with your entities names.

template:

    sensor:
      # Remaining Time Alt
      - name: "switcher_kis_remaining_time_alt"
        unique_id: switcher_kis_remaining_time_alt
        icon: mdi:timelapse
        state: >-
          {% if is_state("switch.switcher_touch_d54f", "off") or is_state("sensor.switcher_touch_d54f_remaining_time", "00:00:00") %}
              off
          {% else %}
              {% set hour = states("sensor.switcher_touch_d54f_remaining_time").split(':')[0] %}
              {% set min = states("sensor.switcher_touch_d54f_remaining_time").split(':')[1] %}
              {% set sec = states("sensor.switcher_touch_d54f_remaining_time").split(':')[2] %}
              {% set sec_int = sec|int %}
              {% set min_int = min|int %}
              {% set hour_int = hour|int %}

              {% if min_int > 0 %}
                {% set min_int = min_int + 1 %}
              {% endif %}
              {% if min_int == 60 %}
                {% set min_int = 0 %}
                {% set hour_int = hour_int + 1 %}
              {% endif %}

              {% if hour_int == 0 and min_int == 0 %}
                  {{ sec_int }} sec
              {% elif hour_int == 0 %}
                  {{ min_int }} min
              {% else %}
                  {{'%02d' % hour_int}}:{{'%02d' % min_int}}
              {% endif %}
          {% endif %}