Skip to main content

Mnemonics Database

We store our mnemonic defintions within a flat tab delimited plain text format. The format has evolved over time to support required functionality.

The first row contains the header. The header defines the columns contents. The columns can be in any order.

Each row defines a single mnemonic and is uniquely identified by the DATA_ID. DATA_ID is also often refered to as Housekeeping ID or HKID for shorthand.

If required, the column must exist but row values may still be empty. Empty values will be default initialized.

Column Type Description Required Empty Allowed Default Value
SUB_SYSTEM String The subsystem. May be empty. Ex: CDH Yes Yes Empty String
NAME String The mnemonic's name. Ex: PowerSupplyCurrent Yes No
DESCRIPTION String The mnemonic's description Yes Yes Empty String
ADC_# Integer The ADC channel No Yes 0
DATA_ID Integer The unique ID Yes No
PACKET_TYPE Integer The packet type or CCSDS Application ID Yes No
PACKET_SUBTYPE Integer Packet subtype No Yes 0
PACKET_NAME String The name of the packet the mnemonic belongs to No Yes Empty String
APPLY_WHEN String Apply when condition of the format: HKID=RANGE. No Yes No apply when conditions
DECODE_TYPE Integer The decoder type Yes No
DECODE_ID1 Integer Decode ID 1 Yes No
DECODE_ID2 Integer Decode ID 2 Yes No
DECODE_ID3 Integer Decode ID 3 Yes No
DECODE_ID4 Integer Decode ID 4 Yes No
CLOCK String The clock's name No Yes Empty String
RAW_FMT String The raw format Yes No
ENG_FMT String The string formatting when engineering conversion is appliedYes No
ENG_EQ_TYPE Integer The type of conversion to apply to the raw valueYes No
ENG_K1 Double Eng Coefficient 1Yes No
ENG_K2 Double Eng Coefficient 2Yes No
SCI_UNITS String The science unitsYes Yes
SCI_FMT String The string formatting when science conversion is appliedYes No
SCI_EQ_TYPE Integer The type of conversion to applyYes No
SCI_FROM_ENG bool If true, the engineering conversion will be applied before applying the science conversionYes No
SCI_K1 Double Science Coefficient 1Yes No
SCI_K2 Double Science Coefficient 2Yes No
SCI_K3 Double Science Coefficient 3Yes No
SCI_K4 Double Science Coefficient 4Yes No
SCI_K5 Double Science Coefficient 5Yes No
SCI_K6 Double Science Coefficient 6Yes No
SCI_K7 Double Science Coefficeint 7Yes No
SCI_K8 Double Science Coefficient 8Yes No
MUX_CH Integer The corresponding mux channel for this mnemonicNo Yes
LIMIT_TYPE_1 Integer Bit pattern defining the limit configurationNo Yes
YELLOW_LIMIT_1 Double The yellow limit valueNo Yes
RED_LIMIT_1 Double The red limit valueNo Yes
LIMIT_TYPE_2 Integer Bit pattern defining the limit configurationNo Yes
YELLOW_LIMIT_2 Double The yellow limit valueNo Yes
RED_LIMIT_2 Double The red limit valueNo Yes
LIMITS JSON The limit set definitionNo Yes
EXTRA_1 String Used for various purposes depending on the SCI_EQ_TYPENo Yes
XINA_MINE_TYPE Integer The XINA mining modeNo Yes
XINA_MINE_RAW bool Whether or not to mine the RAW valuesNo Yes
XINA_MINE_ENG bool Whether or not to mine the ENG valuesNo Yes
DISCRETE_LABELS String Maps a value to stringNo Yes
BUNDLE_ID Integer The XINA bundle IDNo Yes