Installation

Disclaimer

First thing's first. Making a mistake while installing these current transformers can KILL YOU. Installation should be done by a licensed electrician. If you choose to install these yourself, you assume all risk and will not hold Lantern Software, nor any employee of Lantern Software responsible for any injury or damage that may occur.
Before opening the panel, make sure to shut off the main breaker. Even after shutting off the main breaker, the lines coming in are still live unless the meter is pulled. Be extremely careful and stay away from those mains.
Choose a current transformer that matches the breaker size. Open up the CT and put it around the wire coming out of the breaker. The CT can go either direction so choose whichever way is easier.
Snap the CT closed. Make sure the wire goes in between the magnet before you snap it closed to avoid damaging the CT.
If you are mounting the hub outside of the panel, route the headphone jack for the CT through a punchout at the bottom of your panel.
Repeat the process until all of the breakers you're choosing to monitor have CTs on them.
It's a good idea to put some masking tape on the CT and label which space the CT is connected to. This way you can move things around on the ports of your hub without having to trace the wire back to the breaker to figure out what each CT is.
The voltage transformer and power for the Pi need to be plugged into a nearby power outlet. If there isn't already one near your panel, you can install a new breaker in the panel and run power to a power strip, or to a new outlet. Some people install the hubs inside the panel, but putting them outside is recommended to improve wi-fi reception. If you're using the flanged case, it can easily be mounted to the wall near the panel.
After putting the cover back on your panel, turn the main breaker back on.

Hub Adoption

The next step is to add your hubs. To get the hub running, you'll need an SD card flashed with the latest software image which can be downloaded here. You can flash it to a microSD card using Balena Etcher.

When you power on the hub with this SD image, the power light will stay on for about 30 seconds. When the light stays off, that means the service has started and is advertising itself via bluetooth. You can now scan for the hub in the app.

After selecting "Configure Hubs" from the main menu, you'll be brought to a view which lets you know that the app is scanning for your hub. It may prompt you to turn on your bluetooth if it's not turned on. It should find your hub within 10 seconds if it's fully booted and nearby. After it finds it, the light on the side of the hub will blink twice per second until you take an action.

After the hub has been added and is connected via bluetooth, several options are available for control and troubleshooting. You can select "Network Info" to see the IP of the hub and you can use that to SSH into the hub if needed. The default username is pi and the password is LanternPowerMonitor.

Hub Calibration

Now that your hub has been added, you can go back into your panel and assign the hub and port numbers for each space. Hopefully you taped your CTs with space labels so matching the port to the space is easy.

With all of the CTs and the VT hooked up, you need to restart the hub so it picks up the changes. After restarting the hub, you can select "Calibrate" in the panel config. You will be shown real time data of the power of each breaker and the voltage of your mains.

You must calibrate the voltage first. Measure the voltage in an outlet near the panel using a multimeter. Adjust the slider until it matches the voltage reading from your multimeter. Then, using a clamp meter, measure the amperage or power of one of the breakers (one known to be currently using power, plug in a hair dryer or lamp or something). Adjust the slider for the CT calibration until the power reading of the breaker matches what your clamp meter reports.

Now restart your hub one last time so it picks up the calibration change.