From b8ffe573483cb634e3a61c8736c0928519d05755 Mon Sep 17 00:00:00 2001 From: wtxu Date: Fri, 10 Apr 2026 17:06:20 +0800 Subject: [PATCH 01/25] Add Grandstream Home integration documentation --- .../_integrations/grandstream_home.markdown | 194 ++++++++++++++++++ 1 file changed, 194 insertions(+) create mode 100644 source/_integrations/grandstream_home.markdown diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown new file mode 100644 index 000000000000..773e307377ed --- /dev/null +++ b/source/_integrations/grandstream_home.markdown @@ -0,0 +1,194 @@ +--- +title: Grandstream Home +description: Instructions on how to integrate Grandstream devices with Home Assistant. +ha_category: + - Sensor +ha_release: 2026.5 +ha_iot_class: Local Push +ha_config_flow: true +ha_codeowners: + - "@wtxu-gs" +ha_domain: grandstream_home +ha_platforms: + - sensor +ha_integration_type: device +ha_zeroconf: true +--- + +The **Grandstream Home** {% term integration %} allows you to integrate Grandstream devices with Home Assistant for monitoring. This integration supports door access control systems (GDS, GSC). + +## Supported devices + +This integration supports the following Grandstream device types: + +### GDS/GSC Series - Door access control systems + +Door access control devices with SIP calling capabilities. + +- GDS372x series devices +- GSC356X series devices + +### Device Model Discovery + +The integration automatically discovers device models via mDNS/Zeroconf: + +| Device Type | mDNS Service | Example Name | +| ----------- | -------------------------- | ----------------------------- | +| GDS | `_https._tcp.local.` | `gds_001122334455` | +| GSC | `_https._tcp.local.` | `gsc_001122334455` | + +Device names follow the format: `{device_type}_{mac_address}` + +## Prerequisites + +- Grandstream device connected to your local network +- Device administrator password (default username: `gdsha`) +- Device must be accessible from your Home Assistant instance +- Home Assistant control must be enabled on the device (for GDS/GSC devices) + +{% include integrations/config_flow.md %} + +## Configuration + +The integration can be configured through the UI: + +1. Go to {% my integrations title="**Settings** > **Devices & services**" %}. +2. Select **Add integration**. +3. Search for "Grandstream Home". +4. Follow the configuration steps: + - Enter the device IP address or hostname + - Enter the device name +5. On the authentication screen: + - Enter administrator password (username is fixed to `gdsha`) + - (Optional) Configure custom port (default: 443 for HTTPS) + - (Optional) Disable SSL certificate verification (for self-signed certificates) + +### Automatic discovery + +The integration supports automatic device discovery via Zeroconf/mDNS. Discovered devices will appear on the {% my integrations title="**Settings** > **Devices & services**" %} page with a notification to configure them. + +## Supported functionality + +### Sensors + +The integration provides the following sensor: + +#### GDS/GSC Devices + +- **Device status** - Overall device status showing: + - `online` - Device is connected and responding + - `offline` - Device is not reachable + - `account_locked` - User account is temporarily locked + - `auth_failed` - Authentication failed + - `ha_control_disabled` - Home Assistant control is disabled on device + +## Troubleshooting + +### Cannot connect to device + +**Symptoms:** + +- Configuration fails with "Cannot connect" error +- Device shows as unavailable + +**Solutions:** + +1. Verify the device is powered on and connected to the network +2. Check the IP address is correct +3. Ensure your Home Assistant instance can reach the device: + ```bash + ping + ``` +4. Check firewall settings on both Home Assistant and the device +5. Verify the password is correct (default username: `gdsha`) +6. Check if you're using the correct port (default: 443 for HTTPS) +7. If using HTTPS, try disabling SSL verification in the configuration + +### Device not discovered automatically + +**Symptoms:** + +- Failed to discover the device + +**Solutions:** + +1. Ensure the device and Home Assistant are on the same network +2. Check mDNS/Zeroconf is not blocked by your network +3. Verify multicast traffic is allowed +4. Manually add the device using the IP address + +### Sensors not updating + +**Symptoms:** + +- Sensor values are stale or not updating + +**Solutions:** + +1. Check device is online and accessible +2. Verify device firmware is up to date +3. Check Home Assistant logs for errors: + - Go to **Settings** > **System** > **Logs** +4. Try reloading the integration: + - Go to {% my integrations title="**Settings** > **Devices & services**" %} + - Find "Grandstream Home" + - Select the three dots {% icon "mdi:dots-vertical" %} menu + - Select **Reload** + +### Authentication errors + +**Symptoms:** + +- "Invalid authentication" error during setup +- Device becomes unavailable with authentication errors + +**Solutions:** + +1. Verify the password is correct (default username: `gdsha`) +2. Confirm that the account is not locked due to excessive failed login attempts +3. Reset the device password if necessary +4. Verify Home Assistant control is enabled in device web interface settings + +### Home Assistant control disabled + +**Symptoms:** + +- "Home Assistant control is disabled" error + +**Solutions:** + +1. Log in to the device web interface +2. Navigate to the settings page +3. Enable "Home Assistant control" or "Third-party integration" option +4. Save settings and retry the integration setup + +## Known limitations + +- Only sensor platform is supported in the initial release +- Device discovery requires mDNS/Zeroconf to be enabled on your network +- Some older device firmware versions may have limited functionality + +## Security considerations + +- The integration stores credentials locally in Home Assistant's encrypted storage +- Communication with devices uses HTTPS by default (port 443) +- SSL certificate verification can be disabled for self-signed certificates (not recommended for production) +- Administrator password is required for full functionality +- Home Assistant control must be explicitly enabled on the device + +## Removing the integration + +This integration follows standard integration removal. + +{% include integrations/remove_device_service.md %} + +## Support + +For issues and feature requests: + +- [GitHub Issues](https://github.com/home-assistant/core/issues) (for core integration) +- [Home Assistant Community Forum](https://community.home-assistant.io/) + +## See also + +- [Grandstream official website](https://www.grandstream.com/) From f1f3af2925257f1dcbf0465e57a37b961e66ff7c Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 17:09:51 +0800 Subject: [PATCH 02/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 773e307377ed..46576f312982 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -21,7 +21,7 @@ The **Grandstream Home** {% term integration %} allows you to integrate Grandstr This integration supports the following Grandstream device types: -### GDS/GSC Series - Door access control systems +### GDS/GSC series - door access control systems Door access control devices with SIP calling capabilities. From 563279c2a6421422059d2542b70ac83e0af9298f Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 17:10:21 +0800 Subject: [PATCH 03/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 46576f312982..8d97424ff506 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -28,7 +28,7 @@ Door access control devices with SIP calling capabilities. - GDS372x series devices - GSC356X series devices -### Device Model Discovery +### Device model discovery The integration automatically discovers device models via mDNS/Zeroconf: From 6d70e587eaf74f35bb00df1d169617cec1c6d816 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 17:10:38 +0800 Subject: [PATCH 04/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 8d97424ff506..507b58922b7f 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -54,7 +54,7 @@ The integration can be configured through the UI: 1. Go to {% my integrations title="**Settings** > **Devices & services**" %}. 2. Select **Add integration**. -3. Search for "Grandstream Home". +3. Search for **Grandstream Home**. 4. Follow the configuration steps: - Enter the device IP address or hostname - Enter the device name From 08a3b08af5acc761d81635c2ba1f83a1241171f7 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 17:10:51 +0800 Subject: [PATCH 05/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 507b58922b7f..8123019459ea 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -65,7 +65,7 @@ The integration can be configured through the UI: ### Automatic discovery -The integration supports automatic device discovery via Zeroconf/mDNS. Discovered devices will appear on the {% my integrations title="**Settings** > **Devices & services**" %} page with a notification to configure them. +The integration supports automatic device discovery via mDNS/Zeroconf. Discovered devices will appear on the {% my integrations title="**Settings** > **Devices & services**" %} page with a notification to configure them. ## Supported functionality From ac319120b88727a939822c5af1a20ee6232c8b2c Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 17:11:07 +0800 Subject: [PATCH 06/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 9 ++------- 1 file changed, 2 insertions(+), 7 deletions(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 8123019459ea..645de01c4d2a 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -93,16 +93,11 @@ The integration provides the following sensor: **Solutions:** -1. Verify the device is powered on and connected to the network -2. Check the IP address is correct +1. Verify the device is powered on and connected to the network. +2. Check the IP address is correct. 3. Ensure your Home Assistant instance can reach the device: ```bash ping - ``` -4. Check firewall settings on both Home Assistant and the device -5. Verify the password is correct (default username: `gdsha`) -6. Check if you're using the correct port (default: 443 for HTTPS) -7. If using HTTPS, try disabling SSL verification in the configuration ### Device not discovered automatically From eb5c24822a3e489b98614cc49b64fe1fe54e7455 Mon Sep 17 00:00:00 2001 From: wtxu Date: Fri, 17 Apr 2026 17:17:01 +0800 Subject: [PATCH 07/25] Apply review feedback: add periods to troubleshooting steps and bold UI strings --- .../_integrations/grandstream_home.markdown | 38 +++++++++---------- 1 file changed, 19 insertions(+), 19 deletions(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 645de01c4d2a..87f6813a8761 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -107,10 +107,10 @@ The integration provides the following sensor: **Solutions:** -1. Ensure the device and Home Assistant are on the same network -2. Check mDNS/Zeroconf is not blocked by your network -3. Verify multicast traffic is allowed -4. Manually add the device using the IP address +1. Ensure the device and Home Assistant are on the same network. +2. Check mDNS/Zeroconf is not blocked by your network. +3. Verify multicast traffic is allowed. +4. Manually add the device using the IP address. ### Sensors not updating @@ -120,15 +120,15 @@ The integration provides the following sensor: **Solutions:** -1. Check device is online and accessible -2. Verify device firmware is up to date +1. Check device is online and accessible. +2. Verify device firmware is up to date. 3. Check Home Assistant logs for errors: - - Go to **Settings** > **System** > **Logs** + - Go to **Settings** > **System** > **Logs**. 4. Try reloading the integration: - - Go to {% my integrations title="**Settings** > **Devices & services**" %} - - Find "Grandstream Home" - - Select the three dots {% icon "mdi:dots-vertical" %} menu - - Select **Reload** + - Go to {% my integrations title="**Settings** > **Devices & services**" %}. + - Find **Grandstream Home**. + - Select the three dots {% icon "mdi:dots-vertical" %} menu. + - Select **Reload**. ### Authentication errors @@ -139,10 +139,10 @@ The integration provides the following sensor: **Solutions:** -1. Verify the password is correct (default username: `gdsha`) -2. Confirm that the account is not locked due to excessive failed login attempts -3. Reset the device password if necessary -4. Verify Home Assistant control is enabled in device web interface settings +1. Verify the password is correct (default username: `gdsha`). +2. Confirm that the account is not locked due to excessive failed login attempts. +3. Reset the device password if necessary. +4. Verify Home Assistant control is enabled in device web interface settings. ### Home Assistant control disabled @@ -152,10 +152,10 @@ The integration provides the following sensor: **Solutions:** -1. Log in to the device web interface -2. Navigate to the settings page -3. Enable "Home Assistant control" or "Third-party integration" option -4. Save settings and retry the integration setup +1. Log in to the device web interface. +2. Navigate to the settings page. +3. Enable "Home Assistant control" or "Third-party integration" option. +4. Save settings and retry the integration setup. ## Known limitations From a923d4652195b576b5ba19d1aa6a84b63ed21594 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 17:30:34 +0800 Subject: [PATCH 08/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 87f6813a8761..a6651405ebfc 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -71,7 +71,7 @@ The integration supports automatic device discovery via mDNS/Zeroconf. Discovere ### Sensors -The integration provides the following sensor: +The integration provides the following sensor entity: #### GDS/GSC Devices From cf929bb682e6b0107d6bcba16f76c68ec48b1d2a Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 17:30:56 +0800 Subject: [PATCH 09/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index a6651405ebfc..7cac6648c79c 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -73,7 +73,7 @@ The integration supports automatic device discovery via mDNS/Zeroconf. Discovere The integration provides the following sensor entity: -#### GDS/GSC Devices +#### GDS/GSC devices - **Device status** - Overall device status showing: - `online` - Device is connected and responding From 91bc1f353e5223b6989928dd093c3ca80020d060 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 18:06:04 +0800 Subject: [PATCH 10/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 7cac6648c79c..b6338b2c65bd 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -42,7 +42,7 @@ Device names follow the format: `{device_type}_{mac_address}` ## Prerequisites - Grandstream device connected to your local network -- Device administrator password (default username: `gdsha`) +- Device administrator password (username: `gdsha`) - Device must be accessible from your Home Assistant instance - Home Assistant control must be enabled on the device (for GDS/GSC devices) From 03f4b8f9690735f1563b8a2295a7abd3168c9ae8 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 18:20:01 +0800 Subject: [PATCH 11/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index b6338b2c65bd..d3ae008be6d8 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -165,9 +165,9 @@ The integration provides the following sensor entity: ## Security considerations -- The integration stores credentials locally in Home Assistant's encrypted storage +- The integration stores credentials locally in Home Assistant's configuration storage. Make sure you protect your backups, and limit access to your Home Assistant system. - Communication with devices uses HTTPS by default (port 443) -- SSL certificate verification can be disabled for self-signed certificates (not recommended for production) +- Keep SSL certificate verification enabled whenever possible. If your device uses a self-signed certificate, you can disable verification, but this reduces security and should only be used if you understand the risk. - Administrator password is required for full functionality - Home Assistant control must be explicitly enabled on the device From 986ca6ce5d80668bb4bff6d718f6d6d2b43b8cc6 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 18:20:34 +0800 Subject: [PATCH 12/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 10 ++++++---- 1 file changed, 6 insertions(+), 4 deletions(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index d3ae008be6d8..80b97db0d0df 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -32,10 +32,12 @@ Door access control devices with SIP calling capabilities. The integration automatically discovers device models via mDNS/Zeroconf: -| Device Type | mDNS Service | Example Name | -| ----------- | -------------------------- | ----------------------------- | -| GDS | `_https._tcp.local.` | `gds_001122334455` | -| GSC | `_https._tcp.local.` | `gsc_001122334455` | +- GDS + - mDNS service: `_https._tcp.local.` + - Example name: `gds_001122334455` +- GSC + - mDNS service: `_https._tcp.local.` + - Example name: `gsc_001122334455` Device names follow the format: `{device_type}_{mac_address}` From d8cd94c231f9f7e9d7e99f67520e837613458139 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 18:21:09 +0800 Subject: [PATCH 13/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 80b97db0d0df..360711e2e4b3 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -39,7 +39,7 @@ The integration automatically discovers device models via mDNS/Zeroconf: - mDNS service: `_https._tcp.local.` - Example name: `gsc_001122334455` -Device names follow the format: `{device_type}_{mac_address}` +Device names follow the format: `{device_type}_{mac_address}`. ## Prerequisites From a3db53ea7ca65fbc9c35e376b35743f539c988df Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 18:32:18 +0800 Subject: [PATCH 14/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- .../_integrations/grandstream_home.markdown | 22 ++++++------------- 1 file changed, 7 insertions(+), 15 deletions(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 360711e2e4b3..fd21389b305e 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -88,27 +88,19 @@ The integration provides the following sensor entity: ### Cannot connect to device -**Symptoms:** +#### Symptom: "Cannot connect" error during setup -- Configuration fails with "Cannot connect" error -- Device shows as unavailable +When you set up the integration, configuration fails with a "Cannot connect" error, or the device shows as unavailable. -**Solutions:** +##### Resolution + +1. Verify that the device is powered on and connected to the network. +2. Check that the IP address is correct. +3. Confirm that your Home Assistant instance can reach the device: -1. Verify the device is powered on and connected to the network. -2. Check the IP address is correct. -3. Ensure your Home Assistant instance can reach the device: ```bash ping -### Device not discovered automatically - -**Symptoms:** - -- Failed to discover the device - -**Solutions:** - 1. Ensure the device and Home Assistant are on the same network. 2. Check mDNS/Zeroconf is not blocked by your network. 3. Verify multicast traffic is allowed. From 4b8ff325a2b7bdefcf485ddd8a63cc03b339116c Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 18:32:37 +0800 Subject: [PATCH 15/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index fd21389b305e..30f53fbd4514 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -153,9 +153,9 @@ When you set up the integration, configuration fails with a "Cannot connect" err ## Known limitations -- Only sensor platform is supported in the initial release -- Device discovery requires mDNS/Zeroconf to be enabled on your network -- Some older device firmware versions may have limited functionality +- Only sensor platform is supported in the initial release. +- Device discovery requires mDNS/Zeroconf to be enabled on your network. +- Some older device firmware versions may have limited functionality. ## Security considerations From 5a51ecd788b5b205a9728a1e3813885f9a7edc90 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 18:32:49 +0800 Subject: [PATCH 16/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 30f53fbd4514..af2d6dde5427 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -160,10 +160,10 @@ When you set up the integration, configuration fails with a "Cannot connect" err ## Security considerations - The integration stores credentials locally in Home Assistant's configuration storage. Make sure you protect your backups, and limit access to your Home Assistant system. -- Communication with devices uses HTTPS by default (port 443) +- Communication with devices uses HTTPS by default (port 443). - Keep SSL certificate verification enabled whenever possible. If your device uses a self-signed certificate, you can disable verification, but this reduces security and should only be used if you understand the risk. -- Administrator password is required for full functionality -- Home Assistant control must be explicitly enabled on the device +- Administrator password is required for full functionality. +- Home Assistant control must be explicitly enabled on the device. ## Removing the integration From f996b67b817f99682ca9cf6de05ba655238433d7 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Fri, 17 Apr 2026 18:37:36 +0800 Subject: [PATCH 17/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 5 ----- 1 file changed, 5 deletions(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index af2d6dde5427..c63d67a932cb 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -101,11 +101,6 @@ When you set up the integration, configuration fails with a "Cannot connect" err ```bash ping -1. Ensure the device and Home Assistant are on the same network. -2. Check mDNS/Zeroconf is not blocked by your network. -3. Verify multicast traffic is allowed. -4. Manually add the device using the IP address. - ### Sensors not updating **Symptoms:** From b42d0cb582446e8ffa54e36be3c6b198d484b523 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Thu, 30 Apr 2026 10:54:49 +0800 Subject: [PATCH 18/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index c63d67a932cb..00f87232dc14 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -44,7 +44,7 @@ Device names follow the format: `{device_type}_{mac_address}`. ## Prerequisites - Grandstream device connected to your local network -- Device administrator password (username: `gdsha`) +- Device administrator credentials for the `gdsha` account - Device must be accessible from your Home Assistant instance - Home Assistant control must be enabled on the device (for GDS/GSC devices) From a0a0dd79275848a3cec03ae64bcced59079a98b2 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Thu, 30 Apr 2026 10:55:22 +0800 Subject: [PATCH 19/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 00f87232dc14..6cdac28a9aed 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -148,7 +148,7 @@ When you set up the integration, configuration fails with a "Cannot connect" err ## Known limitations -- Only sensor platform is supported in the initial release. +- Only sensors are supported in the initial release. - Device discovery requires mDNS/Zeroconf to be enabled on your network. - Some older device firmware versions may have limited functionality. From 4e75cede6fa20879701750d6056902be928e18b5 Mon Sep 17 00:00:00 2001 From: wtxu Date: Thu, 30 Apr 2026 11:05:41 +0800 Subject: [PATCH 20/25] Fix documentation style: convert bold labels to subheadings and update device series names --- .../_integrations/grandstream_home.markdown | 21 +++++++------------ 1 file changed, 8 insertions(+), 13 deletions(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 6cdac28a9aed..679a7d0c0996 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -15,7 +15,7 @@ ha_integration_type: device ha_zeroconf: true --- -The **Grandstream Home** {% term integration %} allows you to integrate Grandstream devices with Home Assistant for monitoring. This integration supports door access control systems (GDS, GSC). +The **Grandstream Home** {% term integration %} allows you to integrate Grandstream devices with Home Assistant for monitoring. This integration supports door access control systems (GDS372X, GSC356X). ## Supported devices @@ -103,11 +103,9 @@ When you set up the integration, configuration fails with a "Cannot connect" err ### Sensors not updating -**Symptoms:** +#### Symptom: Sensor values are stale or not updating -- Sensor values are stale or not updating - -**Solutions:** +##### Resolution 1. Check device is online and accessible. 2. Verify device firmware is up to date. @@ -121,12 +119,11 @@ When you set up the integration, configuration fails with a "Cannot connect" err ### Authentication errors -**Symptoms:** +#### Symptom: "Invalid authentication" error during setup -- "Invalid authentication" error during setup -- Device becomes unavailable with authentication errors +When you set up the integration or during normal operation, the device becomes unavailable with authentication errors. -**Solutions:** +##### Resolution 1. Verify the password is correct (default username: `gdsha`). 2. Confirm that the account is not locked due to excessive failed login attempts. @@ -135,11 +132,9 @@ When you set up the integration, configuration fails with a "Cannot connect" err ### Home Assistant control disabled -**Symptoms:** +#### Symptom: "Home Assistant control is disabled" error -- "Home Assistant control is disabled" error - -**Solutions:** +##### Resolution 1. Log in to the device web interface. 2. Navigate to the settings page. From 1f1358a59ef9228cd99695090e884e9dc424ffaf Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Thu, 30 Apr 2026 11:40:05 +0800 Subject: [PATCH 21/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 679a7d0c0996..b469553a2276 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -58,12 +58,12 @@ The integration can be configured through the UI: 2. Select **Add integration**. 3. Search for **Grandstream Home**. 4. Follow the configuration steps: - - Enter the device IP address or hostname - - Enter the device name + - Enter the device IP address or hostname. + - Enter the device name. 5. On the authentication screen: - - Enter administrator password (username is fixed to `gdsha`) - - (Optional) Configure custom port (default: 443 for HTTPS) - - (Optional) Disable SSL certificate verification (for self-signed certificates) + - Enter administrator password (username is fixed to `gdsha`). + - (Optional) Configure custom port (default: 443 for HTTPS). + - (Optional) Disable SSL certificate verification (for self-signed certificates). ### Automatic discovery From 3076e2cebaeecf0b4f4a674f0e44aec79e5aa6bd Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Thu, 30 Apr 2026 11:40:26 +0800 Subject: [PATCH 22/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index b469553a2276..08a029ce6a20 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -7,7 +7,7 @@ ha_release: 2026.5 ha_iot_class: Local Push ha_config_flow: true ha_codeowners: - - "@wtxu-gs" + - '@wtxu-gs' ha_domain: grandstream_home ha_platforms: - sensor From 05940b7422b3b0949a6bf3ee5baf63f12c090c9e Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Thu, 30 Apr 2026 11:40:40 +0800 Subject: [PATCH 23/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 08a029ce6a20..14c52d00b8e7 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -15,7 +15,7 @@ ha_integration_type: device ha_zeroconf: true --- -The **Grandstream Home** {% term integration %} allows you to integrate Grandstream devices with Home Assistant for monitoring. This integration supports door access control systems (GDS372X, GSC356X). +The **Grandstream Home** {% term integration %} allows you to integrate Grandstream devices with Home Assistant for monitoring. This integration supports door access control systems (GDS372x, GSC356X). ## Supported devices From 0b08ba8fc96bf061f8ecad0d852984cc5af3d6f8 Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Thu, 30 Apr 2026 11:59:30 +0800 Subject: [PATCH 24/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 1 - 1 file changed, 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index 14c52d00b8e7..c59002dcc0e7 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -47,7 +47,6 @@ Device names follow the format: `{device_type}_{mac_address}`. - Device administrator credentials for the `gdsha` account - Device must be accessible from your Home Assistant instance - Home Assistant control must be enabled on the device (for GDS/GSC devices) - {% include integrations/config_flow.md %} ## Configuration From 8eb15c4bb287ed05abbb79cf995d329eebaa49bb Mon Sep 17 00:00:00 2001 From: wtxu-gs Date: Thu, 30 Apr 2026 11:59:47 +0800 Subject: [PATCH 25/25] Update source/_integrations/grandstream_home.markdown Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com> --- source/_integrations/grandstream_home.markdown | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/source/_integrations/grandstream_home.markdown b/source/_integrations/grandstream_home.markdown index c59002dcc0e7..8fd03753fdb2 100644 --- a/source/_integrations/grandstream_home.markdown +++ b/source/_integrations/grandstream_home.markdown @@ -137,7 +137,7 @@ When you set up the integration or during normal operation, the device becomes u 1. Log in to the device web interface. 2. Navigate to the settings page. -3. Enable "Home Assistant control" or "Third-party integration" option. +3. Enable the **Home Assistant control** or **Third-party integration** option. 4. Save settings and retry the integration setup. ## Known limitations