Setup

Setting up the Integration

To configure the integration, you'll need your Diagral credentials - the same ones used for the Diagral eOne mobile application. The Diagral integration communicates with the Diagral Cloud.

Please be aware that the Diagral alarm system is a security system, and for security reasons, you may want to consider carefully before connecting it to the Home Assistant automation platform. Neither the developer of this integration nor the pydiagral library can be held responsible for any issues that may arise from using this integration or the pydiagral library. Users install and use this integration at their own risk and with full understanding of the potential implications.

Requirements

  1. A working Diagral Alarm system
  2. A Diagral box (DIAG56AAX)
  3. An active Diagral eOne mobile application account
  4. Internet connectivity for your Home Assistant

Required Information

You'll need just a few details to configure the Diagral integration:

  • Your Diagral username (email address)
  • Your account password
  • Your system serial ID (from the DIAG56AAX box)
  • The PIN code associated with your username/password

Finding Your System Serial ID

The serial number is located inside your Diagral box. To access it, open the box and locate a label with a QR code. You'll find a 14-character code - this is your box's serial number.

Location of System Serial ID

For guidance on opening the box, refer to the official DIAG56AAX documentation provided with your device.

Integration Setup in Home Assistant

As only one simultaneous connection is allowed by the Diagral API, before starting the integration setup, make sure you don't have any other active connections such as with the Diagral eOne mobile application.

Start the setup process by clicking the button below:

Open your Home Assistant instance and start setting up a new integration.

The setup process consists of 3 steps:

  • Enter your Serial ID
  • Provide your Diagral credentials
  • Configure Options
Step 1 - Serial ID
Step 2 - Diagral Credentials
Step 3 - Diagral Options

Fill in all fields and click Submit. A success popup will appear where you can select an area for your Diagral alarm.

Click Finish to complete the setup! 🎉

Please check your Home Assistant logs to ensure there are no errors related to the Diagral Integration.

Open your Home Assistant instance and view your Home Assistant logs.

Options

You can customize your integration experience through various options.

Alarm Panel Options

The Alarm Panel options allow you to specify whether a code should be required when using the Alarm Control Panel UI. You can configure when a code is required:

  • Never: No code required for any action
  • Disarm Only: Code required only for disarm actions
  • Always: Code required for both arm and disarm actions
Alarm Control Panel

Keep in mind, if you switch to Never the code will be also automatically removed.