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.

                                           Jun 30, 2008                        tos-decode-flid(1)