From Geekworm Wiki
Jump to navigation Jump to search

X306 UPS Shield for Pi zero W/2W
X306 UPS Shield for Pi zero W/2W- Front View
X306 UPS Shield for Pi zero W/2W - Rear View
X306 UPS Shield for Pi zero W/2W
X306 UPS Shield for Pi zero W/2W + C296
X306 UPS Shield Packing List


X306 is a one cell 18650 UPS shield designed for Raspberry Pi Zero W / 2W.

It equipped with 3 standard USB-A 2.0 ports, and a USB Type C to power. The USB-A port can be used to connect external devices such as mouse, keyboard etc.

Do not connect any device to the Micro USB, OTG port of Raspberry Pi Zero 2W when use with X306, or the USB2.0 ports of X306 is not available to use.


  • BOOKWORM does not require any setup and can be used directly with a keyboard and mouse.
  • The Raspberry Pi board, power adapter are not included in the packing list.
  • Raspberry pi micro OTG port cannot be used as it is occupied by USB HUB of X306
  • Do not connect any device to the Micro USB, OTG port of Raspberry Pi Zero 2W when use with X306, or the USB2.0 ports of X306 is not available to use.


4 Pin header function description:

Pin Function
AL ON: Pin 1&2 Short: Power always on, power button disabled;
AL ON: Pin 1&2 Open: Power button Press to switch on, Hold 3 seconds to switch off
PWR SW: Pin 3&4 for external 2-pin momentary switch

"AL ON" enable, "PWR SW" will be disable.

"PWR SW" enable, "AL ON" will be disable.


  • Ideal Uninterruptible Power Supply (UPS) solution for Raspberry Pi Zero W/2W
  • Max 5.1V 4000mA Power Backup for even the most demanding Raspberry Pi set ups
  • 18650 single cell battery holder
  • Upto 1000mA charging current
  • Integrated battery reverse polarity protection circuit
  • Integrated over current protection and over voltage protection
  • Intelligent automatic charging and discharging
  • 4 blue LEDs indicate battery charging and discharging levels of 25%, 50% , 75% and 100%
  • Red & green LEDs show the status of power on/off and charging status
  • On-board push button to control power on /off (Press-ON, Hold the button pressed at least 3s -OFF)
  • Ultra-low standby power consumption of μA to maximize battery life
  • Advanced system power path management avoids frequent charging and extend battery life
  • Connects to the Raspberry Pi via Pogo Pins - no wirindg & soldering required
  • 4-pin header for external power swtich and always-on power option
  • Equipped with three USB2.0 ports and one USB2.0 4-through-holes for more USB expansion


  • Input supply voltage: 5Vdc +/-5%
  • Input supply current: ≥3A
  • Charging current: 900~1050mA
  • Trickle charge current: 130~140mA
  • Predetermined Charge voltage: 4.2V +/-1.5%
  • Output voltage: 5.1V +/-5%
  • Max output current: 4000mA

How to Power

Power Input: 5.1Vdc +/-5% , ≥3A (Power Via USB Type-C port of X306 NOT Pi zero 2W)

How to charging X306 UPS shield?

How to Cool

Aluminum Heatsink for raspberry pi zero 2 w, please refer to C296

Support Geekworm C296 Heatsink for Pi Zero 2W

Packing List

  • 1 x X306 18650 UPS Shield
  • 4 x M2.5 x 5mm Screws

PCB dimention


Q1. What 18650 battery is recommended?

A: 18650 battery dimension


Q2. What is the power output for each usb port?

A: It is 5V, all ports share 4A, not limited to 500mA.

Q3. Is there any way I can check from the raspberry pi if it's connected to the power or the battery from the UPS?

A: When connected to the power supply to X306, the power supply supplies power to the Raspberry Pi; remove the power supply, it is powered by the battery.

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 #15

6 days ago
Score 0++
Does any 18650 battery fit the x306 or is there any recommendation on max discharge current, voltage ?

Anonymous user #14

19 days ago
Score 0++
Is there a gpio pin that tells the raspberry if ups working on battery or power line (as in the x728 hat)?


15 days ago
Score 0++
X306 does not have this function setting.

Anonymous user #13

28 days ago
Score 0++
I see a lot of people knocking this board, i just want to say it's working great for me, I put virtual here server on a pi zero WH and it works amazingly. I can take my portable usb hub out to the garage and plug my laser cutter into it, then go back to my office and burn for a couple hours only using half battery or so. I didn't do anything special.

Anonymous user #11

2 months ago
Score 0++
I was hesitant to buy this product because of some of the comments but I am glad I bought it. It is exactly what I need. I had a spare battery lying around without use, so I needed a UPS hat. The USB hub was a great extra. But, many comments here and reddit posts complained about USB hub not working. I had an impression that it is not working for everyone. But I can confirm, it is working for me. lsusb detects my usb drives (sandisk cruzer blade) and I can mount them. So if you needed a confirmation that this is a working product, you got it. It does work. Both the USB hub and the UPS part. Maybe the other guys had faulty units, dunno.


2 months ago
Score 0++
Thank you for your trust in our products!

Anonymous user #9

9 months ago
Score 0++

Hi, I'm also having the same problem with the USB ports, none of them are working. They are powering things, but no data goes through. I have confirmed the pogo pins are making contact, and have tried using a USB hub on the pi alone, without the UPS, and the hub works fine, so there's something wrong with this UPS. Does it need a ferrite ring?

Would love to solve this issue!



Anonymous user #10

9 months ago
Score 0++
I am having the same issue, no data on the usb ports, it just turn it on but no data, I cannot see the hub on lsusb, I can see this is a known issue a lot of post here with the same issue...

Anonymous user #12

one month ago
Score 0++

Easy solution, that Geekworm support does not know....

in config.txt comment out: dtoverlay=dwc2

and in cmdline.txt remove: modules-load=dwc2,g_ether

reboot and it works!

Anonymous user #8

10 months ago
Score 0++


What about the jumper? I guess if I want to use power switch I have to set it next and in parallel to the USB-Port?

Anonymous user #7

10 months ago
Score 0++
Can I see the remaining battery percentage?


10 months ago
Score 0++
Hello, the 4 blue LEDs of the X306 UPS Board indicate battery charging and discharging levels of 25%, 50% , 75% and 100%, can only roughly display the percentage of the battery

Anonymous user #6

11 months ago
Score 0++
None of the USB ports are working. Anything I plug into them does not function and is not listed as connected. What should I do to fix this?


11 months ago
Score 0++
Hi, we are sending you an email, hoping that you can provide some hardware installation pictures. The products are tested before leaving the factory, and there will be basically no quality problems. I hope you can check the test ponits under the Raspberry Pi Zero 2W, are these test ponits clean and the pogo pins align well with each test pins? This may affect the USB ports which make it not work.

Anonymous user #5

13 months ago
Score 0++
Is there a case for this?


12 months ago
Score 0++
Hello, I'm sorry, we don't have the X306 shell at present, but we have the specific information of X306 PCB dimention File:X306V1.1.dxf, you can make a shell by other means, such as 3D printing

Anonymous user #3

13 months ago
Score 0++
The usb hub is not getting recognized, any thoughts about to configure it?

Anonymous user #4

13 months ago
Score 0++
Try to remove X306, then test if the usb hub is recognized?

Anonymous user #2

14 months ago
Score 0++
I'm not sure if the USB ports are being recognized. Is there is software setting I need to change in the pi zero to use the USB ports?


14 months ago
Score 0++
Hi,Please connect the mouse and use the 【lsusb】 command to check.

Anonymous user #1

15 months ago
Score 0++
Do you have a Cad Model for this?


15 months ago
Score 0++
Hi,please refer to [PCB dimention]