EP-0136: Difference between revisions
Jump to navigation
Jump to search
Line 195: | Line 195: | ||
* Execute it: | * Execute it: | ||
<pre>python3 OTA.py</pre> | <pre>python3 OTA.py</pre> | ||
< | <font color=red><b>The first time it runs, it may prompt that the device is not registered.If it is a legal device, just wait a few seconds and try again.</b></font> | ||
* UPS Pro Will be turned off after upgrading, Please unplug the power supply, remove the batteries from UPS Pro. | * UPS Pro Will be turned off after upgrading, Please unplug the power supply, remove the batteries from UPS Pro. | ||
* Insert the batteries back to UPS Pro and then connect power supply and turn it on by press power switch. | * Insert the batteries back to UPS Pro and then connect power supply and turn it on by press power switch. |
Revision as of 17:15, 6 January 2021
UPS Plus
Descriptions
UPS Plus is a new generation of UPS power management module.
Features
- Easy to install
- Enhanced power management
- Remote OTA firmware upgrade
- Programmable BACK-TO-AC auto power up
- Programmable sample period
- I2C communication
- Standalone RTC
- Support stacked battery design
Specifications
- Current/voltage monitoring of Raspberry Pi power supply port.
- Battery terminal current/voltage monitoring, supports two-way monitoring of charge and discharge.
- Independent RTC function.
- OTA function (supports forced upgrade mode and active upgrade mode).
- Power estimation
Note: At least one full charge and discharge cycle must be completed!)
- Adjustable sampling period.
- Support FCP, AFC, SFCP fast charge protocol.
- Support BC1.2 charging protocol.
- Battery temperature monitoring
Note: the forced temperature protection cannot be turned off, threshold: 65 degrees!
- Programmable Power Voltage Detector(PVD) function, Default value: 3.6V
- Incoming call self-start function.
- Power down memory function.
- Programmable shutdown / forced restart.
- Running time statistics
- Electrostatic protection.
- Linear compensation range discharge capacity: 5V 4.5A.
- Non-linear compensation range discharge capacity: 5V 8A.
- Charging capacity 4.5V 5A/5V 2.5A/9V 2A/12V 1.5A.
- Stacked battery design
NOTE: Stacked power board need to be special accessories.Can not support None official accessories.
- Use I2C communication without occupying additional ports.
- Support 4.2V 4.35V 4.4V 4.5V lithium battery
Note: Different types of batteries cannot be mixed!
- After-sales data telemetry.
Register Mapping
USB Plus V5.0 Register Mapping Chart
- 0x17 - Operation Mode
Address | Function | Range | Unit |
---|---|---|---|
0x01 - 0x02 | Voltage of UPS's MCU | 2400 - 3600 | mV |
0x03 - 0x04 | Voltage of Pogopin's Bottom | 0 - 5500 | mV |
0x05 - 0x06 | Voltage of Batteries' Terminal | 0 - 4500 | mV |
0x07 - 0x08 | Voltage of USB-C Charging Port | 0 - 13500 | mV |
0x09 - 0x0A | Voltage of MicroUSB Charging Port | 0 - 13500 | mV |
0x0B - 0x0C | Batteries Temperature | -20 - 65 | ℃ |
0x0D - 0x0E | Full Voltage | 0 - 4500 | mV |
0x0F - 0x10 | Empty Voltage | 0 - 4500 | mV |
0x11 - 0x12 | Protection Voltage | 0 - 4500 | mV |
0x13 - 0x14 | Battery Remaining | 0 - 100 | % |
0x15 - 0x16 | Sample Period | 1 - 1440 | Min |
0x17 | Power Status/Operation Mode | 0/1 | Bool |
0x18 | Shutdown Countdown | 0/1 - 255 | Bool/Sec |
0x19 | Back-To-AC Auto Power up | 0/1 | Bool |
0x1A | Restart Countdown | 0/1 - 255 | Bool/Sec |
0x1B | Reset to Factory Defaults | 0/1 | Bool |
0x1C - 0x1F | Cumulative Running Time | 0 - 2147483647 | Sec |
0x20 - 0x23 | Accumulated Charging Time | 0 - 2147483647 | Sec |
0x24 - 0x27 | Running Time | 0 - 2147483647 | Sec |
0x28 - 0x29 | Version | 1 | Fixed |
0x2A - 0xEF | [Reserved] | NA | NA |
0xF0 - 0xFB | Serial Number | Device UID | Fixed |
0xFC - 0xFF | Factory Testing | NA | NA |
- 0x18 - OTA Firmware Upgrade Mode
Address | Function |
---|---|
0x01 - 0x10 | Encrypted buffer |
0x11 - 0xEF | [Reserved] |
0xF0 - 0xFB | Serial Number |
0xFC - 0xFF | Factory Test |
Gallery
PCB Drawing
Function Area Display
How To Assemble
How To Use
Automatic Shutdown Protection
- Download the latest Raspbian OS image from: [ https://www.raspberrypi.org/software/operating-systems/ ]
- Unzip it and flash it to MicroSD card(TF card) with Etcher imaging tool. [ https://www.balena.io/etcher/ ]
- Follow the installation method to assemble the Raspberry Pi and UPS Plus.
- After booting up and make sure Raspberry Pi can access internet.
- Open a terminal by press "Ctrl+ALT+T" or just click terminal icon on the task bar.
curl -Lso- https://git.io/JLygb
or
curl -Lso- https://raw.githubusercontent.com/geeekpi/upsplus/main/install.sh | bash
- When encountering low battery, it will automatically shut down and turn off the UPS and it will restart when AC power comes.
How To Update UPS Firmware via OTA
- Enter the OTA firmware upgrade mode:
Method 1
NOTE: Do not power off or disconnect the network during the upgrade process. If the upgrade fails, the UPS Pro will not work normally.
- Power off the Raspberry Pi.
- Cut off the external charging power (MicroUSB and USB-C)
- Take out all the batteries.
- Press and hold the UPS Pro switch key and insert the battery into the battery compartment.
At this time, the device will be forced to enter OTA mode.
The function of the switch button will no longer be available at this time.
The Raspberry Pi will be running and please execute the following python script in the system terminal to complete the upgrade.
- Create a new file named: "OTA.py" via this command:
nano OTA.py
- Copy following code into this file:
import os import time import json import smbus import requests # Enter OTA method # Step 1) i2cset -y 1 0x17 50 127 b # Step 2) Shut down the Raspberry Pi normally, unplug all power/batteries, and reinstall. DEVICE_BUS = 1 DEVICE_ADDR = 0x18 UPDATE_URL = "https://api.thekoziolfoundation.com/update" bus = smbus.SMBus(DEVICE_BUS) aReceiveBuf = [] for i in range(240,252): aReceiveBuf.append(bus.read_byte_data(DEVICE_ADDR, i)) UID0 = "%08X" % (aReceiveBuf[3] << 24 | aReceiveBuf[2] << 16 | aReceiveBuf[1] << 8 | aReceiveBuf[0]) UID1 = "%08X" % (aReceiveBuf[7] << 24 | aReceiveBuf[6] << 16 | aReceiveBuf[5] << 8 | aReceiveBuf[4]) UID2 = "%08X" % (aReceiveBuf[11] << 24 | aReceiveBuf[10] << 16 | aReceiveBuf[9] << 8 | aReceiveBuf[8]) r = requests.post(UPDATE_URL, data={"UID0":UID0,"UID1":UID1,"UID2":UID2}) r = json.loads(r.text) if r['code'] != 0: print('Firmware acquisition failed, reason:' + r['reason']) exit(r['code']) else: print('The firmware is successfully obtained, and the firmware is being downloaded and updated.') req = requests.get(r['url']) f = open("/tmp/firmware.bin", "wb") f.write(req.content) print("Get the firmware successfully!") print('The firmware starts to be upgraded, please keep the power on, interruption in the middle will cause unrecoverable failure of the UPS!') with open('/tmp/firmware.bin','rb') as f: while True: data = f.read(16) for i in range(len(list(data))): bus.write_byte_data(0x18, i + 1,data[i]) bus.write_byte_data(0x18,50,250) time.sleep(0.1) print('.',end='',flush=True) if len(list(data)) == 0: bus.write_byte_data(0x18,50,0) print('.',flush=True) print('The firmware upgrade is complete, please disconnect all power/batteries and reinstall to use the new firmware.') os.system("sudo halt") while True: time.sleep(10)
- Save it by pressing `CTRL+X` and pressing 'Y'.
- Execute it:
python3 OTA.py
The first time it runs, it may prompt that the device is not registered.If it is a legal device, just wait a few seconds and try again.
- UPS Pro Will be turned off after upgrading, Please unplug the power supply, remove the batteries from UPS Pro.
- Insert the batteries back to UPS Pro and then connect power supply and turn it on by press power switch.
Method 2
- Open a terminal and typing:
i2cset -y 1 0x17 50 127 b
- Shutdown Raspberry Pi and remove all batteries and power supply.
- Insert batteries back into the battery slot.
- Execute OTA.py python script.
- UPS Pro Will be turned off after upgrading, Please unplug the power supply, remove the batteries from UPS Pro.
- Insert the batteries back to UPS Pro and then connect power supply and turn it on by press power switch.
How To Enable Auto-Shutdown Protection Function
How To Collect Data
How To Setup RTC
How To Estimate Battery Power
How To Adjust The Sampling Period
How To Monitor Battery Temperature
How To Enable UPS function
How To Configure Programmable Shutdown/Force Restart
FAQ
- Q: Why does the battery light go off sometime and lights up in a while?
- A: This is because the power chip performs battery re-sampling, and the purpose is that the data of inferior batteries is inaccurate during the sampling process.
- Q: Why is the power cut off every once in a while?
- A: Please check the battery charging current, the data discharge direction or the charging direction. If the load is too large, the charging may not be enough, which will cause this problem.
- Q: What kind of wall charger should I use?
- A: If the load is normal, it is recommended to use an ordinary 5V@2A charging head. If you need to carry a slightly higher load, it is recommended to use a fast charging source. We support FCP, AFC, SFCP protocols Fast charging source.
- Q: Can I directly input 9V and 12V to the USB port?
- A: No, if you must do this, you must remove the DP, DM and other related detection pins, and ensure that the power supply is stable.
- Q: I heard howling, why is this?
- A: Because of the no-load protection mechanism, the howling will disappear after the load is installed.
Keywords
- UPS Plus, GeeekPi UPS V5, UPS for Raspberry Pi