SMA

Getting Started

Connect your SMA hybrid inverter to monitor real-time solar generation, battery state of charge, and grid flows in Joule Genie. Note that the SMA ennexOS public API is read-only — timed charge scheduling is not supported via the cloud API.

Step 1: Check Your Sunny Portal or ennexOS Account

Log in to your SMA account at sunny-portal.com (older systems) or ennexos.com (newer systems). Confirm that your inverter appears in the plant list and is showing live data. If you have never used the SMA portal, contact your installer to ensure the inverter is registered and data-logging is enabled.

Step 2: Add the Integration in Joule Genie

In Joule Genie, go to Settings > Integrations > Add Integration and select SMA from the Inverter category. Enter the email address and password you use to log in to Sunny Portal or ennexOS. Click Find my plants.

Step 3: Select Your Plant

Joule Genie will connect to the SMA monitoring API and list all plants registered to your account. Select the plant you want to monitor. The peak power (kWp) is shown to help identify the correct site. If you only have one plant it will be selected automatically.

Step 4: Verify Connection

Within a few minutes, the dashboard will show real-time solar generation, battery state of charge, and grid flows. Data updates in line with the SMA cloud polling cycle (typically every 5 minutes).

API Limitations

• The SMA ennexOS Monitoring API is read-only. Timed battery charge scheduling is not available via the API — configure charge windows through the SMA Energy app, Sunny Home Manager, or the inverter web interface.
• The monitoring API requires that your inverter is data-logging to Sunny Portal or ennexOS. Local-only setups (no cloud connection) are not supported via this integration.

Troubleshooting

• "Authentication failed"? Double-check the email and password for your Sunny Portal or ennexOS account. If you log in via a social provider (Google), try setting a direct password via the account settings page first.
• No plants found? Ensure at least one plant is visible and actively logging data in your Sunny Portal or ennexOS account. It may take up to 24 hours after commissioning for a new plant to appear.
• No readings? Check that the inverter is online and the monitoring connection is active in the SMA portal. A red or grey status icon indicates the inverter is not currently sending data.