Ferroamp MQTT support sends updates to these topics:

• extapi/data/ehub (interval 1s)
• extapi/data/eso (interval 5s)
• extapi/data/sso (interval 5s)
• extapi/data/esm (interval 60s)

• Home assistant 2021.12
• Enable Ferroamp MQTT by contacting Ferroamp Support to get the username and password for your Energy MQTT broker.
• Enable MQTT in Home assistant and set the broker to your Ferroamp Energy IP and configure it with your username and password received from Ferroamp (or setup a bridge-connection if you already have an MQTT-server, see the Configuring Bridges-section in the Mosquitto documentation).

The repository is compatible with HACS (Home Assistant Community Store).

Install HACS and add the repository to the Custom repositories under HACS Settings tab.

• https://hacs.xyz/docs/installation/manual
  • https://hacs.xyz/docs/basic/getting_started

1. Make sure you have git installed on your machine.
2. Navigate to you home assistant configuration folder.
3. Execute the following command: git clone https://github.com/henricm/ha-ferroamp.git
4. Create a custom_components folder if it does not exist, and cd into it.
5. Create a symbolic link by executing ln -s ../ha-ferroamp/custom_components/ferroamp

1. Add the Ferroamp MQTT Sensors-integration (you might have to refresh your browser window since Home Assistant doesn't update the integration list after a reboot)
2. Set a name for the integration as well as the MQTT-prefix where updates are sent (default values are probably fine for a standard-setup but if a bridge-connection is used the MQTT-topics can be re-mapped)
3. Wait for all the devices to become present (EnergyHub, SSO's, ESOs and ESMs depending on your setup. Be patient since ESMs are only updated every 60 seconds.)

This integration will add lots of sensors for the installed hardware with the prefix <integration name>_. For the SSO and ESO sensors, they will include the id of the SSO or ESO unit, eg sensor.ferroamp_sso_123456_pv_string_power.

I'm also still figuring out what some of the sensors actually are, since the Ferroamp API documentaiton still seems to be incomplete in some areas.

1. Remove the integration configuration. i.e this

   sensor:
     - platform: ferroamp

2. Restart Home Assistant
3. Remove all Ferroamp entities (they will be re-created once the new setup is completed)
4. Follow the regular Setup

NB: Three sensors have changed name due to typos being fixed. Those three will lose their history and any usage in lovelace/automations need to be manually updated.

Renamed sensors:

To avoid too much data into home assistant, we only update sensors with new values every 30 second (average values are calculated where appropriate). This interval can be configured in the options of the integration.

This integration adds services for charging, discharging and autocharge. Please see Ferroamp API documentation for more info about this functionality:

If more than one EnergyHub is configured, the target parameter needs to be set to the name of the EnergyHub to control.

Parameter power needs to be specified in W.

power: 1000

Parameter power needs to be specified in W.

power: 1000

No parameters - sets the battery back into autocharge.

With the Home Assistant Core 2021.8 release an Energy Dashboard was introduced. To set it up correctly with your Ferroamp EnergyHub use the sensors as described below.

External Energy Consumed

External Energy Produced

Total Solar Energy or add one for each SSO and use SSO xxx Total Energy

Battery Energy Produced

Battery Energy Consumed

Inspired from this blog post, I discovered the utility meter sensor available in home assistant. I use it to track grid, solar and battery energy, hourly, daily, monthly by the configuration below in configuration.yml:

utility_meter:
  solar_energy_daily:
    source: sensor.ferroamp_total_solar_energy
    cycle: daily
  solar_energy_monthly:
    source: sensor.ferroamp_total_solar_energy
    cycle: monthly
  battery_energy_produced_daily:
    source: sensor.ferroamp_eso_20030049_total_energy_produced
    cycle: daily
  battery_energy_produced_monthly:
    source: sensor.ferroamp_eso_20030049_total_energy_produced
    cycle: monthly
  battery_energy_consumed_daily:
    source: sensor.ferroamp_eso_20030049_total_energy_consumed
    cycle: daily
  battery_energy_consumed_monthly:
    source: sensor.ferroamp_eso_20030049_total_energy_consumed
    cycle: monthly
  external_energy_consumed_daily:
    source: sensor.ferroamp_external_energy_consumed
    cycle: daily
  external_energy_consumed_monthly:
    source: sensor.ferroamp_external_energy_consumed
    cycle: monthly
  external_energy_produced_daily:
    source: sensor.ferroamp_external_energy_produced
    cycle: daily
  external_energy_produced_monthly:
    source: sensor.ferroamp_external_energy_produced
    cycle: monthly