Co-authored-by: dependabot[bot] <49699333+dependabot[bot]@users.noreply.github.com> Co-authored-by: Franck Nijhof <git@frenck.dev>
5.2 KiB
title, description, ha_category, ha_release, ha_config_flow, ha_iot_class, ha_quality_scale, ha_codeowners, ha_domain, ha_platforms, ha_integration_type
| title | description | ha_category | ha_release | ha_config_flow | ha_iot_class | ha_quality_scale | ha_codeowners | ha_domain | ha_platforms | ha_integration_type | ||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Minut Point | Instructions on how to integrate Minut Point into Home Assistant. |
|
0.83 | true | Cloud Polling | gold |
|
point |
|
integration |
The Point hub enables integration with the Minut Point. To connect with Point, you will have to sign up for a developer account and have a Pro subscription and get a client_id and client_secret with the callback url configured as your Home Assistant URL + /api/minut, e.g., http://localhost:8123/api/minut. The client_id and client_secret should be used as below.
Once Home Assistant is started, a configurator will pop up asking you to Authenticate your Point account via a link. When you follow the link and click on Accept you will be redirected to the callback url and the Point integration will be automatically configured and you can go back to the original dialog and press Submit.
There is currently support for the following device types within Home Assistant:
Configuration
# Example configuration.yaml entry
point:
client_id: CLIENT_ID
client_secret: CLIENT_SECRET
{% configuration %} client_id: description: Your Minut Point developer client ID. required: true type: string client_secret: description: Your Minut Point developer client secret. required: true type: string {% endconfiguration %}
Device types
The integration supports the following device types within Home Assistant:
The Point is just active occasionally so the Sensors are only updated every hour or so. The Binary Sensors are however updated via Cloud Push, making the changes close to instant.
Alarm
Each home configured in the Point mobile application will show up as a separate alarm control panel. The panels allow arming and disarming of the Point home alarm system.
The Point only supports a Arm/Disarm action, so it is only Arm Away that is implemented.
Binary Sensor
Each Point exposes the following binary sensors:
- alarm:
Onmeans alarm sound was recognized,Offmeans normal - battery:
Onmeans low,Offmeans normal - button_press:
Onmeans the button was pressed,Offmeans normal - cold:
Onmeans cold,Offmeans normal - connectivity:
Onmeans connected,Offmeans disconnected - dry:
Onmeans too dry,Offmeans normal - glass:
Onmeans the sound of glass break was detected,Offmeans normal - heat:
Onmeans hot,Offmeans normal - light:
Onmeans light detected,Offmeans no light - moisture:
Onmeans moisture detected (wet),Offmeans no moisture (dry) - motion:
Onmeans motion was detected,Offmeans no motion - noise:
Onmeans noise was detected,Offmeans noise levels have gone back to normal - sound:
Onmeans sound detected,Offmeans no sound (clear) - tamper:
Onmeans the point was removed,Offmeans normal - tamper_old:
Onmeans the point was removed or attached,Offmeans normal (this is only supported on some "old" devices)
The binary sensors button_press, sound and tamper are switched On for a brief moment and are then switched back to Off.
Automation example
The following example show how to implement an automation for the button_press binary sensor.
# Example configuration.yaml Automation entry
automation:
alias: "Point button press"
trigger:
- platform: state
entity_id: binary_sensor.point_button_press # Change this accordingly
to: "on"
action:
- service: persistent_notification.create
data:
title: Point button press
message: Point button was pressed.
Webhook events
The events shown as binary sensors are sent to Home Assistant as webhooks with the event_type set to point_webhook_received. Below is an example of how to use such a webhook do note the trigger.event.data.event.device_id which translates to the id of the Point device that sent the event.
{% raw %}
# Example configuration.yaml Automation entry
automation:
alias: "Point button press (webhook)"
trigger:
- platform: event
event_type: point_webhook_received
event_data: {}
condition:
condition: template
value_template: "{{ trigger.event.data.event.type == 'short_button_press' }}"
action:
- service: persistent_notification.create
data:
title: Point button press (webhook)
message: "Button press on Point {{ trigger.event.data.event.device_id }}"
{% endraw %}
Sensor
Each Point exposes the following sensors:
- temperature: Temperature in °C.
- humidity: Percentage of humidity in the air.
- sound_level: Sound level in dBA