NAME

       tos-set-symbols - set initialized variable values in a binary

SYNOPSIS

       tos-set-symbols [--objcopy=OBJCOPY] [--objdump=OBJDUMP]
                       [--target=TARGET]
                       INPUTFILE OUTPUTFILE [SYMBOL=]VALUE...

       tos-set-symbols --srec [--objcopy=OBJCOPY] [--objdump=OBJDUMP]
                       [--target=TARGET]
                       INPUTFILE OUTPUTFILE [SYMBOL=]VALUE...

       tos-set-symbols --exe [--objcopy=OBJCOPY] [--objdump=OBJDUMP]
                       INPUTFILE OUTPUTFILE [SYMBOL=]VALUE...

       tos-set-symbols --read [--objdump=...] INPUTFILE SYMBOL...

DESCRIPTION

       tos-set-symbols  is  a tool to inspect and modify the initial values of variables in a binary. It is used
       by the TinyOS build system to set a node's ID and AM  address,  for  example,  when  using  install.X  or
       reinstall.X.

       tos-set-symbols  takes  an optional first argument that specifies the format of the binary being modified
       or whether it is only being read.  By default, it acts as  if  --srec  was  passed.  Instead  of  passing
       --srec,  --exe,  the  --target  option  can  be used to specify a target format. This option is passed to
       objcopy. The --objdump and --objcopy options allow you to specify which binary tools to use. By  default,
       tos-set-symbols uses avr-objcopy and avr-objdump.

       The  SYMBOL  parameter  refers  to  a  variable  in the image to modify or print. If the variable is in a
       component, its name is of the  form  component$variable.  If  the  SYMBOL  is  omitted,  it  defaults  to
       TOS_LOCAL_ADDRESS, for compatibility with the TinyOS 1.x set-mode-id tool.

EXAMPLE

       This  reads  in a micaZ .srec file, changes the value of TOS_NODE_ID to 4, and writes out a new binary to
       main.srec.out-4.

         tos-set-symbols build/micaz/main.srec build/micaz/main.srec.out-4 \
         TOS_NODE_ID=4

       This reads in a Telos .srec file, changes the value of TOS_NODE_ID and ActiveMessageAddressC$addr  to  3,
       and  writes  out  a new binary to main.srec.out-3. It uses the msp430, rather than the avr, binary tools,
       and outputs an ihex format executable.

         tos-set-symbols --objcopy=msp430-objcopy --objdump=msp430-objdump \
         --target=ihex build/telosa/main.ihex build/telosa/main.ihex.out-3 \
         TOS_NODE_ID=3 ActiveMessageAddressC$addr=3

                                                   Feb 2, 2006                                tos-set-symbols(1)