Skip to main content
Join the official 2019 Python Developers SurveyStart the survey!

A bump controller emulator on Raspberry Pi Zero W.

Project description

bumpemu

This is a bump controller emulator for CellPro PowerLab 6 and 8 chargers. It allows you to use the CCS mobile app to control your charger over bluetooth low energy (BLE).

To interface to the PowerLab with BLE, you need two pieces of hardware:

FUIM3 USB Adapter

Raspberry Pi Zero W

If you've ever hooked up your PowerLab to your PC and monitored charging, you already have the FUIM3.

Pi Zero W Setup

This controller emulator will run on the Pi Zero W. Follow the instructions for installing the Pi with the latest version of Raspbian.

Once you have the Pi up and running, make sure everything is up to date:

sudo apt-get update
sudo apt-get upgrade

Then install the required libraries:

sudo apt-get install -y libusb-dev libdbus-1-dev libglib2.0-dev libudev-dev libical-dev libreadline-dev libgirepository1.0-dev libcairo2-dev

The Pi will come with bluez already installed, but it will probably be an older version. Version 5.45 has proven to work well so you will need to install it. Download it from here. Then follow these instructions to install it. Make sure to do the step where you enable the experimental features.

Finally, bumpemu can be installed using pip:

sudo pip3 install bumpemu

Then you can run bumpemu as follows:

/usr/local/bin/bumpemu-controller

You can view various configuration options with -h:

/usr/local/bin/bumpemu-controller -h

A systemd service is in the repo if you wish to have bumpemu run at boot.

Presets configuration

The BumpCCS2 app has 7 predefined charger profiles:

  • Accurate
  • Analyze
  • Discharge
  • Fastest
  • Monitor
  • Normal
  • Storage

Bumpemu will map the app's predefined profiles to existing presets in your charger. To do this, create the file /etc/bumpemu/presets.yml on your pi. Set the number of the charger preset you want each app charger profile to map to. An example presets file is in the repo.

To verify you have set the profiles the way you want them, make sure no other instances of bumpemu-controller are running, and then run the following:

/usr/local/bin/bumpemu-controller --show-presets

Battery configuration

When running the BumpCCS app with a real bump controller, you would bump a battery to load the battery configuration to the app. To emulate that, bumpemu loads a battery configuration when it starts up. The battery configuration should go in /etc/bumpemu/battery.yml. An example battery configuration file is in the repo.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for bumpemu, version 0.0.8
Filename, size File type Python version Upload date Hashes
Filename, size bumpemu-0.0.8-py3-none-any.whl (62.5 kB) File type Wheel Python version py3 Upload date Hashes View hashes
Filename, size bumpemu-0.0.8.tar.gz (33.4 kB) File type Source Python version None Upload date Hashes View hashes

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page