GPS Component

The gps component allows you to connect GPS modules to your ESPHome project. Any GPS module that uses the standardized NMEA communication protocol will work.

Adafruit

For this component to work you need to have set up a UART bus in your configuration - only the RX pin should be necessary.

# Example configuration entry

# Declare GPS module
gps:
  latitude:
    name: "Latitude"
  longitude:
    name: "Longitude"
  altitude:
    name: "Altitude"

# GPS as time source
time:
  - platform: gps

The component is split up in platforms, by defining the GPS module (as seen above).

In addition to retrieving GPS position data, the module can also be used as a time platform to get the current date and time via the very accurate GPS clocks without a network connection.

See GPS Time Source for config options for the GPS time source.

Configuration variables:

• latitude (Optional): Include the Latitude as a sensor

  • All options from Sensor.

• longitude (Optional): Include the Longitude as a sensor

  • All options from Sensor.

• speed (Optional): Include the measured speed as a sensor

  • All options from Sensor.

• course (Optional): Include the measured course as a sensor

  • All options from Sensor.

• altitude (Optional): Include the measured altitude as a sensor

  • All options from Sensor.

• satellites (Optional): Include the number of tracking satellites being used as a sensor

  • All options from Sensor.

• hdop (Optional): Include the measured HDOP (Horizontal Dilution Of Precision) as a sensor

  • All options from Sensor.

• update_interval (Optional, Time): The interval of sensor updates. Defaults to 20s.

See Also

• Sensor Filters
• TinyGPS++ library
• API Reference