Skip to content

Pigotka/ha-cc-jablotron-cloud

Repository files navigation

Home Assistant HACS GitHub license

Buy me a coffee


Jablotron logo

Jablotron Cloud

Home Assistant custom component for Jablotron Cloud.

About

This integration allows you to monitor and control alarm sections as well as programmable gates and temperature sensors. It does not require a direct connection to the alarm control panel to run, instead it uses a cloud connection via MyJablotron and takes advantage of the mobile API provided by the JablotronPy library.

Supported entities

The integration uses the following entities to enable monitoring and control of individual components of the Jablotron ecosystem:

Entity type Description
alarm_control_panel Used for monitoring and controlling alarm sections (including triggered state when an alarm is active)
binary_sensor Used for monitoring UNcontrollable programmable gates (PGs)
climate Used for controlling thermo devices (thermostats)
switch Used for controlling programmable gates (PGs)
sensor Used for monitoring temperature sensors and non-controllable section states

HACS Installation

This integration can be installed using HACS, this can be achieved as follows:

  1. Install and open HACS in Home Assistant
  2. Search for Jablotron Cloud
  3. Open it and click on Download button
  4. In Home Assistant go to Integrations
  5. Click on Add integration button
  6. Search for Jablotron Cloud
  7. Complete configuration and confirm

Manual Installation

If you are not using HACS, you can install this integration manually as follows:

  1. Open Home Assistant installation configuration directory (you should see configuration.yaml file)
  2. Create custom_components folder, or skip this step if already exists
  3. Open custom_components folder
  4. Download custom_components/jablotron_cloud folder from this repository
  5. Place downloaded jablotron_cloud folder to created custom_components folder
  6. Restart Home Assistant
  7. In Home Assistant go to Integrations
  8. Click on Add integration button
  9. Search for Jablotron Cloud
  10. Complete configuration and confirm

Integration configuration

To successfully set up this integration, you will need the username (email) and password used for the MyJablotron web service/mobile app.

The integration allows you to modify the following parameters:

  • Default pin used to control PGs
  • Whether to bypass section errors by default when arming sections
  • Frequency of polling data from Jablotron Cloud
  • Timeout for polling data from Jablotron Cloud

Alarm event detection

The integration surfaces an active alarm by flipping the affected alarm_control_panel entity to the triggered state. Detection is per section — when an alarm is in progress, the Jablotron Cloud API returns an event with a message such as "Alarm - Periphery PIR chodba (wifi), Section Dům". The integration parses the section name from the substring after the , Section token and only the matching section is reported as triggered. Other sections of the same service stay in their previous state.

While a section is triggered, its entity exposes the following extra attributes describing the latest matching event:

Attribute Description
last_alarm_type Event type as reported by the cloud (currently always ALARM)
last_alarm_message Human-readable description, e.g. detector and section that triggered
last_alarm_date ISO 8601 timestamp when the event was raised

Example automation that fires whenever any alarm panel is triggered:

- alias: Jablotron alarm triggered
  trigger:
    - platform: state
      entity_id: alarm_control_panel.dum
      to: "triggered"
  action:
    - service: notify.mobile_app
      data:
        title: "Alarm!"
        message: "{{ state_attr(trigger.entity_id, 'last_alarm_message') }}"

Caveats

  • Polling-based detection. The Jablotron Cloud API does not push notifications. The integration only knows about an alarm while the cloud response still contains the active event. If the alarm is silenced before the next poll, the trigger is missed. For time-critical automations consider lowering the Frequency of polling setting (minimum 30 seconds).
  • Message format dependency. Section identification relies on the message ending with , Section <name> where <name> matches the configured section name exactly. If your panel firmware emits ALARM events without that suffix, the entity will not flip to triggered. Please open an issue with a redacted log sample if you observe this.
  • Historical events are not used. The cloud-side event history endpoint (eventHistoryGet) returns 400 METHOD.NOT-SUPPORTED on several panel models (e.g. JA100F), so it is not relied on as a fallback.

Support

Buy me a coffee QR

About

HACS custom component for jablotron cloud integration

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages