Skip to content

intrig/xenon

Repository files navigation

The Intrig Message Decoder

1. Introduction

Intrig Xenon provides flexible, powerful and easy to use C++ API for decoding protocol messages.

Originally developed for 3G and 4G programmers and test engineers to decode their complex messages, the xenon decoder has evolved into a general purpose open source tool with an ever expanding protocol support base.

And, using XDDL, you can support your own proprietary message formats.

See xenon in action for yourself using the Intrig online decoder: intrig.com.

1.1. Quick Start

1.1.1. Building on Mac and Linux

From a terminal, issue the following commands:

git clone --recursive https://github.com/intrig/xenon.git
cd xenon
make
make test
sudo make install

1.1.2. Building on Windows

Windows requires the following steps:

  1. Install Github Desktop

  2. Clone the xenon repo as above.

  3. Install meson

Follow the instructions in the above link to have meson generate the Visual Studio build files.

1.2. Dependencies

  • meson

  • C++17 or later compiler

  • Github desktop (for Windows only)

2. Using Xenon

Link with the libxenon.so library, found in /usr/local/lib/x86_64-linux-gnu/libxenon.so on Ubuntu.

The header files are found in /usr/local/include/xenon.

The XDDL data files are found in /usr/local/share/xddl.

See the xenon/examples directory for some common uses of the decoder.

If you want to parse your own custom protocols, then the XDDL Reference is a complete reference containing useful examples.

Also, the tools directory contains useful examples, such as idm and xv. These two programs are installed into /usr/local/bin.

Enjoy!