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
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
|
#
# avarice - The "avarice" program.
# Copyright (C) 2001, 2003 Scott Finneran
#
# This program is free software; you can redistribute it and/or modify
# it under the terms of the GNU General Public License as published by
# the Free Software Foundation; either version 2 of the License, or
# (at your option) any later version.
#
# This program is distributed in the hope that it will be useful,
# but WITHOUT ANY WARRANTY; without even the implied warranty of
# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
# GNU General Public License for more details.
#
# You should have received a copy of the GNU General Public License
# along with this program; if not, write to the Free Software
# Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111, USA.
#
# doc/running.txt
#
NOTE: This file is _really_ old and hasn't been kept up to date. Start avarice
with the --help option to get the current list of options.
Using AVaRICE:
--------------
> bin/avarice
avrjtagd version 1.0.D084, Nov 12 2001 14:47:08
Usage: bl/bin/avarice [OPTION]... <host-name> <port>
Options:
-d, --debug Enable printing of debug information
-f, --file <filename> Download specified file prior to debugging
-j, --jtag <devname> Port attached to JTAG box (default: /dev/avrjtag)
Required info:
<host-name> : This is the name of the machine attached to the JTAG box.
<port> : This is a unique spare IP port number on that machine.
e.g. bl/bin/avarice --file test.bin --jtag /dev/ttyS0 localhost 4242
Hints/notes:
- The default jtag port is /dev/avrjtag. Rather than enter a serial port
every time, why not add a symlink.
eg. ln -s /dev/ttyS0 /dev/avrjtag
- VERY IMPORTANT: the file specified on the avarice command line needs
to be a BINARY FILE (ie not the elf object file loaded into gdb). This
can be easily created from the elf file using avr-objcopy.
Up and Running with avr-gdb:
----------------------------
1. Apply the standard avr patch to avr-gdb and compile away!
I used the standard distro of gdb (http://sources.redhat.com/gdb/)
and patched it with:
(http://www.amelek.gda.pl/avr/gdb/gdb-5.0-avr-patch-0.1.gz)
note: This patch has a minor problem which breaks the "info registers"
command. To fix this, edit gdb/config/avr/tm-avr.h:314 to read:
#undef GET_SAVED_REGISTER
note: Ted Roth (troth@verinet.com) has identified a LARGE number of
problems with the above patch to gdb. He is currently working on a
series of fixes. Snapshots of his latest work can be found at:
(http://freesoftware.fsf.org/download/simulavr/gdb-patches/)
I would recommend using these over the original patches for
now. Feedback would be helpful or better still, lend Ted a hand!
2. Once installed, run avr-gdb and load in your final avr-elf file. The
simplest way is of course:
avr-gdb target.elf
note: Step 3 really is not needed with my latest patches. Also, don't count on
.avrgdbinit being around in the future due to changes in gdb's design
for 5.2. Just use .gdbinit in the working directory, not
~/.gdbinit or ~/.avrgddinit. TRoth 14 Feb 2002
3. AVR-GDB will need the following config items set (ie enter the following cmds):
set remoteaddresssize 32
set remote Z-packet enable
There are a few ways to do this:
- Enter them manually when you start avr-gdb
- Dump these commands into a text file and run avr-gdb with the -x option.
- Dump these commands into ~/.gdbinit.
Note: chances are that your hosts' version of gdb also uses the same
filename for its config. Probably best not to get the two confused.
That said, thanks to Ted Roth for suggesting the following:
In the sources for GDB, add the following 2 lines to gdb/config/avr/tm-avr.h
/* Rename .gdbinit to aid in debugging. */
#define GDBINIT_FILENAME ".avrgdbinit"
This gives avr-gdb a unique config filename.
He has also submitted an example .avrgdbinit file:
echo loading demo.elf\n
file demo.elf
echo Setting remote addr size to 32\n
set remoteaddresssize 32
echo Connecting to remote target\n
target remote localhost:1212
echo Downloading program to target\n
load
Please note, at this time, avarice does not support GDB's load
command. It is on the todo list.
4. Run avarice (refer above):
5. Enter the following command:
target remote HOST:PORT e.g. target remote localhost:4242
The HOST:PORT need to match the values entered on the avarice command
line for <host-name> <port> (refer above).
6. Something along these lines should greet you:
GNU gdb 5.0
Copyright 2000 Free Software Foundation, Inc.
GDB is free software, covered by the GNU General Public License, and you are
welcome to change it and/or distribute copies of it under certain conditions.
Type "show copying" to see the conditions.
There is absolutely no warranty for GDB. Type "show warranty" for details.
This GDB was configured as "--host=i686-pc-linux-gnu --target=avr"...
(gdb) target remote localhost:4242
Remote debugging using localhost:4242
0x0 in .__start_of_init__ ()
7. The normal gdb "run" command doesn't seem to have that much meaning
here (read the gdb doco with reference to the remote debug
protocol). As such, use the "continue" command to kick off your
program.
|
