功能简介

特性	单色LED
'	无特性，不解释
'	无特性，不解释
'	无特性，不解释
'	无特性，不解释
接口		I2C

说明

本产品有中文版和英文版，软硬件兼容。

使用前注意事项：接入Raspberry Pi Pico时，需要模块的顶针位置需要顶至Raspberry Pi Pico的TP3（D+）和TP2（D-）位置

产品简介

专门为Raspberry Pi Pico 设计的智能电子时钟扩展板，板载高精度DS3231 RTC时钟芯片，I2C通信接口，支持外接更多传感器。

产品特性

板载 Raspberry Pi Pico 接口，适用于Raspberry Pi Pico 系列主板并预留了40PIN接口，还将本产品的占用GP进行了区分，方便用户接入其他模块
采用顶针通信，为PICO提供外围编程接口，本产品使用Raspberry PICO 作为控制器，专门为Raspberry PICO 配置了顶针通信，在外围提供编程接口，方便用户调试。
- 板载高精度 DS3231 RTC 时钟芯片，并带备用电池座
- 可对年、月、周、日、时、分、秒进行计时，年计数可达 2100 年，具有闰年补偿功能
- 可选择 24 小时制或 12 小时制 (AM / PM格式)
- 两个可编程闹钟时钟
- 内部集成了一个非常精确的数字温度传感器，可通过I2C读取
板载两片SM16106 LED显示屏驱动芯片、一片SM5166PLED显示控制芯片，用于控制8 X 24矩阵LED的显示。
显示亮度自动调节，板载光敏传感器，开启自动亮度后会自动根据周围环境改变显示亮度
多功能状态指示栏，状态栏可以指示滚动打开、闹钟打开、倒计时、摄氏/华氏、正计时、整点报时、自动亮度、在显示12小时制时会开启上午/下午状态显示。
智能控制，三个键即可控制全部功能
提供完善的配套资料手册 (Raspberry Pi Pico C/C++ 示例程序)

产品参数

电气	参数
工作电压	3.3V ~ 5V
后备电池电压	2.3V ~ 5.5V
工作温度	-40°C ~ +85°C
功耗	100nA (保持数据和时钟信息)

产品尺寸

环境设置

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/a/ab/Pico-Clock-Green.zip 
cd  ~/pico  
unzip Pico-Clock-Green.zip

c

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

cd ~/pico/Pico-Clock-Green/build/
cmake ..
make
sudo mount /dev/sda1 /mnt/pico && sudo cp Pico-Clock-Green.uf2 /mnt/pico/ && sudo sync && sudo umount /mnt/pico && sleep 2

Windows

1. 下载解压示例程序到Windows桌面,参考Windows软件环境设置
2. 找到下载的程序下面的build文件下的Pico-Clock-Green.uf2文件，按住Pico的BOOTSEL键,用MicroUSB线缆连接Pico的USB到PC，将uf2文件拖进Pico
3. 代码调试，将下载的Pico-Clocd-Green文件夹复制到你的pico-examples文件目录下,好需要修改一下pico-example目录下的CMakelists.txt配置文件如下图所示，打开Visual Studio Code，打开你的pico-examples文件夹，选择Pico-Clock-Green，点击生成后可以在build文件夹下找到Pico-Clock-Green.uf2文件

示例程序功能说明

时间显示界面时间显示界面下可以显示星期、小时、分钟，支持12/24小时制式
状态栏状态栏可以指示滚动开关、闹钟开关、倒计时、温度（摄氏/华氏）、正计时、整点报时、自动亮度、在显示12小时制时会开启上午/下午状态显示
滚动显示滚动打开之后每隔三分钟滚动一次，滚动会显示年月日时分以及温度
温度显示滚动打开之后显示，可以选择摄氏度或者华氏度显示
闹钟设置闹钟均按周设置(设置好响闹时间，选择闹钟在星期几响闹即可)
按键声音可以打开或关闭按键声音，bp:ON 或 bp:OF
计时最长支持59分59秒计时，倒计时接上会响滴滴声
自动亮度打开自动亮度之后可以根据环境进行亮度调节

功能使用说明

按键说明自上到下一共三个按键，我们将其分别定义为设置/切换按键、上调按键、下调/退出按键，按键短按时长范围：<=300ms;按键长按时长范围 >300ms。
按键功能说明三个按键分别有长按和短按功能，设置/切换按键(短按为切换设置模式；长按进入闹钟设置)、上调键（短按切换状态;长按进入计时设置）、下调/退出键(短按切换状态；长按退出到时间显示状态)
设置/切换按键短按可进行普通模式设置的切换，选中可以改变状态时当前位置会进行闪烁【时间、按键声音开关（BP:ON 或 BP:OF）、滚动开关(DP:ON或 DP:OF )、时间显示模式(MD:1 12小时制或MD:2 24小时制)、整点报时开关(FT:ON 或 FT:OF)；长按设置模式切换按键则进入闹钟设置模式】
时间设置进入到普通设置模式下的年月日时分，选中时当前位置会进行闪烁，通过上调按键或者下调按键设置时间，当设置模式被切换/退出按键/无操作退出(10秒无任何操作)时当前位置的数值将会被写入到RTC，如果数值从未被改变则不会被重写，注意设置分钟时数值会秒钟会被清零
闹钟设置长按设置/切换按键则进入闹钟设置; A0/A1:ON/OF 短按上调或者下调按键选择哪个闹钟进行设置；短按设置/切换按键按键进入时分设置、接下来选择闹钟在星期几响闹(此时星期状态会跳至星期一下，通过上调按键/下调按键选择星期几)，再次短按设置/切换按键后设置闹钟成功。（响闹方式：蜂鸣器长响）
计时设置长按上调按键进入计时设置，通过上调/下调键选择TM.OF/UP/DN,OF:关闭/UP:正计时/DN:倒计时；之后切换设置模式，正计时：会进入计时状态，每3秒更新一次计时结果，再次按下设置模式切换按键时显示正计时结果，再按下设置模式切换按键会回到时间显示状态；倒计时：设置倒计时时间，设置好之后将会开始倒计时，计时结束之后自动将会触发蜂鸣器。
摄氏/华氏选择在时间显示状态下短按上调按键可以切换温度显示模式
自动亮度在时间显示状态下短按下调减号键可以打开或者关闭自动亮度

Micropython

1.按住Pico板上的BOOTSET按键，将pico通过Micro USB线接到电脑的USB接口，待电脑识别出一个可移动硬盘（RPI-RP2）后，松开按键。
2.将示例程序文件目录中rp2-pico-w-20230219-unstable-v1.19.1.uf2 文件复制到识别的可移动盘（RPI-RP2）中
3.打开Thonny IDE（注意：要使用最新版本的Thonny，否则是没有Pico的支持包的）
4.点击工具->设置->解释器，如图所示选择Pico及对应的端口

5.点击STOP按键，shell输出以下信息说明下载固件与连接成功，如下图所示：

6.文件->pico-clock-green-python-main->文件全选上传，等待上传成功，如下图所示：

7.点击pico文件的main.py进行运行，如下图所示：

8.成功运行后，将pico插在Pico-clock-green的正确位置上，显示如下图所示：

具体程序说明与最新更新可以关注github程序

示例程序功能说明

时间显示界面时间显示界面下可以显示星期、小时、分钟，支持12/24小时制式
状态栏状态栏可以倒计时、温度（摄氏/华氏）、自动亮度、在显示12小时制时会开启上午/下午状态显示
滚动显示短按滚动按键后开始滚动，滚动会显示时分以及温度
温度显示滚动打开之后显示，可以选择摄氏度或者华氏度显示
倒计时可设置倒计时时长，按下开始则开始倒计时
调节亮度短按调节键进行从高到低调节亮度
自动亮度打开自动亮度之后可以根据环境进行亮度调节

功能使用说明

按键说明自上到下一共三个按键，我们将其分别定义为设置/切换按键、上调按键/调温度按键、下调/调亮度按键，按键短按时长范围：<=500ms;按键长按时长范围 >500ms。
按键功能说明三个按键分别有长按和短按功能，设置/切换按键(短按为切换显示时间；长按进入切换模式)、上调键（短按开始滚动画面;长按切换摄氏度/华氏度）、下调/调亮度键(短按调节亮度与自动亮度)
设置/切换按键短按可显示当前时间【时、分、星期】，长按可进入切换模式（显示时间、设置时间、倒计时），通过上调键和下调键进行切换，设置键进行确认。

时间设置进入到时间设置模式下的年月日时分，选中时当前位置会进行闪烁，通过上调按键或者下调按键设置时间，当设按下确认键则跳至下个被设置的参数，全部设置好显示DONE后，数值将会被写入到RTC。

倒计时设置进入倒计时设置后，通过上调/下调键修改倒计时时间，设置好后按下确认键开始倒计时。

摄氏/华氏选择长按上调按键可以切换温度显示模式°C/°F

自动亮度短按下调键/调亮度按键进行修改亮度与自动亮度模式

资料

配套资料

文档

程序

示例程序

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，由于我的电脑已经安装过了，所以显示已安装