Custom Home Assistant integration for G90 security systems

Description

The integration supports G90-based security systems might be distributed under different vendors - Golden Security, PST, Kerui etc. Those having G90 in the model name has a good chance to be supported - please give it a try and report back.

Actual interface with the security system is implemented via pyg90alarm Python package. Please see its documentation for more details, especially on enabling the device notifications.

Basically, for HomeAssistant to receive notifications from the device on its state changes and sensor activity the device should have its IP address set to 10.10.10.250. That is a specific limitation of how device's firmware works.

NOTE If you're unable to move your alarm panel to the address above, the integration will have additional limitations:

• Delays reflecting panel status up to 30 seconds
• Sensor state changes will be absent

NOTE To work around the limitation above the integration now supports simulating the device alerts from the history it records - it is implemented by pyg90alarm Python package, and it does so by periodically polling the device history and sending newer entries down the code path as if those been received from device. The mode is enabled by selecting Simulate device alerts from history option in device configuration, and enabling particular device alerts types you're interested in via mobile application. This mode will still have limitations as not reflecting the state of motion sensors (as those come as device notifications not alerts).

Additionally, you might want to enable door close alerts ("Alarm Alert -> Door close" in mobile application), so the integration properly reflects the state of a door sensor. Not enabling it will lead the sensor to become inactive in 3 seconds, same behavior as for other sensors types. This is another limitation of the device, as it doesn't indicate when the sensor became inactive for most of the cases. Please note enabling the door alert will have more notifications (and possible SMS messages if you enabled those in mobile application) to be sent.

Installation

• Install HACS by following Setup and Configuration steps
• Download Golden Security Alarm integration in HACS
• Add the Golden Security Alarm integration in HomeAssistant

Specifics

• The integration doesn't manage most of settings for the alarm panel, including adding/removing sensors - you can only enable/disable sensors/realy. For the rest you will still need the mobile application
• No cloud or Internet connectivity required in case of local setup (Home Assistant in the same local network as the alarm panel)
• Changes in alarm panel with regards to sensors and switches require the integration to be reloaded, it currently does not support making those updates available in HomeAssistant without the restart
• If your alarm panel is in a subnet different from one HomeAssistant runs, making the integration receiving the device notification messages will require additional steps - the notifications are sent by alarm panel as broadcast packets, thus you'll need those forwarded to the HomeAssistant subnet. Alternatively, you could consider the alert simulation option above.

Troubleshooting

If you need to troubleshoot the integration it is recommended to first enable debug logging for it, to capture additional details.

For that you'll need to add following options to HomeAssistant's configuration.yaml. Please note this will also set logging level to info for all other HomeAssistant components - please adjust default: info to fit your needs.

logger:
  default: info
  logs:
    pyg90alarm: debug
    homeassistant.gs_alarm: debug
    custom_components.gs_alarm: debug