Difference between revisions of "EP-0136"
(→USB Plus V5.0 Register Mapping Chart)
(→How To Use)
|Line 134:||Line 134:|
==How To Assemble==
==How To Assemble==
==How To Use==
==How To Use==
===How To Update UPS Firmware via OTA ===
===How To Update UPS Firmware via OTA ===
Revision as of 16:34, 23 December 2020
- 1 UPS Plus
- 2 Descriptions
- 3 Features
- 4 Gallery
- 5 How To Assemble
- 6 How To Use
- 6.1 Automatic Shutdown Protection
- 6.2 How To Update UPS Firmware via OTA
- 6.3 How To Enable Auto-Shutdown Protection Function
- 6.4 How To Collect Data
- 6.5 How To Setup RTC
- 6.6 How To Estimate Battery Power
- 6.7 How To Adjust The Sampling Period
- 6.8 How To Monitor Battery Temperature
- 6.9 How To Enable UPS function
- 6.10 How To Configure Programmable Shutdown/Force Restart
- 7 FAQ
- 8 Keywords
UPS Plus is a new generation of UPS power management module.
It is an improved version of the original UPS prototype.
It has been fixed the bug that UPS could not charge and automatically power off during work time.
It can not only perform good battery power management, but also provide stable voltage output and RTC functions.
At the same time,it support for FCP, AFC, SFCP fast charge protocol, support BC1.2 charging protocol, support battery terminal current/voltage monitoring and support two-way monitoring of charge and discharge.
It can provide programmable PVD function.
Power Voltage Detector (PVD) can be used to detect if batteries voltage is below or above configured voltage.
Once this function has been enabled, it will monitoring your batteries voltage, and you can control whether or not shut down Raspberry Pi via simple bash script or python script.
This function will protect your batteries from damage caused by excessive discharge.
It can provide Adjustable data sampling Rate.
This function allows you to adjust the data sampling rate so that you can get more detailed battery information and also it will consume some power.
The data sampling information can communicate with the upper computer device through the I2C protocol.
UPS Plus supports the OTA firmware upgrade function.
Once there is a new firmware update, it is very convenient for you to upgrade firmware for UPS Plus.
The firmware upgrade can be completed only by connecting to the Internet,and execute a python script.
Support battery temperature monitoring and power-down memory function.
UPS Plus can be set to automatically start the Raspberry Pi after the external power comes on.
The programmable shutdown and forced restart function will provide you with a remote power-off restart management method.
That means you don’t need to go Unplug the power cable or press the power button to cut off the power again.
You can set the program to disconnect the power supply after a few seconds after the Raspberry Pi is shut down properly.
And you can also reconnect the power supply after a forced power failure to achieve a remote power-off and restart operation.
Once it was setting up, you don't need to press power button to boot up your device which is very suitable for smart home application scenarios.
- 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
- 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.
USB Plus V5.0 Register Mapping Chart
- 0x17 - Operation Mode
|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
|0x01 - 0x10||Encrypted buffer|
|0x11 - 0xEF||[Reserved]|
|0xF0 - 0xFB||Serial Number|
|0xFC - 0xFF||Factory Test|
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 -sSL https://github.com/geeekpi/upsplus/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
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
- 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.
- UPS Plus, GeeekPi UPS V5, UPS for Raspberry Pi