mirror of
https://github.com/home-assistant/home-assistant.io.git
synced 2025-07-15 21:36:52 +00:00
Add troubleshooting, data updates and known limitations to the bosch_alarm integration (#38376)
* Add data updates documentation and troubleshooting info * Add known limitations * update troubleshooting * update troubleshooting * add more troubleshooting information * add more troubleshooting information * add more troubleshooting information * add more troubleshooting information * update docs * Update source/_integrations/bosch_alarm.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * Update source/_integrations/bosch_alarm.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * Update source/_integrations/bosch_alarm.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * apply style fixes * Update source/_integrations/bosch_alarm.markdown * Update source/_integrations/bosch_alarm.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * Update source/_integrations/bosch_alarm.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * bolden ui strings * bolden ui strings * bolden ui strings * remove note about dhcp discovery since it isnt merged yet * tiny tweak * remove bold and caps * Update source/_integrations/bosch_alarm.markdown Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com> * bosch alarm panel -> bosch alarm --------- Co-authored-by: c0ffeeca7 <38767475+c0ffeeca7@users.noreply.github.com>
This commit is contained in:
Sanjay Govind
GitHub
parent
765f966cad
commit
145824638b
@ -15,7 +15,7 @@ ha_platforms:
|
||||
ha_integration_type: integration
|
||||
---
|
||||
|
||||
The **Bosch Alarm Panel** {% term integration %} allows you to connect your [Bosch Alarm Panel](https://www.boschsecurity.com) to Home Assistant to control and monitor your Bosch Alarm Panel.
|
||||
The **Bosch Alarm** {% term integration %} allows you to connect your [Bosch Alarm Panel](https://www.boschsecurity.com) to Home Assistant to control and monitor your Bosch Alarm Panel.
|
||||
|
||||
{% include integrations/config_flow.md %}
|
||||
|
||||
@ -45,12 +45,12 @@ This entity reports state (_disarmed_, _armed_away_, etc.).
|
||||
The primary means of authentication for the _Mode 2_ API is the _Automation_ passcode. It needs to be at least 10 characters long, and it is different from the _User_ code -- a shorter numeric pin used to arm/disarm the panel.
|
||||
The integration will prompt for the required passcodes, which depend on the panel type.
|
||||
|
||||
| Panel | Code |
|
||||
| --- | --- |
|
||||
| Solution | User [^2] |
|
||||
| Panel | Code |
|
||||
| -------- | ---------- |
|
||||
| Solution | User [^2] |
|
||||
| B Series | Automation |
|
||||
| G Series | Automation |
|
||||
| AMAX | Both |
|
||||
| AMAX | Both |
|
||||
|
||||
[^2]: The user needs to have the "master code functions" authority if you wish to interact with history events.
|
||||
|
||||
@ -58,6 +58,96 @@ The integration will prompt for the required passcodes, which depend on the pane
|
||||
Since the _Mode 2_ automation user has "superuser" privileges, it bypasses the regularly configured alarm pin: you will _not_ be prompted for a _User_ code when arming/disarming through the integration.
|
||||
{% endimportant %}
|
||||
|
||||
## Data updates
|
||||
|
||||
The **Bosch Alarm** {% term integration %} fetches data from the device every 30 seconds.
|
||||
Newer devices and firmware revisions have the possibility to push data instead of needing to rely on {% term polling %}.
|
||||
At startup, the integration checks whether your panel supports push data updates and falls back to {% term polling %} if not.
|
||||
|
||||
## Troubleshooting
|
||||
|
||||
### Issues with Bosch Solution 2000/3000/4000 panels
|
||||
|
||||
We have found that some panels end up with a configuration on them that is incompatible with the integration.
|
||||
When this happens, you will get a connection error when attempting to communicate with the panel, even if the credentials are correct.
|
||||
If you continue to have connection errors even after rebooting your panel, then you have an issue with your configuration.
|
||||
The easiest way to solve this is to follow the full reset and restore procedure outline below.
|
||||
|
||||
#### Resetting the configuration and restoring the integration
|
||||
|
||||
1. Update firmware (Recommended).
|
||||
1. Download and install the latest firmware for the control panel and IP module from the Bosch Security website.
|
||||
2. Back up the existing configuration.
|
||||
1. Connect to the panel via A-Link Plus.
|
||||
2. Perform an upload of the panel configuration.
|
||||
3. Save the configuration to your computer.
|
||||
3. Default the control panel.
|
||||
1. Press the default/reset button on the panel.
|
||||
2. Use installer code 1234.
|
||||
3. Set:
|
||||
1. Location 0081 = 3 (Enables IP module mode)
|
||||
2. Location 4456 = 4 (Enables RSC+ communication)
|
||||
4. Set date and time using master code `25806#`.
|
||||
4. Initial Home Assistant test.
|
||||
1. Wait 2 to 5 minutes after resetting the panel.
|
||||
2. Set up the integration on the panel using its IP address.
|
||||
3. Home Assistant should connect using default configuration and show panel status.
|
||||
5. Restore your original configuration.
|
||||
1. Reconnect to the panel using A-Link Plus.
|
||||
2. Modify zones, outputs, and user codes to match the original setup.
|
||||
3. Save and download the updated config to the panel.
|
||||
4. Wait 2 to 5 minutes.
|
||||
6. Reconnect to Home Assistant.
|
||||
1. Open Home Assistant.
|
||||
2. The integration should now detect the updated configuration.
|
||||
3. All relevant entities (zones, partitions, outputs) should appear automatically.
|
||||
|
||||
#### Restarting a panels network stack
|
||||
|
||||
We have found that the Solution panels have a bug where they can get into a state where the network module stops letting us use the _Mode 2_ API.
|
||||
If your configuration information is correct, but you are still unable to connect to your panel, then you are likely encountering this bug.
|
||||
This can be resolved by restarting the network modules, which can be done with the following steps.
|
||||
|
||||
##### Resetting network module 1
|
||||
|
||||
Using the codepad, enter your master code, followed by the `[9][4][1]` and `[#]` keys.
|
||||
|
||||
##### Resetting network module 2
|
||||
|
||||
Using the codepad, enter your master code, followed by the `[9][4][2]` and `[#]` keys.
|
||||
|
||||
### Issues with the Bosch B/G Series (B3512/B4512/B5512/B8512/B9512)
|
||||
|
||||
The following procedure can be used to configure the panel correctly so that it will work with the integration.
|
||||
|
||||
#### Panel configuration procedure
|
||||
|
||||
1. Update Firmware (Recommended).
|
||||
1. Use RPS to update the control panel and B426 (IP module if used) to the latest firmware.
|
||||
2. Download firmware from the Bosch Security website.
|
||||
2. Set IP Address.
|
||||
1. Configure the panel’s IP settings using RPS or via the codepad.
|
||||
2. Use DHCP for initial setup (optional), or assign a static IP.
|
||||
3. Configure the automation device.
|
||||
1. In RPS:
|
||||
1. Set **Automation Device** to **Mode 2** (Bosch Standard Protocol).
|
||||
2. Set your automation passcode (used for Home Assistant authentication).
|
||||
4. Wait for changes to apply.
|
||||
1. Wait 2 to 5 minutes for the panel to reboot and apply settings.
|
||||
5. Connect to Home Assistant.
|
||||
1. Set up the integration using the panel’s IP address.
|
||||
2. Enter the automation passcode in the Home Assistant configuration.
|
||||
3. Home Assistant should connect and display panel status, zones, and partitions.
|
||||
|
||||
#### TLS issues
|
||||
|
||||
Some older firmwares for these panels use outdated certificates that are no longer trusted by Home Assistant. If you have issues connecting and see a TLS error in your logs, update the firmware on your panel.
|
||||
|
||||
## Known limitations
|
||||
|
||||
- The integration does not allow you to configure the panel; you can instead do this via the panel's configuration utility.
|
||||
- Some older firmware versions for the Solution / AMAX series panels only support a single connection at a time. If you try to have a cloud connection and use the integration on these panels simultaneously, the panel's network stack can lock up, and the integration will stop working.
|
||||
|
||||
## Removing the integration
|
||||
|
||||
This integration follows standard integration removal. No extra steps are required.
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user