跳转到内容

Wi-Fi 信号传感器

wifi_signal 传感器平台允许您读取当前连接的 Wi-Fi 接入点 的信号强度。

传感器数值为”接收信号强度指示”(RSSI),单位为 dBm。这些值始终为负数,越接近零,信号越好。

# 示例配置条目
sensor:
- platform: wifi_signal
name: "WiFi Signal Sensor"
update_interval: 60s

如需以百分比显示信号强度,请使用复制传感器(由于同一传感器会向 Home Assistant 报告静态的 uniqueid,因此无法添加两次相同的传感器):

# 带 2 个传感器和过滤器的示例配置条目
sensor:
- platform: wifi_signal # 以 dB 报告 Wi-Fi 信号强度/RSSI
name: "WiFi Signal dB"
id: wifi_signal_db
update_interval: 60s
entity_category: "diagnostic"
- platform: copy # 以百分比报告 Wi-Fi 信号强度
source_id: wifi_signal_db
name: "WiFi Signal Percent"
filters:
- lambda: return min(max(2 * (x + 100.0), 0.0), 100.0);
unit_of_measurement: "Signal %"
entity_category: "diagnostic"
device_class: ""
  • update_interval (可选, Time): 检查传感器的间隔。默认为 60s。

  • Sensor 的所有其他选项。

WARNING

仅当 Wi-Fi 处于 station(站点)模式时才有信号强度读数。如果设备作为接入点运行且没有任何站点模式连接,则读数无效。