add guides

docs/energy-gateway/compatible-devices/apsystems.md

@@ -0,0 +1,90 @@
+# Modbus TCP Configuration - APsystems ECU
+
+## Communication Setup Overview
+
+APsystems inverters use RS-485 communication via RJ45. To connect to a network, a bridge device is needed to convert RS-485 to Modbus TCP. The Waveshare RS485 to ETH converter (RS232/485 to ETH-B) can be used for this purpose and is available from [Waveshare](https://www.waveshare.com/RS232-485-TO-ETH.htm) directly.
+
+## Prerequisites
+
+- Mobile device with `EMA Manager` app installed from:
+  - `App Store` (iOS)
+  - `Play Store` (Android)
+- Access to the `ECU` device
+- `WiFi` connectivity
+- Waveshare RS485 to ETH converter or equivalent RS-485 to TCP bridge
+- RS-485 cable for connection between ECU and converter
+
+## Configuration Process
+
+### Initial Connection
+
+1. Press the `AP` button on the `ECU`
+2. Connect to WiFi network: `ECU_R_216xxxx`
+3. Use password: `88888888`
+
+### Modbus Configuration
+
+1. Launch `EMA Manager`
+2. Navigate to: `Local Access` → `Workspace` → `Sunspec Configuration`
+3. Enable `Modbus` toggle
+4. Save changes and acknowledge any warnings
+
+### Bridge Setup
+
+1. Connect the RS-485 cable between your ECU's RS-485 port and the Waveshare converter
+2. Configure the converter's network settings according to your local network requirements
+3. Make note of the IP address assigned to the converter - you'll need this for testing and monitoring
+
+## Important Notes
+
+- `AP mode` remains active for 1 hour
+- Press `AP` button again to extend configuration time
+- Your specific inverter IDs will differ from documentation examples
+- Ensure proper wiring between ECU and RS-485 converter
+- Keep the converter in a dry, protected location
+
+## Testing Connectivity
+
+After configuring both the ECU and the RS-485 to TCP bridge, you should verify that the connection is working properly. You can follow our [testing guide](https://github.com/srcfl/egw-getting-started/blob/main/test_con.md) to confirm the connection. When testing APsystems ECU devices through the bridge, remember that the default Modbus port is 502, and the Unit ID is typically set to 1. You may need to wait a few minutes after configuration before the Modbus TCP connection becomes active. When testing, use the IP address of your RS-485 to TCP bridge, not the ECU's IP address.
+
+## Troubleshooting
+
+### Connection Issues
+
+If unable to connect to `ECU`:
+
+1. Verify `AP mode` is active
+2. Maintain close proximity to `ECU` during setup
+3. Check WiFi password (eight 8s)
+
+### Application Issues
+
+If experiencing problems with the app:
+
+1. Verify connection to `ECU` network
+2. Restart `EMA Manager`
+3. Update to latest version
+
+### Modbus Problems
+
+If Modbus is not functioning:
+
+1. Confirm `Modbus` toggle is enabled
+2. Verify inverter IDs are visible
+3. Check RS-485 cable connections
+4. Verify bridge device network settings
+5. Test connection with monitoring system
+
+### Bridge Communication Issues
+
+If the RS-485 to TCP bridge isn't working:
+
+1. Check power supply to the converter
+2. Verify RS-485 cable connections and polarity
+3. Confirm network settings on the converter
+4. Test network connectivity to the converter's IP address
+
+## Source
+
+- Community
+- [APsystems ECU Modbus Settings](https://global.apsystems.com/wp-content/uploads/2022/09/APsystems-Energy-Communication-Unit-ECU-R-User-Manual_Rev7.7_2022-08-30.pdf)

docs/energy-gateway/compatible-devices/deye.md

@@ -0,0 +1,69 @@
+# Modbus TCP Configuration - Deye Inverter
+
+The following guide describes how to configure the `Modbus TCP` settings for Deye inverters and how to test the connection.
+
+## Prerequisites
+
+- Compatible with `SUN-G3-EU-230` Series (300W to 2000W models)
+- Network scanning tool (e.g., `Advanced IP Scanner`)
+- Web browser
+- Network connectivity
+
+## Configuration Process
+
+### Locating Your Inverter
+
+1. Choose one of these methods:
+   - Use your router's interface
+   - Use `Advanced IP Scanner` to identify inverter `IP`
+
+### Accessing Settings
+
+1. Enter inverter `IP` in browser
+2. Login with default credentials:
+   - Username: `admin`
+   - Password: `admin`
+3. Modify URL to: `http://<ipaddress>/config_hide.html`
+
+### Modbus Configuration
+
+Configure "Internal server parameters settings":
+
+1. Set Protocol to `TCP-Server`
+2. Set Port to `8899`
+3. Enter your server `IP` address
+4. Set TCP timeout to `300`
+
+## Testing Connectivity
+
+After completing the configuration, you should verify that the Modbus TCP connection is working properly. Follow our [testing guide](https://github.com/srcfl/egw-getting-started/blob/main/test_con.md) to confirm the connection. For Deye inverters, remember to use port 8899 when testing the connection. The Unit ID is typically set to 1, but you may need to try 0 if that doesn't work.
+
+## Troubleshooting
+
+### Inverter Discovery Issues
+
+If you cannot find your inverter:
+
+1. Verify inverter power status
+2. Check network connectivity
+3. Try alternative network scanning tools
+
+### Settings Problems
+
+If settings are not saving:
+
+1. Confirm you're using the `config_hide.html` URL
+2. Clear browser cache and retry
+3. Verify `admin` access rights
+
+### Modbus Connection Issues
+
+If Modbus is not working:
+
+1. Verify port `8899` is accessible
+2. Check server address accuracy
+3. Test using `Modbus` diagnostic tool
+
+## Source
+
+- Community

docs/energy-gateway/compatible-devices/fronius.md

@@ -1 +1,94 @@
-# Fronius
+# Modbus TCP Configuration - Fronius Inverters
+
+Fronius inverters can be configured for `Modbus TCP` in two different ways, depending on your model. This guide covers both standard Fronius inverters with `Datalogger` and `GEN24` models.
+
+## Prerequisites
+
+Access level requirements vary by model:
+
+- Standard Fronius with `Datalogger`: `Admin` credentials
+- `GEN24`: `Technician` account or `Customer` account with support assistance
+- Network connectivity
+- Web browser
+
+## Configuration for Standard Fronius with Datalogger
+
+### Initial Connection
+
+1. Connect to inverter's WiFi access point:
+   - Locate network name containing `Datalogger ID` (240.xxxxx or 239)
+   - Use default WiFi password: `12345678`
+   - Access web interface at `192.168.250.181` (or assigned IP)
+
+### Modbus Configuration
+
+1. Log in with `Admin` credentials
+2. Navigate to `Modbus` settings
+3. Configure the following:
+   - Set "Data export via Modbus" to `tcp`
+   - Change "Sunspec Model type" to `float`
+4. Save configuration
+
+### Control Priority Setup
+
+1. Access `DNO Editor`
+2. Set "Controlling via Modbus" to priority 1
+3. Adjust priority order if needed
+4. Save changes
+
+## Configuration for GEN24 Series
+
+### Initial Access Setup
+
+1. Connect to inverter WiFi (password: `12345678`)
+2. Navigate to `192.168.250.181`
+3. Access `System` → `Support`
+4. Enable both:
+   - `Remote Access`
+   - `Support User`
+
+### Modbus Configuration (Technician Access)
+
+1. Navigate to `Communication` → `Modbus`
+2. Enable "Control via Modbus TCP"
+3. Set "SunSpec Model Type" to `float`
+4. Enable "Allow Control"
+
+### Control Priority Setup
+
+1. Access `Safety and Grid Regulations`
+2. Set `Modbus Control` to highest priority
+3. Save all changes
+
+## Important Notes
+
+- Password management varies by model type
+- Multiple inverters require individual configuration
+- Document settings for each unit
+
+## Testing Connectivity
+
+After configuring Modbus TCP on your Fronius inverter, it's important to verify that the connection is working properly. You can follow our [testing guide](https://github.com/srcfl/egw-getting-started/blob/main/test_con.md) to confirm the connection. For Fronius inverters, use the default Modbus port 502. The Unit ID is typically set to 1, but you might need to check your specific configuration if this doesn't work. Remember that both standard and GEN24 models use the same Modbus TCP port and Unit ID conventions.
+
+## Troubleshooting
+
+### Access Issues
+
+For login problems:
+
+1. Contact support with model and serial numbers for password resets
+2. Verify network settings
+3. Double-check IP addresses
+
+### Configuration Problems
+
+If experiencing issues:
+
+1. For `GEN24` models, consult installer or Fronius support
+2. Verify all settings are saved properly
+3. Check network connectivity
+
+## Source
+
+- Community
+- [Fronius Inverter Modbus TCP Configuration Guide](https://villageenergy.zohodesk.com/portal/en/kb/articles/enable-modbus-tcp-on-your-fronius-inverter#1_Connect_to_your_Inverters_interface)

docs/energy-gateway/compatible-devices/huawei.md

@@ -1 +1,84 @@
-# Huawei
+# Modbus TCP Configuration - Huawei Inverter
+
+The following guide describes how to configure the `Modbus TCP` settings for Huawei inverters and how to test the connection.
+
+## Prerequisites
+
+### Hardware Requirements
+
+- Mobile device with `Android 4.0` or later
+- Huawei `SDongle`
+- Internet connectivity
+- `WiFi` capability
+
+### Software Requirements
+
+- `SUN2000` App (version `3.2.00.015` or later)
+- Available from `Huawei AppGallery`
+
+## Configuration Process
+
+### Initial Setup
+
+1. Install `SUN2000` App from `Huawei AppGallery`
+2. Ensure `SDongle` remains powered throughout configuration
+
+### Connection Setup
+
+1. Open `SUN2000` App
+2. Select `Connect` → `WLAN`
+3. Choose inverter's WiFi network
+4. Enter password:
+   - First login: `Changeme`
+   - Change password after initial login
+
+### Modbus Configuration
+
+1. Login as installer (default password: `00000a`)
+2. Navigate to: `Settings` → `Communication Configuration` → `Dongle Parameter Settings` → `Modbus-TCP`
+3. Select appropriate access mode:
+   - `Unrestricted`: Allows all LAN devices (one at a time)
+   - `Restricted`: Requires setting trusted IP address
+   - `Disabled`: No Modbus access
+
+## Important Notes
+
+- Configuration settings persist through power cycles
+- New inverters require fresh configuration
+- `SDongle` replacement doesn't require reconfiguration
+- Keep `SDongle` powered during configuration process
+
+## Testing Connectivity
+
+Once you've configured Modbus TCP on your Huawei inverter, it's essential to verify that the connection is working correctly. You can follow our [testing guide](https://github.com/srcfl/egw-getting-started/blob/main/test_con.md) to confirm the connection. For Huawei inverters, note that the default Modbus port is 6607, which differs from the standard Modbus port. The Unit ID is typically set to 1. If you've enabled the restricted access mode, make sure you're testing from an allowed IP address.
+
+## Troubleshooting
+
+### Missing Modbus Options
+
+If Modbus settings are not visible:
+
+1. Check firmware versions
+2. Update app if necessary
+3. Verify `SDongle` compatibility
+
+### Connection Problems
+
+If unable to connect:
+
+1. Ensure `SDongle` is powered
+2. Stay within WiFi range
+3. Verify correct password
+
+### Access Issues
+
+If experiencing access problems:
+
+1. Check IP restrictions if enabled
+2. Verify only one client is connecting
+3. Confirm network settings are correct
+
+## Source
+
+- Community
+- [Huawei Inverter Modbus TCP Configuration Guide](https://forum.huawei.com/enterprise/intl/en/thread/modbus-tcp-guide/667250677153415168?blogId=667250677153415168)