跳转到内容
ESPHome - 智能家居，简单易用

GPS 组件

gps 组件允许您将 GPS 模块连接到您的 ESPHome 项目。 任何使用标准化 NMEA 通信协议的 GPS 模块都可以使用。

GPS 模块。图片由 Adafruit 提供

要使此组件工作，您需要在配置中设置一个 UART 总线——只需要 RX 引脚。

# 示例配置条目


# 声明 GPS 模块
gps:
  latitude:
    name: "Latitude"
  longitude:
    name: "Longitude"
  altitude:
    name: "Altitude"


# GPS 作为时间源
time:
  - platform: gps

该组件分为平台，通过定义 GPS 模块（如上所示）。

除了获取 GPS 位置数据外，该模块还可以用作时间平台， 通过非常精确的 GPS 时钟获取当前日期和时间，无需网络连接。

有关 GPS 时间源的配置选项，请参阅 GPS。

配置变量

Section titled “配置变量”

  • latitude (可选): 将纬度作为传感器包含

  • longitude (可选): 将经度作为传感器包含

  • speed (可选): 将测量的速度作为传感器包含

  • course (可选): 将测量的航向作为传感器包含

  • altitude (可选): 将测量的海拔作为传感器包含

  • satellites (可选): 将正在使用的跟踪卫星数量作为传感器包含

  • hdop (可选): 将测量的 HDOP（水平精度稀释因子）作为传感器包含

  • update_interval (可选, 时间): 传感器更新的间隔。默认为 20s。

另请参阅

Section titled “另请参阅”