Skip to content

Commit 918fdaf

Browse files
committed
conflit resolution
1 parent 8706bf0 commit 918fdaf

1 file changed

Lines changed: 27 additions & 18 deletions

File tree

README.md

Lines changed: 27 additions & 18 deletions
Original file line numberDiff line numberDiff line change
@@ -9,7 +9,8 @@
99
[![CodeQL](https://github.com/HotNoob/PythonProtocolGateway/actions/workflows/github-code-scanning/codeql/badge.svg)](https://github.com/HotNoob/PythonProtocolGateway/actions/workflows/github-code-scanning/codeql)
1010

1111
For advanced configuration help, please checkout the documentation :)
12-
https://github.com/HotNoob/PythonProtocolGateway/tree/main/documentation
12+
13+
[/documentation](/documentation)
1314

1415
# Python Protocol Gateway
1516

@@ -18,8 +19,9 @@ Configuration is handled via a small config files.
1819
In the long run, Python Protocol Gateway will become a general purpose protocol gateway to translate between more than just modbus and mqtt.
1920

2021
For specific device installation instructions please checkout the documentation:
21-
Growatt, EG4, Sigineer, SOK, PACE-BMS
22-
https://github.com/HotNoob/PythonProtocolGateway/tree/main/documentation
22+
Growatt, EG4, Sigineer, SOK, PACE-BMS, Sigineer, ect...
23+
24+
[/documentation/devices](/documentation/devices)
2325

2426
# General Installation
2527
Connect the USB port on the inverter into your computer / device. This port is essentially modbus usb adapter.
@@ -29,7 +31,7 @@ Alternatively, connect a usb adapter to your rs485 / can port with appropriate w
2931

3032
### install as homeassistant add-on
3133
checkout:
32-
https://github.com/felipecrs/python-protocol-gateway-hass-addon/tree/master
34+
[PPG HASS Addon](https://github.com/HotNoob/python-protocol-gateway-hass-addon/tree/master)
3335

3436
### install requirements
3537
```
@@ -50,21 +52,30 @@ nano config.cfg
5052
manually select protocol in .cfg
5153
protocol_version = {{version}}
5254
```
55+
eg4_v58 = eg4 inverters
56+
eg4_3000ehv_v1 = eg4 inverters
5357
v0.14 = growatt inverters 2020+
5458
sigineer_v0.11 = sigineer inverters
55-
growatt_2020_v1.24 = alt protocol for large growatt inverters - currently untested
56-
srne_v3.9 = SRNE inverters - confirmed working-ish
57-
victron_gx_3.3 = Victron GX Devices - Untested
58-
solark_v1.1 = SolarArk 8/12K Inverters - Untested
59+
srne_v3.9 = SRNE inverters
60+
5961
hdhk_16ch_ac_module = some chinese current monitoring device :P
60-
srne_2021_v1.96 = SRNE inverters 2021+ (tested at ASF48100S200-H, ok-ish for HF2430U60-100 )
62+
```
6163

62-
eg4_v58 = eg4 inverters ( EG4-6000XP, EG4-12K, EG4-18K ) - confirmed working
63-
eg4_3000ehv_v1 = eg4 inverters ( EG4_3000EHV )
64+
Untested Protocols
6465
```
66+
growatt_2020_v1.24 = alt protocol for large growatt inverters
67+
victron_gx_3.3 = Victron GX Devices
68+
solark_v1.1 = SolarArk 8/12K Inverters
69+
```
70+
71+
For a complete list of protocols, explore:
72+
[/Protocols](/protocols)
6573

66-
more details on these protocols can be found in the documentation:
67-
https://github.com/HotNoob/PythonProtocolGateway/tree/main/documentation
74+
For a more complete list of tested devices & protocols:
75+
[Tested Devices & Protocols](documentation/usage/devices_and_protocols.csv)
76+
77+
more advanced details can be found in the documentation:
78+
[/Documentation](/documentation)
6879

6980
### run as script
7081
```
@@ -109,8 +120,8 @@ once installed; the device should show up on home assistant under mqtt
109120

110121
```Settings -> Devices & Services -> MQTT ```
111122

112-
more docs on setting up mqtt here: https://www.home-assistant.io/integrations/mqtt
113-
i probably might have missed something. ha is new to me.
123+
more docs on setting up mqtt here:
124+
https://www.home-assistant.io/integrations/mqtt
114125

115126
#### connect mqtt on home assistant with external mqtt broker
116127
[HowTo Connect External MQTT Broker To HomeAssistant](https://www.youtube.com/watch?v=sP2gYLYQat8)
@@ -122,8 +133,6 @@ git pull
122133
systemctl restart protocol_gateway.service
123134
```
124135

125-
**if you installed this when it was called growatt2mqtt-hotnoob or invertermodbustomqtt, you'll need to reinstall if you want to update. **
126-
127136
### Unknown Status MQTT Home Assistant
128137
If all values appear as "Unknown"
129138
This is a bug with home assistant's discovery that some times happens when adding for the first time. just restart the service / script and it will fix itself.
@@ -164,6 +173,6 @@ donations / sponsoring this repo would be appreciated.
164173
- ``` docker pull hotn00b/pythonprotocolgateway ```
165174
- ```docker run -v $(pwd)/config.cfg:/app/config.cfg --device=/dev/ttyUSB0 hotn00b/pythonprotocolgateway```
166175

167-
See [config.cfg.example](https://github.com/HotNoob/PythonProtocolGateway/blob/main/config.cfg.example)
176+
See [config.cfg.example](/config.cfg.example)
168177

169178
[Docker Image Repo](https://hub.docker.com/r/hotn00b/pythonprotocolgateway)

0 commit comments

Comments
 (0)