This is a Home Assistant integration to support modbus devices running behind a Modbus TCP gateway.
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 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 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.
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).
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
Select the correct device type.
Configuration of the update frequency can be performed defaults to 30 seconds