1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
|
.TH tos-set-symbols 1 "Feb 2, 2006"
.SH NAME
tos-set-symbols - set initialized variable values in a binary
.SH SYNOPSIS
\fBtos-set-symbols\fR [\fB--objcopy=\fR\fIOBJCOPY\fR] [\fB--objdump=\fR\fIOBJDUMP\fR]
[\fB--target=\fR\fITARGET\fR]
\fIINPUTFILE\fR \fIOUTPUTFILE\fR [\fISYMBOL\fR=]VALUE...
\fBtos-set-symbols\fR --srec [\fB--objcopy=\fR\fIOBJCOPY\fR] [\fB--objdump=\fR\fIOBJDUMP\fR]
[\fB--target=\fR\fITARGET\fR]
\fIINPUTFILE\fR \fIOUTPUTFILE\fR [\fISYMBOL\fR=]VALUE...
\fBtos-set-symbols\fR --exe [\fB--objcopy=\fR\fIOBJCOPY\fR] [\fB--objdump=\fR\fIOBJDUMP\fR]
\fIINPUTFILE\fR \fIOUTPUTFILE\fR [\fISYMBOL\fR=]VALUE...
\fBtos-set-symbols\fR --read [\fB--objdump=\fR...] \fIINPUTFILE\fR \fISYMBOL\fR...
.SH DESCRIPTION
\fBtos-set-symbols\fR 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 \fBinstall.X\fR or
\fBreinstall.X\fR.
\fBtos-set-symbols\fI 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 \fB--srec\fR was passed. Instead of passing
\fB--srec\fR, \fB--exe\fR, the \fB--target\fR option can be used to
specify a target format. This option is passed to objcopy. The \fB--objdump\fR
and \fB--objcopy\fR options allow you to specify which binary tools
to use. By default, \fBtos-set-symbols\fR uses \fBavr-objcopy\fR and
\fBavr-objdump\fR.
The \fISYMBOL\fR 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 \fIcomponent\fR$\fIvariable\fR. If the \fISYMBOL\fR is
omitted, it defaults to \fBTOS_LOCAL_ADDRESS\fR, for compatibility
with the TinyOS 1.x \fBset-mode-id\fR tool.
.SH 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
|
