--- title: "GTD8" description: "GTD8 8-channel switch and LED panel connected to TapHome via Modbus TCP. 8 switches with LED indicator mirroring." url: "https://taphome.com/en/compatibility/gtd8/" language: en lastmod: 2026-03-30 generator: hugo ai: topics: ["modbus-tcp","i/o-module","ethernet","wall-switch","led-indicator"] questions: ["How to integrate GTD8 switch panel with TapHome?","What does the GTD8 TapHome template control?","How to connect GTD8 via Modbus TCP to TapHome?","How does the LED indicator mirroring work on the GTD8?","What Modbus registers does the GTD8 use for switches and LEDs?"] --- # GTD8 Communication: Modbus TCP - [GTD IOT Product Page (same manufacturer)](https://gtdiot.en.made-in-china.com/product/eniRXBoGOfWx/China-OEM-LED-Bedside-Control-8-Buttons-Panel-Touch-Light-Dimmer-Control-Smart-Wall-Switches-with-12-24V-RS-485-Modbus.html) > Network address > > TapHome reaches this device at the address entered on import. Give the device a fixed address — an IP reservation in the router, or its mDNS name if it supports one — otherwise the integration stops working when the router changes the address. > > [Network Preparation](https://taphome.com/en/docs/setup/network-preparation/) ## Integration guide The GTD8 is an 8-channel switch and LED panel from GTD IOT that communicates via Modbus TCP over Ethernet. It provides 8 independent on/off switches (H:0–H:7) and 8 corresponding LED indicators (H:10–H:17), all accessible as holding registers. TapHome connects directly to the panel over the local network — no additional gateway is required. The template uses the MODBUSWNE (write-no-echo) pattern for all write operations and polls the device at 500 ms intervals. ## Network connection Connect the GTD8 panel to the same local network as TapHome Core using a standard Ethernet cable. - **Protocol:** Modbus TCP - **Port:** 502 - **Default Slave ID:** 1 ## Configuration No special configuration is needed on the GTD8 panel. The Modbus TCP interface is active by default on port 502. When importing the template in TapHome, provide: - **IP Address** — the panel's IP on the local network (default: 192.168.0.1) - **Slave ID** — Modbus slave address (default: 1) ## Device capabilities The template exposes 16 devices: 8 switches and 8 LED indicators. ### Switch control (Switches 1–8) All 8 switches operate identically. Each switch is exposed as an on/off switch in TapHome: - **Read:** The switch state is read from holding registers H:0 through H:7 (one per switch) - **Write:** When toggled from TapHome, the template writes the switch state to H:0–H:7 using the MODBUSWNE (write-no-echo) pattern ### LED indicators (LEDs 1–8) Each switch has a corresponding LED indicator that can be controlled independently: - **Read:** The LED state is read from holding registers H:10 through H:17 - **Write:** LEDs can be toggled from TapHome via H:10–H:17 using MODBUSWNE The LED indicators can be used to mirror the switch state or driven independently for custom signaling. | Switch | Switch register | LED register | Poll interval | |--------|----------------|--------------|---------------| | Switch 1 | H:0 | H:10 | 500 ms | | Switch 2 | H:1 | H:11 | 500 ms | | Switch 3 | H:2 | H:12 | 500 ms | | Switch 4 | H:3 | H:13 | 500 ms | | Switch 5 | H:4 | H:14 | 500 ms | | Switch 6 | H:5 | H:15 | 500 ms | | Switch 7 | H:6 | H:16 | 500 ms | | Switch 8 | H:7 | H:17 | 500 ms | > [!NOTE] > Unlike the GTD IOT 8-Button Touch Switch (RS-485 variant), the GTD8 does not have an initialization script — no touch-to-toggle mode configuration is required. The switches and LEDs are directly readable and writable from import. ## Troubleshooting ### No Modbus communication 1. Verify the Ethernet cable is connected and the panel is powered 2. Confirm the panel's IP address — check the router's DHCP lease table 3. Ensure TapHome Core and the GTD8 are on the same network/subnet 4. Check that no firewall is blocking port 502 ### LED not matching switch state The GTD8 template controls switches and LEDs as independent devices. If you need LED mirroring (LED follows switch state automatically), create a TapHome Smart Rule that copies the switch state to the corresponding LED device. ## Available devices 16 These devices appear in TapHome after import. GTD8 Module Switch 1 Switch Read and write On/off switch channel 1 — reads/writes holding register H:0 Register: H:0 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 0, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 0, Bool, St) ``` Switch 1 LED Switch Read and write LED indicator for channel 1 — reads/writes holding register H:10 Register: H:10 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 10, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 10, Bool, St) ``` Switch 2 Switch Read and write On/off switch channel 2 — reads/writes holding register H:1 Register: H:1 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 1, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 1, Bool, St) ``` Switch 2 LED Switch Read and write LED indicator for channel 2 — reads/writes holding register H:11 Register: H:11 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 11, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 11, Bool, St) ``` Switch 3 Switch Read and write On/off switch channel 3 — reads/writes holding register H:2 Register: H:2 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 2, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 2, Bool, St) ``` Switch 3 LED Switch Read and write LED indicator for channel 3 — reads/writes holding register H:12 Register: H:12 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 12, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 12, Bool, St) ``` Switch 4 Switch Read and write On/off switch channel 4 — reads/writes holding register H:3 Register: H:3 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 3, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 3, Bool, St) ``` Switch 4 LED Switch Read and write LED indicator for channel 4 — reads/writes holding register H:13 Register: H:13 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 13, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 13, Bool, St) ``` Switch 5 Switch Read and write On/off switch channel 5 — reads/writes holding register H:4 Register: H:4 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 4, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 4, Bool, St) ``` Switch 5 LED Switch Read and write LED indicator for channel 5 — reads/writes holding register H:14 Register: H:14 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 14, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 14, Bool, St) ``` Switch 6 Switch Read and write On/off switch channel 6 — reads/writes holding register H:5 Register: H:5 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 5, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 5, Bool, St) ``` Switch 6 LED Switch Read and write LED indicator for channel 6 — reads/writes holding register H:15 Register: H:15 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 15, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 15, Bool, St) ``` Switch 7 Switch Read and write On/off switch channel 7 — reads/writes holding register H:6 Register: H:6 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 6, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 6, Bool, St) ``` Switch 7 LED Switch Read and write LED indicator for channel 7 — reads/writes holding register H:16 Register: H:16 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 16, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 16, Bool, St) ``` Switch 8 Switch Read and write On/off switch channel 8 — reads/writes holding register H:7 Register: H:7 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 7, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 7, Bool, St) ``` Switch 8 LED Switch Read and write LED indicator for channel 8 — reads/writes holding register H:17 Register: H:17 Bool Values / States: ON · OFF Read switch state ```taphome MODBUSR(H, 17, Bool) ``` Write switch state ```taphome MODBUSWNE(H, 17, Bool, St) ``` **Connection:** Modbus TCP • Slave ID: $\[SlaveId] ## Import parameters Enter these values when you import the XML. | Asked in the app | Default | |------------------|---------------| | Slave ID | `1` | | IP address | `192.168.0.1` | ## Sources - GTD IOT 8-Button Touch Switch Panel — Product Page (same manufacturer) [gtdiot.en.made-in-china.com](https://gtdiot.en.made-in-china.com/product/eniRXBoGOfWx/China-OEM-LED-Bedside-Control-8-Buttons-Panel-Touch-Light-Dimmer-Control-Smart-Wall-Switches-with-12-24V-RS-485-Modbus.html) 2026-03-30 ## Related Documentation - [Modbus Integration](https://taphome.com/en/compatibility/modbus-guide/) - [Modbus](https://taphome.com/en/docs/integration/modbus/) - [Simple configuration using templates](https://taphome.com/en/docs/integration/modbus/templates/) - [Modbus scripts and prefetch](https://taphome.com/en/docs/script/modbus-scripts/) - [Modbus functions](https://taphome.com/en/docs/script/modbus/) - [Modbus data types](https://taphome.com/en/docs/script/modbus-data-types/)