Pico-Clock-Green

来自Waveshare Wiki
跳转至: 导航搜索
{{{name2}}}
{{{name3}}}
功能简介
特性 单色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 (保持数据和时钟信息)

产品尺寸

Pico-clock-PCB.jpg

环境设置

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

相关资料参考:Raspberry Pi Pico C/C++ SDK 官方搭建手册(英文)

示例使用

树莓派

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文件

Pico-Clock-Green002.png
Pico-Clock-Green003.png

示例程序功能说明

  • 时间显示界面 时间显示界面下可以显示星期、小时、分钟,支持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及对应的端口

Pico-clock-green 14.png

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

Pico-clock-green 02.png

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

Pico-clock-green 03.png

  • 7.点击pico文件的main.py进行运行,如下图所示:

Pico-clock-green 04.png

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

Pico-clock-green 05.jpg

示例程序功能说明

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

功能使用说明

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

Pico-clock-green 06.jpg Pico-clock-green 07.jpg Pico-clock-green 09.jpg

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

Pico-clock-green 08.jpg

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

Pico-clock-green 12.jpgPico-clock-green 13.jpg

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

Pico-clock-green 05.jpgPico-clock-green 10.jpg

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

Pico-clock-green 11.jpg

Pico快速上手

固件下载

MicroPython固件下载
Pico MicroPython.gif
C_Blink固件下载
Pico Blink.gif
教程名3
列表3
教程名4
列表4
教程名5
列表5
教程名6
列表6
教程名7
列表7
教程名8
列表8

文字教程

基础介绍

Raspberry Pi Pico的基础介绍

MicroPython系列

安装Thonny IDE

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

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

Pico-R3-Tonny1.png

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

Raspberry-Pi-Pico-Basic-Kit-M-2.png
Raspberry-Pi-Pico-Basic-Kit-M-3.png

  • 点击ok后返回到Thonny主界面,下载对应的固件库并烧录到设备中,然后点击停止按钮,在Shell窗口中即可显示当前使用到的环境
  • Pico/Pico2在windows下载固件库方法: 按住BOOT键后连接电脑后,松开BOOT键,电脑会出现一个可移动磁盘,将固件库复制进去即可
  • RP2040/RP2350在windows下载固件库方法: 连接电脑后,同时按下BOOT键跟RESET键,先松开RESET键再松开BOOT键,电脑会出现一个可移动磁盘,将固件库复制进去即可(用Pico/Pico2的方式也可以)

Raspberry-Pi-Pico2-Python.png

讲解视频

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

安装VSCode

  1. 首先,点击下载 pico-vscode 程序包,解压并打开程序包,双击安装 VSCode
    Pico-vscode-1.JPG
    注意:如果已安装 vscode 注意检查版本是否为 v1.87.0 或更高版本
    Pico-vscode-2.JPG
    Pico-vscode-3.JPG

安装扩展

  1. 点击扩展,选择从 VSIX 安装
    Pico-vscode-4.JPG
  2. 选择 vsix 后缀的软件包,点击安装
    Pico-vscode-5.JPG
  3. 随后 vscode 会自动安装 raspberry-pi-pico 及其依赖扩展,可以点击刷新查看安装进度
    Pico-vscode-6.JPG
  4. 右下角显示完成安装,关闭 vscode
    Pico-vscode-7.JPG

配置扩展

  1. 打开目录 C:\Users\用户名,将整个 .pico-sdk 拷贝至该目录
    Pico-vscode-8.JPG
  2. 拷贝完成
    Pico-vscode-9.JPG
  3. 打开 vscode,对 Raspberry Pi Pico 扩展中各个路径进行配置
    Pico-vscode-10.JPG
    配置如下:
    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             
    

新建工程

  1. 配置完成,测试新建工程,输入工程名、选择路径后点击 Creat 创建工程
    测试官方示例,可以点击工程名旁的 Example 进行选择
    Pico-vscode-11.JPG
  2. 创建工程成功
    Pico-vscode-12.JPG
  3. 选择SDK版本
    Pico-vscode-13.JPG
  4. 选择 Yes 进行高级配置
    Pico-vscode-14.JPG
  5. 选择交叉编译链,13.2.Rel1 适用 ARM 核,RISCV.13.3 适用 RISCV 核,这里根据您的需求任意选择其中一个即可
    Pico-vscode-15.JPG
  6. CMake 版本选择 Default(前面配置的路径)
    Pico-vscode-16.JPG
  7. Ninja 版本选择 Default
    Pico-vscode-17.JPG
  8. 选择开发板
    Pico-vscode-18.JPG
  9. 点击 Complie 进行编译
    Pico-vscode-19.JPG
  10. 成功编译出 uf2 格式文件即可
    Pico-vscode-20.JPG

导入工程

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

更新扩展

  1. 离线包中的扩展版本为0.15.2,安装完成后,您也可以选择更新至最新版本
    Pico-vscode-22.JPG

Arduino IDE 系列

安装Arduino IDE

  1. 首先到Arduino官网下载Arduino IDE的安装包。
    Arduino下载2.0版本.jpg
  2. 这里选择仅下载就可以了。
    仅下载不捐赠.png
  3. 下载完成后,点击安装。
    IDE安装水印-1.gif
    注意:安装过程中会提示你安装驱动,我们点击安装即可
    Arduino驱动安装水印.jpg

Arduino IDE中文界面

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

在Arduino IDE中安装Arduino-Pico Core

  1. 打开Arduino IDE,点击左上角的文件,选择首选项
    首选项水印-1.png
  2. 在附加开发板管理器网址中添加如下链接,然后点击OK
    https://github.com/earlephilhower/arduino-pico/releases/download/4.0.2/package_rp2040_index.json

    Pico首选项.png
    注意:如果您已经有ESP32板URL,您可以使用逗号分隔 URL,如下所示:

    https://dl.espressif.com/dl/package_esp32_index.json,https://github.com/earlephilhower/arduino-pico/releases/download/4.0.2/package_rp2040_index.json
  3. 点击工具>开发板>开发板管理器>搜索pico,由于我的电脑已经安装过了,所以显示已安装
    开发板管理器.png
    开发板管理器-1.png
国内用户
  • 因为网络原因,国内用户连接github并不稳定,我们另外提供了一份安装包,可以跳过在线的过程
  • 若已经成功配置了pico环境,可以直接跳过本章
  1. 下载rp2040压缩包,将解压的rp2040文件夹复制到如下路径下
    C:\Users\[username]\AppData\Local\Arduino15\packages

    Rp2040包.png
    注意:将里面用户名:[username]替换成自己的用户名

第一次上传程序

  1. 按住Pico板上的BOOTSET按键,将pico通过Micro USB线接到电脑的USB接口,待电脑识别出一个可移动硬盘(RPI-RP2)后,松开按键。
    Pico连接数据线.gif
  2. 下载程序,打开arduino\PWM\D1-LED路径下的D1-LED.ino
  3. 点击工具>端口,记住已有的COM,不需要点击这个COM(不同电脑显示的COM不一样,记住自己电脑上已有的COM)
    Pico连接前端口.png
  4. 用USB线将驱动板和计算机连接起来,再点击工具>端口,第一次连接选择uf2 Board,上传完成后,再次连接就会多出一个COM口
    Pico连接后uf2.png
  5. 点击工具>开发板>Raspberry Pi Pico/RP2040>Raspberry Pi Pico
    工具pico开发板.png
    Arduono-Raspberrypi pico.png
  6. 设置完成后,点击向右箭头上传将程序
    Pico上传程序.png
  • 如果期间遇到了问题,需要重新安装或者更换Arduino IDE版本时,卸载Arduino IDE需要卸载干净,卸载软件后需要手动删除C:\Users\[name]\AppData\Local\Arduino15这个文件夹内的所有内容(需要显示隐藏文件才能看到) 再重新安装

开源例程

MircoPython视频例程(github)
MicroPython固件/Blink例程(C)
树莓派官方C/C++示例程序 (github)
树莓派官方micropython示例程序 (github)
Arduino官方C/C++示例程序 (github)


FAQ


技术支持


联系人:林工
EMAIL:3005425717@qq.com
电话:0755-83043099
QQ:3005425717
微信:扫下方二维码添加
Lzr.png

说明:进行售后服务前,请准备好客户信息(定货单位、定货人等),以供验证