Usage

EDIE provides different classes for interfacing with messages, each at a different level of the decoder stack. The main use-case of EDIE is to transform the data from one format into another. Documentation on the three NovAtel formats can be found on the OEM7 Receiver User Documentation portal at: ASCII, Abbreviated ASCII, and Binary. Flattened binary is a format unique to EDIE that standardizes the Binary format to have consistent-length arrays. So variable-length arrays are converted into fixed-size arrays. Flattened binary covers all formats (ASCII, abbreviated ASCII, and Binary).

User

Task

Purpose

Format

Example

Person

Human-readable

To make the data understandable to people

ASCII/Abbreviated ASCII

Finding the timestamp of a BESTPOS message

Programmer

Program-accessible

To make the data accessible from a programming language

Flattened Binary

Filtering a log file for BESTPOS messages

Computer

Machine-readable

To have efficient transmission and storage of the data

Binary

Efficient long-term storage of logs

Flowchart

Use the following flowchart to determine which EDIE class you need.

Notes

  • The MessageDecoder and Encoder class output and input the EDIE intermediate format and not ASCII/Binary.

  • The RXCONFIG and RANGECMP* messages are handled in different classes because of their unique traits.

  • The FileParser and Parser classes automatically filter and decode RXCONFIG and RANGECMP messages. So the RxConfigHandler and RangeDecompressor classes should only be used when bypassing the Parser class.

  • The Parser class can handle any byte stream such as a file stream, serial, Ethernet, or USB.