From Geekworm
Jump to navigation Jump to search
X728 ups board-Front
X728 ups board-Back
X728 ups board
X728-A1 Packing List
X728-A2 Packing List
X728 PCB Layout

X728 V1.3 is released

X728 V1.3 is released at Febuary 2021.

  • V1.3 removes the ASD function and adds power surge protection function.
  • The charging power indicator (LED1-LED4) is relatively brighter than V1.2.


The X728 is an advanced uninterruptible power supply expansion board for all current models of the Raspberry Pi using a 40 pin header.

It provides 5.1V 8000mA Power Backup for even the most demanding Raspberry Pi set ups, intelligent and safe power management, safe shutdown,AC power loss/ power adapter failure detection , auto power-on, full poweroff from software, and a real- time clock.

The X728 reserves the 40-pin header that can be stacked with other Raspberry Pi accessory boards for enhanced applications. The X728 can also be used with the X825/X828/X829 (2.5" HDD/SSD Shield) and X857/X862/X872 (MSATA/M.2 SSD shield) 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 X728 on the wood material or carpet and unattended.
  • Must keep the X728 away from children.
  • Please watch Main Video and Tutorial Video regarding 18650 batteries at: https://www.staysafebattery.com/en/



  • Raspberry Pi 1 Model B+/ 2 Model B / 3 Model B / 3 Model B+ / 3 Model A+ / 4 Model B


  • Raspbian Stretch
  • Safe shutdown function tested for Raspbian, other operating systems to be tested and advised


X728 18650 UPS + Power management board

  • Smart and powerful Uninterruptible Power Supply (UPS)
  • Provides continuous operations for up to 10~30hours (depending on battery type and qty used)
  • Max 5.1V 8000mA Power Backup for even the most demanding RPi set ups
  • Can work with X728-A2 stackable 2-cell battery holder to increase battery capacity
  • Supports 3000mA fast battery charging
  • Integrated over current protection and over voltage protection
  • Integrated Maxim's fuel-gauge systems (Reading battery voltage and percentage via i2c)
  • Integrated 10-A fully-integrated synchronous boost converter
  • Intelligent automatic charging and discharging
  • On-board 4 green LEDs indicate battery charging and discharging levels of 25%, 50% , 75% and 100%

  • Intelligent and safe power management
  • Equipped with momentary button for easy power control
  • Press the button to turn on
  • Press the button and hold for 1~2seconds to reboot
  • Press the button and hold for 3~7seconds to implement safe shutdown
  • Press the button and hold for >8seconds to force shutdown
  • Supports safe shutdown and full poweroff through software
  • On-board blue LED shows the status of power on, reboot and shutdown
  • AC power loss or power adapter failure detection (LED and GPIO detection)
  • On-board pin header allows to select auto power-on when power supplied
  • Automatic safe shutdown when battery low (voltage <3.0V)
  • Ultra-low standby power consumption to maximize battery life
  • Operate in both charge mode and boost mode to allow full system management and battery power management
  • Integrated IN-to-SYS pass-through path to pass the input voltage to the system
  • Advanced system power-path management avoids batteries frequent charging and discharging
  • Advanced system power-path management allows 3A fast charging and powering Raspberry Pi at the same time

  • Integrated Hardware DS1307 Real Time Clock (RTC) with Battery Back-Up
  • Keeps track of the time while the Raspberry Pi is switched off
  • Allows the Raspberry Pi to retrieve the current date and time when it is switched back on
  • Uses the 18650 battery to maintain the date and time - no additional battery required

  • Powers the Raspberry Pi via the 40-pin header - no additional cabling required
  • On-board DC power jack (5.5*2.5mm) and Type-C socket convenient for power input
  • On-board PH2.0 connector allows to connect external power switch and DIY your perfect case
  • On-board XH2.54 power output connector allows to power other devices
  • Reserves the 40-pin header that can be stacked with other Raspberry Pi accessory boards


  • Power supply via Type-C socket : 5Vdc ±5%, ≥3A, Via DC power jack : 5Vdc ±5%, ≥4A
  • UPS output : 5.1V ±5% Max 8A
  • UPS charging current: 2.3~3.2A
  • Terminal Battery Voltage : 4.24V
  • Recharge Threshold : 4.1V


  • Do not apply power to your Raspberry Pi via the Micro USB socket or Type-C socket.
  • Do not use 18650 battery with built-in protection circuit

Packing List

  • X728 Expansion Board x 1
  • Screw M2.5 *5mm x 8
  • Spacer M/F M2.5 *20mm x 4
  • Spacer F/F M2.5 *20mm x 4
  • Jumper link Pitch 2.54mm x 3


X728-A1 Optional Raspberry Pi cooling fan

  • Completely solve the overheating problem of your Raspberry Pi
  • Efficient drop temp of your Raspberry Pi by using the X728-A1
  • Stackable design allows you to connect both X728 and X728-A1on your Raspberry Pi
  • On-board XH2.54 power output connectors allow to power other devices
  • Reserves the 40-pin header that can be stacked with other Raspberry Pi accessory boards


X728-A2 Optional 18650 2-Cell battery holder

  • Stackable 18650 two cells lithium Ion holder
  • Ideal solution to increase battery capacity
  • Integrated battery protection circuit

User manual


Q: Why the X728 V1.3 remove the ASD function?

A: Because the ASD jumper will generate some issues, so we remove the ASD jumper, but now you can achieve ASD function by software. Read the voltage through I2C, and then decide whether to shut down.

Q1: Why X728 V1.2 automatically shuts down?

A: 1. X728 V1.2 will automatic safe shutdown when battery voltage is low than 3.0V, please charge in time;

2. Please try the following operation by step:

  1. Remove all jumper cap,
  2. Remove all 18650 battery
  3. Place 18650 battery again and wait a few seconds before testing

3. What battery is recommended for X728?

A:Because there are so many kind of batteries, and the quality is also various. So we suggest to use the NCR18650B from PANASONIC. Also do not use 18650 battery with built-in protection circuit for X728.

Q2: We want automatic shutdown when the external AC power supply is disconnected, is possible?

A: Yes. you can program a script to get this function. Example (The following is a pseudo code):

while (1) {
  // invoke the API to get AC PSU status: connected or disconnected
  int disconnected_flag = getACPSUStatus(); 	// please refer to the user manual to achieve getACPSUStatus function;
  int battery_voltage = getBatteryVoltage();    // please refer to the user manual to achieve getBatteryVoltagefunction;
  // You can make your own actions based on disconnected_flag and battery_voltage, you can only select one condition also
  if (disconnected_flag) {
    // execute linux or software shutdown command


Q3: How to restart the pi board when AC Power supply is connected?

A: Please enable 'AUTO POWER ON' or 'AUTO ON' function if you want restart when the AC Power supply is reapplied.

Q4: About auto shutdown, found your board auto shutdown.

A: Please check if enable the ASD function (shorted the ASD header), if you enable the ASD function, please make sure your operation is right: first, place the battery into the battery holder, insert the jumper to ASD header after 3 seconds,this is very important!!

Q5:Is the recharge threshold and terminal battery voltage adjustable? I want to keep the batteries between 80% and 20%

A: Sorry, this is not support.

Q6: Which GPIO is used to power the X728-A1 cooling fan?

A: The X728-A1 does not occupy the GPIO, it use the PIN 2,4 to provide the power.

Q7: How can I remove all software created by the setup and start over?

A: 1) sudo /etc/rc.local , delete x728pwr.sh

2) sudo rm /etc/x728pwr.sh

3) sudo rm /usr/local/bin/x728softsd.sh

Q8: What are GPIO5 and GPIO12 used for?

A: GPIO5 control shutdown, GPIO12 BOOK OK.

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

Anonymous user #18

12 days ago
Score 0++
x728 ver 1.3 does not shutdown when battery voltage is 3.0V. How to get safe shutdown when battery voltage drops bellow threshold?

Anonymous user #17

2 months ago
Score 0++

I have an issue with the RTC clock and can’t find a solution. I tried to install a brand new OS from the official Raspbian Buster Lite, and did a clean install of the x728.sh script from github. The error code at startup of raspberry is:

[ 22.027235] rc.local[621]: hwckock: ioctl(RTC_RD_TIME) to /dev/rtc0 to read the time failed: Invalid argument [FAILED] Failed to start /etc/rc.local Compatibility See ‘systemctl status rc-local.service’ for details.

I think the problem goes around “hwclock”. Even if I try to “hwclock -r” the result is: hwckock: ioctl(RTC_RD_TIME) to /dev/rtc0 to read the time failed: Invalid argument

How can i solve it?

Anonymous user #16

2 months ago
Score 0++

For anyone wondering. setting GPIO 13 as out and high will turn off the x728.

Would be really helpful to have that listed here as not everyone can install the soft as lifted in this wiki. I am using it on a pi running android.

Anonymous user #14

2 months ago
Score 0++

I installed and used an x728 hat on an RPi4 a few months ago, and it worked great. Unfortunately, I had to do a complete reinstall of the operating system on that Pi, and when I went to reinstall the x728... I can't get it to work. When I try to boot it up (by applying power from the power brick via the usb-c port on the x728), I can see the red and green lights on the RPi start to flash as they would during startup, but then it simply shuts down after about three seconds. This happens every time. In an effort to troubleshoot, I tried:

- disconnecting the x728 hat

- deleting the /etc/x728pwr.sh and /usr/local/bin/x728softsd.sh

- reconnecting the x728 hat (without batteries)

- booting up RPi and running sudo bash x728.sh

- shutting down RPi, moving power source to x728 hat, and installing batteries

- turning on power to x728

The result is always the same... I can see the red and green lights on the RPi flash for about three seconds and then it just shuts off. If I remove the batteries from the x728, and move the power source back to the RPi (usb-c connector) and apply power, the RPi boots up just fine.

It simply won't boot up if power is coming from / or via the x728 hat. Any ideas?

Anonymous user #15

2 months ago
Score 0++
had the same problem, the Raspberry starts briefly and switches off again. After trying for a long time, it worked again using the following procedure. 1. Disconnect the X728 from the Raspberry and remove the batteries 2. Put the X728 back on the Raspberry 3. Insert the batteries (Raspberry must not start, it did it for me every now and then, then start all over again) 3. USB-C charger on connect the X728 4. Switch on X728. Since then everything has been working normally again. Hope it helps with you too.

Anonymous user #14

2 months ago
Score 0++
Tired your suggestion, but no success. I even drained both batteries completely and the tried again. Oddly, that worked at first, but once the batteries got charged up to a certain point, the x728 shut down the RPi. I have no idea what's going on, but no one from Geekworm is responding on their dedicated forum. I'm not inclined to purchase any more of their products.

Anonymous user #19

8 days ago
Score 0++
Same here. Excluding X728, my RPi4 works perfectly. However, if I re-install it, the power is automatically cut off after 3 seconds. I'm not sure if they can really give us an answer. But we must remember. It's Made in China.

Anonymous user #13

2 months ago
Score 0++


on my x728 the RTC clock works, but does not continue to run when it is switched off. The Raspberry 4 has the time from the last shutdown after switching on. The fake hwclock has been uninstalled. Already had another x728 and there was no problem. Can someone help?

Anonymous user #12

2 months ago
Score 0++
Im experiencing an issue with starting up this UPS.I have tried charging my batteries with an efest battery pack charger and in the hat itself but when i try to power on the board it shuts down within 3 seconds. I have followed the troubleshooting tips above but i have yet to fin a problem. The Power light turns on and the 5v power led does as well, but then they both shut off. Id like to assume my board isnt broken and my batteries work, so is there a schema or effective way to test points with a multimeter so i can use this properly. I used it for a while in perfect condition but now it isnt working. The batteries indicate full charge on my charger and on the board. Please help

Anonymous user #11

3 months ago
Score 0++

Hi there,

the x728 works fine. The command "x728off" works wonderfully via the lxterminal, but I would like to use this command in a Python script so that I don't have to press the power button for 8 seconds after shutting down. Have already tried the subprocess module but without success. Does somebody has any idea? Thanks...

Anonymous user #15

2 months ago
Score 0++

I found a solution for everyone who wants to shut down the Raspberry Pi and the X728 via a Python script. - import subprocess - subprocess.call(["sudo", "/usr/local/bin/x728softsd.sh"])

so it should work.

Anonymous user #10

4 months ago
Score 0++
Mine seems to be defective, it's outputting 13.4v and the 5v out led flashes regardless of the condition. it seems to charge ok. I was planning on using this in an embedded application with an rpi 4b but I now have concerns about reliability. Anything to try?

Anonymous user #10

4 months ago
Score 0++
Never mind, one of the TPS61088 Synchronous Boost Converters had a cold solder joint. I was able to flex the board and make the problem come and go. When I reflowed solder to and around the converter the problems went away. Unfortunately due to the quality of construction I will not be able to use it for my intended purpose. Bummer!


4 months ago
Score 0++
It should be caused by the HDMI input resolution higher than 1080p25fps (the resolution supported by the Raspberry Pi is 1080p25fps),By the way ,There are many Raspberry Pi fans exchange experiences on our official website, you are welcome to join us https://geek...munity/forum

Anonymous user #9

5 months ago
Score 0++
How can we configure the X728 with NUT? Using this unit with Home Assistance server and would like it to be able to communicate the Battery Status. NUT is the Linux UPS Manager, and Home Assistance has support for that.


4 months ago
Score 0++
Hi dear,for the NUT & X728, As it is a DIY project, we dont know the details, please refer to x728-Software to read the voltage and power

Anonymous user #8

5 months ago
Score 0++
Hi, what is the operating temperature and humidity range for this ? Thanks


4 months ago
Score 0++

Hi dear ,The general environmental operation is no problem, the specific temperature range cannot be informed because the high and low temperature reliability test is not done. You can read the battery voltage and power through I2C

There are many Raspberry Pi fans exchange experiences on our official website, you are welcome to join us https://geek...munity/forum

Anonymous user #6

6 months ago
Score 0++

Hello, your x728 board is excellent!

I was just wondering though how can I get servos to move position when I shutdown when I press the power switch?


6 months ago
Score 0++
After charging, the battery capacity measurement is no longer correct and only slowly recovers when the Raspberry Pi has been running for a while? Furthermore, the volt measurement shows 3.6 V but the capacity measurement already shows only 5 percent. What could that be?

Anonymous user #7

6 months ago
Score 0++
I also had this issue, have you found an answer?


4 months ago
Score 0++

Hi dear ,The battery chip need a continuous learning process during reading the battery capacity, we suggest that the battery should be fully charged at first, and then put off the electricity fully. Repeat like that after many times, the battery capacity will be gradually accurate. Note: When you trying, DON'T remove the battery plug , If you do, you need to retry again.

By the way ,There are many Raspberry Pi fans exchange experiences on our official website, you are welcome to join us https://geek...munity/forum

Anonymous user #5

6 months ago
Score 0++
Although this device "supports 3A fast charging", how can you configure it to not fast charge? I want to use a battery but it has a max-charge-current of 2.6A.

Anonymous user #5

6 months ago
Score 0++

How much current (max) does the ups draw for charging?

While plugged in, can the device still output over 3amps if the supply is only 3amps?

Anonymous user #4

7 months ago
Score 0++
Is there a case of the just size?


7 months ago
Score 0++
Hello sir,Sorry, do design case but you caan use the HAT size acrylic case or N300 for X728, please refer to https://geekworm.com/.


9 months ago
Score 0++

Is it compatible with X835? https://rasp...iki.com/X835

If so, how it should be powered?


8 months ago
Score 0++

Hi friend,

Sorry, X728 is not compatible with X835, as the X835 requires 12V power supply.

Anonymous user #3

9 months ago
Score 0++

Why does the Raspberry Pi turn on and off repeatedly? The power turns on and turns off after 3 seconds, and turns on again. Is it because the battery is not fully charged?

X750 had the same error...


9 months ago
Score 0++

I'm running https://raspap.com/ to use the Pi as a wireless hotspot. There was an issue with bringing up the wireless interface on RaspberryPi 3B+, if I short the jumper pin for ASD (Auto Shutdown). If I don't short the jumper, it becomes normal.

Has anyone else encountered the same issue?

Anonymous user #2

11 months ago
Score 0++


When do you expect the X728-A1 and X728-A2 boards to be available?

Is there a X728 Case in the pipeline?


11 months ago
Score 0++

Hi friend,

The X728-A1 and X728-A2 will release later in May.

Anonymous user #1

11 months ago
Score 0++
When will this item be released?


11 months ago
Score 0++

Hi friend, The X728 has just been releasded today, please refer to: https://geek...gement-board Best regards,