NAME¶
tos-decode-flid - Turn a base-4 Safe TinyOS error code into a human-readable
error message
SYNOPSIS¶
tos-decode-flid flid-file flid
DESCRIPTION¶
By default, a mote that encounters a safety violation repeatedly blinks a
failure code (also called flid, or fault-location identifier) on its LEDs.
tos-decode-flid can be used to turn this code into a readable error
message.
A flid is a sequence of 8 digits each in the range 0-3. To read this code, wait
for the mote's LEDs to "roll," or rapidly blink several times in a
1-2-3 sequence. Next, some number of LEDs will be lit-- write down this
number. Usually the first digit or two of the flid will be zero. Following
each digit of the flid, all three LEDs will be very briefly illuminated to
serve as a separator. After all 8 digits have been presented the LEDs will
roll and then the FLID is repeated. Once you have the sequence of 8 digits, it
can be decoded using tos-decode-flid.
The flid-file argument specifies a file that helps the script map from the flid
to an error message. The flid file is create as a side effect of compiling a
safe application; it is placed into the application's build directory and is
named flids.txt.