# Waveshare relays

<!-- BEGIN GENERATED: __badges_waveshare-relay-d8__ -->
<span class="badge testing">TESTING</span> <span class="badge origin-etm">ETM</span> <span class="badge experimental">EXPERIMENTAL</span>

<!-- END GENERATED -->

Waveshare relay module (8-channel RS485 variant), driven over **Modbus RTU**.

## 1. Hardware required

- Waveshare 8-Channel Relay Module (RS485)
- A USB↔RS485 adapter on the hub side
- 12 V DC supply + bus cable (A/B)

## 2. RS485 wiring

A↔A, B↔B, common ground, **120 Ω** at the end of the bus.
12 V DC to the module's VCC/GND terminals.

## 3. Modbus addressing

Default address: **1**. Configurable from the Waveshare utility, or by the
Modbus address-change command.

Parameters: **9600 bps, 8N1**.

## 4. Adding in PowerSync

Manual addition (serial port, slave address).
See [Adding a device](../../installation/application.md).

---

## Reference

<!-- BEGIN GENERATED: integrationpluginwaveshare-relay-d8.json -->
**Manufacturer:** Waveshare  
**Plugin:** `WaveshareRelayD8`

#### Supported models
| Model | Role | Transport | Pairing | Quantities |
| --- | --- | --- | --- | --- |
| **Waveshare Relay D8** | — | Modbus RTU | Auto-discovery | 17 |

#### Per-model detail
??? abstract "Waveshare Relay D8 — `waveshareRelayD8`"
    _Settings:_

    | Key | Label | Type | Range | Default | Read-only |
    | --- | --- | --- | --- | --- | --- |
    | `rtuMaster` | Modbus RTU master UUID | QString | — | — | no |
    | `slaveAddress` | Modbus slave address | int | 1–247 | `1` | no |

    _Measured quantities:_

    | Key | Quantity | Type | Unit |
    | --- | --- | --- | --- |
    | `connected` | Connected | bool | — |
    | `relay1State` | Relay 1 | bool | — |
    | `relay2State` | Relay 2 | bool | — |
    | `relay3State` | Relay 3 | bool | — |
    | `relay4State` | Relay 4 | bool | — |
    | `relay5State` | Relay 5 | bool | — |
    | `relay6State` | Relay 6 | bool | — |
    | `relay7State` | Relay 7 | bool | — |
    | `relay8State` | Relay 8 | bool | — |
    | `input1State` | Input 1 | bool | — |
    | `input2State` | Input 2 | bool | — |
    | `input3State` | Input 3 | bool | — |
    | `input4State` | Input 4 | bool | — |
    | `input5State` | Input 5 | bool | — |
    | `input6State` | Input 6 | bool | — |
    | `input7State` | Input 7 | bool | — |
    | `input8State` | Input 8 | bool | — |

<!-- END GENERATED -->