readme.txt

一个非常好的人工智能开发工具开源软件

/***
 *** See the file "L2_RTI_EO1/disclaimers-and-notices-L2.txt" for 
 *** information on usage and redistribution of this file, 
 *** and for a DISCLAIMER OF ALL WARRANTIES.
 ***/
XFTo build the Decoder:
- rm apiGen printName
- make -f apiGen.make
- ./apiGen EO1
- make -f decoder.make 


To execute:
- put EO1/eo1-l2/RTI/tools into your path
- decodeTelemetry 
- decodeL2script

Note:
There is an issue involved in the encoding/decoding. There are two
separate programs which will both output a file called enumapi.h. One 
file contains the mapping from enumerated types into integers, useful for 
other applications to send data to L2 as integers. The other version 
contains the mapping from integers to strings, useful for decoding log
files. Both are needed for running L2 on EO1, but are generated in two 
separate steps. It would be "nice" to unify them, but we don't presently 
have the time to do that. 

The program mba/cpp/bin/api_gen, located in the L2 source directory,
outputs the first type of enumapi.h file.  Monitors will use this mapping
to send the observations and commands to L2 in the form of integers.  
A sample of the output is below:

/*
 * automatically generated on Mon Nov  8 15:21:41 2004
 * from EO1
 * by api_gen version 2.7.7 (released 2003-11-19 15:37)
 */

#ifndef _ENUMAPI_H_
#define _ENUMAPI_H_


/*  CONSTANTS */
enum enumapi_constants {
  VARIABLE_COUNT = 61
};


/*  OBSERVATIONS */
enum observable_types {
    test_ali_IHSKP_DATAGATE = 59,
    test_ali_IHSKP_LEDSTAT09 = 58,
    test_ali_IHSKP_LEDSTAT08 = 57,
    test_ali_IHSKP_MTR_PWR = 56,
    test_ali_IHSKP_OPERPWRA = 55,
    test_warp_BTLCRSNMOD = 23,
    test_warp_WRMWMODE = 22,
    test_hyperion_YCOVRPOS = 12,
    test_hyperion_YIMAGE_MODE = 11,
    NUM_observable_types=9
};


/*  OBSERVATION TYPES */
enum test_ali_IHSKP_DATAGATE_values {
    test_ali_IHSKP_DATAGATE_DISABLED=0,
    test_ali_IHSKP_DATAGATE_ENABLED=1
};


The program apiGen outputs the second version of enumapi.h, used to decode
log files and also by the telemetry RDL. The source is apiGen.cpp, in this 
directory. A sample of the output follows:

/*
 * automatically generated on Tue Nov  9 13:58:36 2004
 * by pitex_api_gen version 
 */

#define NUMBER_OF_L2VARS 61
#define NUMBER_OF_QVALS 10


/*  Initial definitions */
typedef struct {
   char variable_name_primary[150];
   char variable_values_primary[10][100];
   char variable_name_secondary[150];
   char variable_values_secondary[10][100];
   } L2_var_complex;
L2_var_complex L2_model[61] = {
{
{"test.ali.mechanismPowerSensor.actualValue"},
{
{"DISABLED"},
{"ENABLED"},
},
{},{},
},