summaryrefslogtreecommitdiff
path: root/plugins/gpsnmea/README
blob: 28c6fcbe87a3f1f1530a81a9eba289991ecf004e (plain)
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
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
# GPS NMEA plugin {#gpsnmea_plugin}
Version: @PROJECT_VERSION@

This plugin uses NMEA-compatible devices to provide location information to AMB.

To enable the GPS NMEA plugin, run cmake and enable the gpsnmea_plugin option:

cmake -Dgpsnmea_plugin=On ..

To use the Database plugin, add the following to the "sources" array in /etc/ambd/config:

~~~~~~~~~~~~~{.json}
{
	"name" : "gpsnmea",
	"path" : "@PLUGIN_INSTALL_PATH@/gpsnmea.so",
	"device" : "/dev/ttyUSB0",
	"baudrate" : "4800",
	"bluetoothAdapter" : "00:00:00:00:00:00"
}
~~~~~~~~~~~~~

## Configuration Key Definitions:

"name"
name of plugin.  This key is not used by the plugin at this moment.

"path"
path to plugin on the filesystem.

"device"
gps device.  This must be a serial device.  It can also be a bluetooth address.

Default: none

"baudrate"
Baudrate for serial devices : 2400,4800,9600,19200 or 38400.

Default: 9600

"bluetoothAdapter"
bluetooth adapter to use.  This is only used if "device" is also a bluetooth device.
If left blank, the system default adapter will be used.

Default: none

## AMB Properties:

GpsTime
Timestamp in seconds from unix epoc (UTC) parsed from the NMEA output.

Type: double
Access: readonly

GpsSpeed
Speed as reported by GPS

Type: UInt16
Access: readonly

GpsFix
Fix status.

~~~~~~~~~~~~(.cpp}
enum FixType {
	NoFix = 1,
	Fix2D = 2,
	Fix3D = 3
};
~~~~~~~~~~~~

Type: int
Access: readonly

GpsSatsUsed {#GpsSatsUsed}
How many satellites are being used in the fix

Type: UInt16
Access: readonly

GpsNmea
Raw NMEA message.  Useful for debugging

Type: String
Access: readonly

## DBus Interfaces:

### org.automotive.GpsInfo
**Properties**
GpsTime - Corresponds with the GpsTime AMB Property
Speed - Corresponds with the GpsSpeed AMB Property
Fix - Corresponds with the GpsFix AMB Property
SattelitesUsed - Corresponds with the GpsSatsUsed AMB Property
RawNmea - Corresponds with the GpsNmea AMB Property

interface GpsInfo
{

}