v0.3.2

This release includes several small improvements and fixes, plugins, and a snazzy new 3D printable case!

All users currently running a v0.3.x version are recommended update to this version. Updating while on v0.3.0 involves the following git operations:

cd ~/rpi_power_monitor
sed -i 's|+refs/tags/v0.3.*:refs/tags/v0.3.*|+refs/heads/*:refs/remotes/origin/*|g' .git/config
git fetch
git checkout v0.3.2

sudo systemctl restart power-monitor.service

Also note: If you are using the configuration setting watts_cutoff_threshold, please update your config file with the new amps_cutoff_threshold. See the docs for more details. The watts_cutoff_threshold will inadvertently cause valid amperage measurements to be discarded if the 9V AC transformer is removed or fails.

What's Changed

• MQTT Plugin by @jmadden91 in #104
• Adding the RPi 4 Model B Case by @onixx in #121
• Adding mqtt_v2 plugin by @onixx in #124

New Contributors

• @jmadden91 made their first contribution in #104
• @onixx made their first contribution in #121

Full Changelog: v0.3.0...v0.3.2

v0.3.1

This release is an update to the custom OS image only.

It is based off the Raspberry Pi OS May 3rd 2023 build. The official Raspberry Pi OS release includes the new Linux kernel version 6.1, which brings some sampling rate improvements to this project.

This release also includes the latest version of Grafana - v10.0.3.

Documentation:

https://david00.github.io/rpi-power-monitor/

v0.3.0

This release includes several major enhancements including:

• complete overhaul of the configuration structure
• standardized command line options
• a new backup script (backs up all power monitor data and user configuration to USB drive)
• restructured the sample collection and processing code, eliminating the need for complicated calibration
• automatic creation of InfluxDB retention policies and continuous queries
• the power monitor will check to see if it's already running upon starting (eliminates duplicate processes that compete for access to the ADC)

And, almost more importantly, a brand new documentation site, with all docs rewritten from scratch!

https://david00.github.io/rpi-power-monitor/

Upgrading...

If you're on the original v0.1.0 image, see the instructions in my comments here.

If you're on v0.2.0, the upgrade is less involved. See the instructions on the v0.3.0 beta release here.

v0.3.0-beta

This is a beta release for v0.3.0. Help testing would be much appreciated!

See below for instructions to upgrade from v0.2.0.

Upgrading from v0.2.0

The setup and calibration of v0.3.0 is greatly simplified in v0.3.0. Before upgrading, please make sure you know exactly which sensor ratings are on each channel of your power monitor - you'll need to enter them into the new config file. Also, you'll need to get your grid voltage and AC voltage measurements either from your current (old) config.py file, or conduct the measurements again.

1. Stop the power monitor service:

   sudo systemctl stop power-monitor.service
   

2. Create a backup of your current power_monitor directory just in case.

   cd ~/rpi_power_monitor
   tar --exclude=".git" -czf ~/power_monitor_v0.2.0_backup.tar.gz .
   

3. Navigate to the existing power monitor directory, and use git to checkout v0.3.0. The sed command is used to update your git config to make sure it's not set to track the single v0.2.0 branch.

   cd rpi_power_monitor/
   sed -i 's|+refs/tags/v0.2.0:refs/tags/v0.2.0|+refs/heads/*:refs/remotes/origin/*|g'  ~/rpi_power_monitor/.git/config
   git fetch
   git stash
   git checkout master
   pip install .
   

4. Download the config.toml file:

   cd ~/rpi_power_monitor/rpi_power_monitor
   wget https://raw.githubusercontent.com/David00/rpi-power-monitor/docs/_docs/v0.3.0/config.toml
   

5. Go through the newly released beta documentation for the setup of your power monitor:

   https://david00.github.io/rpi-power-monitor/docs/v0.3.0/configuration.html

6. When you are done going through the setup, run the power monitor with the new -v flag (or --verbose):

    python3 ~/rpi_power_monitor/rpi_power_monitor/power_monitor.py -v
   

Please use the discussion thread to report any issues or ask questions - thank you for testing!

Discussion thread here

config.toml.txt

v0.2.0

This release includes my Custom Pi OS image, built with https://github.com/guysoft/CustomPiOS. The image is built from the stock Raspberry Pi OS Lite 32-bit image, released on Sept. 22, 2022.

What's Changed

• Docker has been removed. InfluxDB and Grafana now run natively on the Pi.
• Refactor into a Class by @kizniche in #62 (allows this project to be imported into other projects as a library)
• py-spidev version bumped to 3.6, which resolves an SPI bandwidth issue noticed only on v5 kernels
• Channel numbers in the software start at 1 now instead of 0, so you have CT1 - CT6 instead of CT0 - CT5.

New Contributors

• @kizniche made their first contribution in #62

Full Changelog: v0.1.0...v0.2.0

v0.1.0

This release establishes a formal versioning system for the software, and a custom Raspberry Pi OS Lite image with all of the prerequisite software already installed.