Manual:System/GPS: Difference between revisions
(18 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
{{Versions|v3, v4, v5 +}} | {{Versions|v3, v4, v5, v6 +}} | ||
__TOC__ | __TOC__ | ||
==Summary== | ==Summary== | ||
<p id="shbox"><b>Sub-menu:</b> <code>/system gps</code> | <p id="shbox"> | ||
<b>Package requirement:</b> <code>gps</code> | |||
<br /> | |||
<b>Sub-menu:</b> <code>/system gps</code> | |||
<br /> | <br /> | ||
<b>Standards:</b> <code>GPS, NMEA 0183, [http://www8.garmin.com/support/text_out.html Simple Text Output Protocol]</code> | <b>Standards:</b> <code>GPS, NMEA 0183, [http://www8.garmin.com/support/text_out.html Simple Text Output Protocol]</code> | ||
Line 19: | Line 21: | ||
|desc=Description | |desc=Description | ||
}} | }} | ||
{{Mr-arg-table | |||
|arg=enabled | |||
|type=yes {{!}} no | |||
|default=no | |||
|desc=Whether GPS is enabled | |||
}} | |||
{{Mr-arg-table | |||
|arg=port | |||
|type=string | |||
|default= | |||
|desc=Name of the USB/Serial port where GPS receiver is connected | |||
}} | |||
{{Mr-arg-table | {{Mr-arg-table | ||
Line 27: | Line 47: | ||
}} | }} | ||
{{Mr-arg-table | {{Mr-arg-table | ||
|arg= | |arg=init-channel | ||
|type= | |type=integer [0..4294967295] | ||
|default= | |default= | ||
|desc= | |desc=Channel for init-string execution | ||
}} | }} | ||
{{Mr-arg-table | {{Mr-arg-table | ||
|arg= | |arg=init-string | ||
|type=string | |type=string | ||
|default= | |default= | ||
|desc= | |desc=AT init string for GPS initialization | ||
}} | }} | ||
Line 51: | Line 71: | ||
|desc=Whether to set router's date and time to one received from GPS. | |desc=Whether to set router's date and time to one received from GPS. | ||
}} | }} | ||
==Monitoring Status== | ==Monitoring Status== | ||
Line 76: | Line 94: | ||
|arg=latitude | |arg=latitude | ||
|type= none {{!}} string | |type= none {{!}} string | ||
|desc= | |desc=Latitude in DM (Degrees Minute decimal) format | ||
}} | }} | ||
Line 82: | Line 100: | ||
|arg=longitude | |arg=longitude | ||
|type=none {{!}} string | |type=none {{!}} string | ||
|desc= | |desc=Longitude in DM (Degrees Minute decimal) format | ||
}} | }} | ||
Line 88: | Line 106: | ||
|arg=speed | |arg=speed | ||
|type=none {{!}} string | |type=none {{!}} string | ||
|desc= | |desc=Current moving speed of the GPS unit | ||
}} | }} | ||
Line 94: | Line 112: | ||
|arg=bearing | |arg=bearing | ||
|type=none {{!}} string | |type=none {{!}} string | ||
|desc= | |desc=The compass direction toward which a GPS is moving | ||
}} | }} | ||
Line 108: | Line 126: | ||
|desc=Number of satellites seen by the device. | |desc=Number of satellites seen by the device. | ||
}} | }} | ||
''Note: The time is not stratum 1 as RouterBOARD devices do not have [http://en.wikipedia.org/wiki/Pulse_per_second PPS] implemented'' | |||
==Basic examples== | ==Basic examples== | ||
Adjust port settings specific for your device | Check port usage, only one instance can use serial port simultaneously | ||
<pre> | |||
[admin@MikroTik] /port print | |||
Flags: I - inactive | |||
# DEVICE NAME CHANNELS USED-BY BAUD-RATE | |||
0 serial0 1 Serial Console auto | |||
</pre> | |||
in this case port is used by console, release it from console menu: | |||
<pre> | |||
[admin@MikroTik] > /system console print | |||
Flags: X - disabled, U - used, F - free | |||
# PORT TERM | |||
0 U serial0 vt102 | |||
[admin@MikroTik] > /system console disable 0 | |||
</pre> | |||
Adjust port settings specific for your device (leave "auto" for LtAP mini) | |||
<pre> | <pre> | ||
[admin@MikroTik] /port> set 0 baud-rate=4800 parity=odd | [admin@MikroTik] /port> set 0 baud-rate=4800 parity=odd | ||
[admin@MikroTik] /port> print detail | [admin@MikroTik] /port> print detail | ||
Flags: I - inactive | Flags: I - inactive | ||
0 name="usb1" used-by=" | 0 name="usb1" used-by="" channels=1 baud-rate=4800 data-bits=8 parity=odd stop-bits=1 flow-control=none | ||
</pre> | </pre> | ||
Line 126: | Line 163: | ||
port: usb1 | port: usb1 | ||
channel: 0 | channel: 0 | ||
init-channel: 0 | |||
init-string: | |||
set-system-time: no | set-system-time: no | ||
Line 133: | Line 172: | ||
<pre> | <pre> | ||
[admin@MikroTik] /system gps> monitor | [admin@MikroTik] /system gps> monitor | ||
date-and-time: | date-and-time: jul/02/2015 14:36:08 | ||
latitude: N 56 57' 32.262'' | |||
longitude: E 24 9' 7.262'' | |||
altitude: 36.700001m | |||
speed: 0.000000 km/h | |||
destination-bearing: none | |||
true-bearing: 0.000000 deg. True | |||
magnetic-bearing: 0.000000 deg. Mag | |||
valid: yes | |||
satellites: 7 | |||
</pre> | </pre> | ||
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. | |||
[https://mikrotik.com/product/ltap_mini LtAP mini] has low gain GPS antenna build in, for better experience we suggest using additional [https://mikrotik.com/product/acgpsa external antenna] | |||
Switch between internal and external antennas under GPS menu: | |||
<pre> | |||
[admin@MikroTik] > /system gps set gps-antenna-select=external | |||
</pre> | |||
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. | |||
[[Category:Manual|G]] | [[Category:Manual|G]] | ||
[[Category:System|G]] | [[Category:System|G]] | ||
{{cont}} |
Revision as of 07:22, 7 March 2019
Summary
Package requirement: gps
Sub-menu: /system gps
Standards: GPS, NMEA 0183, Simple Text Output Protocol
Global Positioning System (GPS) is used for determining precise location of a GPS receiver.
Configuration Properties
Property | Description |
---|---|
enabled (yes | no; Default: no) | Whether GPS is enabled |
port (string; Default: ) | Name of the USB/Serial port where GPS receiver is connected |
channel (integer [0..4294967295]; Default: 0) | Port channel used by device |
init-channel (integer [0..4294967295]; Default: ) | Channel for init-string execution |
init-string (string; Default: ) | AT init string for GPS initialization |
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 |
speed (none | string) | Current moving speed of the GPS unit |
bearing (none | string) | The compass direction toward which a GPS is moving |
valid (yes | no) | |
satellites (integer) | Number of satellites seen by the device. |
Note: The time is not stratum 1 as RouterBOARD devices do not have PPS implemented
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 this case port 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)
[admin@MikroTik] /port> set 0 baud-rate=4800 parity=odd [admin@MikroTik] /port> print detail Flags: I - inactive 0 name="usb1" used-by="" channels=1 baud-rate=4800 data-bits=8 parity=odd stop-bits=1 flow-control=none
Enable GPS
[admin@MikroTik] /system gps> set enable=yes port=usb1 [admin@MikroTik] /system gps> print enabled: yes port: usb1 channel: 0 init-channel: 0 init-string: set-system-time: no
Monitor status
[admin@MikroTik] /system gps> monitor date-and-time: jul/02/2015 14:36:08 latitude: N 56 57' 32.262'' longitude: E 24 9' 7.262'' altitude: 36.700001m speed: 0.000000 km/h destination-bearing: none true-bearing: 0.000000 deg. True magnetic-bearing: 0.000000 deg. Mag valid: yes satellites: 7
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.
[ Top | Back to Content ]