From Geekworm Wiki
Jump to navigation Jump to search



The X700 is a multifunctional expansion board for all current models of the Raspberry Pi using a 40 pin header. It provides intelligent and safe power management, safe shutdown, full poweroff through software and an advanced uninterruptible power supply. The X700 reserves the 40-pin header that can be stacked with other Raspberry Pi accessory boards for enhanced applications. The X700 can also be used with the X820 (2.5" HDD/SSD Shield), X850 (MSATA SSD shield), X822, for safe data backup.


  • You must read these safety instructions and warnings before charging your batteries.
  • Lithium Polymer and Li-ion batteries are volatile. Failure to read and follow the below instructions may result in fire, personal injury and damage to property if charged or used improperly.
  • Never make wrong polarity connection when charging and discharging battery packs. Always double check polarity of battery's connector to make sure "+" to "+" and "-" to "-".
  • Do not mix and use old batteries and new batteries, or batteries with different brand names.
  • Lithium batteries has it's cycle life, please replace old battery with new one when it reaches it's service life or when it is two year old, whichever comes first.
  • When charging Battery Pack, please put battery in a fire proof container. Please don't leave the X700 on the wood material or carpet and unattended.
  • Must keep the X700 away from children.


Item Description
Compatible with Raspberry Pi Model B+/ 2 Model B / 3 Model B / 3 Model B+ / 3 Model A+
Operating System Raspbian Stretch
Safe shutdown function tested for Raspbian, other operating systems to be tested and advised
Key Features Smart Uninterruptible Power Supply (UPS)
Provides continuous operations for up to 10hours (depending on battery type used)
5.1V 3000mA Power Backup for even the most demanding Pi 3 set ups
18650 dual Cells Lithium Ion Holder
Can work with single or dual 18650 Lithium Ion battery
Integrated battery protection circuit
Integrated over current protection and over voltage protection
Integrated Maxim's fuel-gauge systems (Reading battery voltage and percentage via i2c)
Intelligent automatic charging and discharging
On-board 4 green LEDs indicate battery charging and discharging levels of 25%, 50% , 75% and 100%
On-board red LED show the status of battery charging or fully charged

Intelligent and safe power management
Equipped with both momentary button and latching switch for easy power control
Press the momentary button to turn on
Press the momentary button and hold for 1~2seconds to reboot
Press the momentary button and hold for 3~7seconds to implement safe shutdown
Press the momentary button and hold for >8seconds to force shutdown
Supports safe shutdown and full poweroff through software
On-board switch convenient to select latching or momentary power control switches
Press the latching power switch once to turn on and again to implement safe shutdown
On-board LED shows the status of power on, reboot and shutdown
On-board PH2.0 connectors allows to use external latching switch or momentary button
Powers the Raspberry Pi via the 40-pin header - no additional cabling required
Allows power input via DC jack or Micro-USB socket or XH2.54 connector
Allows power output via XH2.54 socket and or the 40-pin header

Reserved 40-pin stackable Header for Add-On Boards
Powers the Raspberry Pi via the 40-pin header - no additional cabling required
Works with all current models of the Raspberry Pi using a 40 pin header
On-board DC jack (5.5*2.5mm) and micro-USB socket convenient for power input
On-board connector allowing to connect external power switch and DIY your perfect case
Specification Power supply: 5.1Vdc,2.5~4A
UPS output: 5.1V 3A
UPS charging current:
18650 Battery Request: battery voltage: 3.7V-4.2V and without protect circuit
Recharge Threshold: 3.99V

Packing List

  • 1 x X700 board
  • 1 x Installation screw pack (Spacer F/F M2.5*20, Screw M2.5*6)


Power management chip docuemtn: File:MAX17040-MAX17041.pdf

X700 use the same script with X730.

We test this shell script base official Raspbian '2018-11-13-raspbian-stretch.img' version;

wget https://raw.githubusercontent.com/geekworm-com/x730-script/master/x730.sh
sudo chmod +x x730.sh
sudo bash x730.sh
printf "%s\\n" "alias x730off='sudo x730shutdown.sh'" >> ~/.bashrc
sudo reboot

How to Reading battery voltage and percentage

Please refer to File:X700-ups.zip

#X700 Battery voltage & precentage reading

    sudo sed -e '/shutdown/ s/^#*/#/' -i /etc/rc.local

    echo '#!/usr/bin/env python
import struct
import smbus
import sys
import time

def readVoltage(bus):

     address = 0x36
     read = bus.read_word_data(address, 2)
     swapped = struct.unpack("<H", struct.pack(">H", read))[0]
     voltage = swapped * 1.25 /1000/16
     return voltage

def readCapacity(bus):

     address = 0x36
     read = bus.read_word_data(address, 4)
     swapped = struct.unpack("<H", struct.pack(">H", read))[0]
     capacity = swapped/256
     return capacity

bus = smbus.SMBus(1) # 0 = /dev/i2c-0 (port I2C0), 1 = /dev/i2c-1 (port I2C1)

while True:

 print "******************"
 print "Voltage:%5.2fV" % readVoltage(bus)

 print "Battery:%5i%%" % readCapacity(bus)

 if readCapacity(bus) == 100:

         print "Battery FULL"

 if readCapacity(bus) < 20:

         print "Battery LOW"
 print "******************"
' > /home/pi/x700ups.py
sudo chmod +x /home/pi/x700ups.py

Installation Guide



Customer question 1: I will plug into my car lighter. i want to shut down when i turn off the car, and boot automatically when i turn on the car. will the x700 do both?

Answer: Yes, X700 should be able to meet your needs.

I recommend you use wall power supply to test it firstly. you need

Let me give you an example: If we turn the wall switch of the bedroom on, when the external power supply is on, the light is on, when the external power is off, the light is off.

Go back to X700, please refer to the second picture of ASIN, press down the 'Toggle button/ Select Button' to enable the Latching swith, then press the latching switch (this latching switch is equal to the wall switch).

BUT you use the car lighter, maybe you need to check your ignition line.

Question 2: Does the X700 support Auto Power On function?

Answer: Yes, the X700 is support auto power on, but the auto power on function use latching switch, so it you use the auto power on function then X700 will not support safely shutdown by software.

Add your comment
Geekworm Wiki welcomes all comments. If you do not want to be anonymous, register or log in. It is free.

Anonymous user #7

51 months ago
Score 0++

Can I still use the 40 pin header for additional hardware?

Like a NRF24L01 receiver board (using pins 17 - 24)?

Anonymous user #5

55 months ago
Score 0++

Love the product, but these don't work for me on Raspberry pi 4:

Press the momentary button and hold for 1~2seconds to reboot Press the momentary button and hold for 3~7seconds to implement safe shutdown Press the momentary button and hold for >8seconds to force shutdown

Also the latching button does nothing; are these tested on pi 4?

So when I want to shutdown from hardware switches on X700, I'm pressing

Anonymous user #5

55 months ago
Score 0++

Continued post (I posted before finishing all comment by mistake sorry):

So when I want to shutdown from hardware switches on X700, I'm pressing down the toggle switch called "button A" above. I can see red power LED goes off.. (I'm not completely sure if this is "safe shutdown")

To power on, I make sure both button A and B are not toggled and just press momentary button once. (After the boot, momentary button does nothing for me on pi4 as stated above.

Anonymous user #6

55 months ago
Score 0++

Sorry, I just realized and confirmed that momentary buttons work as documented after installing shell script written above.

Another problem is that, if I try to charge (when pi is running) by connecting usb cable to the micro usb port of X700, obviously the voltage pi receives will get lowered and cpu clock (tested by vcgencmd get_config arm_freq) goes down to around 600mhz even after cpuinfo-set -g performance. I can also see the under voltage by just seeing red LED lamp of raspberry pi 4 which goes out after plugging cable to x700. Is there any way to solve this issue?


Anonymous user #4

57 months ago
Score 0++

In your FAQ it says you can use this in a car to shutdown when the car is switched off. This is what I need to do but the Pi and the X700 will be hidden so I will have no access to the buttons once this is installed. So, to confirm.

Permanent live to X700 Power is passed through to Pi when car is on When car is off, Pi is powered by battery Software can shut the Pi down cleanly after 'x' seconds? Pi will restart when car is turned back on

Is this correct?

Thank you!

Anonymous user #2

57 months ago
Score 0++

I have one more question....

If I have this installed how can I install an additional hat? After installing your X700 the pin assembly no longer lines up with the mounting holes? Thank you for your input.


57 months ago
Score 0++

Hello friend,

You can add two or three Stacking Headers on the GPIO PIN, hope it will help.

Anonymous user #2

57 months ago
Score 0++
Just received my X700 and was wondering if there might be a more detailed description of how this thing works/needs to be configured to start when a power supply is connected and auto shutdown when the external power supply is disconnected.


57 months ago
Score 0++
Hello friend, Please refer to the document above.

Anonymous user #3

57 months ago
Score 0++
yea... wondering the same question... i can get it to turn on, but i haven't installed the software yet, pretty sure there should be a way to turn this thing off without having to disconnect the batteries... whould be super helpful to know what the buttons actually do

Anonymous user #1

58 months ago
Score 0++
Can I get this with the X720 Case without the X720 board? Why does step 5 have a picture of the X720 is this is the X700?


57 months ago
Score 0++

Hi, We have we have various raspberry pi ups board, this is the X700 board, it is similar to the X720 board, but they still have any difference from functions. For X720, please refer to: http://www.r...dex.php/X720 We don't have cases for this X720 board yet, but we will consider to make it if it is necessory, please take notice of us. Regards,