AMS AS3935 富兰克林雷电传感器

AS3935 传感器平台允许您使用 AS3935 传感器 （数据手册） 在雷暴接近时收到通知。

AS3935 可以检测到雷电活动的存在，并提供 到风暴前缘距离的估计。该芯片通过中断 引脚发出通知。

组件/中心

AS3935 可以配置为使用 SPI 或 I²C 协议进行数据通信。 首先选择要使用的通信方法，为传感器设置相应的 SI 引脚电平，并在 ESPHome 中设置所选通信方法的组件。

模块引脚

模块引脚	说明
VCC/VDD	正电源电压
GND	地线
SCL	I²C 时钟总线或 SPI 时钟总线（根据 SI 设置）
MOSI	I²C 数据总线或 SPI 数据输入总线（根据 SI 设置）
MISO	SPI 数据输出总线
CS	片选（低电平有效）
SI	接口选择（GND → SPI 或 VDD → I²C）
IRQ	中断（输出）
EN_V	稳压器使能
A0	I²C 地址选择最低位
A1	I²C 地址选择最高位

AS3935 雷电传感器。

通过 SPI

as3935_spi 传感器平台允许您使用 AS3935 传感器 （AMS AS3935）在雷暴接近时收到通知。

# Example configuration for SPI
as3935_spi:
  cs_pin: GPIOXX
  irq_pin: GPIOXX

配置变量

• cs_pin (必选, Pin Schema): 片选引脚。

• irq_pin (必选, Pin): IRQ 引脚，指示是否检测到雷电。

• indoor (可选, boolean): 指示传感器是否在室内使用。默认为 true。

• noise_level (可选, int): 噪声电平与已知参考电压进行比较。 如果超过此电平，芯片将向 IRQ 引脚发出中断，广播因噪声而无法 正常工作 (INT_NH)。默认为 2。

• spike_rejection (可选, int): 有助于区分假事件和真实雷电。 增加此值可以提高鲁棒性，但会降低对远处事件的灵敏度。默认为 2。

• lightning_threshold (可选, int): 在 15 分钟时间 窗口内必须出现的雷电次数才能检测到雷暴。 15 分钟是重置已检测到雷电事件数量的时间窗口。 雷电次数可以设置为 1、5、9 或 16。默认为 1。

• mask_disturber (可选, boolean): 此设置将返回干扰源是否触发 IRQ 引脚。默认为 false。

• div_ratio (可选, int): 天线设计为在 500kHz 下谐振，因此可以使用 以下设置进行调谐。天线的精度必须在 3.5% 以内， 才能正确验证信号和估计距离。默认为 0。

• capacitance (可选, int): 此设置将在产品上的串联 RLC 天线上增加电容 以帮助调谐其谐振频率。数据手册规定在 500kHz 的 3.5% 以内才能获得最佳的雷电 检测和距离感知。最多可以向天线增加 120pF，步进为 8pF。默认为 0。

• watchdog_threshold (可选, int): 确定触发 IRQ 引脚的事件阈值。 默认为 2。

• tune_antenna (可选, boolean): 以天线调谐模式启动传感器。它将在 INT 引脚上发出振荡器 频率以供读取。请遵循 AS3935 文档。请注意，启用此模式时， 将不会检测到雷电。它仅应用于初始校准，以确定 capacitance 和/或 div_ratio 参数的正确值。 默认为 False。

• calibration (可选, boolean): 在启动时启用/禁用振荡器校准。建议首先执行 天线调谐过程并调整参数，使 RLC 天线谐振处于最佳范围内。 默认为 True。

通过 I²C

as3935_i2c 传感器平台允许您使用 AS3935 传感器 （AMS AS3935）在雷暴接近时收到通知。

# Example configuration for I²C
as3935_i2c:
  irq_pin: GPIOXX

配置变量

• address (可选, int): 手动指定 传感器的 I²C 地址。默认为 0x03（A0 和 A1 引脚拉高）。 地址由 A0 的状态作为第 1 位和 A1 的状态作为第 2 位组成，因此总共可以有四个地址。

• irq_pin (必选, Pin): IRQ 引脚，指示是否检测到雷电。

• indoor (可选, boolean): 指示传感器是否在室内使用。默认为 true。

• noise_level (可选, int): 噪声电平与已知参考电压进行比较。 如果超过此电平，芯片将向 IRQ 引脚发出中断，广播因噪声而无法 正常工作 (INT_NH)。默认为 2。

• spike_rejection (可选, int): 有助于区分假事件和真实雷电。 增加此值可以提高鲁棒性，但会降低对远处事件的灵敏度。默认为 2。

• lightning_threshold (可选, int): 在 15 分钟时间 窗口内必须出现的雷电次数才能检测到雷暴。 15 分钟是重置已检测到雷电事件数量的时间窗口。 雷电次数可以设置为 1、5、9 或 16。默认为 1。

• mask_disturber (可选, boolean): 此设置将返回干扰源是否触发 IRQ 引脚。默认为 false。

• div_ratio (可选, int): 天线设计为在 500kHz 下谐振，因此可以使用 以下设置进行调谐。天线的精度必须在 3.5% 以内， 才能正确验证信号和估计距离。默认为 0。

• capacitance (可选, int): 此设置将在产品上的串联 RLC 天线上增加电容 以帮助调谐其谐振频率。数据手册规定在 500kHz 的 3.5% 以内才能获得最佳的雷电 检测和距离感知。最多可以向天线增加 120pF，步进为 8pF。默认为 0。

• watchdog_threshold (可选, int): 确定触发 IRQ 引脚的事件阈值。 默认为 2。

• tune_antenna (可选, boolean): 以天线调谐模式启动传感器。它将在 INT 引脚上发出振荡器 频率以供读取。请遵循 AS3935 文档。请注意，启用此模式时， 将不会检测到雷电。它仅应用于初始校准，以确定 capacitance 和/或 div_ratio 参数的正确值。 默认为 False。

• calibration (可选, boolean): 在启动时启用/禁用振荡器校准。建议首先执行 天线调谐过程并调整参数，使 RLC 天线谐振处于最佳范围内。 默认为 True。

传感器

一个用于读取雷电数据的传感器平台。

sensor:
  - platform: as3935
    lightning_energy:
      name: Lightning Energy
    distance:
      name: Distance Storm

配置变量：

• lightning_energy (可选): 雷电能量值。根据数据手册，这只是一个纯数值，没有任何物理意义。 来自 Sensor 的所有选项。

• distance (可选): 到风暴前缘的距离（单位为 km），而不是到雷电的距离。 来自 Sensor 的所有选项。

二值传感器

指示是否检测到雷电的二值传感器。

# Example storm alert binary sensor
binary_sensor:
  - platform: as3935
    name: Storm Alert

配置变量：

• 来自 Binary Sensor 的所有选项。

参见

• 传感器过滤器
• 数据手册
• Little Arduino Projects
• AMS AS3935
• SparkFun 库
• API 参考：as3935.h