Skip to content

Commit

Permalink
[skip ci] Update readme.
Browse files Browse the repository at this point in the history
  • Loading branch information
denpamusic committed Oct 6, 2023
1 parent b670584 commit 5daada4
Showing 1 changed file with 62 additions and 0 deletions.
62 changes: 62 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -316,6 +316,40 @@ This event is fired when ecoMAX controller issues an alert.
## Services
This integration provides following services:

### Get parameter
Provides ability to get device/sub-device parameter by name.

#### Fields

| Field | Type | Description |
|-------|---------------------|-------------------------|
| name | string | Name of the parameter. |

#### Targets

| Device <sup>1</sup> | Description |
|---------------------|-----------------------------------------|
| ecoMAX | Set parameter on the ecoMAX controller. |
| Mixer | Set parameter on the mixer sub-device. |

<small><sup>1</sup> Device can be targeted via any selector: area, device or entity.</small>

#### Response

| Field | Type | Description | Example |
|---------------------------|--------|--------------------------------|-----------------------|
| name | string | Name of the parameter. | heating_target_temp |
| value | number | Value of the parameter. | 65 |
| min_value | number | Minimum allowed value. | 40 |
| max_value | number | Maximum allowed value. | 80 |
| device_type | string | Device type. ecomax or mixer. | ecomax |
| device_uid | string | UID of device. | N271PAKR2NCP31K8G05G0 |
| device_index <sup>1</sup> | number | Connected device number. | 0 |

<small><sup>1</sup> This will help identify which sub-device (mixer) this parameter belongs to.
Root device (controller) is always 0, while connected mixers can have 1-5.</small>


### Set parameter
Provides ability to set device/sub-device parameter by name. Any parameter that is supported by the device/sub-device can be used with this service. To get parameter names, please download and open diagnostics data.

Expand All @@ -335,6 +369,34 @@ Provides ability to set device/sub-device parameter by name. Any parameter that

<small><sup>1</sup> Device can be targeted via any selector: area, device or entity.</small>

### Get schedule.
Allows to get different schedules from the device.

#### Fields

| Field | Type | Description |
|---------|---------------------------|--------------------------|
| type | "heating", "water_heater" | Type of the schedule. |
| weekday | "monday", "tuesday", ... | Weekday of the schedule. |

#### Response

| Field | Type | Description | Example |
|---------------------------|------------|------------------------------------|-----------------------------------|
| schedule | dictionary | Dictionary that contains schedule. | {"00:00": true, 00:30: true, ...} |

### Set schedule.
Allows to set different schedules on the device.

#### Fields

| Field | Type | Description |
|---------|---------------------------|--------------------------|
| type | "heating", "water_heater" | Type of the schedule. |
| weekday | "monday", "tuesday", ... | Weekday of the schedule. |
| state | boolean | State at scheduled time. |
| start | time | Time of schedule start. |
| end | time | Time of schedule end. |

### Calibrate meter
Allows to set meter entity to a specific value.<br>
Expand Down

0 comments on commit 5daada4

Please sign in to comment.