Fronius Solar Inverter Driver

Version 2.19

Monitors one or more Fronius solar inverters over the local Solar API. Exposes live power flow, grid import/export, energy totals, battery and self-sufficiency as system variables; optionally shows live electricity pricing (Amber, flat rate, or time-of-use) and what your solar is worth; fires events and runs optional RTI macros on status changes; and provides a dashboard Web Object plus a hardware-remote Browse Menu.

1. Setup

1. Find the inverter's IP address (your router, or the Fronius Solar.web site / app). Give it a fixed/reserved IP so it does not change.

2. In Driver Properties > Connection, enter the Inverter IP Address. Leave Port at 80 for real hardware.

3. Set a Site Name and Poll Interval (10 seconds is typical).

4. Multiple inverters: enter the primary (the one with the smart meter / battery) as the Inverter IP, then add the others as Additional Inverter 2/3/4 IP. The driver sums each inverter's solar production and reports the whole-site totals.

5. The driver runs a 120-minute trial. To licence it permanently, read the MAC shown in the MACForKey variable (or the debug console), obtain a key, and paste it into Licence > Licence Key.

2. Enabling the Solar API on the inverter

Newer Fronius inverters (GEN24 and similar) ship with the local Solar API switched OFF for security. If the driver shows a connection but no data, log into the inverter's web interface as the Customer user and enable Communication > Solar API, then reload the driver. Note: some GEN24 models only expose the power-flow data over the local API. On those, the detailed grid meter tiles (frequency, voltage, power factor, lifetime import/export) are hidden automatically, and "today's energy" is derived from the lifetime total - this is expected and everything else works normally.

3. Energy Pricing (optional)

Driver Properties > Energy Pricing > Pricing Mode selects how prices and the dollar value are worked out:

Off: no pricing. The dollar tiles are hidden.

Amber Electric (live): pulls live wholesale buy and sell prices from your Amber account. Paste your Amber API Token (get it free in the Amber app under Settings > Developers > Generate a new token) and leave Amber Site ID blank - the driver finds your site automatically. This lights up the live Import Price, Feed-in Price, Renewables percent and price-event tiles.

Flat rate: enter Flat: Import Rate per kWh (what you pay to buy power, e.g. 0.30) and the Feed-in / Value per kWh field below (what you are paid to export, e.g. 0.07).

Time of Use: enter Peak and Off-Peak import rates and the Peak Start / End hours (24-hour clock), plus the Feed-in / Value rate.

All rates are in dollars per kWh. If you are on Amber, the token is the accurate option and the flat fields can be left blank.

4. Savings and Environment

Feed-in / Value per kWh drives the "Value Today / Lifetime" dollar tiles (energy multiplied by this rate). CO2 Factor (kg per kWh, default 0.79 for Australia) drives the CO2-avoided tiles. Currency Symbol sets the prefix shown on dollar values.

5. Web Object Dashboard

A premium dashboard with an adaptive production gauge, a power-flow hero, and swipeable cards (production, grid, house, self-sufficiency, energy, battery, pricing, savings, CO2, inverters). Tap any card to expand it for detail. The "Power Today" card opens a full intraday graph of solar generation versus home consumption, with the surplus (excess) period shaded green so you can see exactly when free solar is available to run discretionary loads. The card carousel auto-scrolls and has prev / pause / next controls beneath it. Tap the gear to change the colour theme. It scales to any Web Object size. There are two ways to serve it:

On the processor (default, recommended): leave "Enable Web Object (On Processor)" on and add a Web Object pointing at the processor's own address (default port 9060):

http://THIS-PROCESSOR-IP:9060/

No internet or cloud is needed - the processor serves everything.

Cloud (optional): tick "Also Push To Cloud Dashboard" to let a panel show the data without LAN access to the processor, using:

https://shpdrivers.services/fronius/?mac=YOUR-PROCESSOR-MAC

6. Browse Menu (hardware remotes)

For ISR / T-class remotes that cannot render a Web Object, drop the "Browse" tag onto a list widget to auto-bind the menu. Drop the "Browse Back" and "Browse Home" tags onto buttons. The menu covers Production, Grid, House, Self-Sufficiency, Energy, Battery, Energy Pricing, Savings and Environment, Inverters and Status. If you change the list-selection wiring or upgrade the driver, simply re-drop the "Browse" tag to refresh the binding.

7. Macros On Status Change

Each status change can run an RTI macro AND fire an event. In Driver Properties > Macros On Status Change, pick a macro for any of: Connected, Disconnected, Started / Stopped Exporting, Production Started / Stopped, High / Low Production, Battery Charging / Discharging, Battery Low, Battery Full, Grid Import High, Surplus Available, Daily Target Reached, Price Spike, Price Negative, High Feed-in. Example: start the pool pump or EV charger when the system has surplus to export, or when the Amber price goes negative.

8. Events

CONNECTED, DISCONNECTED, EXPORTING_TO_GRID, IMPORTING_FROM_GRID, PRODUCTION_STARTED, NO_PRODUCTION, HIGH_PRODUCTION, LOW_PRODUCTION, BATTERY_CHARGING, BATTERY_DISCHARGING, BATTERY_LOW, BATTERY_FULL, GRID_IMPORT_HIGH, SURPLUS_AVAILABLE, DAILY_TARGET_REACHED, PRICE_SPIKE, PRICE_NEGATIVE, FEEDIN_HIGH.

9. Thresholds

In Driver Properties > Thresholds: Export, High Production, Low Production, Surplus and Grid Import High (watts); Battery Low and Battery Full (percent); Daily Energy Target (kWh). In Energy Pricing: Price Spike Threshold and High Feed-in Threshold (dollars per kWh). These control when the matching events and macros fire.

10. Key System Variables

SolarPower, SolarWatts, IsProducing, GridPower, GridDirection, IsExporting, HouseLoad, Autonomy, SelfConsumption, EnergyToday, EnergyYear, EnergyTotal, HasBattery, BatteryPower, BatterySOC, BatteryCharging, InverterCount, InverterStatus, Connected. Pricing: PricingMode, CurrentImportPrice, CurrentFeedInPrice, PriceRenewables, PriceDescriptor, PriceSpike, PriceNegative, FeedInHigh. Savings: MoneySavedToday, MoneySavedTotal, CO2Today, CO2Total. Per-inverter: Inv1Power..Inv4Power. Diagnostics: HasMeter, HasGridData, GridFrequency, GridVoltageL1/L2/L3.

11. Debug Console

Telnet to the processor on the Debug Console Port (default 12509) for live diagnostics. Type help for commands (status, vars, poll, solar, grid, energy, battery, inverters, api, probe).

Support

Smart Home Programming - https://smarthomeprogramming.com.au