pcf8523实时时钟的circuitpython库。
adafruit-circuitpython-pcf8523的Python项目详细描述
Adafruit的PCF8523实时时钟（RTC）库简介
这是一个伟大的电池支持的实时时钟（RTC），允许您 微控制器项目，即使重新编程也能跟踪时间， 或者如果失去了动力。非常适合数据记录、时钟构建、时间 配有PCF8523 RTC的冲压、计时器和报警器等-它可以 使用3.3V或5V电源和逻辑！
PCF8523是一种简单、廉价但不高精度的设备。 它可能会损失或增加高达两秒一天。为了达到高精度， 温度补偿方案，请检查 DS3231 precision RTC. 如果出于兼容性原因需要DS1307，请查看 DS1307 RTC breakout。
依赖关系
这个驱动程序依赖于Register 和Bus Device 图书馆。请确保在circuitpython文件系统上也可以使用它们。 这很容易通过下载来实现 a library and driver bundle。
从PyPI安装
在支持的gnu/linux系统（如raspberry pi）上，可以在本地安装驱动程序from PyPI。要为当前用户安装：
pip3 install adafruit-circuitpython-pcf8523
要在系统范围内安装（在某些情况下这可能是必需的）：
sudo pip3 install adafruit-circuitpython-pcf8523
要在当前项目的虚拟环境中安装，请执行以下操作：
mkdir project-name &&cd project-name python3 -m venv .env source .env/bin/activate pip3 install adafruit-circuitpython-pcf8523
使用说明
基础知识
当然，您必须导入库才能使用它：
importbusioimportadafruit_pcf8523importtime
所有的adafruit rtc库都采用一个实例化的活动i2c对象 （来自busio库）作为其构造函数的参数。通往 创建I2C对象取决于您正在使用的板。带标签的电路板 SCL和SDA引脚，您可以：
fromboardimport*
您也可以通过 微控制器。引脚模块。
现在，初始化I2C总线：
i2c_bus=busio.I2C(SCL,SDA)
一旦创建了I2C接口对象，就可以使用它来实例化 rtc对象：
rtc=adafruit_pcf8523.PCF8523(i2c_bus)
日期和时间
要设置时间，需要将datetime`设置为time.struct\u time对象：
rtc.datetime=time.struct_time((2017,1,9,15,6,0,0,9,-1))
设置rtc后，您可以通过读取日期时间来检索时间。 属性并访问结构时间的标准属性，如tm_year， tm_hour和tm_min
t=rtc.datetimeprint(t)print(t.tm_hour,t.tm_min)
警报
要设置时间，您需要将alarm设置为具有time.struct\u time的元组 表示频率的对象和字符串，例如“hourly”：
rtc.alarm=(time.struct_time((2017,1,9,15,6,0,0,9,-1)),"daily")
设置RTC后，通过读取 报警状态属性。一旦为真，请将其设置回false以重置。
ifrtc.alarm_status:print("wake up!")rtc.alarm_status=False
贡献
欢迎投稿！请阅读我们的Code of Conduct 在帮助这个项目保持热情之前。
本地建筑
压缩发布文件
要在本地构建此库，您需要安装 circuitpython-build-tools包。
python3 -m venv .env
source .env/bin/activate
pip install circuitpython-build-tools
安装后，请确保您处于虚拟环境中：
source .env/bin/activate
然后运行生成：
circuitpython-build-bundles --filename_prefix adafruit-circuitpython-pcf8523 --library_location .
斯芬克斯文件
sphinx用于根据代码中的rst文件和注释构建文档。第一， 安装依赖项（请随意重用上面的虚拟环境）：
python3 -m venv .env
source .env/bin/activate
pip install Sphinx sphinx-rtd-theme
现在，激活虚拟环境后：
cd docs
sphinx-build -E -W -b html . _build/html
这将把文档输出到docs/_build/html。在浏览器中打开index.html以 查看它们。它还将（由于-w）错误的任何警告，像特拉维斯将。这是个很好的方法 本地验证它将通过。
欢迎加入QQ群-->： 979659372
