Verified by Homebridge

For GivEnergy homes. With Homebridge.

Local GivEnergy control, refined for Apple Home

Keep your home battery for your home.

Your car has a cheap charging slot. Your home battery shouldn’t have to pay for it. GivHome helps stop your battery draining into your EV during Intelligent Octopus Go sessions.

GivHome follows Octopus smart charging windows and protects stored energy for the house. Battery, solar and everyday controls stay close at hand in Apple Home.

Free Homebridge pluginLocal battery controlWorks with Apple Home
GivHome battery, solar and energy controls in Apple Home

GivHome is a free Homebridge plugin for compatible GivEnergy systems. It brings battery readings and controls into Apple Home and helps protect stored energy during Intelligent Octopus Go smart EV charging.

Keep stored energy for your home

Protect your battery during Octopus smart EV charging.

Make the most of cheap electricity

Choose your overnight period and Night Target. Let tomorrow’s solar help shape the charge.

Your energy, all together

Battery, solar, import and export at a glance in Apple Home.

Intelligent Octopus Go battery protection

Charge the car. Keep energy for the house.

Without protection, your inverter can treat the EV as another household load and use your stored battery energy to charge it—even during a cheap Octopus slot. GivHome helps keep that energy where you wanted it.

Follows your smart charging slotsGivHome follows the windows supplied by Octopus, including extra slots outside your usual overnight period.
Protects your home batteryWith IOG protection configured, GivHome uses your inverter’s supported controls to help prevent the car from draining stored energy.
Leaves the EV with OctopusGivHome looks after the home battery. Octopus continues to control the car’s charging.

Set up IOG battery protection

New in GivHome 4.1

More control when you need it.
More room for tomorrow’s sunshine.

Two thoughtful additions to everyday battery life. A way back to normal when you need it, and an overnight charge that makes room for the day ahead.

Emergency Stop

Back to normal, from Apple Home.

If your battery is charging or exporting unexpectedly, tap Emergency Stop. GivHome stops the current action, returns the battery to normal Eco operation and checks that the stop has taken effect.

Eligible future schedules stay in place. Once the stop is confirmed, you can start a new action whenever you’re ready.

How Emergency Stop works
Solar-Aware Cheap Overnight

Leave room for tomorrow.

A dull day may call for more cheap overnight energy. A brighter day may give your battery another chance to fill from your own panels.

Choose three overnight battery levels and the forecast boundaries between them. GivHome uses tomorrow’s forecast to apply the right level, within your normal Night Target.

Choose your solar-aware charge

Learning locally. Preparing for what comes next.

Local Learning begins building a picture of your home’s energy use, solar generation and charging response. It uses readings GivHome already receives, keeps its observations on your Homebridge device and limits the storage it uses. It is enabled by default and can be switched off in Plugin Config.

This prepares the ground for future Automatic Solar-Aware Cheap Overnight. Local Learning does not yet calculate or change charging targets.

More from your battery. Less to think about.

Keep energy for the house, charge when electricity is cheap and put spare energy to use. Choose what suits your household and let GivHome look after the routine.

Intelligent Octopus Go

Keep your battery energy for the house

GivHome follows Octopus smart EV charging slots and can protect your stored energy while the car charges. That includes extra cheap slots outside your usual overnight period.

Your energy, at a glance

See your energy at a glance

GivHome shows battery level, solar generation, import and export together in Apple Home. It gets the readings directly from your inverter over your home network.

Night Target

Your overnight charge. Your choice.

Set the battery percentage you want Cheap Overnight to work towards, from Apple Home. It is your normal overnight target and the maximum for solar-aware charging. IOG protection and timed charges keep their own targets.

A little extra control

A little extra charge when you need it

Start a timed charge or export from Apple Home, or pause supported charging and discharging. GivHome checks the inverter and manages when timed actions finish.

Flux and Agile

Sell spare energy. Keep your reserve.

Optional evening and Flux export plan around the energy you can spare and the reserve you want to keep. Agile Outgoing adds half-hour prices, with a preview before you enable live export.

History and forecast

Plan ahead with tomorrow's solar

Add each array’s capacity, direction, tilt and shading. GivHome estimates tomorrow’s generation and sets the Solar 2mrw tile scale for you. Forecasts refresh every 90 minutes. For what actually happened, look back in Eve.

See where your energy went.

Check the moment in Apple Home. Look back over hours, days, weeks and months in Eve. GivHome records solar, import and export history locally, so you can see how your home uses energy over time.

At home on your home network.

GivHome connects directly to your inverter for everyday readings and supported controls. Octopus supplies smart charging times and tariff information; Open-Meteo supplies the weather data for solar forecasts.

Quick to checkOpen Home for the latest available readings. GivHome checks for changes in the background.
Timed means timedGivHome follows timed charge and export actions through to their end.
Built for your systemAvailable controls depend on your inverter. GivHome checks which ones your system supports.

Cheap charging. Sensible exporting.

Fill the battery during your cheap period, keep stored energy for the house when the car charges, and export energy you can afford to spare. Choose the options that fit your tariff and household.

Cheap OvernightCharge towards your chosen target during your low-rate period. You can use it without Intelligent Octopus Go.
Flux ExportUse the valuable peak period to sell spare energy while keeping your chosen reserve.
Agile OutgoingPlan around changing export prices. Start with the preview; live export needs deliberate setup.

Careful with the battery you rely on.

GivHome checks the inverter before supported control actions and verifies important changes. When an action finishes, it restores the settings it borrowed while respecting newer changes made elsewhere. If communication is interrupted, recovery can continue when it returns. Available controls and charging limits depend on your inverter; the FAQs explain what to check.

Get started with GivHome

Open Plugins in Homebridge, search for GivHome and click Install. Then connect your inverter and pair GivHome with Apple Home.

View the Homebridge plugin

Free to install. Runs on your Homebridge host.

1In Homebridge, open Plugins, search for GivHome and click Install or Update to get the published plugin.
2Open the plugin settings and enter your inverter IP address and serial number. Confirm local readings before enabling battery controls.
3Enable the Child Bridge, restart when prompted and pair it with Apple Home. Choose the features that suit your home, then save your settings.
Detailed setup journey

Install through Homebridge

  1. Sign in to your Homebridge dashboard and open Plugins.
  2. Search for GivHome and click Install. Existing users can click Update on the GivHome plugin card.
  3. Follow any restart prompt and open the GivHome plugin settings.

Configure GivHome

  1. Enter the local inverter IP address and serial number. The serial is a safety gate: GivHome rejects a responder that does not match.
  2. Leave the Modbus port at 8899 unless you are deliberately validating another adapter.
  3. Start with telemetry only. Confirm Apple Home shows sensible battery, solar, import, export and load values.
  4. Choose the charging, export, history and forecast features that suit your home. The advanced charging check is recommended for new users. Remember to click Save at the end.

Enable the Child Bridge and pair with Apple Home

  1. On the GivHome card, enable Child Bridge and restart when prompted.
  2. Return to the plugin card, open the pairing code, then scan the QR code with your iPhone camera or enter the code in Apple Home.
  3. Once paired, move the new GivHome tiles to the right room and favourite the ones you use often.

Before using live controls

Keep a Homebridge backup and a route back to the previous plugin version. Test charge and export controls while you are at home and able to watch the system.

Recommended for Apple Home: use a HomePod, HomePod mini or Apple TV as your Apple Home hub. GivHome can work locally on your home network without one, but the overall Apple Home experience is better with a Home hub, especially for remote access and reliable automations.
Updating from v4? Your settings, Apple Home accessories, Eve history and Local Learning data carry forward. Night Target keeps your saved overnight percentage. Keep a Homebridge backup before updating. Moving from v3? Read the migration guide in the plugin documentation first.

Good to know

A few useful answers before you get started.

How do I use Emergency Stop?

Tap Emergency Stop in Apple Home to stop an unwanted forced battery charge or export. GivHome checks the current action, returns the battery to normal Eco operation and verifies the result. The tile returns Off when the stop completes. If GivHome cannot confirm the result, Apple Home shows a fault and GivHome keeps track of unfinished recovery, including after restart. The tile is available by default on supported systems with battery control enabled; you can hide it in Plugin Config. It controls the home battery. EV charging stays under Octopus’s control.

How do I use Solar-Aware Cheap Overnight?

Set up Cheap Overnight and Predicted Solar in Plugin Config, then enable Solar-Aware Cheap Overnight. Choose battery levels for low, medium and high solar days, and set the forecast boundaries between them. Turn its Apple Home switch On to use those choices, or Off to use your normal Night Target. A missing or unsuitable forecast also uses your normal target. Your Night Target remains the maximum; IOG protection keeps its own target.

Does Local Learning change my charging?

No. It records existing readings and forecasts to begin learning about your home. Observations stay on the Homebridge device, storage is limited and no learning history is sent to the developer. Learning is enabled by default and can be switched off in Plugin Config. Automatic calculation of charging targets is a future development.

Can I use GivEnergy with Apple Home or HomeKit?

Yes. GivHome runs on Homebridge and connects compatible GivEnergy systems to Apple Home using HomeKit. See battery and solar readings and use supported controls from the Home app. Read the GivEnergy and Apple Home setup guide.

How can I keep my house battery from draining into my EV?

With Intelligent Octopus Go configured, GivHome follows Octopus smart EV charging slots and can protect your house battery during those periods. Protection depends on your inverter's supported controls and the selected settings; it is not a promise for every EV charging session. Read about smart EV charging and battery protection.

What is Battery Care Charging?

Battery Care can plan a gentler charge rate during your main cheap overnight period when there is enough time to reach your target. It is optional and does not apply to extra smart EV slots or manual charging.

Looking for GivHome for iPhone or iPad?

Explore GivHome for iPhone and iPad. This page covers GivHome for Homebridge, which runs on your Homebridge host and brings compatible GivEnergy systems into Apple Home.

What is included?

GivHome 4.1 brings local monitoring and supported battery controls, Emergency Stop, Night Target, Solar-Aware Cheap Overnight, Intelligent Octopus Go protection, export planning, Eve history and Predicted Solar into Apple Home. Local Learning prepares for future features on your Homebridge device. Choose what suits your home in Plugin Config; available controls depend on your inverter.

How do I install GivHome?

In your Homebridge dashboard, open Plugins, search for GivHome and click Install. Homebridge installs the complete plugin. Open its settings, enter your inverter details, then enable the Child Bridge and pair it with Apple Home. Existing users can update from the GivHome plugin card.

Do I need GivTCP or MQTT?

No. GivHome connects directly to your inverter over your home network for monitoring and supported controls. Those functions do not need GivTCP, MQTT or the GivEnergy cloud.

What changes if I have an older GivHome setup?

Older setups used GivTCP and MQTT. The current plugin connects directly to the inverter instead, so you will need its local IP address and serial number. Back up Homebridge and read the migration guide linked from the plugin documentation before upgrading.

Which GivEnergy systems are compatible?

Your GivEnergy system needs to be reachable over local Modbus TCP. Monitoring and control support vary by inverter model and firmware. GivHome checks the configured serial number and supported capabilities before allowing controls. Check the plugin documentation for your system; if you are unsure, get in touch with your model and firmware details.

Does GivHome support multiple AIO batteries?

If your GivGateway presents the batteries as one combined system, use its serial number rather than an individual AIO serial. Support depends on the Gateway and firmware; not every combination has been tested. Confirm the combined readings and available controls before enabling automation.

What should I enter for Serial Number?

For a single AIO or inverter, use the serial shown for that device in the GivEnergy app. For a Gateway-presented multi-AIO system, use the GivGateway serial. The serial is also a safety check: GivHome rejects a Modbus responder that does not match the configured serial.

What is Night Target?

Night Target is the Apple Home percentage slider for Cheap Overnight only. It replaces the name Charge Target and keeps your saved overnight percentage. It does not start charging or change IOG protection and timed-charge targets. With Solar-Aware Cheap Overnight on, it also sets the maximum overnight level.

Why does Night Target stay On?

Night Target represents a saved choice, rather than whether the battery is charging. Apple Home uses a dimmer-style tile for the percentage slider, so it stays On. To turn Cheap Overnight off, use its own switch. To stop a current battery action, use Emergency Stop.

Why might a target not reach 100% on CH/AIO?

Some CH/AIO systems have a separate limit on scheduled AC charging. GivHome reads and reports this limit but leaves it unchanged. If that limit is 80%, requesting 100% may still leave the battery at 80%. The plugin documentation calls this setting HR242.

How does GivHome handle IOG and Cheap Overnight overlap?

Your configured Cheap Overnight period takes priority while it is running. When it ends, GivHome can hand over to IOG protection if a suitable smart charging window is still active.

What is Evening Excess Export?

Evening Excess Export is optional local evening export management. It can sell spare battery energy later in the evening while keeping a reserve for the home and the next cheap overnight window. It is not Agile price chasing.

What is Octopus Flux Export?

Flux Export plans short runs within your eligible peak period, keeping your chosen battery reserve and a margin for the home. Enable it in Plugin Config and choose whether to show the Flux Out tile. The tile lets you turn Flux export off or back on in Apple Home. Hiding it leaves the enabled function following its configured rules. After a Homebridge restart, Flux follows the enabled configuration again.

What is Agile Outgoing support?

Agile Outgoing uses half-hour export prices to plan around spare energy, your reserve and permitted export times. Start in preview mode, which does not control the inverter. Live export is an optional setting that requires acknowledgement; review the plans before enabling it.

What is Predicted Solar?

Predicted Solar estimates tomorrow’s generation from Open-Meteo weather data and each array’s capacity, direction, tilt and shading. Solar 2mrw shows the forecast as a percentage, with its scale calculated from your combined panel capacity. GivHome checks for a fresh forecast every 90 minutes. The forecast itself does not control charging; optional Solar-Aware Cheap Overnight can use it to choose between your overnight levels.

How much space do Eve history records use?

Very little. The existing estimate remains less than 40 MB for five years of solar, import and export history. Totals are stored locally and survive restarts.

Why enable Child Bridge mode?

Child Bridge mode usually gives the cleanest Apple Home experience. It keeps GivHome separate inside Homebridge, makes pairing easier, and helps preserve stable HomeKit accessories during plugin updates.

Why do some GivHome tiles appear as lights?

Apple Home does not offer native tile types for every battery concept. GivHome uses reliable HomeKit accessory types so battery level, solar generation, Night Target, smart windows, grid import/export and manual controls remain visible, automatable and Siri-friendly.

Do I need Homebridge running first?

Yes. Install GivHome through your existing Homebridge dashboard. If you are new to Homebridge, follow the official Homebridge setup guide for your chosen host, then install GivHome from the Plugins page.

What should I back up before upgrading?

Save a Homebridge backup and keep a copy of your Eve history and any useful diagnostics. Check how to return to your previous plugin version before updating a system that controls your battery.

Contact GivHome

Questions, bug reports and useful feedback are welcome.

This opens your email app so you can review the message before it is sent.

Please type GivHome before sending.
Please type GivHome in the human check field.

Get more from GivHome

Connect GivEnergy to Apple Home with Homebridge

Keep battery energy for the house during Octopus smart EV charging

GivHome is an independent project developed by Kernowek Consulting. Explore the source code and documentation or published Homebridge plugin.