Skip to content

🔧 Built-In Diagnostic Actions

Having connection issues? Use the built-in Universal Register Scanner to see exactly what your inverter answers, register by register, without a terminal.

The action only appears once a device has been added

Home Assistant does not load an integration until it has at least one configured device, and the scanner is provided by the integration. Installing the files is not enough - Settings -> Tools -> Actions will not list it until you have added an inverter.

This page previously said the opposite. If you are here because you cannot find the action, that is why, and the way through is below.

✨ What It Does

The Universal Register Scanner action:

  • ✅ 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 and add a device

  1. Install through HACS, or extract a release to /config/custom_components/growatt_modbus/
  2. Restart Home Assistant
  3. Add your inverter under Settings -> Devices & Services -> Add Integration

Step 3 is not optional. Until a device exists, Home Assistant never loads the integration, so the scanner action is not registered and will not appear in Settings -> Tools -> Actions.

If your inverter is not supported yet, see Scanning an inverter that is not supported yet - you can still get a scan.

Step 2: Run the Diagnostic

  1. Go to Settings → Tools → Actions
  2. Search for "Growatt Modbus: Universal Register Scanner"
  3. Select your inverter from the Device dropdown (recommended), or enter connection parameters manually
  4. 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

Scanning an inverter that is not supported yet

This is the case the scanner is most useful for, and the one that used to be impossible to reach.

Add the inverter anyway, with a profile chosen by hand. The scan sweeps every register range the integration knows about, regardless of which profile is configured - so the profile you pick does not have to be right, or even close. It only has to let the config flow finish.

  1. Settings -> Devices & Services -> Add Integration -> Growatt Modbus
  2. Enter your connection details as normal
  3. When detection fails or picks something implausible, choose any profile manually
  4. Finish the flow. Entities will be wrong or missing - that is expected and temporary
  5. Run the Universal Register Scanner against that device
  6. Attach the CSV to your GitHub issue

Once the correct profile exists, switch to it under Configure - your entity IDs are preserved.

If the config flow will not complete at all, say so on your issue with the error it shows. That is worth knowing about separately.

📊 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:

  1. Configure the integration:
  2. Go to Settings → Devices & Services
  3. Click Add Integration
  4. Search for Growatt Modbus
  5. Select your inverter model
  6. Enter the same connection details
  7. Check your sensors:
  8. Verify all expected sensors appear
  9. Compare values with inverter display
  10. Add to Energy Dashboard if desired
  11. Configure options:
  12. Set scan interval (default 30s)
  13. Enable grid power inversion if needed
  14. Adjust connection timeout if necessary

📝 Reporting Issues

If diagnostic fails, include this info when reporting:

  1. Full notification text or log output
  2. Inverter model (exact model number)
  3. Adapter type (EW11, USR-W630, etc.)
  4. Time of day you tested
  5. 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:
      - action: 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!