LibMISB - Evaluating - Evaluating the library

LibMISB
Introduction
What is LibMISB What does the library do Functionalities supported
Getting Started
How to get the library How to compile
Examples
Library basic usage GStreamer Application
Evaluating
Evaluating the library
Contact Us

This wiki page serves as a guide to testing the evaluation binary provided by RidgeRun.

Features in the Evaluation

To help you test LibMISB, RidgeRun can provide an evaluation version of the library. The following table summarizes the features available in both the professional and evaluation version of the library.

Feature	Professional	Evaluation
Set Debugger level	Y	Y
Set Formatter	Y	Y
Encode	Y	Y
Decode	Y	Y
MISB ST 0601	Y(1)	N(2)
Source Code	Y	N

(1) The supported tags are 1 to 93, except by 48, 73, 74, and 81. The other tags are in development.

(2) This version only has support for the first 10 tags and tag 65.

Requesting the Evaluation Binary

In order to request an evaluation binary for a specific architecture, please contact us providing the following information:

• Platform (i.e.: TX1, TX2, Nano, x86, etc...)
• The output of the command uname -a

Dependencies

Please follow the next link instructions to install dependencies: [How to compile]

Eval Binary Structure

.
└── usr
    ├── bin
    │   ├── misb-converter
    │   └── misb_ST0601_sample.json
    ├── include
    │   └── libmisb-0.0
    │       └── libmisb
    │           ├── eval.hpp
    │           ├── formatter
    │           │   ├── iformatter.hpp
    │           │   └── jsonformatter.hpp
    │           ├── libmisb.hpp
    │           ├── logger.hpp
    │           └── metadata.hpp
    └── lib
        └── aarch64-linux-gnu
            ├── libformatter.so
            ├── libformatter.so.0
            ├── libformatter.so.0.1.0
            ├── libmisb-0.0.so
            ├── libmisb-0.0.so.0
            ├── libmisb-0.0.so.0.1.0
            └── pkgconfig
                └── misb-0.0.pc

Eval Binary Installation

To use the binary provided by RidgeRun, export the location of the evaluation binary libraries in your environment.

export LD_LIBRARY_PATH=${LD_LIBRARY_PATH}:${PATH_TO_EVALUATION_BINARY}/usr/lib/aarch64-linux-gnu/

where PATH_TO_EVALUATION_BINARY is set the location in your file system where you have stored the binary provided by RidgeRun.

Alternatively, you may just copy the binaries into the standard libraries search path as the follow instructions:

sudo cp ${PATH_TO_EVALUATION_BINARY}/usr/lib/aarch64-linux-gnu/* /usr/lib/aarch64-linux-gnu/
sudo cp ${PATH_TO_EVALUATION_BINARY}/usr/include/* /usr/include/* /usr/include/

Eval Binary Testing

Finally, test the library with the resources in the bin directory from the files provided by RidgeRun. Please running:

 ./misb-converter --verbose --encode -i misb_ST0601_sample.json -o klv.bin

with expected output:

 
                                               
        *************************************  
        *** THIS IS AN EVALUATION VERSION ***  
        *************************************  
                                               
                Thanks for evaluating          
                  RidgeRun LibMISB             
                                               
          This version only has support for 
          the first 10 tags. Please contact                       
          <support@ridgerun.com> to purchase   
          the professional version of this     
          framework.                           
                                               
        *************************************  
        *** THIS IS AN EVALUATION VERSION ***  
        *************************************  
                                               
  
WARNING	Skipped: Tag 15 cannot be found
INFO	6 14 43 52 2 11 1 1 14 1 3 1 1 0 0 0 40 2 8 0 4 89 249 174 32 34 168 3 9 77 73 83 83 73 79 78 48 49 4 6 65 70 45 49 48 49 5 2 113 194 65 1 17 1 2 207 90

Another examples to run are the following:

 ./misb-converter --decode -i klv.bin -o output.json

with expected output:

                                               
        *************************************  
        *** THIS IS AN EVALUATION VERSION ***  
        *************************************  
                                               
                Thanks for evaluating          
                  RidgeRun LibMISB             
                                               
          This version only has support for 
          the first 10 tags. Please contact                       
          <support@ridgerun.com> to purchase   
          the professional version of this     
          framework.                           
                                               
        *************************************  
        *** THIS IS AN EVALUATION VERSION ***  
        *************************************  
                                               
  
INFO	Formatted data generated

You will see with that encode method creates klv.bin files with the metadata encoded. Also, with the decode method created output.json with the metadata decoded using json format.