PCF8563实时时钟的CircuitPython库。
项目描述
Adafruit的PCF8563实时时钟（RTC）库简介
这是一个优秀的电池备份实时时钟（RTC），可以让您的微控制器项目在重新编程或断电的情况下仍能跟踪时间。非常适合数据记录、时钟构建、时间戳、定时器和闹钟等。
PCF8563简单且价格低廉，但不是高精度设备。它可能每天会丢失或获得数秒。如果您需要高精度、温度补偿的替代品，请查看DS3231精确RTC。 如果您需要DS1307进行兼容性原因，请查看我们的DS1307 RTC分线板。
依赖关系
此驱动程序依赖于Register和Bus Device库。请确保它们也存在于CircuitPython文件系统中。这可以通过下载一个库和驱动程序包轻松实现。
从PyPI安装
在支持GNU/Linux系统（如树莓派）上，您可以从PyPI本地安装驱动程序。安装到当前用户
pip3 install adafruit-circuitpython-pcf8563全局安装（在某些情况下可能需要）
sudo pip3 install adafruit-circuitpython-pcf8563在当前项目的虚拟环境中安装
mkdir project-name && cd project-name
python3 -m venv .venv
source .venv/bin/activate
pip3 install adafruit-circuitpython-pcf8563使用说明
基础
当然，您必须导入库才能使用它
import busio
from adafruit_pcf8563.pcf8563 import PCF8563
import time所有Adafruit RTC库都将实例化和活跃的I2C对象（来自busio库）作为构造函数的参数。创建I2C对象的方式取决于您使用的板。对于带有标有SCL和SDA引脚的板，您可以
from board import *现在，初始化I2C总线
i2c_bus = board.I2C()一旦创建了I2C接口对象，您就可以使用它来实例化RTC对象
rtc = PCF8563(i2c_bus)日期和时间
要设置时间，您需要将datetime设置为一个time.struct_time对象
rtc.datetime = time.struct_time((2017,1,9,15,6,0,0,9,-1))设置RTC后，您可以通过读取datetime属性来检索时间，并访问struct_time的标准属性，如tm_year、tm_hour和tm_min。
t = rtc.datetime
print(t)
print(t.tm_hour, t.tm_min)闹钟
要设置时间，您需要将alarm设置为一个包含time.struct_time对象和表示频率的字符串（如“hourly”）的元组
rtc.alarm = (time.struct_time((2017,1,9,15,6,0,0,9,-1)), "daily")设置RTC后，您可以通过读取alarm_status属性来检索闹钟状态。一旦为True，将其设置回False以重置。
if rtc.alarm_status:
print("wake up!")
rtc.alarm_status = False文档
此库的API文档可以在Read the Docs上找到。
有关构建库文档的信息，请参阅本指南。
贡献
欢迎贡献！在贡献之前，请阅读我们的行为准则，以帮助本项目保持友好。
哈希值 for adafruit_circuitpython_pcf8563-2.0.2-py3-none-any.whl
| 算法 | 哈希摘要 | |
|---|---|---|
| SHA256 | 933cf2303b63e5b3e02f90bfb37841660bd25f525818b0579e535aad5469f3a7 |
|
| MD5 | 16d23013f4aac21ed52208607604b511 |
|
| BLAKE2b-256 | 5409eec0ce101a673f9c5ca36652ad6ff09cbb89fb474bee772d09610b7f9317 |
