> For the complete documentation index, see [llms.txt](https://man.bsdcn.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://man.bsdcn.org/man4/ds3231.4.md).

# ds3231(4)

`ds3231` — 极高精度 I2C 集成实时时钟（RTC）/TCXO/晶体

## 名称

`ds3231`

## 概要

`device iic device iicbus device ds3231`

## 描述

`ds3231` 是一种低成本、极高精度的 I2C 实时时钟（RTC），集成了温度补偿晶体振荡器（TCXO）和晶体。

该器件包含电池输入，当器件主电源中断时能维持精确计时。

通过 [sysctl(8)](/man8/sysctl.8.md) 接口访问 `ds3231` 数据：

```sh
dev.ds3231.0.%desc: Maxim DS3231 RTC
dev.ds3231.0.%driver: ds3231
dev.ds3231.0.%location: addr=0xd0
dev.ds3231.0.%pnpinfo: name=rtc compat=maxim,ds3231
dev.ds3231.0.%parent: iicbus1
dev.ds3231.0.temperature: 23.2C
dev.ds3231.0.temp_conv: 0
dev.ds3231.0.bbsqw: 0
dev.ds3231.0.sqw_freq: 8192
dev.ds3231.0.sqw_mode: interrupt
dev.ds3231.0.32khz_enable: 1
```

**`dev.ds3231.%d.temperature`** RTC 读取的当前温度的只读值。

**`dev.ds3231.%d.temp_conv`** 启动一次新的温度转换。读取为 1 时表示温度转换正在进行。读取为 0 然后设为 1 时，启动一次温度转换。温度转换在上电时自动运行，此后每 64 秒运行一次。

**`dev.ds3231.%d.bbsqw`** 若设为 1 且 `dev.ds3231.%d.sqw_mode` 设为 square-wave，则启用电池备份方波输出。若设为 0，当 RTC 由电池供电时，SQW 引脚将设为高阻态。

**`dev.ds3231.%d.sqw_freq`** 在 `dev.ds3231.%d.sqw_mode` 上启用方波输出时选择 SQW 引脚的频率。可设为 1、1024、4096 和 8192。

**`dev.ds3231.%d.sqw_mode`** 设置 SQW 引脚的工作模式。可设为'interrupt'（默认）或'square-wave'。在 interrupt 模式下，SQW 引脚用于为 RTC 闹钟生成中断。在 square-wave 模式下，SQW 引脚输出频率为 `dev.ds3231.%d.sqw_freq` 的方波。

**`dev.ds3231.%d.32khz_enable`** 启用 32kHz 输出。

更多详情请查阅 `ds3231` 数据手册。

在基于 [device.hints(5)](/man5/device.hints.5.md) 的系统（如 `MIPS`）上，这些值可为 `ds3231` 配置：

**`hint.ds3231.%d.at`** `ds3231` 所连接的 [iicbus(4)](/man4/iicbus.4.md)。

**`hint.ds3231.%d.addr`** `ds3231` 的 8 位 i2c 地址。`ds3231` 的默认 8 位地址为 0xd0。

在基于 FDT(4) 的系统上，必须设置以下属性：

**`compatible`** 必须始终设为"maxim,ds3231"。

**`reg`** `ds3231` 的 7 位 i2c 地址。`ds3231` 的默认 7 位地址为 0x68。

## 参见

[fdt(4)](/man4/fdt.4.md), [iic(4)](/man4/iic.4.md), [iicbus(4)](/man4/iicbus.4.md), [sysctl(8)](/man8/sysctl.8.md)

## 历史

`ds3231` 驱动首次出现于 FreeBSD 11.0。

## 作者

`ds3231` 驱动及本手册页由 Luiz Otavio O Souza <loos@FreeBSD.org> 编写。