UPS3

From Geekworm Wiki
Jump to navigation Jump to search


UPS HAT V3 Front View
UPS HAT V3 Back View
How to Install UPS3
UPS HAT V3 Interface
UPS HAT V3 Interface
UPS 3 PCB Layout
UPS 3 GPIO PIN

Overview

UPS3 is the upgrade version of UPS2, we solve some questions of UPS2.

NOTE: UPS 3 ONLY supports Linux OS, DON'T use UPS 3 on windows OS.

QC charge

Features

  • Raspberry Pi standard HAT size, all components under the PCB board, and the use of 5mm high female socket, can reduce the thickness of the expansion board, easy to put into the shell. You can use the header to increase the height.
  • Equipped with a custom long header (This is optional accessories)
  • Supports power supply of TYPE-C.
  • Type-C power supply interface is compatible with a variety of fast charge standard PD2.0/QC3.0/QC2.0 (5V/3A); Default 3A charging current, integrated chip will intelligently adjust the charging current according to the battery and power capabilities
  • Up to maximum 3A current output;
  • Long press power button 2 seconds to power on / off
  • With 4 LED power indicator (controlled by program, please refer to User Manual)
  • Supports AUTO POWER ON function (need to select the AUTO UPS switch to ON)
  • Use TI battery monitoring IC with patented Impedance Track algorithm
  • Support I2C communication to read battery capacity, voltage, charge status and battery life (please refer to status.py)
  • With charge and discharge protection and overheat protection
  • The capacity of Lithium Battery MUST be more than 2500mAh, you can use the more big capacity battery. PS: Voltage must be 3.7V. The connector specification is: PH 2.02-PIN connector

Packing List

  • 1 x UPS HAT 3 Board

User Manual

please download it from here:File:Ups3-master.zip then unzip if you can't download it from github.com

sudo rpi-update
sudo apt-get update
sudo apt-get dist-upgrade
git clone https://github.com/geekworm-com/ups3.git
cd ups3
chmod +x *.sh *.py
sudo ./install.sh

               ┌────────────────────┤ UPS V3 Setting ├────────────────────┐
               │ Select the appropriate options:                                                                    │
               │                                                                                                    │
               │                 1 UPS GPIO [ 18 ]                                                                  │
               │                 2 LED Brightness [ 10% ]                                                           │
               │                 3 Poweoff power [ <5% ]                                                            │
               │                 4 Auto run script [ enabled ]                                                      │
               │                 5 Safe shutdown [ enabled ]                                                        │
               │                 6 Apply Settings                                                                   │
               │                 7 Remove                                                                           │
               │                 8 Exit                                                                             │
               │                                                                                                    │
               │                                                                                                    │
               │                                                                                                    │
               │                                                                                                    │
               │                                      <Ok>                                                          │
               │                                                                                                    │
               └──────────────────────────────────────────────────┘

View Status:

sudo python status.py or sudo python status.py -t

View logs:

cat /var/log/smartups.log

FAQ

Q1: Customer feedback 1: I have an issue with UPS hat 3. I tried to use battery from the old tablet and pack of cells, but none of them work well and the raspberry is turning off about 0.5 to 1 second after disconnecting the power. I'm not sure, that it's problem of batteries or hat itself. Do you have any suggestions what is wrong? Could you suggest which batteries works best?

A: I guess, I found the reason why the UPS hat is not working properly. My raspberry pi is overclocked to 2.0GHz and also has increased voltage. When I use the defaults voltage and clock values in the configuration file it works better, but still I think my batteries are too weak. I'll do more tests and let you know. Currently, I find it important to note that overclocking is bad for the condition of the UPS 3 hat.

Q:Is it allowed to supply 12VDC directly to VCC and GND wires of the USB-connector ?

A: Yes, it is ok to use 12VDC directly.


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
  } 

  sleep(10);
}


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: Why the Raspberry Pi can't turn on after install the UPS3?

A: Please pay attention to the UPS3 board installation directions, this is wrong.

UPS3-Wrong-Installation.png
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 #21

2 months ago
Score 0++

Hello I have one of your UPS v3 connecter to my Pi. I have activated the Auto UPS feature (on). However, when the Pi is powered off using the poweroff command, the Pi does not restart when power is put back on.

What could be the cause?

Anonymous user #20

3 months ago
Score 0++
After installing the UPS3 and some testing, it seems that the Raspberry pi 4 will not boot up if it's powered down (poweroff) and the power is back, except if the battery is dead or removed in the mean time. Is the behavior correct? Based on the description, as soon as power is back, the Pi shoud boot up normally

Lisa

3 months ago
Score 0++
Hi, please follow here[[1]] to explain to check the question

Anonymous user #19

6 months ago
Score 0++
After installing UPS V3 software on Raspberry Pi 4, it never seems to shutdown completely, it gets stuck on plymouth-poweroff.service screen, how do I fix this?

Anonymous user #18

8 months ago
Score 0++

I've ordered UPS 3 from aliexpress u-geek workshop store.

In the package I've received the UPS 3 and a small plastic bag with two PH 2.0 2-PIN cables and two very small radiators(these are not for raspberryPI as they are very small and it's almost the size of the microchips on the ups 3 hat)


Besides that I have one more question. Sometimes the board makes some coil whining noise, is this normal?

Lisa

8 months ago
Score 0++
If the heat sink is very small, it is used on the chip of the UPS board. and it is also possible not to use it. please try to contact the customer service of aliexpress u-geek workshop store.

Anonymous user #18

8 months ago
Score 0++

Hi, I've ordered a UPS HAT3 and received it along with two heatsinks. Where on the ups hat 3 board should these heatsinks be placed?

Thank you!

Lisa

8 months ago
Score 0++

Hi,

If you received a small aluminum heatsink, it's probably for a Raspberry Pi motherboard. But our UPS 3 HAT does not include a heatsink.where did you buy the UPS 3,could you please tell us your order number?

Anonymous user #17

10 months ago
Score 0++
Great product - very easy to start off with. But I am trying to make the Auto ON function work. When the RPi starts to shut down, I get a "kernel panic - not syncing" error (systemd-shutdow Tainted) when the Auto ON function is enabled. I am running fresh Rasbian Buster with newest kernel 5.10.95, and have also tried with 5.10.63 - please help

Lisa

9 months ago
Score 0++

Hello,

Auto ON is a hardware function and not affect system updates. Please refresh the system and try again.Thanks.

Anonymous user #14

10 months ago
Score 0++
Is there a way to connect a battery thermistor for the BQ25895 thermistor input?

Lisa

9 months ago
Score 0++

Hello,

Sorry, It is not supported.

Anonymous user #16

10 months ago
Score 0++

Hello! Is there any way to implement the following scenario?- 1) Raspberry is running and battery is completely charged and input power is up 2) Input power goes down, raspberry gets the information from UPS3 and shuts down shortly 3) Battery remains charged and raspberry stays off while input power is down

4) Input power comes back up and raspberry boots up

Lisa

10 months ago
Score 0++

Hello,

For you questions 1/2/3)you need to turn off the power by the switch. 4) Please refer to 'AUTO ON' function

Anonymous user #15

11 months ago
Score 0++

Hello.

I can't get the hat to work well.

Can you tell me all the dependencies and library you use.

Thanks a lot.

Lisa

11 months ago
Score 0++

Hello,

sorry,I don't understand what you need.Could you please tell us more details?

For UPS 3 GPIO PIN and instructions, please refer to the picture and the content above.

Anonymous user #15

11 months ago
Score 0++

Hello.

I am trying to install the hat on a lite version of rapbyan. I have not managed to get anything to work with another user other than "pi".

I need all the modules and libraries that are linked to the UPS in order to install it correctly.

Lisa

11 months ago
Score 0++

Hello,

Please refer the above script of [User Manual] , please try another network source to reinstall and test.

Anonymous user #14

11 months ago
Score 0++
Battery fuel gauge chip MAX17048: Uses I2C addresses 0x6C and 0x6D, per the Maxim datasheet. However, your smartups.py code has "MAX17048_ADDR = 0x36". Which is correct, and how does this work?

Lisa

11 months ago
Score 0++
these two are the same thing, It's just that the address is a little different; One is adding 0 before the address, and the other is adding 0 after the address. The program is to use 0X36, in the system, the ADDR is 0x36

Anonymous user #14

11 months ago
Score 0++

I need some help for using your UPS3 with other HATs in the same system. What are all the GPIO pins the UPS3 uses? Studying your Wiki and Github info I find:

- LED brightness (control): GPIO 18 controls LEDs, and this can be changed to GPIO 12 (either provides Pi PWM0). I must also change the "DI" strap on the UPS3 board, next to the "POFF" strap to use GPIO 12, correct? - Power off control: Using the UPS3_power_off_guide, if I strap connect GPIO 6 and then drive GPIO 6 high then the UPS3 immediately turns off power to the 5V output, correct? - I2C port used: Uses Pi I2C1 interface on Pi P1 connector pins 3 and 5, correct? - Battery charger chip BQ25895: Uses I2C address 0x6A, correct? - Battery fuel gauge chip MAX17048: Uses I2C addresses 0x6C and 0x6D, per the Maxim datasheet. However, your smartups.py code has "MAX17048_ADDR = 0x36". Which is correct, and how does this work?

- Are there any other resources on the Pi P1 connector that are used, so that I can avoid conflicts in my board design?

Lisa

11 months ago
Score 0++
Hi,We uploaded a schematic diagram of UPS3 GPIO function, please refer to the picture

Anonymous user #14

12 months ago
Score 0++
If I supply a fixed, constant 12V to the USB-C connector will this cause any battery over charging or more wasted power/heat in the UPS3 board? Is there an advantage of 5V versus 12V power in?

Lisa

11 months ago
Score 0++

Hi,It can support 12V/9V/5V input, will not overcharge the battery.

The charging current of the battery is dynamically adjusted according to the battery status.

Anonymous user #13

13 months ago
Score 0++

Yet another geekworm ups hat that does not do what it should..

With the switch in UPS mode, if the pi is shut down it will not power back up again if the input power cycles. Completely useless. I have to make some sort of monostable oscillator that gives me a 2sec pulse to power back up in normal mode to get any use of this.

Lisa

12 months ago
Score 0++
If you want continuous power supply, you need to turn on the 【auto 】switch.If you are using UPS mode, the auto function cannot be realized. Please understand.

Anonymous user #12

14 months ago
Score 0++
Is there a place on the board where i can solder wires from psu, instead of using the Type C connector?

Lisa

14 months ago
Score 0++
Hi, UPS3 board does not support that

Anonymous user #11

17 months ago
Score 0++

Hi

Hope you can help me with this. I have an UPS3 board on a raspberry pi 4 and a 3,7v 6000mah battery attached. It works. but there is a red led for ac input power and a green for battery input power. first they both lit up and after a couple of day the red ac light began to blink. what does this means? If I pull the ac power off and attached it again it will light up steady and then after a couple of days it will start to blink.

best regards

Robin Petersen

Lisa

17 months ago
Score 0++

Hi, The red light flashing is an Alert, which is usually caused by a malfunction of the charging adapter. At this time, please unplug the power and plug it in again.

Best regards

Anonymous user #10

21 months ago
Score 0++

hello! before shutdown, i need to perform an action on the RPi..

can the switch off button's message to Rpi be edited in order to perform this action before the acutal safe shutdown?

let's say: 1) switch off pressed 2)message sent from UPS HAT to Rpi in order to manage an additional/external operation from the Rpi (in my case is safely shutdown a device from a Rpi's Gpio) 3)Rpi safe shutdown

greetings

Lisa

17 months ago
Score 0++
Hi,how to use the GPIO port of UPS3 to realize software shutdown function?please refer here:UPS3 power off guide

Anonymous user #9

21 months ago
Score 0++

Given that the Voltage of this UPS Hat is specified as 3.7V could we also use LiFePo4 batteries rated at 3.6V?

Most other HATs charge up to 4.2V and that's way to much. We're just 0.1V above that ... so would it be save to use LiFePo4?

I really don't trust Lithium-Batteries at all for that use-case ...

Lisa

17 months ago
Score 0++
Hello,We do not recommend use 3.6V, it needs to use 3.7V

Anonymous user #8

24 months ago
Score 0++

Given that :

- We use I2C to track the charging status and detect a power failure - We set the AUTO UPS switch to ON


1 - We detect a power failure 2 - Battery is now used and everything is alright 3 - We decide to shut down the RPi 4 - During the shutdown phasis, the power is back


Q : What happens at 4?

I think that actually, the RPi will just keep on shutting down normally but never powers ON again until a new power failure + power recovery cycle occurs. Which would be quite a problem and would defeat the purpose of this UPS device.

Xiali

24 months ago
Score 0++

Hi dear ,Glad to receive your message 1. The battery power is decreasing. It may be the voltage change during charging. The measuring chip is recalculating the power. The light is red to indicate that it is charging. Check the power situation after a while. If the power keeps dropping, try another power cord. 2. The automatic power-on function means that when you turn on the "auto on" switch, when the external power supply is connected, the Raspberry Pi will be powered on. The switch button controls 3. There are many Raspberry Pi fans exchange experiences on our official website, you are welcome to join us

https://geek...munity/forum

Anonymous user #7

25 months ago
Score 0++
Where do you enable 'auto power on' or 'auto on' functions?

Rwagnon

25 months ago
Score 0++
Can it be powered / charged by header pins (5v/gnd) - this would allow PoE hat.

Anonymous user #6

25 months ago
Score 0++

The UPS hat stops charging the battery once the main power is reconnected. If I shutdown the raspberry Pi and restart HAT either with push button or with the auto-power switch, only then SOC% start increasing in the log(battery really starts charging). Details below:

Steps & Observation: 1. Raspberry Pi powered via HAT and battery is charging, log file shows SOC% going up. 2. Power is disconnected from HAT USB-C 3. Raspberry Pi still remains operational as expected. log file shows SOC% dropping as expected with status:discharging 4 HAT USB-C is supplied power again (doesn't matter on the auto-power switch state) 5. Raspberry Pi still remains operational. log file shows:

smartups.log: INFO Input:Connected , ChargeStatus: Charging , SOC:44%. <== SOC continue to drop

Anonymous user #6

25 months ago
Score 0++
It turned out to be the power supply issue. Replacing it with recommended 18W+ power supply with PD or QC fast charging support resolved.

Anonymous user #5

26 months ago
Score 0++

This Hat helped with the power problems I had with my Pi setup. I'm very pleased so far. I am unable to get the battery test to work, ill try to figure that out soon. The only thing extra is, that I would have liked to have solder pads for input power along with the current connector. Very Nice... if you could point me to how to fix the batter level indication, I would be appreciated. Also if there is a more detailed user manual than the single sheet. Love the Hat !

I will reccomend this to a few Pi using friends !

Anonymous user #4

26 months ago
Score 0++
If using a high discharge battery, can the device be Modified to output more than 3A? Are there any power sensitive components?

Anonymous user #3

27 months ago
Score 0++
What is the P2 position? I want to mount an external push button power switch on the outside of my case. How would I do that? Thanks

Anonymous user #3

27 months ago
Score 0++
Is there a way to add an external On/Off switch?

Harry

27 months ago
Score 0++
You can check the P2 position.

Swereska

27 months ago
Score 0++
I was going to come here and ask a bunch of questions about why things didn't work... Instead I'll say: nice reverse current protection! My battery was wired backwards...

Xiali

24 months ago
Score 0++

Hi dear,There are many Raspberry Pi fans exchange experiences on our official website, you are welcome to join us: http://geekw...munity/forum Sincerely

Ada/Geekworm

Anonymous user #2

27 months ago
Score 0++
Can I add pins to the back of the module in order to attach another HAT on top of it?

Harry

27 months ago
Score 0++
why not?

Serveurperso

27 months ago
Score 0++
It look the long awaited product for small robots. All other have some hardware bugs and problem, this one pass all intensive testing we make for small Vigibot.com community robots.

Anonymous user #1

29 months ago
Score 0++

Looks primising, will test it!

How to configure (limit) charging current to 1A ?