User Guide for ACKSYS models including: APNUS026-4, HWTO-NMEA, APNUS026 How to Get GNSS NMEA Data, APNUS026, How to Get GNSS NMEA Data, GNSS NMEA Data, NMEA Data

ACKSYS How To Get GNSS NMEA Data V1.0

kodjovi.attisso@acksys.fr

HOWTO Get-GNSS-NMEA-..>

Index of /wp-content/uploads/2024/07


File Info : application/pdf, 13 Pages, 1.11MB

PDF preview unavailable. Download the PDF instead.

HOWTO Get-GNSS-NMEA-data APNUS026-4
HOW-TO
APNUS026 How to Get GNSS NMEA Data
Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

HOW-TO | HWTO- NMEA
Content
1. Glossary ..................................................................................................................................................................... 3 2. Introduction ............................................................................................................................................................... 3 3. Scenario details ........................................................................................................................................................ 3 4. Installation Overview and Prerequesites ........................................................................................................... 3 5. GNSS System types ................................................................................................................................................ 4 6. GNSS Configuration architecture ........................................................................................................................ 4 7. ACKSYS Router configuration ............................................................................................................................. 5
Configuring WAN Interface ............................................................................................................................................... 5 Configuring WIFI Interface ................................................................................................................................................ 6 Configuring LAN Interface ................................................................................................................................................. 7 Configuring GNSS Agent .................................................................................................................................................... 8 Configuring WaveManager to access GNSS POSITION via Telemetry................................................................................ 9 8. STATUS.....................................................................................................................................................................10 WAN Router Wireless: Status ......................................................................................................................................... 10 WAN Router: Network Status..........................................................................................................................................10 WAN Router: Network Testing ........................................................................................................................................ 11 9. GNSS DATA COLLECT ......................................................................................................................................... 11 WAN Router: CLI GNSS .................................................................................................................................................... 11 Configuring MIB Browser to access GNSS NMEA Data via SNMP .................................................................................... 12 WAN Router: GNSS Status ............................................................................................................................................... 13 WaveManager: GNSS Status............................................................................................................................................13

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

2

HOW-TO | HWTO- NMEA
1. Glossary
GPS : Global Positioning System GPS is the generic term used to describe the satellite-based timing and positioning system operated by the United States Department of Defense (DoD), Galileo (European), GLONASS (Russian) and Beidou (Chinese). NMEA: National Marine & Electronics Association GNSS: Global Navigation Satellite System SNMP: Simple Network Management Protocol
2. Introduction
By installing GPS devices as Acksys router on fleet vehicles or buses, fleet managers can track their trucks or buses' locations and statuses, as well as get important insights about their fleet's efficiency. Fleet managers use GPS on a daily basis to keep track of their fleets and other assets. They can get information that helps them solve issues such as compliance, efficiency, and safety reason why Commercial fleets often use GPS to monitor their fleet vehicles.
3. Scenario details
Some models from the Acksys Router family (RailBox, AirWan, AirBox, etc..) have embedded an internal GPS module. This means that besides Cellular router conventional tasks (giving Internet connectivity to connected devices), they can also perform additional tasks with the GPS location. First defined by the National Marine Electronics Association, NMEA is currently the most common data format supported by GNSS equipment. It allows connecting different types of hardware and software
4. Installation Overview and Prerequesites
Before we begin, let's overview the configuration that we are attempting to achieve and the prerequisites that make it possible in this How-To note :
· GPS Server: One Cellular AirBox router or any type of Acksys Cellular Router · Connect GPS antenna on the GPS connector · A valid SIM card from an ISP · A GPS NMEA frame Receiver Client : WaveManager or any type of GPS received Server · Laptop to configure the router

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

3

HOW-TO | HWTO- NMEA
5. GNSS System types
There are different type of GNSS system in the world and the GNSS component embedded with Acksys Cellular router automatically can track position of the four existing satellite systems, GPS (American), Galileo (European) GLONASS (Russian), Beidou (Chinese) The purpose of GNSS system is to provide signals from space and transmit timing and positioning data to the GNSS receivers located on Earth. The receivers further use these data to determine your precise location.
6. GNSS Configuration architecture
In this How-To, we will explain in detail how to access directly the Acksys router's internal GPS NMEA data from an external GPS client.
ACKSYS ROUTER WITH GNSS MODULE 
WaveManager or Any other GPS client

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

4

HOW-TO | HWTO- NMEA
7. ACKSYS Router configuration
We may need the Acksys Cellular router to have a server prepared to the event of an external client receiver, so the GPS NMEA data is sent through it. For this configuration it will be enough to specify In this note, the WIFI interface will not be configured but we will use the default LAN setting and configure WAN Cellular interface.
Configuring WAN Interface If you have familiarized yourself with the configuration scheme and we can start configuring the router using instructions provided in this section:
in GUI and go to Setup  Physical Interfaces  Enable the WAN Interface.
· Click the "Edit" button located to the right and configure WAN Interface. · General Setup · Select IPv6 in IP family · Check Replace default route · Set 0 as routing metric 0 for default gateway · Check Use peer DNS in case DNS is on the LAN to use the ISP DNS · Save

· Select the correct SIM slot (in case of dual SIM) and fill out APN with the connection information provided by the ISP (in this case sfr SIM card is used): sl2sfr

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

5

HOW-TO | HWTO- NMEA
· Enable AT transactions logs for better understanding in troubleshoot in case of issue. · Save and apply the config
· Save and apply the config To check NMEA frame in CLI, we need to enable Cellular Log Level to Debug for more GNSS information in log. Go in Tools Logs Setting Cellular  Log Setting
· Save and apply the config
Configuring WIFI Interface In this note, the WIFI interface will not be enabled or used.

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

6

HOW-TO | HWTO- NMEA
Configuring LAN Interface In this note, we will use the default IP address of the router 192.168.1.253 in this section: Go in GUI and go to Setup  Physical Interfaces  LAN setting Interface.

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

7

HOW-TO | HWTO- NMEA
Configuring GNSS Agent If you have familiarized yourself with the configuration scheme and have all of the device in order, we can start configuring the router using instructions provided in this section:
· Login to the router's WebUI and go to Setup  ServicesGNSS Agent. Do this on the router:

Enable Allow use of the location service.
Serve external clients Allow devices outside of the product to query its position using the gpsd protocol. If disabled, the position can still be queried with SNMP, displayed on the StatusDevice Information page, or logged to an external log server.
Listen port Change TCP server port for external clients :2947
Position logging period Periodically add an entry in the system log indicating current position:4
URI for map link
The current position that appears on the StatusDevice Information page is embedded in a web link, allowing for example to display a map using external services. Here you can choose among renown public services, or set up a link to your preferred web server. To disable the link entirely, choose custom and enter a dash or a hash mark (anything but a column). If the string %1 appears in the link, it will be replaced with the latitude, and %2 will be replaced with the longitude.

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

8

HOW-TO | HWTO- NMEA
It is also possible to retrieve NMEA Data in local or on a remote GNSS Client as receiver if you want to read NMEA DATA on another device. Login to the router's WebUI and go to Setup  Services  Statistic. Do this on the router:
· Enable GPS statistic · GPS server IP address :127.0.0.1 · GPS server port: 2947 · Save and apply
NOTE: GPS Server IP address 127.0.0.1 because the Acksys cellular router provides GPS service and the Telelemetry service is used in order to send logs to WaveManager Server in this note.
Configuring WaveManager to access GNSS POSITION via Telemetry
In this note, we will also use WaveManager Server to receive GNSS position therefore we will enable Telemetry service. To enable Telemetry service on WaveManager in Setting Data Collect  Operational enable Data Collect Save

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

9

HOW-TO | HWTO- NMEA
8. STATUS
If you've followed all the steps presented above, your configuration should be finished and let have an overview on status of the Cellular and GNSS. WAN Router Wireless: Status
In GUI and go to Status  Cellular
WAN Router: Network Status To verify the connection, click in Status>Network as shown in the screenshot below where the WAN interface receive Internet IP address. In GUI and go to Status  Network

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

10

HOW-TO | HWTO- NMEA
WAN Router: Network Testing GNSS Agent can show position only if the WAN router get internet therefore we do network connectivity test with ping on google DNS works with success as shown the screenshot below:

9. GNSS DATA COLLECT
WAN Router: CLI GNSS To verify the NMEA data, we can enable SSH service in Tools Service enable SSH with the command logfile after enable GNSS log level to Debug.
Once you have configured the router, if you connect in CLI on the AirBox router IP, we will get the NMEA data in real time, 1 data per 4 second according to my configuration as shown in the screenshot below:

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

11

HOW-TO | HWTO- NMEA
Configuring MIB Browser to access GNSS NMEA Data via SNMP
Positioning information can also be read directly via SNMP on any MIB Browser and on any remote Management system by using OIDS from Acksys MIB from the gnss-current-position table as shown in the screenshot below.

The string displayed in the system log and the string obtained through the `gnssAllPositions' SNMP OID have the same format. It consists in a series of column-separated values in the following order:

Valid flag Dimension Date Time
Latitude Longitude Altitude

1 if position is undefined, 2 if the following data is valid 2 if only latitude/longitude are known, 3 if elevation (altitude) is also valid, 0 or 1 if position unknown Last fix date. YYMMDD (year, month, day) or empty if invalid Last fix time. If time is available: HHMMSS.ddd (hour, minute, second, dot, milliseconds). If time is unavailable: ssssssssss (integer number of seconds since 1/1/1970) as known to the product. Always greater than 1000000.
±DD.dddddd degrees from equator, 6 decimal places, a minus sign means south of equator ±DD.dddddd degrees from Greenwich, 6 decimal places, a minus sign means west of Greenwich HHH.hhhhhh Height above mean see level, in meters

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

12

HOW-TO | HWTO- NMEA

Speed Direction

kkk.vvvvvv Horizontal displacement speed in kilometers per hour, 6 decimal places DDD.dddddd degrees from true north, 6 decimal places, DDD ranges from 0 to 359

WAN Router: GNSS Status
You can retrieve the current position Via GUI in on "Device Information" page as shown in the screenshot below Status

WaveManager: GNSS Status
We can retrieve the current position Via WaveManager on "Device Information" page (Latitude and Longitude) as shown in the screenshot below where.

Email : support@acksys.fr

Copyright © 2023 ACKSYS Communications & Systems. All rights reserved.

13



References

GPL Ghostscript 9.55.0