adafruit-circuitpython-ds1307 2.0.0

简介

这是一个伟大的电池支持的实时时钟（RTC），允许您 微控制器项目，即使重新编程也能跟踪时间， 或者如果失去了动力。非常适合数据记录、时钟构建， 时间戳、计时器和警报器等。DS1307是最受欢迎的 RTC-但它需要5伏电源才能工作。

DS1307是简单而廉价的，但不是一个高精度的设备。它可能 每天损失或增加最多两秒。高精度、高温度 补偿方案，请查看 DS3231 precision RTC。 如果您不需要DS1307，或者您需要一个3.3V电源/逻辑能力的RTC 请查看我们的平价 PCF8523 RTC breakout。

依赖关系

此驱动程序取决于：

• Adafruit CircuitPython
• Bus Device
• Register

请确保circuitpython文件系统上的所有依赖项都可用。 这很容易通过下载来实现 the Adafruit library and driver bundle。

使用说明

当然，您必须导入库才能使用它：

importbusioimportadafruit_ds1307importtime

所有的adafruit rtc库都采用一个实例化的活动i2c对象 （来自busio库）作为其构造函数的参数。通往 创建I2C对象取决于您正在使用的板。带标签的电路板 SCL和SDA引脚，您可以：

fromboardimport*

您还可以通过 microcontroller.pin模块。

现在，初始化I2C总线：

myI2C=busio.I2C(SCL,SDA)

一旦创建了I2C接口对象，就可以使用它来实例化 rtc对象：

rtc=adafruit_ds1307.DS1307(myI2C)

要设置时间，需要将datetime设置为time.struct\u time对象：

rtc.datetime=time.struct_time((2017,1,9,15,6,0,0,9,-1))

在设置了rtc之后，您可以通过读取^{tt4}来检索时间。$ 属性并访问结构时间的标准属性，如tm_year， tm_hour和tm_min。

t=rtc.datetimeprint(t)print(t.tm_hour,t.tm_min)

贡献

欢迎投稿！请阅读我们的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-ds1307 --library_location .

python3 -m venv .env
source .env/bin/activate
pip install Sphinx sphinx-rtd-theme

cd docs
sphinx-build -E -W -b html . _build/html