1.. _waveshare_pico_ups_b_shield:
2
3Waveshare Pico UPS-B shield
4###########################
5
6Overview
7********
8
9The Waveshare Pico UPS-B shield is an uninterruptible Power supply (UPS)
10module designed for the Raspberry Pi Pico which uses the Texas Instruments' INA219
11current/power Monitor. It communicates with the Raspberry Pi Pico over I2C
12
13.. figure:: waveshare_pico_ups_b.jpg
14   :align: center
15   :alt: Waveshare Pico UPS-B shield
16
17   Waveshare Pico UPS-B shield
18
19Hardware
20--------
21
22- INA219
23
24        - Senses bus voltages from 0 to 26 V
25        - Reports current, voltage and power
26        - 16 Programmable Addresses
27        - SOT23-8 and SOIC-8 packages
28        - Calibration registers
29
30- ETA6003
31
32        - Switching charger with power path management
33        - Up to 95% DC-DC efficiency
34        - 0mΩ power path MOSFET
35        - Up to 2.5A max charging current
36
37- Connectivity
38
39        - Raspberry Pi Pico compatible (I2C)
40        - 2 pin jst header for Li-po battery
41
42-------+-----------------------+---------------------------+
43| Name  | Function              | Usage                     |
44+=======+=======================+===========================+
45| GP0   | None                  |                           |
46+-------+-----------------------+---------------------------+
47| GP1   | None                  |                           |
48+-------+-----------------------+---------------------------+
49| GP2   | None                  |                           |
50+-------+-----------------------+---------------------------+
51| GP3   | None                  |                           |
52+-------+-----------------------+---------------------------+
53| GP4   | None                  |                           |
54+-------+-----------------------+---------------------------+
55| GP5   | None                  |                           |
56+-------+-----------------------+---------------------------+
57| GP6   | I2C1_SDA ACTIVE_LOW   | INA219                    |
58+-------+-----------------------+---------------------------+
59| GP7   | I2C1_SCL ACTIVE_LOW   | INA219                    |
60+-------+-----------------------+---------------------------+
61| GP8   | None                  |                           |
62+-------+-----------------------+---------------------------+
63| GP9   | None                  |                           |
64+-------+-----------------------+---------------------------+
65| GP10  | None                  |                           |
66+-------+-----------------------+---------------------------+
67| GP11  | None                  |                           |
68+-------+-----------------------+---------------------------+
69| GP12  | None                  |                           |
70+-------+-----------------------+---------------------------+
71| GP13  | None                  |                           |
72+-------+-----------------------+---------------------------+
73| GP14  | None                  |                           |
74+-------+-----------------------+---------------------------+
75| GP15  | None                  |                           |
76+-------+-----------------------+---------------------------+
77| GP16  | None                  |                           |
78+-------+-----------------------+---------------------------+
79| GP17  | None                  |                           |
80+-------+-----------------------+---------------------------+
81| GP18  | None                  |                           |
82+-------+-----------------------+---------------------------+
83| GP19  | None                  |                           |
84+-------+-----------------------+---------------------------+
85| GP20  | None                  |                           |
86+-------+-----------------------+---------------------------+
87| GP21  | None                  |                           |
88+-------+-----------------------+---------------------------+
89| GP22  | None                  |                           |
90+-------+-----------------------+---------------------------+
91| GP23  | None                  |                           |
92+-------+-----------------------+---------------------------+
93| GP24  | None                  |                           |
94+-------+-----------------------+---------------------------+
95| GP25  | None                  |                           |
96+-------+-----------------------+---------------------------+
97| GP26  | None                  |                           |
98+-------+-----------------------+---------------------------+
99| GP27  | None                  |                           |
100+-------+-----------------------+---------------------------+
101| GP28  | None                  |                           |
102+-------+-----------------------+---------------------------+
103
104
105- Power Supply
106
107        - 3.3V ~ 5V
108
109- Components
110
111        - Power switch
112        - Power LED
113        - Charging LED
114
115For more information about the Waveshare Pico UPS-B:
116
117- `Waveshare Pico UPS website`_
118- `INA219 data sheet`_
119- `ETA6003 data sheet`_
120
121Programming
122***********
123
124Set ``--shield waveshare_pico_ups_b`` when you invoke ``west build`` or ``cmake`` in your Zephyr application. For
125example:
126
127.. zephyr-app-commands::
128   :zephyr-app: samples/sensor/ina219
129   :tool: all
130   :board: rpi_pico
131   :shield: waveshare_pico_ups_b
132   :goals: build flash
133
134.. _Waveshare Pico UPS website:
135   https://www.waveshare.com/wiki/Pico-UPS-B
136
137.. _INA219 data sheet:
138   https://www.ti.com/lit/ds/symlink/ina219.pdf
139
140.. _ETA6003 data sheet:
141   https://www.waveshare.com/w/upload/3/3f/ETA6003.pdf
142