内核驱动 sht3x

支持的芯片

作者

描述

此驱动程序实现了对 Sensirion SHT3x-DIS 和 STS3x-DIS 系列湿度和温度传感器的支持。 温度以摄氏度为单位测量，相对湿度表示为百分比。 在 sysfs 接口中，所有值都按 1000 缩放，即 31.5 摄氏度的值为 31500。

该设备使用 I2C 协议进行通信。 根据接线方式，传感器可以具有 I2C 地址 0x44 或 0x45（对于 sts3x 为 0x4a 或 0x4b）。 有关实例化设备的方法，请参见如何实例化 I2C 设备。

即使 sht3x 传感器在单次模式下支持时钟延长（阻塞模式）和非延长（非阻塞模式），此驱动程序也仅支持后者。

sht3x 传感器支持单次模式以及 5 种周期性测量模式，可以使用 update_interval sysfs 接口进行控制。 允许的 update_interval（以毫秒为单位）如下

0

单次模式

2000

0.5 Hz

周期性测量

1000

1 Hz

周期性测量

500

2 Hz

周期性测量

250

4 Hz

周期性测量

100

10 Hz

周期性测量

在周期性测量模式下，传感器会自动以配置的更新间隔触发芯片上的测量。 当温度或湿度读数超过配置的限制时，警报属性设置为 1，并且传感器上的警报引脚设置为高电平。 当温度和湿度读数移回迟滞值之间时，警报位设置为 0，并且传感器上的警报引脚设置为低电平。

暴露给 debugfs 的序列号允许唯一标识传感器。 对于 sts32、sts33 和 sht33，制造商通过 API 提供校准证书。

sysfs 接口

temp1_input

温度输入

humidity1_input

湿度输入

temp1_max

最高温度值

temp1_max_hyst

最高限制的温度滞后值

humidity1_max

最高湿度值

humidity1_max_hyst

最高限制的湿度滞后值

temp1_min

最低温度值

temp1_min_hyst

最低限制的温度滞后值

humidity1_min

最低湿度值

humidity1_min_hyst

最低限制的湿度滞后值

temp1_alarm

如果温度超出配置的限制，则警报标志设置为 1。 警报仅在周期性测量模式下有效

humidity1_alarm

如果湿度超出配置的限制，则警报标志设置为 1。 警报仅在周期性测量模式下有效

heater_enable

加热器启用，加热元件从传感器中去除多余的湿度

  • 0: 关闭

  • 1: 开启

update_interval

更新间隔，单次拍摄为 0，周期性测量为毫秒间隔。 如果传感器不支持该间隔，则选择下一个更快的间隔

repeatability

写入或读取可重复性，更高的可重复性意味着更长的测量持续时间、更低的噪声水平和更大的能量消耗

  • 0: 低可重复性

  • 1: 中等可重复性

  • 2: 高可重复性

debugfs 接口

serial_number

传感器的唯一序列号，以十进制表示