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
Index of /wp-content/uploads/2024/07
File Info : application/pdf, 13 Pages, 1.11MB
DocumentDocumentHOW-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