hass_max_home_automation

Home Assistant support for MAX! Cube via MAX! Home Automation - HTTP API

Preview

Sample configuration

# Example configuration.yaml entry
maxhomeautomation:
  gateways:
    host: localhost
    port: 8080
    scan_interval: 10
    cubes:
      - hex_address: 
        name: 
        radiator_thermostats:
          - hex_address:
            name: 
        wall_thermostats:
          - hex_address:
            name: 
        window_shutters:
          - hex_address:
            name: 
        eco_buttons:
          - hex_address:
            name:

Notes: if you have no devices of some type, ie. wall_thermostat, leave the list empty. Omitting the list cause configuration error as described in issue #3 and issue #6. Example:

maxhomeautomation:
  gateways:
    host: localhost
    port: 8080
    scan_interval: 10
    cubes:
      - hex_address: FFFFFF
        name: My CUBE
        radiator_thermostats:
          - hex_address: FFFFFF
            name: Some radiator
        wall_thermostats:
        window_shutters:
        eco_buttons:

UI configuration example (one half of the screenshot)

type: vertical-stack
  - entity: climate.obytna_kuchyne
    type: thermostat
  - columns: 7
    entities:
      - entity: binary_sensor.obytna_kuchyne_initialized
      - entity: binary_sensor.obytna_kuchyne_link
      - entity: binary_sensor.obytna_kuchyne_unlocked
      - entity: binary_sensor.obytna_kuchyne_low_battery
      - entity: binary_sensor.obytna_kuchyne_error
      - entity: sensor.obytna_kuchyne_valve
      - entity: sensor.obytna_kuchyne_offset
    show_name: false
    show_state: true
    title: Obytná kuchyně
    type: glance
  - columns: 5
    entities:
      - entity: binary_sensor.okenni_senzor_obytna_kuchyne_initialized
      - entity: binary_sensor.okenni_senzor_obytna_kuchyne_link
      - entity: binary_sensor.okenni_senzor_obytna_kuchyne_low_battery
      - entity: binary_sensor.okenni_senzor_obytna_kuchyne_error
      - entity: binary_sensor.okenni_senzor_obytna_kuchyne_open_window
    show_name: false
    show_state: true
    title: Obytná kuchyně - okno
    type: glance

Notes:

Thermostat name is "Obytna kuchyne".
Window sensor name is "Okenni senzor obytna kuchyne".
Use apropriate indent.

Conditions

Feel free to use. Feel free to make Pull requests with enhanced features or correction of bugs. Please note I have started with Home Assistant and MAX! Cube system on 02/15/2019. Hence this implementation is probably not following HA best practices.

As almost everyone I am developing this in my free time, so be kind in case I have delays in communication/enhancements.

Deployment

I have Home Assistant and MAX! Home Automation installed on the same Raspberry PI Model 3B+. MAX! Home Automation has enabled HTTP API only for localhost at 8080 port.

Useful links

How to install MAX! Home Automation on Raspberry PI: https://sourceforge.net/p/max-home-automation/wiki/Raspberry%20installation/

Feature list

Climate Component (Eq-3 MAX!, Eq-3 MAX!+, Eq-3 Wall Thermostat)
- Supported operational modes
  - Auto
  - Manual
  - Heat (via Eq-3 BOOST)
  - Eco (via Eq-3 VACATION)
- Note: Eco operation mode via Eq-3 VACATION mode has fixed initial interval 365 days
Sensors
- Current temperature (Eq-3 MAX!, Eq-3 MAX!+, Eq-3 Wall Thermostat)
- Target temperature (Eq-3 MAX!, Eq-3 MAX!+, Eq-3 Wall Thermostat)
- Valve (Eq-3 MAX!, Eq-3 MAX!+)
- Offset (Eq-3 MAX!, Eq-3 MAX!+)
- Mode (Eco button)
- Cube RF duty cycle (MAX! Cube)
Binary Sensors
- Link error (Eq-3 MAX!, Eq-3 MAX!+, Eq-3 Wall Thermostat, Eco button, Window Sutter)
- Error (Eq-3 MAX!, Eq-3 MAX!+, Eq-3 Wall Thermostat, Eco button, Window Sutter)
- Low battery (Eq-3 MAX!, Eq-3 MAX!+, Eq-3 Wall Thermostat, Eco button, Window Sutter)
- Panel unlocked (Eq-3 MAX!, Eq-3 MAX!+, Eq-3 Wall Thermostat, Eco button)
- Initialized (Eq-3 MAX!, Eq-3 MAX!+, Eq-3 Wall Thermostat, Eco button, Window Sutter)
- Open window (Window Sutter)