功能简介

特性	UPS电源
'	无特性，不解释
'	无特性，不解释
'	无特性，不解释
'	无特性，不解释
接口		I2C

说明

产品简介

Pico-UPS-B 是专为 Raspberry Pi Pico 设计的不间断电源 (UPS) 扩展板，板载带路径管理的开关型锂电池充电芯片和电压电流监测芯片，可通过 I2C 接口监测电池工作状态，支持叠加使用。

产品特性

板载 Raspberry Pi Pico 接口，适用于 Raspberry Pi Pico 系列主板
板载锂电池充电芯片，支持动态路径管理，供电更稳定
可通过 I2C 接口通信，测量电池电压、电流、功率和剩余电量等参数，实时检测模块工作状态
板载电池保护电路，防过充、防过放、防过流、防短路和防反接，均衡充电，工作稳定更安全
板载充电指示灯，电源指示灯，电池反接警示灯，方便查看电池是否接反
提供完善的配套资料手册 (Raspberry Pi Pico C/C++ 和 MicroPython 等示例程序)

产品参数

电气	参数
工作电压	5V
控制接口	I2C
电池规格	600mAh 3.7V聚合物锂电池
产品尺寸	62 × 21mm

引脚分布

产品尺寸

锂电池使用注意事项

锂聚合物和锂离子电池很不稳定。如果充电或使用不当，可能会导致火灾，人身伤害和财产损失。
对电池组充电和放电时，切勿极性连接错误。请勿选用其他劣质的充电器或充电板对锂电池进行充电。
如需另购锂电池产品，须确保电池参数与锂电池扩展板兼容，推荐选择正规的电池厂家，并需要自行老化测试确保锂电池能够稳定安全工作。
锂电池具有循环寿命，请在达到使用寿命时，用新电池更换旧电池。
请妥善放置电池类产品，远离易燃易爆类物品，远离儿童，避免因保管不慎，引发安全事故。

使用

硬件连接

环境设置

1. 树莓派环境设置请点击查阅链接
2. Windows环境设置请点击查阅链接

树莓派

1. 使用SSH登陆树莓派终端或使用屏幕时同时按下Ctrl+Alt+T打开终端
2. 下载解压程序到Pico C/C++ SDK目录下,还未安装SDK用户参考教程

#注意自己目录,SDK安装教程默认安装目录为~/pico/,如若用户自定义其它目录,自行更改
wget -P ~/pico https://www.waveshare.net/w/upload/9/92/Pico-UPS-A.zip
cd ~/pico
unzip Pico-UPS-A.zip

c

1. 按住Pico/Pico2的BOOTSEL使用MicroUSB线缆连接Pico/Pico2到树莓派的USB后松开
2. 编译运行Pico-UPS-A的c示例程序

cd ~/pico/Pico-UPS-A/c/build/
 
#Pico
cmake -DPICO_BOARD=pico -DPICO_PLATFORM=rp2040 ..
#Pico2
cmake -DPICO_BOARD=pico2 -DPICO_PLATFORM=rp2350 ..

make
sudo mount /dev/sda1 /mnt && sudo cp Pico_UPS.uf2 /mnt && sudo sync && sudo umount /mnt && sleep 2 && sudo minicom -b 115200 -o -D /dev/ttyACM0

3. Pico/Pico2运行,树莓派终端打开了minicom显示传感器信息,退出按Ctrl+A再按Q按Enter

python

1. 按照python环境配置设置,使用树莓派桌面系统
2. 打开树莓派系统的Thonny IDE,将代码文件拉进IDE,保存到Pico/Pico2文件系统里面,如图所示

3. 点击运行按钮执行python程序,如图所示

Windows

1. 下载解压示例程序到Windows桌面,参考Windows软件环境设置
2. 按住Pico/Pico2的BOOTSEL键,用MicroUSB线缆连接Pico/Pico2的USB到PC,将c或python程序导入Pico/Pico2使其运行
3. 使用串口查看Pico/Pico2的USB枚举的虚拟串口查看打印信息,注意打开DTR,波特率为115200,如图所示

资料

配套资料

文档

程序

示例程序

Pico快速上手

固件下载

MicroPython固件下载

C_Blink固件下载

基础介绍

Raspberry Pi Pico的基础介绍

MicroPython系列

安装Thonny IDE

为了方便在电脑上使用MicroPython开发Pico/Pico2板，建议下载Thonny IDE

下载Thonny IDE并按照步骤安装，安装包均为Windows版本，其他版本请参考Thonny官网
安装完成之后，第一次要配置语言和主板环境，由于我们是为了使用Pico/Pico2，所以注意主板环境选择Raspberry Pi 选项

配置Micrpython环境及选择Pico/Pico2端口
- 先将Pico/Pico2接入电脑，左键点击Thonny右下角的配置环境选项--》选择configture interpreter
- 在弹出的窗口栏中选择MicroPython(Raspberry Pi Pico),同时选择对应的端口

烧录固件

点击ok后返回到Thonny主界面，下载对应的固件库并烧录到设备中，然后点击停止按钮，在Shell窗口中即可显示当前使用到的环境
注意：烧录Micropython官方提供的Pico2固件可能导致无法识别设备，请使用下方或程序包中的固件
- Pico固件库
- Pico2固件库
Pico/Pico2在windows下载固件库方法: 按住BOOT键后连接电脑后，松开BOOT键，电脑会出现一个可移动磁盘，将固件库复制进去即可
RP2040/RP2350在windows下载固件库方法: 连接电脑后，同时按下BOOT键跟RESET键,先松开RESET键再松开BOOT键，电脑会出现一个可移动磁盘，将固件库复制进去即可（用Pico/Pico2的方式也可以）

讲解视频

【MicroPython】machine.Pin类函数详解
 【MicroPython】machine.PWM类函数详解
 【MicroPython】machine.ADC类函数详解
 【MicroPython】machine.UART类函数详解
 【MicroPython】machine.I2C类函数详解
 【MicroPython】machine.SPI类函数详解
 【MicroPython】rp2.StateMachine类函数详解

C/C++系列

对于 C/C++，建议使用 Pico VSCode 进行开发，这是一款 Microsoft Visual Studio Code 扩展，旨在让您在为 Raspberry Pi Pico 系列开发板创建、开发和调试项目时更加轻松。无论您是初学者还是经验丰富的专业人士，此工具都可以帮助您自信而轻松地进行 Pico 开发。下面我们介绍如何安装该扩展并使用。

官网教程：https://www.raspberrypi.com/news/pico-vscode-extension/
本教程适用于树莓派Pico、Pico2与本公司开发的RP2040、RP2350系列开发板
开发环境默认以 Windows11 为例，其他环境请参考官网教程进行安装

安装VSCode

首先，点击下载 pico-vscode 程序包，解压并打开程序包，双击安装 VSCode

注意：如果已安装 vscode 注意检查版本是否为 v1.87.0 或更高版本

安装扩展

点击扩展，选择从 VSIX 安装
选择 vsix 后缀的软件包，点击安装
随后 vscode 会自动安装 raspberry-pi-pico 及其依赖扩展，可以点击刷新查看安装进度
右下角显示完成安装，关闭 vscode

配置扩展

打开目录 C:\Users\用户名，将整个 .pico-sdk 拷贝至该目录
拷贝完成

打开 vscode，对 Raspberry Pi Pico 扩展中各个路径进行配置

配置如下：

Cmake Path：
${HOME}/.pico-sdk/cmake/v3.28.6/bin/cmake.exe

Git Path:
${HOME}/.pico-sdk/git/cmd/git.exe    

Ninja Path:
${HOME}/.pico-sdk/ninja/v1.12.1/ninja.exe

Python3 Path:
${HOME}/.pico-sdk/python/3.12.1/python.exe

新建工程

配置完成，测试新建工程，输入工程名、选择路径后点击 Creat 创建工程
测试官方示例，可以点击工程名旁的 Example 进行选择
创建工程成功

编译工程

选择SDK版本
选择 Yes 进行高级配置
选择交叉编译链，13.2.Rel1 适用 ARM 核，RISCV.13.3 适用 RISCV 核，这里根据您的需求任意选择其中一个即可
CMake 版本选择 Default（前面配置的路径）
Ninja 版本选择 Default
选择开发板
点击 Complie 进行编译
成功编译出 uf2 格式文件即可

导入工程

选择工程目录，导入工程
导入工程的 Cmake 文件不能有中文（包括注释），否则可能导致导入失败
导入自己的工程需要在 Cmake 文件中加一行代码，才能正常切换 pico 和 pico2，否则即使选择 pico2，编译得到的固件仍是适用于 pico 的
```
set(PICO_BOARD pico CACHE STRING "Board type")
```

更新扩展

离线包中的扩展版本为0.15.2，安装完成后，您也可以选择更新至最新版本

Arduino IDE 系列

安装Arduino IDE

首先到Arduino官网下载Arduino IDE的安装包。
这里选择仅下载就可以了。
下载完成后，点击安装。

注意：安装过程中会提示你安装驱动，我们点击安装即可

Arduino IDE中文界面

第一次安装完成后，打开Arduino IDE全是英文界面,我们可以在File>Preferences切换成简体中文。
在Language里面选择简体中文，点击OK。

在Arduino IDE中安装Arduino-Pico Core

打开Arduino IDE，点击左上角的文件，选择首选项
在附加开发板管理器网址中添加如下链接，然后点击OK
该链接已包含RP2040、RP2350等版型，最新版型文件请访问arduino-pico获取
```
https://github.com/earlephilhower/arduino-pico/releases/download/4.5.2/package_rp2040_index.json
```
注意：如果您已经有ESP32板URL，您可以使用逗号分隔 URL，如下所示：
```
https://dl.espressif.com/dl/package_esp32_index.json,https://github.com/earlephilhower/arduino-pico/releases/download/4.5.2/package_rp2040_index.json
```
点击工具>开发板>开发板管理器>搜索pico，由于我的电脑已经安装过了，所以显示已安装