Resources for the PiJuice range (complete with our revolutionary PiAnywhere technology – the best way to take your Pi off the grid!). Originally funded on Kickstarter.

Due to our Kickstarter, there will be no PiJuice boards available to purchase until after the Kickstarter units are all shipped out to our backers. However, we have already got some confirmed outlets that will sell PiJuice HATs, solar panels and cases. Some of them will let you provide an expression of interest (and receive an email when in stock) and others will actually let you place provisional pre-orders. We have indicated whether you can pre-order / register your interest / quote next to each one:

• Pi Supply - register interest
• ModMyPi - register interest
• Raspberry Pi Denmark - register interest
• Pi Shop Switzerland - register interest
• Allied Elec - pre order
• Arrow - quote / pre order
• Newark - pre order / register interest
• Farnell - pre order / register interest
• KUBII - register interest
• Ameridroid - pre order
• S.O.S Solutions - register interest
• BuyAPi - register interest
• Melopero - register interest
• Botland - register interest
• Chicago Electronics Distributors - register interest
• Elmwood Electronic - register interest
• RS Components (coming soon) - register interest
• RPiShop.cz - register interest
• Eckstein GmbH - register interest

PiJuice is a fully uninterruptable / uninterupted power supply that will always keep your Raspberry Pi powered! It has a real time clock (RTC) for time tracking and scheduled tasks when the Pi is offline (as well as remote on/off of your Pi). It also has an integrated microcontroller (MCU) chip which will manage soft shut down functionality, a true low power deep sleep state and intelligent start up.

The tri-coloured RGB LEDs will allow you to keep track of the battery charge levels and other info (they are programmable). There are also three programmable buttons which will allow you to trigger events or customisable scripts aside from their predefined functions. PiJuice only uses five of the Pi's GPIO pins (just power and I2C), the rest are free and made available via the stacking header which allows for other boards to be used along side PiJuice. The board can be powered directly from the grid with the standard Raspberry Pi PSU, via an on board battery, via external batteries, solar panels, wind turbines and other renewable sources.

The board has a Raspberry Pi HAT compatible layout, with onboard EEPROM (you can disable the EEPROM if you want also). It has been designed for the Raspberry Pi A+, B+, 2B and 3B but it is also electrically compatible with the Raspberry Pi Zero v1.3 and Zero W v1.1 or any other Pi.

PiJuice is a fully CE and FCC tested design and battery safety tests have also been carried out for peace of mind when using in educational or industrial settings.

PiJuice will actually work straight out of the box, with no software, to power the Pi and for some other basic functionality. However to get the most out of PiJuice you really need to install the software packages. For PiJuice we have created a Raspbian / Debian Package to make it extra simple to obtain and install the necessary software. At the command line simply type:

sudo apt-get install pijuice-gui

After a restart a new icon "PiJuice Settings" will appear under Menu>Preferences.

If you wish to install just the light version of PiJuice with no GUI:

sudo apt-get install pijuice-base

This is particularly indicated for Raspbian Lite or an headless installation.

Please refer to our software section to find out more.

Important note: If your PiJuice was supplied with a battery fitted, you will need to remove the little plastic battery isolation tab. If you don't remove that plastic tab, your PiJuice will not charge up, and will report 0% battery level.

Once the battery is slotted into place (make sure you remove the little plastic battery isolation tab too!) LED1 will start blinking in green. This doesn't mean your Raspberry Pi is yet receiving power it is just telling you that the PiJuice MCU is receiving power and is in standby.

If you wish to start your Raspberry Pi using the PiJuice SW1 you'll have to connect the micro USB to the PiJuice directly.

To power on the Raspberry Pi single press SW1 briefly as you would for a click of a mouse. If the micro USB is directly connected to the Raspberry Pi then it will power up immediately without you needing to press the SW1. To power off press and keep pressed SW1 for about 10 seconds. A "halt" command will be received by the OS and the Raspberry Pi will shut down in the proper manner. To remove power to the Pi press and keep pressed SW1 for at least 20 seconds. This will remove power from the Raspberry Pi without issuing a "power off" command to the OS. This approach should only be used in case nothing else works or if the OS is mounted in read only mode otherwise data on SD card may be corrupted.

PiJuice can recharge its on board battery in several ways and via different power sources. The most common approach is to use the standard Raspberry Pi PSU or a micro USB PSU with similar characteristics but solar panels, wind mills, and other renewable power sources can be used too. When the PiJuice is installed over the Raspberry Pi you can power both the Pi and PiJuice via either the Pi's micro USB or the PiJuice's one. That's because the power lines on the GPIO header are shared by both boards and this allows to effectively be able to charge the battery independently from which micro USB connector you use. Other ways of providing power to the PiJuice is directly via the GPIO pin headers or one of the other connectors on board. See the hardware section for more information.

SW1 and LED1 have predefined default functions associated.

• SW1 - Power button:

  • Single brief press to power on.
  • Long press of at least 10 seconds to halt (soft shutdown).
  • Long press of at least 20 seconds to cut power (hard shutdown).

• LED1 - Charge status:

  • with Pi off
    • Green blinking: Standby
    • Blue blinking: Charging
    • Red blinking: Low battery
  • with Pi on
    • Green steady: Power on - Battery over 50%
    • Blue blinking: Charging
    • Orange steady: Low battery - level < 50%
    • Red steady: Low battery - level < 15% or battery absent

On board the PiJuice there are three buttons and two multicolour LEDs please refer to the hardware and the software sections to find out more.

The PiJuice provides an onboard intelligent on/off switch allowing you to have control on when the Raspberry Pi will be switched on or off without having to plug or unplug the PSU as you would normally have to do.

Note: Turning on the Raspberry Pi via the onboard intelligent switch only works when the power is provided to the micro USB on the PiJuice.

When the Raspberry Pi is off, for example due to a scheduled power off via the onboard RTC, the PiJuice will enter a low power deep-sleep state which guarantees only a minute fraction of the battery charge will be required to keep the circuitry on ensuring long periods of inactivity between recharges.

This is for example ideal when dealing with recyclable energy sources like solar panels. At all times the PiJuice will still be able to trigger a wake-up call to the Raspberry Pi via interrupt or calendar event.

The PiJuice has been designed so that it can accept power sources of different nature. It accepts power sources providing between 4.2V and 10V which can be applied on different onboard connectors.

You can find out more in the hardware section.

One of the main functionalities provided by PiJuice is to ensure that the Raspberry Pi always remains on when it needs to and shuts down safely when low on power. It provides a hardware watchdog timer to keep your Raspberry Pi up and running for mission-critical remote applications and works as a full uninterrupted / uninterruptable power supply solution.

The board comes with an onboard 1820 mAh "off the shelf" Lipo / LiIon battery which guarantees ~4/6 hours of up time. PiJuice is compatible with any single cell LiPo or LiIon battery so bigger (or even smaller) batteries can be chosen especially depending on CPU load and connected hardware which may cause significant variations to the overall maximum up time of the Raspberry Pi. That's why we have provided means to support bigger battery sizes like 5000 or 10,000 mAH+ to help your PiJuice last up to 24 hrs +.

The batteries can be replaced without downtime as long as an alternative power source is provided in the meantime. You could for example even use a battery bank whilst replacing either the onboard battery or one connected to the screw terminal (you shouldn't connect a battery on board and to screw terminal at same time though or you will fry your PiJuice). Using a standard PSU will of course work too and that configuration is in fact ideal for a UPS setup.

An enhanced graphical user interface (GUI) is available via APT and provides a full power management API for Raspbian that allows auto shutdown capability when running low on batteries.

It also provides a means to attach customisable scripts to power events and reporting of the battery status. You can find out more in the software section.

• The EEPROM can be disabled and its I2C address changed for increased compatibility with other boards
• BP7X battery - original battery from Motorola Droid 2 (A955) - 1820mAh battery
• Microcontroller is an ST Micro STM32F030CCT6 ARM CortexM0,48MHz,F256KB,R32KB,I2C,SPI,USART,2.4-3.6V
• Charge IC - BQ24160RGET Charger IC Lithium-Ion/Polymer, 2.5A, 4.2-10V
• Fuel gauge IC - LC709203FQH-01TWG Battery Fuel Gauge, 1-Cell Li-ion, 2.8%
• EEPROM - CAT24C32WI-GT3 EEPROM, I2C, 32KBIT, 400KHZ, 1V7-5V5
• Optional spring pin - Mil-Max 0929-7-15-20-77-14-11-0 or 0929-7-15-20-75-14-11-0
• Compatible with any 4 pin battery on board that can be used with 00-9155-004-742-006 battery contacts from AVX including the BP7X, BP6X, and any compatible batteries including the 1600mAh and 2300mAh ones from CameronSino (CS-MOA853SL and CS-MOA855XL)
• There is an on board 4 pin screw terminal block for larger off board batteries. Any single cell LiPo / LiIon is compatible. However, you use your own sourced battery at your own risk. We HIGHLY RECOMMEND using a battery with an internal protection circuit and a NTC (temp sensor)
• Optional header for offboard button - connected to same output as SW1
• 6 pin breakout header - with two GPIO from the ARM Cortex-M0, Vsys, 5v0, 3v3, GND connections
• Header for optional off board solar panel / wind turbine etc.
• Optional RF Shield attachment - Harwin S02-20150300 (can also double as an inexpensive heatsink)
• Input voltage range - 4.2V – 10V
• Output voltage - 3.3V and 5V
• Output amperage - maximum current at 5V gpio is 2.5A and at VSYS output 2.1A, but also this depends heavily on battery capacity. For BP7X have measured around 1.1A at 5V GPIO and around 1.6A at VSYS output. Obviously this also depends heavily on the current draw demanded by the Raspberry Pi / device itself. To achieve maximum of 2.5A it will need battery over 3500mAh.

Apart from the material available on Github we are also preparing guides, tutorials and additional information on various platforms and media. This is a list of current and future resources:

• Check the main PiJuice Quick Start Guide and FAQ for a detailed assembly guide
• Our PiJuice Battery Discharge Time Calculator
• There is a "quick start guide" in the package which you can see here. As you can see it's pretty basic but really the PiJuice is quite intuitive and very easy to use.
• A lot of picture guides and tutorials are going up on our Maker Zone
• We will soon have the pinouts available at Raspberry Pi Pinout
• We will also have tutorials on Instructables and Hackster.io

Here are some links to reviews and articles from around the web:

• MagPi 5 star review - PiJuice Review: Portable Power For Raspberry Pi
• Electromaker 4.5 star review - A smart portable power solution for your Raspberry Pi
• RasPi.TV technical discussion - PiJuice – testing the software and hardware plus 6W 40W solar panels video?
• RasPi.TV unboxing - PiJuice – unboxing, first look and why it’s 2 years late?
• Michael Horne / Tim Richardson review - PiJuice – portable battery power for your Raspberry Pi – a review
• Novaspirit Tech review / video - PiJuice HAT Review
• Lots of info and images and updates available on the PiJuice Kickstarter

It is safe to say we have an awesome and growing community of people using PiJuice to add battery power to their projects - both from our Kickstarter and beyond. We get a huge amount of contributions of code, some of which we can easily integrate here and others which we can't (we are only a small team). However we want to make sure that any contributions are easy to find, for anyone looking. So here is a list of other software libraries that might be useful to you (if you have one of your own, please visit the "Issues" tab above and let us know!):

• Power outage monitor (using PiJuice and PaPiRus) by Frederick Vandenbosch. You can find pictures and code here
• Build a wildlife camera using a Raspberry Pi and PiJuice by Electromaker
• CarPi - a Raspberry Pi, PiJuice and a HifiBerry all living neatly in a dashboard running Android Auto! by Rick Tonoli