aboutsummaryrefslogtreecommitdiffstats
path: root/doc/gps-track.md
blob: 721b075a83635df5ffa0b177979492edd5ad1780 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
Send GPS position to server
===========================

[⬅️ Go back to main README](../README.md)

> ℹ️ **Info**: This script can not be used on its own but requires the base
> installation. See [main README](../README.md) for details.

Description
-----------

This script is supposed to run periodically from scheduler and send GPS
position data to a server for tracking.

A hardware GPS antenna is required.

Requirements and installation
-----------------------------

Just install the script:

    $ScriptInstallUpdate gps-track;

... and create a scheduler:

    /system/scheduler/add interval=1m name=gps-track on-event="/system/script/run gps-track;" start-time=startup;

Configuration
-------------

The configuration goes to `global-config-overlay`, the only parameter is:

* `GpsTrackUrl`: the url to send json data to

> ℹ️ **Info**: Copy relevant configuration from
> [`global-config`](../global-config.rsc) (the one without `-overlay`) to
> your local `global-config-overlay` and modify it to your specific needs.

The configured coordinate format (see `/system/gps`) defines the format
sent to the server.

---
[⬅️ Go back to main README](../README.md)  
[⬆️ Go back to top](#top)