内核驱动 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

周期性测量

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

传感器的唯一序列号(十进制)