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.
Support for 5G is underway. See progress at #44
And, using XDDL, you can support your own proprietary message formats.
See xenon in action for yourself using the Intrig online decoder: SMS Message
Xenon is a CMake based project. It builds on Linux, MacOS, and Windows.
A Makefile is provided for convenience only and can be used on MacOS and Linux.
git clone --recurse-submodules http://github.com/intrig/xenon.git cd xenon cmake -B build -S . -GNinja -DCMAKE_BUILD_TYPE=Release cmake --build build cmake --install build -v
For MacOS you can also use -Gxcode in the above cmake command to make an xcode
project in the xcode subdirectory.
Windows requires the following steps:
-
Clone the xenon repo as above.
-
Using a recent version of Visual Studio, select menu item "File/Open/Folder…" and select the top level xenon directory.
-
Select menu item "Build/Build All"
-
Select menu item "Test/Run CTests" for xenon
This currently builds a static libary.
Link with the libxenon.so library, found in:
-
/usr/local/lib//libxenon.soon Linux, -
/usr/local/lib/libxenon.dylibon MacOS. -
C:\Program Files (x86)\xenon\lib\xenon.libon Windows.
Header files:
-
/usr/local/include/xenonon MacOS and Linux, -
C:\Program Files (x86)\xenon\include\xenonon Windows.
The XDDL data files:
-
/usr/local/share/xddlon MacOS and Linux, -
C:\Program Files (x86)\xenon\share\xddlon Windows.
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 xenon-dm and
xenon-xv.
These two programs are installed into /usr/local/bin.
asnx converts asn.1 PER files to xddl. It handles a subset of the asn.1 spec.
If there any problems please submit an issue.
For 3GPP specs, e.g. 36.331:
-
Download the latest pdf spec.
-
Save it to text file, e.g. 36.331.txt.
Ubuntu the pdftotext command can be used, for example:
pdftotext -nopgbrk -layout ts_136331v150700p.pdf 36.331.txt -
Run: asn-strip -m 36.331.txt > 36.331.asn
-
Run: asnx -o TS-36.331.xddl -t 36.331.asn
Edit 36.331.asn by hand. Some of the lines may have been broken at '-' characters. Fix the errors by hand and run the above step repeatedly until you fixed the errors.
-
Add resulting xddl file to git.
Enjoy!