SPA06-003 温度+压力传感器

spa06 传感器平台允许您在 ESPHome 中使用 Goermicro SPA06-003（数据手册，Adafruit 或 Seeed）温度与压力传感器。要在您的配置中使该传感器正常工作，必须先设置好 I²C 或 SPI 总线。

配置示例

通过 I²C

# I2C 连接的示例配置条目
sensor:
  - platform: spa06_i2c
    temperature:
      name: "Indoor Temperature"
    pressure:
      name: "Indoor Pressure"

通过 SPI

# SPI 连接的示例配置条目
sensor:
  - platform: spa06_spi
    cs_pin: 12
    temperature:
      name: "Indoor Temperature"
    pressure:
      name: "Indoor Pressure"

配置变量

temperature (可选): 温度传感器的信息。
- oversampling (可选): 温度传感器的过采样率。参见过采样选项。
- sample_rate (可选): 温度传感器的内部采样率。参见采样率。
- Sensor 的所有其他选项。
pressure (可选): 压力传感器的信息。
- oversampling (可选): 压力传感器的过采样率。参见过采样选项。
- sample_rate (可选): 压力传感器的内部采样率。参见采样率。
- Sensor 的所有其他选项。
update_interval (可选, Time): 检查传感器的间隔。默认为 60s。
address (可选, int, 仅 I²C): 手动指定传感器的 I²C 地址。默认为 0x77。另一个可用地址为 0x76。
cs_pin (必选, 仅 SPI): 指定用于该传感器的片选引脚。
i2c_bus (可选, str) (仅 I²C): 如果设备有多个 I²C 总线，可手动指定所使用的 I²C 总线。
spi_bus (可选, str) (仅 SPI): 如果设备有多个 SPI 总线，可手动指定所使用的 SPI 总线

过采样选项

默认情况下，SPA06 传感器对压力测量进行 16 次过采样，不对温度测量进行过采样。较高的过采样率可以在提高精度的同时，以较慢的更新速度和可能更高的电流消耗为代价。可选的过采样值包括：

NONE（传感器采样一次，温度的默认值）
2x
4x
8x
16x（压力的默认值）
32x
64x
128x

数据手册（第 19 页）提供了展示过采样权衡的表格：

过采样设置

过采样设置	测量时间 (ms)	压力精度 (PaRMS)
`NONE`	3.6	2
`2x`	5.2	1
`4x`	8.4	0.7
`8x`	14.8	0.6
`16x`	27.6	0.5
`32x`	53.2	0.4
`64x`	104.4	0.3
`128x`	206.8	0.2

采样率选项

SPA06 的采样频率最高可达每秒 200 次，最低可达每秒 1 次。请注意，如果 update_interval 的速率高于传感器的采样率，传感器将报告上一次读数的数据。完整的采样选项列表如下：

1: 1 Hz（默认）
2: 2 Hz
4: 4 Hz
8: 8 Hz
16: 16 Hz
32: 32 Hz
64: 64 Hz
128: 128 Hz
25p16: 每 16 秒采样 25 次（约 1.56 Hz）
25p8: 每 8 秒采样 25 次（约 3.13 Hz）
25p4: 每 4 秒采样 25 次（6.25 Hz）
25p2: 每 2 秒采样 25 次（12.5 Hz）
25: 25 Hz
50: 50 Hz
100: 100 Hz
200: 200 Hz

WARNING

SPA06 传感器对每秒可采样的样本数有限制，取决于温度与压力传感器的过采样和采样率配置（数据手册第 26 页）。配置的速率必须满足以下等式：

$1 > t_T \times r_T + t_P \times r_P$

其中 $t_T$ 是所配置温度过采样率对应的等效测量时间， $r_T$ 是以赫兹为单位的温度采样率， $t_P$ 是所配置压力过采样率对应的等效测量时间， $r_P$ 是以赫兹为单位的压力采样率。如果未配置压力，则 $t_P \times r_P$ 等于 0。

参见

传感器过滤器