HomeDicator

A customisable SenseCap Indicator Firmware using ESPHome. De#spired by the official example project.

• Supports multiple pages
• Each page can have multiple tiles (4 visible at the same time - more with scrolling)
  • Currently supported tiles are:
    • Sensor tiles (square & wide)
    • Thermostat tiles (square & wide)
    • More will be added in the future
• Settings page to configure screen timeout, 24h clock and screen brightness
• Bluetooth Proxy Enabled

• Additional tiles including:
  • Light brightness tiles
  • Switch tiles
  • Button tiles
• Thermostat view (that can be linked to a tile showing the current temperature and opens on click)

Go to HomeDicator-Templates and copy the .yaml for the device you are using (as of now only the SenseCap Indicator is supported) into your esphome config folder. This file will from now on be referred to as device_config.yaml.
Copy the folder HomeDicator from within the latest ESPHome-Package zip into your esphome config folder.
You can have multiple device_config.yaml files with different names for different devices.
The folder must retain its name and does not need to be duplicated for each device.

Open the device_config.yaml and get conformable with its settings.

Tiles require sensors to be added to import the state of entities from Home Assistant into ESPHome.
There are different sensor templates for different kind of Home Assistant entities.

Below the sensor block, add the following configuration for each number sensor you wish to add:

- !include 
    file: HomeDicator/core/templates/sensor.yaml
    vars:
      hass_sensor_id: "airgradient_schlafzimmer_temperature"

Below the sensor block, add the following configuration for each thermostat you wish to add.
It will be used to fetch the currently set temperature.

- !include 
    file: HomeDicator/core/templates/climate_sensor.yaml
    vars:
      hass_climate_id: "schlafzimmer_schreibtisch" # Omit the "climate." portion you find within Home Assistant

Once you have added your sensors, go to the ADD / ADJUST YOUR PAGES HERE section.

A page looks like this:

- id: first_page
  bg_opa: TRANSP
  widgets:
    - !include
        file: HomeDicator/user_interface/templates/page_title.yaml
        vars:
          title: "Bedroom" # CHANGE PAGE TITLE HERE
    - obj:
        styles: content_container
        layout: 
          type: FLEX
          flex_flow: ROW_WRAP
          flex_align_main: LV_FLEX_ALIGN_START
          flex_align_cross: CENTER
          widgets:
            # Your tiles go here!

You can use this block if you want to add more pages. Make sure that the id is unique and that you update the title.
When you have finished adding pages, update the total_pages variable at the top of the file to reflect your total pages + the settings page.

Like sensors there are different templates for different tiles you can add to a page.
A screen can hold four square tiles at a time, but you can add more and access them by scrolling down on the Indicator.

To show a numeric sensor value add the following block below widgets:.

- !include
    file: HomeDicator/user_interface/templates/tiles/sensor/square.yaml
    vars:
      color: 0xeebf41
      hass_sensor_id: "airgradient_schlafzimmer_temperature"
      icon: "\U000F02E3"
      unit: "°C"
      title: "Bedroom"

To control a heating thermostat add the following block below widgets:.

- !include
    file: HomeDicator/user_interface/templates/tiles/thermostat/square.yaml
    vars:
      color: 0xeebf41
      hass_climate_id: "schlafzimmer_schreibtisch"
      min_value: 5
      max_value: 25
      title: "Living Room"

You can now compile your firmware and install it on your device.
Make sure to add your device to Home Assistant (it should be discovered automatically) as it will not receive data if you don't.