Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Routario Home Assistant Integration

A Home Assistant custom integration that exposes Routario GPS tracking devices as entities.

How it works

Routario pushes position updates to Home Assistant via webhook. No polling, no API token — devices appear automatically as updates arrive.

Installation

HACS (recommended)

  1. Open HACS → Integrations → Custom repositories
  2. Add https://github.com/bkbilly/routario-ha with category Integration
  3. Install Routario and restart Home Assistant

Manual

Copy the custom_components/routario/ folder into your Home Assistant custom_components/ directory and restart.

Setup

  1. Go to Settings → Integrations → Add Integration and search for Routario
  2. The setup screen shows a webhook URL — copy it
  3. In Routario, go to User Settings → Webhooks and paste the URL
  4. Devices appear automatically as position updates are received

Entities

Each Routario device creates the following entities, grouped under one Home Assistant device:

Entity Type Description
device_tracker.{name} Device Tracker GPS position, shown on the HA map
binary_sensor.{name}_ignition Binary Sensor Ignition on/off
binary_sensor.{name}_moving Binary Sensor Moving (speed > 0)
sensor.{name}_speed Sensor Speed in km/h
sensor.{name}_last_seen Sensor Timestamp of last position update
sensor.{name}_course Sensor Heading in degrees (diagnostic)
sensor.{name}_altitude Sensor Altitude in meters (diagnostic)
sensor.{name}_satellites Sensor GPS satellite count (diagnostic)

Dynamic entities

Additional entities are created automatically based on what the device reports:

  • Numeric/string sensors (e.g. battery_voltage, fuel_level, gsm_signal, temperature) → sensor.{name}_{key}
  • Boolean sensors (e.g. door, charging, shock, alarm_active) → binary_sensor.{name}_{key}

Notes

  • Entities are unavailable after a Home Assistant restart until the next position update arrives
  • The webhook URL changes if the integration is removed and re-added

About

🛰️ Automatically create entities for the Routario fleet management platform

Topics

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages