Modbus Local Gateway component
This is a Home Assistant integration to support modbus devices running behind a Modbus TCP gateway.
Device support
The has been tested with a WaveShare Wi-Fi to RS485 gateway (https://www.waveshare.com/rs485-to-wifi-eth.htm) Configured as a Modbus RTU to Modbus TCP gateway.
Configuration for the WaveShare Wi-Fi gateway
| Configuration Page | Setting | Value |
|---|---|---|
| Mode Selection | Data Transfer Mode | Modbus TCP<==>Modbus RTU |
| Application | Baud Rate | 9600 |
| Application | Data Bits | 8 |
| Application | Parity | None |
| Application | Stop | 1 |
| Application | Bradrate adaptive | Disable |
| Application | UART AutoFrame | Disable |
| Application | Modbus Polling | Off |
| Application | Network A, TCP Time out | 5 |
| Application | Network A, MAX TCP Num | 24 |
Slave devices for testing have been:
- Growatt MIN-6000-TL-XH
- Growatt MOD-6000-TL-X
- Growatt MIC-2500-TL-X
- Eastron SDM230
- Eastron SDM630
- Finder 7M.38
- Finder 7M.24
Note that devices sometimes get firmware upgrades, or incompatible versions are sold under the same model name, so it is possible that the device will not work despite being listed.
Support for additional devices can be added via yaml configuration files in the devices folder. Existing configuration files can be used as templates.
Installation
Installation is easiest via the Home Assistant Community Store (HACS), which is the best place to get third-party integrations for Home Assistant. Once you have HACS set up, simply click the button below (requires My Homeassistant configured) or follow the instructions for adding a custom repository and then the integration will be available to install like any other.
Configuration
After installing, you can easily configure your devices using the Integrations configuration UI. Go to Settings / Devices & Services and press the Add Integration button, or click the shortcut button below (requires My Homeassistant configured).
Stage One
The first stage of configuration is to provide the information needed to connect to the device.
- IP address / hostname
- TCP Port number
- Modbus Slave ID
- Prefix for Sensors
Stage Two
Select the correct device type.
Configuration
Configuration of the update frequency can be performed defaults to 30 seconds