8000 GitHub - bkbilly/Routario-ha: 🛰️ Automatically create entities for the Routario fleet management platform · GitHub
[go: up one dir, main page]

Skip to content

About

🛰️ Automatically create entities for the Routario fleet management platform

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Latest commit

 

History

6 Commits

Folders and files

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

1 watching

Forks

Releases

Packages

Contributors

Languages

0