AMS AS3935 富兰克林雷电传感器
AS3935 传感器平台允许您使用 AS3935 传感器（数据手册）在雷暴接近时获得通知。
AS3935 可以检测雷电活动的存在，并估算风暴头部的距离。芯片通过中断引脚发出通知。
组件/集线器
Section titled “组件/集线器”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 地址选择 LSB |
| A1 | I²C 地址选择 MSB |
通过 SPI
Section titled “通过 SPI”as3935_spi 传感器平台允许您使用 AS3935 传感器（AMS AS3935）在雷暴接近时获得通知。
# SPI 配置示例as3935_spi: cs_pin: GPIOXX irq_pin: GPIOXX-
cs_pin (必需, 引脚模式): 片选引脚。
-
irq_pin (*必需, 引脚): IRQ 引脚，指示是否检测到雷击。
-
indoor (可选, 布尔值): 指示传感器是否在室内使用。默认为
true。 -
noise_level (可选, 整数): 噪声底电平与已知参考电压进行比较。 如果超过此电平，芯片将向 IRQ 引脚发出中断，广播由于噪声而无法正常工作（INT_NH）。默认为
2。 -
spike_rejection (可选, 整数): 帮助区分虚假事件和实际雷电。 增加此值会增加鲁棒性，但会降低对远距离事件的灵敏度。默认为
2。 -
lightning_threshold (可选, 整数): 在检测到雷暴之前，15 分钟时间窗口内必须出现的闪电次数。 15 分钟是检测到的闪电事件次数重置之前的时间窗口。 闪电次数可以设置为 1、5、9 或 16。默认为
1。 -
mask_disturber (可选, 布尔值): 此设置将返回干扰是否触发 IRQ 引脚。默认为
false。 -
div_ratio (可选, 整数): 天线设计为在 500kHz 谐振，因此可以通过以下设置进行调谐。 天线的精度必须在该值的 3.5% 以内，才能正确进行信号验证和距离估算。默认为
0。 -
capacitance (可选, 整数): 此设置将向产品上的串联 RLC 天线添加电容，以帮助调谐其谐振。 数据手册规定在 500kHz 的 3.5% 以内才能获得最佳雷电检测和距离感知。 可以按 8pF 的步进向天线添加最多 120pF 的电容。默认为
0。 -
watchdog_threshold (可选, 整数): 确定触发 IRQ 引脚的事件阈值。默认为
2。 -
tune_antenna (可选, 布尔值): 在天线调谐模式下启动传感器。它将在 INT 引脚上输出振荡频率。 请遵循 AS3935 文档。请注意，在此模式启用期间，将不会检测到闪电。 它应仅用于初始校准，以确定
capacitance和/或div_ratio参数的正确值。 默认为False。 -
calibration (可选, 布尔值): 在启动时启用/禁用振荡器校准。建议先执行天线调谐程序并调整参数， 使 RLC 天线谐振调谐到最佳范围内。默认为
True。
通过 I²C
Section titled “通过 I²C”as3935_i2c 传感器平台允许您使用 AS3935 传感器（AMS AS3935）在雷暴接近时获得通知。
# I²C 配置示例as3935_i2c: irq_pin: GPIOXX-
address (可选, 整数): 手动指定传感器的 I²C 地址。 默认为
0x03（A0和A1引脚拉高）。 地址由A0的状态作为位 1 和A1的状态作为位 2 组成，因此总共可能有四个地址。 -
irq_pin (*必需, 引脚): IRQ 引脚，指示是否检测到雷击。
-
indoor (可选, 布尔值): 指示传感器是否在室内使用。默认为
true。 -
noise_level (可选, 整数): 噪声底电平与已知参考电压进行比较。 如果超过此电平，芯片将向 IRQ 引脚发出中断，广播由于噪声而无法正常工作（INT_NH）。默认为
2。 -
spike_rejection (可选, 整数): 帮助区分虚假事件和实际雷电。 增加此值会增加鲁棒性，但会降低对远距离事件的灵敏度。默认为
2。 -
lightning_threshold (可选, 整数): 在检测到雷暴之前，15 分钟时间窗口内必须出现的闪电次数。 15 分钟是检测到的闪电事件次数重置之前的时间窗口。 闪电次数可以设置为 1、5、9 或 16。默认为
1。 -
mask_disturber (可选, 布尔值): 此设置将返回干扰是否触发 IRQ 引脚。默认为
false。 -
div_ratio (可选, 整数): 天线设计为在 500kHz 谐振，因此可以通过以下设置进行调谐。 天线的精度必须在该值的 3.5% 以内，才能正确进行信号验证和距离估算。默认为
0。 -
capacitance (可选, 整数): 此设置将向产品上的串联 RLC 天线添加电容，以帮助调谐其谐振。 数据手册规定在 500kHz 的 3.5% 以内才能获得最佳雷电检测和距离感知。 可以按 8pF 的步进向天线添加最多 120pF 的电容。默认为
0。 -
watchdog_threshold (可选, 整数): 确定触发 IRQ 引脚的事件阈值。默认为
2。 -
tune_antenna (可选, 布尔值): 在天线调谐模式下启动传感器。它将在 INT 引脚上输出振荡频率。 请遵循 AS3935 文档。请注意，在此模式启用期间，将不会检测到闪电。 它应仅用于初始校准，以确定
capacitance和/或div_ratio参数的正确值。 默认为False。 -
calibration (可选, 布尔值): 在启动时启用/禁用振荡器校准。建议先执行天线调谐程序并调整参数， 使 RLC 天线谐振调谐到最佳范围内。默认为
True。
用于读取雷电数据的传感器平台
sensor: - platform: as3935 lightning_energy: name: Lightning Energy distance: name: Distance Storm配置变量：
-
lightning_energy (可选): 雷电能量值。根据数据手册，这只是一个纯数值，没有任何物理意义。 Sensor 的所有选项。
-
distance (可选): 到风暴前端的距离（以 km 为单位），而不是到雷击的距离。 Sensor 的所有选项。
指示是否检测到雷击的二值传感器。
# 风暴警报二值传感器示例binary_sensor: - platform: as3935 name: Storm Alert配置变量：
- Binary Sensor 的所有选项。