Template:X120x-FAQ: Difference between revisions

(28 intermediate revisions by 5 users not shown)

Line 1:

~~Q. How to disable/enable~~ the ~~5V output~~ of ~~the UPS when the RPi 5 is turned off~~?

<span style="color:red">Q1: Why does the message "This power supply is not capable of supplying 5A" appear??</span>

</div>

A:

X120X series UPS shield can provide '''enough 5A''' power supply capacity;

Please set as follows:

Open the Teminal window based on '''Raspberry Pi OS''' and execute the following command:

sudo rpi-eeprom-config -e

Add <code>PSU_MAX_CURRENT=5000</code> at the end of the file that reads like this:

[[File:X1012-setting.png|700px]]

Press '''Ctrl-O''', then enter, to write the change to the file.

Press '''Ctrl-X''' to exit nano (the editor).

'''Reboot''' your Raspberry Pi 5 to make the change take effect.

'''Note:''' If you are using other OS like Ubuntu, please flash '''Raspberry Pi OS''' first, and then re-flash other OS such as Ubuntu etc after completing the above settings.

~~Editing the EEPROM configuration~~

~~From~~ the ~~command line or Terminal window start by running~~ the following ~~command~~ :

If you are using '''USB peripherals''' that need to be powered from the RPi5's USB port, '''don't forget''' to enable the following settings to ensure that the RPi5's USB port's current output is not limited:

Add <code>usb_max_current_enable=1</code> in the <code>/boot/firmware/config.txt</code> file.

</div>

<span style="color:red">Q2. Why am I seeing an "Undervoltage Detected" warning?</span>

</div>

A:Regarding the low voltage warning issue(Please refer to Q1 to check whether the connection is installed correctly):

* Please carefully check whether your hardware installation is secure and if the pogo pins are making proper contact. We have had cases where customers found that loose brass standoffs caused poor contact with the pogo pins, leading to the low voltage warning.

* It may be caused by an OS update. Please confirm whether you have recently updated the OS or if your OS system updates automatically.

* Please run the command:<code>vcgencmd pmic_read_adc</code> and provide us with the result. Alternatively, use a multimeter to measure the voltage value of '''PIN2'''. As shown in the figure

[[File:X120x.png|700px]]

<pre>

~~sudo rpi-eeprom-config -e~~

pi@geekworm:~ $ vcgencmd pmic_read_adc

3V7_WL_SW_A current(0)=0.00097593A

3V3_SYS_A current(1)=0.13955800A

1V8_SYS_A current(2)=0.25374180A

DDR_VDD2_A current(3)=0.01854267A

DDR_VDDQ_A current(4)=0.00049020A

1V1_SYS_A current(5)=0.25276590A

0V8_SW_A current(6)=0.34547920A

VDD_CORE_A current(7)=0.87514000A

3V3_DAC_A current(17)=0.00024420A

3V3_ADC_A current(18)=0.00024420A

0V8_AON_A current(16)=0.00341880A

HDMI_A current(22)=0.02063490A

3V7_WL_SW_V volt(8)=3.70534400V

3V3_SYS_V volt(9)=3.31467300V

1V8_SYS_V volt(10)=1.80024200V

DDR_VDD2_V volt(11)=1.11355200V

DDR_VDDQ_V volt(12)=0.60109830V

1V1_SYS_V volt(13)=1.10622600V

0V8_SW_V volt(14)=0.80109810V

VDD_CORE_V volt(15)=0.72017020V

3V3_DAC_V volt(20)=3.31318300V

3V3_ADC_V volt(21)=3.31684600V

0V8_AON_V volt(19)=0.80029220V

HDMI_V volt(23)=5.19920000V

EXT5V_V volt(24)=5.20322000V

BATT_V volt(25)=0.00000000V

</pre>

Please check the voltage value of <mark>EXT5V_V</mark> line

~~Change~~ the ~~setting~~ of <~~code~~>~~POWER_OFF_ON_HALT~~</~~code~~> ~~from <code>0</code> to <code>1</code> , Add <code>PSU_MAX_CURRENT=5000</code> at the end of the file that reads like this:~~

~~[[File:x120x_setting1.png|800px]]~~

</div>

Line 22:

Line 74:

~~Q: Why does~~ the ~~message "This power supply~~ is ~~not capable of supplying 5A" appear?~~?

Q3. How to disable/enable the 5V output of the UPS when the RPi 5 is turned off?

</div>

~~X120X series UPS shield can provide '''enough 5A''' power supply capacity;~~

A: Editing the EEPROM configuration

~~Please set as follows~~:

From the command line or Terminal window start by running the following command :

~~Open the Teminal window based on '''Raspberry Pi OS''' and execute the following command:~~

<pre>

sudo rpi-eeprom-config -e

~~Add~~ <code>~~PSU_MAX_CURRENT=5000~~</code> ~~at the end of the file that reads~~ like this:

</pre>

Set <code>POWER_OFF_ON_HALT</code> to <code>0</code> or <code>1</code> like this:

[[File:X1012-setting.png|700px]]

<code>1</code>: disable 5v outputs

<code>0</code>: enable 5v outputs

Press '''Ctrl-O''', then enter, to write the change to the file.

Line 40:

Line 98:

'''Reboot''' your Raspberry Pi 5 to make the change take effect.

~~'''Note:''' If you are using other OS like Ubuntu, please flash '''Raspberry Pi OS''' first, and then re-flash other OS such as Ubuntu etc after completing the above settings.~~

If you are using '''USB peripherals''' that need to be powered from the RPi5's USB port, '''don't forget''' to enable the following settings to ensure that the RPi5's USB port's current output is not limited:

~~Add <code>usb_max_current_enable=1</code> in the <code>/boot/firmware/config.txt</code> file.~~

</div>

Line 52:

Line 103:

Q: How to disable '''auto power on''' feature on [[X1200]]?

Q4: How to disable '''auto power on''' feature on [[X1200]]?

</div>

Line 71:

Line 122:

Q: How to disable '''auto power on''' feature on [[X1201]]?

Q5: How to disable '''auto power on''' feature on [[X1201]]?

</div>

Line 90:

Line 141:

Q: How to disable '''auto power on''' feature on [[X1202]]?

Q6: How to disable '''auto power on''' feature on [[X1202]]?

</div>

Line 109:

Line 160:

Q: How to disable '''auto power on''' feature on [[X1203]]?

Q7: How to disable '''auto power on''' feature on [[X1203]]?

</div>

Line 128:

Line 179:

Q: Why is the RPi5 LED still on and red after the UPS is turned off?

Q8: Why is the RPi5 LED still on and red after the UPS is turned off?

</div>

Line 150:

Line 201:

Q: What battery is recommended for this ~~ups~~ shield

Q9: What battery is recommended for this UPS shield?

</div>

Line 159:

Line 210:

If using a lithium battery, the required voltage is 3.7V;

if using a battery pack, please make sure it is a parallel battery pack.

If using a battery pack or battery holder, please make sure it is a parallel battery pack. '''Please use a high-quality battery holder with thick and durable connection cables. Using a low-quality battery holder with thin or poorly connected wires may cause the X1203 to malfunction or fail to operate as expected.'''

There are 2 XH2.54-2P battery connectors on board, it is recommended to use the same type of battery.

Line 169:

Line 221:

Q: Run <code>sudo i2cdetect -y 1</code>, can't find I2C address 0x36?

Q10: Run <code>sudo i2cdetect -y 1</code>, can't find I2C address 0x36?

</div>

Line 188:

Line 240:

Q. How do you disable the X1202 auto-shutdown when you use it standalone (not installed on a RPi5)?

Q11. How do you disable the X1202 auto-shutdown when you use it standalone (not installed on a RPi5)?

</div>

Line 198:

Line 250:

Q. X1203 UPS voltage drops / low voltage warning appears?

Q12. X1203 UPS voltage drops / low voltage warning appears?

</div>

Line 208:

Line 260:

[[File:Test pad on the Pi's PCB.png|800px]]

</div>

Q13. Documentation about the I2C registers：

</div>

A:

[https://www.analog.com/media/en/technical-documentation/data-sheets/MAX17040-MAX17041.pdf MAX17040G+]

</div>

Q14. Why does the RPI 5 lose power within a few seconds after pressing the power button on the X120x UPS?

</div>

A:

'''Please note: If the UPS does not detect the RPi5, it will automatically shut down within 3 seconds. So you need to install the RPi 5 on the UPS and make sure that the RPi5 has good contact with the UPS's pogo pins.'''

</div>

Q15. Which product should I choose if I can’t connect to a Raspberry Pi via pogo pins?

</div>

A:

For the X12-UPS series, we recommend the '''[[X1206]]''' – models from X1200 to X1205 do not support this usage. The X120- UPS series auto-powers off when no Raspberry Pi 5 is detected, while the X1206 can be set to "Always Power On" mode and keeps working even if the Raspberry Pi is shut down. Please refer to <span style="color:red">'''Interface ⑩_ALON'''</span> in the picture.

[[File:X1206-IMG-7240-Interface-New.jpg|800px]]

You can also consider the '''[[X-UPS1]]'''. It features a GPIO Pin-Connected standalone design with high flexibility for installation and adaptation (refer to the picture).

[[File:X-UPS1-IMG-5409.jpg|800px]]

</div>

@@ Line 1: / Line 1: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q. How to disable/enable the 5V output of the UPS when the RPi 5 is turned off?
+<span style="color:red">Q1: Why does the message "This power supply is not capable of supplying 5A" appear??</span>
 </div>
 <div class="mw-collapsible-content">
-A:
+X120X series UPS shield can provide '''enough 5A''' power supply capacity;
+Please set as follows:
+Open the Teminal window based on '''Raspberry Pi OS''' and execute the following command:
+ sudo rpi-eeprom-config -e
+Add <code>PSU_MAX_CURRENT=5000</code> at the end of the file that reads like this:
+[[File:X1012-setting.png|700px]]
+Press '''Ctrl-O''', then enter, to write the change to the file.
+Press '''Ctrl-X''' to exit nano (the editor).
+'''Reboot''' your Raspberry Pi 5 to make the change take effect.
+'''Note:''' If you are using other OS like Ubuntu, please flash '''Raspberry Pi OS''' first, and then re-flash other OS such as Ubuntu etc after completing the above settings.
-Editing the EEPROM configuration
-From the command line or Terminal window start by running the following command :
+If you are using '''USB peripherals''' that need to be powered from the RPi5's USB port, '''don't forget''' to enable the following settings to ensure that the RPi5's USB port's current output is not limited:
+Add <code>usb_max_current_enable=1</code> in the <code>/boot/firmware/config.txt</code> file.
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+<span style="color:red">Q2. Why am I seeing an "Undervoltage Detected" warning?</span>
+</div>
+<div class="mw-collapsible-content">
+A:Regarding the low voltage warning issue(Please refer to Q1 to check whether the connection is installed correctly):
+* Please carefully check whether your hardware installation is secure and if the pogo pins are making proper contact. We have had cases where customers found that loose brass standoffs caused poor contact with the pogo pins, leading to the low voltage warning.
+* It may be caused by an OS update. Please confirm whether you have recently updated the OS or if your OS system updates automatically.
+* Please run the command:<code>vcgencmd pmic_read_adc</code> and provide us with the result. Alternatively, use a multimeter to measure the voltage value of '''PIN2'''. As shown in the figure
+[[File:X120x.png|700px]]
 <pre>
-sudo rpi-eeprom-config -e
+pi@geekworm:~ $ vcgencmd pmic_read_adc
+V7_WL_SW_A current(0)=0.00097593A
+V3_SYS_A current(1)=0.13955800A
+V8_SYS_A current(2)=0.25374180A
+  DDR_VDD2_A current(3)=0.01854267A
+  DDR_VDDQ_A current(4)=0.00049020A
+V1_SYS_A current(5)=0.25276590A
+V8_SW_A current(6)=0.34547920A
+  VDD_CORE_A current(7)=0.87514000A
+V3_DAC_A current(17)=0.00024420A
+V3_ADC_A current(18)=0.00024420A
+V8_AON_A current(16)=0.00341880A
+      HDMI_A current(22)=0.02063490A
+V7_WL_SW_V volt(8)=3.70534400V
+V3_SYS_V volt(9)=3.31467300V
+V8_SYS_V volt(10)=1.80024200V
+  DDR_VDD2_V volt(11)=1.11355200V
+  DDR_VDDQ_V volt(12)=0.60109830V
+V1_SYS_V volt(13)=1.10622600V
+V8_SW_V volt(14)=0.80109810V
+  VDD_CORE_V volt(15)=0.72017020V
+V3_DAC_V volt(20)=3.31318300V
+V3_ADC_V volt(21)=3.31684600V
+V8_AON_V volt(19)=0.80029220V
+      HDMI_V volt(23)=5.19920000V
+     EXT5V_V volt(24)=5.20322000V
+      BATT_V volt(25)=0.00000000V
 </pre>
+Please check the voltage value of <mark>EXT5V_V</mark> line
-Change the setting of  <code>POWER_OFF_ON_HALT</code> from <code>0</code> to <code>1</code> , Add <code>PSU_MAX_CURRENT=5000</code> at the end of the file that reads like this:
-[[File:x120x_setting1.png|800px]]
 </div>
 </div>
@@ Line 22: / Line 74: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: Why does the message "This power supply is not capable of supplying 5A" appear??
+Q3. How to disable/enable the 5V output of the UPS when the RPi 5 is turned off?
 </div>
 <div class="mw-collapsible-content">
-X120X series UPS shield can provide '''enough 5A''' power supply capacity;
+A: Editing the EEPROM configuration
-Please set as follows:
+From the command line or Terminal window start by running the following command :
-Open the Teminal window based on '''Raspberry Pi OS''' and execute the following command:
+<pre>
- sudo rpi-eeprom-config -e
+sudo rpi-eeprom-config -e
-Add <code>PSU_MAX_CURRENT=5000</code> at the end of the file that reads like this:
+</pre>
+Set <code>POWER_OFF_ON_HALT</code> to <code>0</code> or <code>1</code> like this:
 [[File:X1012-setting.png|700px]]
+<code>1</code>: disable 5v outputs
+<code>0</code>: enable 5v outputs
 Press '''Ctrl-O''', then enter, to write the change to the file.
@@ Line 40: / Line 98: @@
 '''Reboot''' your Raspberry Pi 5 to make the change take effect.
-'''Note:''' If you are using other OS like Ubuntu, please flash '''Raspberry Pi OS''' first, and then re-flash other OS such as Ubuntu etc after completing the above settings.
-If you are using '''USB peripherals''' that need to be powered from the RPi5's USB port, '''don't forget''' to enable the following settings to ensure that the RPi5's USB port's current output is not limited:
-Add <code>usb_max_current_enable=1</code> in the <code>/boot/firmware/config.txt</code> file.
 </div>
 </div>
@@ Line 52: / Line 103: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: How to disable '''auto power on''' feature on [[X1200]]?
+Q4: How to disable '''auto power on''' feature on [[X1200]]?
 </div>
 <div class="mw-collapsible-content">
@@ Line 71: / Line 122: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: How to disable '''auto power on''' feature on [[X1201]]?
+Q5: How to disable '''auto power on''' feature on [[X1201]]?
 </div>
 <div class="mw-collapsible-content">
@@ Line 90: / Line 141: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: How to disable '''auto power on''' feature on [[X1202]]?
+Q6: How to disable '''auto power on''' feature on [[X1202]]?
 </div>
 <div class="mw-collapsible-content">
@@ Line 109: / Line 160: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: How to disable '''auto power on''' feature on [[X1203]]?
+Q7: How to disable '''auto power on''' feature on [[X1203]]?
 </div>
 <div class="mw-collapsible-content">
@@ Line 128: / Line 179: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: Why is the RPi5 LED still on and red after the UPS is turned off?
+Q8: Why is the RPi5 LED still on and red after the UPS is turned off?
 </div>
 <div class="mw-collapsible-content">
@@ Line 150: / Line 201: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: What battery is recommended for this ups shield
+Q9: What battery is recommended for this UPS shield?
 </div>
 <div class="mw-collapsible-content">
@@ Line 159: / Line 210: @@
 If using a lithium battery, the required voltage is 3.7V;
-if using a battery pack, please make sure it is a parallel battery pack.
+If using a battery pack or battery holder, please make sure it is a parallel battery pack. '''Please use a high-quality battery holder with thick and durable connection cables. Using a low-quality battery holder with thin or poorly connected wires may cause the X1203 to malfunction or fail to operate as expected.'''
 There are 2 XH2.54-2P battery connectors on board, it is recommended to use the same type of battery.
@@ Line 169: / Line 221: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q: Run <code>sudo i2cdetect -y 1</code>, can't find I2C address 0x36?
+Q10: Run <code>sudo i2cdetect -y 1</code>, can't find I2C address 0x36?
 </div>
 <div class="mw-collapsible-content">
@@ Line 188: / Line 240: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q. How do you disable the X1202 auto-shutdown when you use it standalone (not installed on a RPi5)?
+Q11. How do you disable the X1202 auto-shutdown when you use it standalone (not installed on a RPi5)?
 </div>
 <div class="mw-collapsible-content">
@@ Line 198: / Line 250: @@
 <div class="toccolours mw-collapsible mw-collapsed">
 <div style="font-weight:bold;line-height:1.0;">
-Q. X1203 UPS voltage drops / low voltage warning appears?
+Q12. X1203 UPS voltage drops / low voltage warning appears?
 </div>
 <div class="mw-collapsible-content">
@@ Line 208: / Line 260: @@
 [[File:Test pad on the Pi's PCB.png|800px]]
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+Q13. Documentation about the I2C registers：
+</div>
+<div class="mw-collapsible-content">
+A:
+[https://www.analog.com/media/en/technical-documentation/data-sheets/MAX17040-MAX17041.pdf MAX17040G+]
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+Q14. Why does the RPI 5 lose power within a few seconds after pressing the power button on the X120x UPS?
+</div>
+<div class="mw-collapsible-content">
+A:
+'''Please note: If the UPS does not detect the RPi5, it will automatically shut down within 3 seconds. So you need to install the RPi 5 on the UPS and make sure that the RPi5 has good contact with the UPS's pogo pins.'''
+</div>
+</div>
+<div class="toccolours mw-collapsible mw-collapsed">
+<div style="font-weight:bold;line-height:1.0;">
+Q15. Which product should I choose if I can’t connect to a Raspberry Pi via pogo pins?
+</div>
+<div class="mw-collapsible-content">
+A:
+For the X12-UPS series, we recommend the '''[[X1206]]''' – models from X1200 to X1205 do not support this usage. The X120- UPS series auto-powers off when no Raspberry Pi 5 is detected, while the X1206 can be set to "Always Power On" mode and keeps working even if the Raspberry Pi is shut down. Please refer to <span style="color:red">'''Interface ⑩_ALON'''</span> in the picture.
+[[File:X1206-IMG-7240-Interface-New.jpg|800px]]
+You can also consider the '''[[X-UPS1]]'''. It features a GPIO Pin-Connected standalone design with high flexibility for installation and adaptation (refer to the picture).
+[[File:X-UPS1-IMG-5409.jpg|800px]]
 </div>
 </div>