(One intermediate revision by one other user not shown)
Line 23:
Line 23:
{{Mr-arg-table
{{Mr-arg-table
|arg=enabled
|arg=channel
|type=yes {{!}} no
|type=integer [0..4294967295]
|default=0
|desc=Port channel used by device
}}
{{Mr-arg-table
|arg=coordinate-format
|type=dd {{!}} dms {{!}} ddmm
|default=no
|default=no
|desc=Whether GPS is enabled
|desc=Which coordinate format to use, "Decimal Degrees", "Degrees Minutes Seconds" or "NMEA format DDDMM.MM[MM]"
}}
}}
{{Mr-arg-table
{{Mr-arg-table
|arg=port
|arg=enabled
|type=string
|type=yes {{!}} no
|default=
|default=no
|desc=Name of the USB/Serial port where GPS receiver is connected
|desc=Whether GPS is enabled
}}
}}
{{Mr-arg-table
{{Mr-arg-table
|arg=channel
|arg=gps-antenna-select
|type=integer [0..4294967295]
|type=external {{!}} internal
|default=0
|default=internal
|desc=Port channel used by device
|desc=Depending on model. Can be used to select internal antenna, if device has one.
}}
}}
{{Mr-arg-table
{{Mr-arg-table
Line 62:
Line 65:
|default=
|default=
|desc=AT init string for GPS initialization
|desc=AT init string for GPS initialization
}}
{{Mr-arg-table
|arg=port
|type=string
|default=
|desc=Name of the USB/Serial port where GPS receiver is connected
}}
}}
Line 101:
Line 112:
|type=none {{!}} string
|type=none {{!}} string
|desc=Longitude in DM (Degrees Minute decimal) format
|desc=Longitude in DM (Degrees Minute decimal) format
}}
{{Mr-arg-ro-table
|arg=altitude
|type=none {{!}} string
|desc=Altitude based on GPS data
}}
}}
Line 110:
Line 127:
{{Mr-arg-ro-table
{{Mr-arg-ro-table
|arg=bearing
|arg=destination-bearing
|type=none {{!}} string
|desc=The direction toward which a GPS is moving
}}
{{Mr-arg-ro-table
|arg=true-bearing
|type=none {{!}} string
|desc=The direction toward which a GPS is moving
}}
{{Mr-arg-ro-table
|arg=magnetic-bearing
|type=none {{!}} string
|type=none {{!}} string
|desc=The compass direction toward which a GPS is moving
|desc=The direction toward which a GPS is moving
}}
}}
{{Mr-arg-ro-table
{{Mr-arg-ro-table
Line 121:
Line 151:
}}
}}
{{Mr-arg-ro-table-end
{{Mr-arg-ro-table
|arg=satellites
|type=integer
|desc=Number of satellites seen by the device.
}}
{{Mr-arg-ro-table
|arg=fix-quality
|type=integer
|desc=Quality of the signal
}}
{{Mr-arg-ro-table
|arg=satellites
|arg=satellites
|type=integer
|type=integer
Line 127:
Line 170:
}}
}}
''Note: The time is not stratum 1 as RouterBOARD devices do not have [http://en.wikipedia.org/wiki/Pulse_per_second PPS] implemented''
{{Mr-arg-ro-table-end
|arg=horizontal-dilution
|type=integer
|desc=Horizontal dilution of precision (HDOP);
}}
''Note: The time is not stratum 1 as RouterBOARD devices do not have [http://en.wikipedia.org/wiki/Pulse_per_second PPS] implemented'' as of RouterOS v6. This might change with new NTP server in v7.
==Basic examples==
==Basic examples==
Line 138:
Line 187:
0 serial0 1 Serial Console auto
0 serial0 1 Serial Console auto
</pre>
</pre>
in this case port is used by console, release it from console menu:
In case there is one port and it is used by console, release it from console menu:
<pre>
<pre>
[admin@MikroTik] > /system console print
[admin@MikroTik] > /system console print
Line 182:
Line 231:
valid: yes
valid: yes
satellites: 7
satellites: 7
</pre>
Port and GPS settings for '''LtAP'''
<pre>
/port set serial1 baud-rate=115200
</pre>
<pre>
/system gps set port=serial1 channel=0 enabled=yes
Depending on model. Can be used to select internal antenna, if device has one.
init-channel (integer [0..4294967295]; Default: )
Channel for init-string execution
init-string (string; Default: )
AT init string for GPS initialization
port (string; Default: )
Name of the USB/Serial port where GPS receiver is connected
set-system-time (yes | no; Default: no)
Whether to set router's date and time to one received from GPS.
Monitoring Status
Command:/system gps monitor
This command is used for monitoring the data received from a GPS receiver
Parameters:
Property
Description
date-and-time (date)
Date and time received from GPS
latitude (none | string)
Latitude in DM (Degrees Minute decimal) format
longitude (none | string)
Longitude in DM (Degrees Minute decimal) format
altitude (none | string)
Altitude based on GPS data
speed (none | string)
Current moving speed of the GPS unit
destination-bearing (none | string)
The direction toward which a GPS is moving
true-bearing (none | string)
The direction toward which a GPS is moving
magnetic-bearing (none | string)
The direction toward which a GPS is moving
valid (yes | no)
satellites (integer)
Number of satellites seen by the device.
fix-quality (integer)
Quality of the signal
satellites (integer)
Number of satellites seen by the device.
horizontal-dilution (integer)
Horizontal dilution of precision (HDOP);
Note: The time is not stratum 1 as RouterBOARD devices do not have PPS implemented as of RouterOS v6. This might change with new NTP server in v7.
Basic examples
Check port usage, only one instance can use serial port simultaneously
[admin@MikroTik] /port print
Flags: I - inactive
# DEVICE NAME CHANNELS USED-BY BAUD-RATE
0 serial0 1 Serial Console auto
In case there is one port and it is used by console, release it from console menu:
[admin@MikroTik] > /system console print
Flags: X - disabled, U - used, F - free
# PORT TERM
0 U serial0 vt102
[admin@MikroTik] > /system console disable 0
Adjust port settings specific for your device (leave "auto" for LtAP mini)
/system gps set port=serial1 channel=0 enabled=yes
We have also created an in-depth article about live GPS tracking, using scripting and a web server: Manual:GPS-tracking.
Troubleshooting
Note that sometimes in order to make GPS module to be recognized under RouterOS you need to change the baud-rate setting in the '/port' menu.
LtAP mini has low gain GPS antenna build in, for better experience we suggest using additional external antenna
Switch between internal and external antennas under GPS menu:
[admin@MikroTik] > /system gps set gps-antenna-select=external
On some modems with GPS support you need to send multiple init commands for the continuous GPS monitoring, for example, for Huawei cards you need to send "AT^WPDST=1,AT^WPDGP" init string to get continuous monitoring.
