🔧 Built-In Diagnostic Service¶

Having connection issues? Use our built-in diagnostic service to test your connection before installing the integration!

✨ What It Does¶

The Universal Register Scanner diagnostic service:

✅ Tests TCP connection to your adapter
✅ Auto-detects your inverter model (VPP 2.01 inverters)
✅ Scans all register ranges automatically
✅ Validates responses are correct
✅ Shows results as a notification
✅ Exports complete register dump to CSV
✅ No Terminal or SSH needed!

Note: For VPP Protocol V2.01-capable inverters, auto-detection identifies your model automatically. Legacy protocol inverters require manual model selection.

🚀 How to Use¶

Step 1: Install the Integration Files¶

You don't need to configure the integration, just have the files installed:

Download the latest release
Extract to /config/custom_components/growatt_modbus/
Restart Home Assistant

The diagnostic service will be available immediately!

Step 2: Run the Diagnostic¶

Go to Developer Tools → Actions
Search for "Growatt Modbus: Universal Register Scanner"
Select your inverter from the Device dropdown (recommended), or enter connection parameters manually
Click "Perform Action"

The scanner will: - Automatically detect your model (if VPP 2.01 supported) - Scan all register ranges (0-124, 125-249, 1000-1124, 3000-3249) - Show detection confidence rating (High/Medium/Low) - Export results to CSV file

Step 3: Check Results¶

Option A: Notification (if enabled)

A persistent notification will appear in the top-right
Shows test results and troubleshooting advice
Click to expand full details

Option B: Logs

Go to Settings → System → Logs
Search for growatt_modbus
View detailed test results

📊 Example Results¶

✅ Auto-Detection Success (VPP 2.01 Inverter)¶

🔌 Universal Register Scanner

✅ Auto-Detection: MIN 7000-10000TL-X (V2.01)
Confidence: HIGH
DTC Code: 5201 (register 30000)
Protocol Version: 2.01 (register 30099)

Scanned Registers:
• Range 0-124: 89 readable
• Range 3000-3249: 124 readable
• Range 30000-30999: 43 readable (V2.01)
• Range 31000-31999: 67 readable (V2.01)

Sample Values:
• Status (3000): Normal
• PV1 Voltage (3003): 284.50 V
• PV2 Voltage (3007): 289.00 V
• PV3 Voltage (3011): 291.20 V
• AC Voltage (3026): 240.10 V

CSV exported to: /config/growatt_register_scan_20250121_143022.csv

✅ Next Steps:
Your inverter supports VPP 2.01 and was auto-detected!
Configure the integration - auto-detection will identify it automatically.

⚠️ Legacy Inverter (No Auto-Detection)¶

🔌 Universal Register Scanner

⚠️ Auto-Detection: FAILED
Reason: DTC register (30000) not readable
Conclusion: Legacy protocol inverter (V1.39 or V3.05)

Scanned Registers:
• Range 0-124: 78 readable
• Range 3000-3249: 0 readable
• Range 30000-30999: 0 readable (V2.01 not supported)
• Range 31000-31999: 0 readable (V2.01 not supported)

Sample Values:
• Status (0): Normal
• PV1 Voltage (3): 285.30 V
• PV2 Voltage (7): 289.50 V
• AC Voltage (38): 241.20 V

CSV exported to: /config/growatt_register_scan_20250121_150033.csv

⚠️ Next Steps:
Your inverter uses legacy protocol (no V2.01 support).
When configuring the integration, you will need to manually select your inverter series.
Based on scan results, possible models: MIC or MIN 3-6kW

❌ All Tests Failed¶

🔌 Growatt Diagnostic: MIN 7000-10000TL-X

❌ All tests failed (0/6)

Results:
• ✅ Connected to 192.168.1.147:502
• ❌ Register 3000 (Status): Read error
• ❌ Register 3003 (PV1 Voltage): Read error
• ❌ Register 3007 (PV2 Voltage): Read error
• ❌ Register 3011 (PV3 Voltage): Read error
• ❌ Register 3026 (AC Voltage): Read error

❌ Troubleshooting:
No registers responded. Check:
• Wiring (try swapping A/B)
• Slave ID (try 1, 2, or 3)
• Inverter is powered on
• Baud rate is 9600

📊 Understanding Status Values¶

The Status register (shown as "Status: Normal" in results) indicates the inverter's current operating state:

Status	Meaning	When You'll See It
Waiting	Waiting for sufficient PV power or grid	Startup, low sun, early morning/late evening
Normal	Operating normally	Active power generation during day
Fault	Fault condition detected	Error state - check fault code for details

Typical Daily Cycle: - Sunrise: Waiting → Normal (as PV voltage builds) - Daytime: Normal (active generation) - Sunset: Normal → Waiting → Offline - Night: Inverter powered off (no response)

💡 Tip: If the scanner shows "Waiting" during sunny conditions, check for low PV voltage, grid issues, or inverter configuration.

🎯 What Gets Tested¶

MIN 3000-6000TL-X¶

Status register
PV1 & PV2 voltage
AC voltage
AC frequency

MIN 7000-10000TL-X¶

Status register
PV1, PV2, PV3 voltage
AC voltage

SPH 3000-10000 (Hybrid)¶

Status register (base range)
PV1 & PV2 voltage
AC voltage
Battery voltage
Battery SOC

MID 15000-25000TL3-X (Three-phase)¶

Status register
PV1 voltage
Grid voltages (R, S phases)
Grid frequency

MOD 6000-15000TL3-XH (Three-phase hybrid)¶

Status register
PV1 voltage
AC voltage (R phase)
Battery voltage
Battery SOC

🐛 Troubleshooting¶

"Service not found"¶

Integration files not installed correctly
Restart Home Assistant after installing files
Check /config/custom_components/growatt_modbus/ exists

"Connection refused"¶

Adapter not listening on port 502
Check adapter web interface settings
Verify TCP Server or Modbus Gateway mode

"Timeout" errors¶

Inverter is offline (try during daytime)
Wrong IP address
Network connectivity issue

All registers fail but connection succeeds¶

Wrong slave ID (try 1, 2, 3)
RS485 wiring incorrect (swap A/B)
Wrong inverter model selected
Baud rate mismatch (should be 9600)

Some registers work, others don't¶

Normal if inverter is offline (night time)
Some values may be 0V during standby
Battery registers won't work on non-hybrid models
Try again during daytime with sun

🔄 Testing Different Settings¶

You can run the diagnostic multiple times with different settings:

Test different slave IDs:

host: 192.168.1.100
slave_id: 1    # Try 1, then 2, then 3

Test different models:

inverter_series: min_7000_10000_tl_x    # Try different profiles

Test without notification:

notify: false    # Results only in logs

✅ Next Steps After Success¶

Once your diagnostic passes:

Configure the integration:
Go to Settings → Devices & Services
Click Add Integration
Search for Growatt Modbus
Select your inverter model
Enter the same connection details
Check your sensors:
Verify all expected sensors appear
Compare values with inverter display
Add to Energy Dashboard if desired
Configure options:
Set scan interval (default 30s)
Enable grid power inversion if needed
Adjust connection timeout if necessary

📝 Reporting Issues¶

If diagnostic fails, include this info when reporting:

Full notification text or log output
Inverter model (exact model number)
Adapter type (EW11, USR-W630, etc.)
Time of day you tested
Inverter display shows (voltage, status, etc.)

Post in GitHub Issues with this information!

🎨 Advanced: Automation Example¶

You can even automate diagnostics! Run tests automatically:

automation:
  - alias: "Test Inverter Connection at Sunrise"
    trigger:
      - platform: sun
        event: sunrise
        offset: "+00:30:00"  # 30 min after sunrise
    action:
      - service: growatt_modbus.run_diagnostic
        data:
          host: "192.168.1.100"
          port: 502
          slave_id: 1
          inverter_series: "min_7000_10000_tl_x"
          notify: true

💡 Tips¶

Test during daytime - Inverter needs to be powered on
Wait 30 seconds after wiring changes before testing
Try all slave IDs - Some inverters use 2 or 3 instead of 1
Check adapter LEDs - Activity lights should blink during test
Compare with display - Values should match inverter screen
Test twice - First test might fail as inverter wakes up

Questions? Ask in GitHub Discussions

Found a bug? Report in GitHub Issues

Made with 🔧 and ☕ for easier troubleshooting from the comfort of your HA UI!