/* S-record download support for GDB, the GNU debugger.
|
/* S-record download support for GDB, the GNU debugger.
|
Copyright 1995, 1996, 1997 Free Software Foundation, Inc.
|
Copyright 1995, 1996, 1997 Free Software Foundation, Inc.
|
|
|
This file is part of GDB.
|
This file is part of GDB.
|
|
|
This program is free software; you can redistribute it and/or modify
|
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
|
it under the terms of the GNU General Public License as published by
|
the Free Software Foundation; either version 2 of the License, or
|
the Free Software Foundation; either version 2 of the License, or
|
(at your option) any later version.
|
(at your option) any later version.
|
|
|
This program is distributed in the hope that it will be useful,
|
This program is distributed in the hope that it will be useful,
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
GNU General Public License for more details.
|
GNU General Public License for more details.
|
|
|
You should have received a copy of the GNU General Public License
|
You should have received a copy of the GNU General Public License
|
along with this program; if not, write to the Free Software
|
along with this program; if not, write to the Free Software
|
Foundation, Inc., 59 Temple Place - Suite 330,
|
Foundation, Inc., 59 Temple Place - Suite 330,
|
Boston, MA 02111-1307, USA. */
|
Boston, MA 02111-1307, USA. */
|
|
|
#include "defs.h"
|
#include "defs.h"
|
#include "serial.h"
|
#include "serial.h"
|
#include "srec.h"
|
#include "srec.h"
|
#include <time.h>
|
#include <time.h>
|
|
|
extern void report_transfer_performance PARAMS ((unsigned long, time_t, time_t));
|
extern void report_transfer_performance PARAMS ((unsigned long, time_t, time_t));
|
|
|
extern int remote_debug;
|
extern int remote_debug;
|
|
|
static int make_srec PARAMS ((char *srec, CORE_ADDR targ_addr, bfd * abfd,
|
static int make_srec PARAMS ((char *srec, CORE_ADDR targ_addr, bfd * abfd,
|
asection * sect, int sectoff, int *maxrecsize,
|
asection * sect, int sectoff, int *maxrecsize,
|
int flags));
|
int flags));
|
|
|
/* Download an executable by converting it to S records. DESC is a
|
/* Download an executable by converting it to S records. DESC is a
|
serial_t to send the data to. FILE is the name of the file to be
|
serial_t to send the data to. FILE is the name of the file to be
|
loaded. LOAD_OFFSET is the offset into memory to load data into.
|
loaded. LOAD_OFFSET is the offset into memory to load data into.
|
It is usually specified by the user and is useful with the a.out
|
It is usually specified by the user and is useful with the a.out
|
file format. MAXRECSIZE is the length in chars of the largest
|
file format. MAXRECSIZE is the length in chars of the largest
|
S-record the host can accomodate. This is measured from the
|
S-record the host can accomodate. This is measured from the
|
starting `S' to the last char of the checksum. FLAGS is various
|
starting `S' to the last char of the checksum. FLAGS is various
|
random flags, and HASHMARK is non-zero to cause a `#' to be
|
random flags, and HASHMARK is non-zero to cause a `#' to be
|
printed out for each record loaded. WAITACK, if non-NULL, is a
|
printed out for each record loaded. WAITACK, if non-NULL, is a
|
function that waits for an acknowledgement after each S-record,
|
function that waits for an acknowledgement after each S-record,
|
and returns non-zero if the ack is read correctly. */
|
and returns non-zero if the ack is read correctly. */
|
|
|
void
|
void
|
load_srec (desc, file, load_offset, maxrecsize, flags, hashmark, waitack)
|
load_srec (desc, file, load_offset, maxrecsize, flags, hashmark, waitack)
|
serial_t desc;
|
serial_t desc;
|
const char *file;
|
const char *file;
|
bfd_vma load_offset;
|
bfd_vma load_offset;
|
int maxrecsize;
|
int maxrecsize;
|
int flags;
|
int flags;
|
int hashmark;
|
int hashmark;
|
int (*waitack) PARAMS ((void));
|
int (*waitack) PARAMS ((void));
|
{
|
{
|
bfd *abfd;
|
bfd *abfd;
|
asection *s;
|
asection *s;
|
char *srec;
|
char *srec;
|
int i;
|
int i;
|
int reclen;
|
int reclen;
|
time_t start_time, end_time;
|
time_t start_time, end_time;
|
unsigned long data_count = 0;
|
unsigned long data_count = 0;
|
|
|
srec = (char *) alloca (maxrecsize + 1);
|
srec = (char *) alloca (maxrecsize + 1);
|
|
|
abfd = bfd_openr (file, 0);
|
abfd = bfd_openr (file, 0);
|
if (!abfd)
|
if (!abfd)
|
{
|
{
|
printf_filtered ("Unable to open file %s\n", file);
|
printf_filtered ("Unable to open file %s\n", file);
|
return;
|
return;
|
}
|
}
|
|
|
if (bfd_check_format (abfd, bfd_object) == 0)
|
if (bfd_check_format (abfd, bfd_object) == 0)
|
{
|
{
|
printf_filtered ("File is not an object file\n");
|
printf_filtered ("File is not an object file\n");
|
return;
|
return;
|
}
|
}
|
|
|
start_time = time (NULL);
|
start_time = time (NULL);
|
|
|
/* Write a type 0 header record. no data for a type 0, and there
|
/* Write a type 0 header record. no data for a type 0, and there
|
is no data, so len is 0. */
|
is no data, so len is 0. */
|
|
|
reclen = maxrecsize;
|
reclen = maxrecsize;
|
make_srec (srec, 0, NULL, (asection *) 1, 0, &reclen, flags);
|
make_srec (srec, 0, NULL, (asection *) 1, 0, &reclen, flags);
|
if (remote_debug)
|
if (remote_debug)
|
{
|
{
|
srec[reclen] = '\0';
|
srec[reclen] = '\0';
|
puts_debug ("sent -->", srec, "<--");
|
puts_debug ("sent -->", srec, "<--");
|
}
|
}
|
SERIAL_WRITE (desc, srec, reclen);
|
SERIAL_WRITE (desc, srec, reclen);
|
|
|
for (s = abfd->sections; s; s = s->next)
|
for (s = abfd->sections; s; s = s->next)
|
if (s->flags & SEC_LOAD)
|
if (s->flags & SEC_LOAD)
|
{
|
{
|
int numbytes;
|
int numbytes;
|
bfd_vma addr = bfd_get_section_vma (abfd, s) + load_offset;
|
bfd_vma addr = bfd_get_section_vma (abfd, s) + load_offset;
|
bfd_size_type size = bfd_get_section_size_before_reloc (s);
|
bfd_size_type size = bfd_get_section_size_before_reloc (s);
|
char *section_name = (char *) bfd_get_section_name (abfd, s);
|
char *section_name = (char *) bfd_get_section_name (abfd, s);
|
/* Both GDB and BFD have mechanisms for printing addresses.
|
/* Both GDB and BFD have mechanisms for printing addresses.
|
In the below, GDB's is used so that the address is
|
In the below, GDB's is used so that the address is
|
consistent with the rest of GDB. BFD's printf_vma() could
|
consistent with the rest of GDB. BFD's printf_vma() could
|
have also been used. cagney 1999-09-01 */
|
have also been used. cagney 1999-09-01 */
|
printf_filtered ("%s\t: 0x%s .. 0x%s ",
|
printf_filtered ("%s\t: 0x%s .. 0x%s ",
|
section_name,
|
section_name,
|
paddr (addr),
|
paddr (addr),
|
paddr (addr + size));
|
paddr (addr + size));
|
gdb_flush (gdb_stdout);
|
gdb_flush (gdb_stdout);
|
|
|
data_count += size;
|
data_count += size;
|
|
|
for (i = 0; i < size; i += numbytes)
|
for (i = 0; i < size; i += numbytes)
|
{
|
{
|
reclen = maxrecsize;
|
reclen = maxrecsize;
|
numbytes = make_srec (srec, (CORE_ADDR) (addr + i), abfd, s,
|
numbytes = make_srec (srec, (CORE_ADDR) (addr + i), abfd, s,
|
i, &reclen, flags);
|
i, &reclen, flags);
|
|
|
if (remote_debug)
|
if (remote_debug)
|
{
|
{
|
srec[reclen] = '\0';
|
srec[reclen] = '\0';
|
puts_debug ("sent -->", srec, "<--");
|
puts_debug ("sent -->", srec, "<--");
|
}
|
}
|
|
|
/* Repeatedly send the S-record until a good
|
/* Repeatedly send the S-record until a good
|
acknowledgement is sent back. */
|
acknowledgement is sent back. */
|
do
|
do
|
{
|
{
|
SERIAL_WRITE (desc, srec, reclen);
|
SERIAL_WRITE (desc, srec, reclen);
|
if (ui_load_progress_hook)
|
if (ui_load_progress_hook)
|
if (ui_load_progress_hook (section_name, (unsigned long) i))
|
if (ui_load_progress_hook (section_name, (unsigned long) i))
|
error ("Canceled the download");
|
error ("Canceled the download");
|
}
|
}
|
while (waitack != NULL && !waitack ());
|
while (waitack != NULL && !waitack ());
|
|
|
if (hashmark)
|
if (hashmark)
|
{
|
{
|
putchar_unfiltered ('#');
|
putchar_unfiltered ('#');
|
gdb_flush (gdb_stdout);
|
gdb_flush (gdb_stdout);
|
}
|
}
|
} /* Per-packet (or S-record) loop */
|
} /* Per-packet (or S-record) loop */
|
|
|
if (ui_load_progress_hook)
|
if (ui_load_progress_hook)
|
if (ui_load_progress_hook (section_name, (unsigned long) i))
|
if (ui_load_progress_hook (section_name, (unsigned long) i))
|
error ("Canceled the download");
|
error ("Canceled the download");
|
putchar_unfiltered ('\n');
|
putchar_unfiltered ('\n');
|
}
|
}
|
|
|
if (hashmark)
|
if (hashmark)
|
putchar_unfiltered ('\n');
|
putchar_unfiltered ('\n');
|
|
|
end_time = time (NULL);
|
end_time = time (NULL);
|
|
|
/* Write a terminator record. */
|
/* Write a terminator record. */
|
|
|
reclen = maxrecsize;
|
reclen = maxrecsize;
|
make_srec (srec, abfd->start_address, NULL, NULL, 0, &reclen, flags);
|
make_srec (srec, abfd->start_address, NULL, NULL, 0, &reclen, flags);
|
|
|
if (remote_debug)
|
if (remote_debug)
|
{
|
{
|
srec[reclen] = '\0';
|
srec[reclen] = '\0';
|
puts_debug ("sent -->", srec, "<--");
|
puts_debug ("sent -->", srec, "<--");
|
}
|
}
|
|
|
SERIAL_WRITE (desc, srec, reclen);
|
SERIAL_WRITE (desc, srec, reclen);
|
|
|
/* Some monitors need these to wake up properly. (Which ones? -sts) */
|
/* Some monitors need these to wake up properly. (Which ones? -sts) */
|
SERIAL_WRITE (desc, "\r\r", 2);
|
SERIAL_WRITE (desc, "\r\r", 2);
|
if (remote_debug)
|
if (remote_debug)
|
puts_debug ("sent -->", "\r\r", "<---");
|
puts_debug ("sent -->", "\r\r", "<---");
|
|
|
SERIAL_FLUSH_INPUT (desc);
|
SERIAL_FLUSH_INPUT (desc);
|
|
|
report_transfer_performance (data_count, start_time, end_time);
|
report_transfer_performance (data_count, start_time, end_time);
|
}
|
}
|
|
|
/*
|
/*
|
* make_srec -- make an srecord. This writes each line, one at a
|
* make_srec -- make an srecord. This writes each line, one at a
|
* time, each with it's own header and trailer line.
|
* time, each with it's own header and trailer line.
|
* An srecord looks like this:
|
* An srecord looks like this:
|
*
|
*
|
* byte count-+ address
|
* byte count-+ address
|
* start ---+ | | data +- checksum
|
* start ---+ | | data +- checksum
|
* | | | |
|
* | | | |
|
* S01000006F6B692D746573742E73726563E4
|
* S01000006F6B692D746573742E73726563E4
|
* S315000448600000000000000000FC00005900000000E9
|
* S315000448600000000000000000FC00005900000000E9
|
* S31A0004000023C1400037DE00F023604000377B009020825000348D
|
* S31A0004000023C1400037DE00F023604000377B009020825000348D
|
* S30B0004485A0000000000004E
|
* S30B0004485A0000000000004E
|
* S70500040000F6
|
* S70500040000F6
|
*
|
*
|
* S<type><length><address><data><checksum>
|
* S<type><length><address><data><checksum>
|
*
|
*
|
* Where
|
* Where
|
* - length
|
* - length
|
* is the number of bytes following upto the checksum. Note that
|
* is the number of bytes following upto the checksum. Note that
|
* this is not the number of chars following, since it takes two
|
* this is not the number of chars following, since it takes two
|
* chars to represent a byte.
|
* chars to represent a byte.
|
* - type
|
* - type
|
* is one of:
|
* is one of:
|
* 0) header record
|
* 0) header record
|
* 1) two byte address data record
|
* 1) two byte address data record
|
* 2) three byte address data record
|
* 2) three byte address data record
|
* 3) four byte address data record
|
* 3) four byte address data record
|
* 7) four byte address termination record
|
* 7) four byte address termination record
|
* 8) three byte address termination record
|
* 8) three byte address termination record
|
* 9) two byte address termination record
|
* 9) two byte address termination record
|
*
|
*
|
* - address
|
* - address
|
* is the start address of the data following, or in the case of
|
* is the start address of the data following, or in the case of
|
* a termination record, the start address of the image
|
* a termination record, the start address of the image
|
* - data
|
* - data
|
* is the data.
|
* is the data.
|
* - checksum
|
* - checksum
|
* is the sum of all the raw byte data in the record, from the length
|
* is the sum of all the raw byte data in the record, from the length
|
* upwards, modulo 256 and subtracted from 255.
|
* upwards, modulo 256 and subtracted from 255.
|
*
|
*
|
* This routine returns the length of the S-record.
|
* This routine returns the length of the S-record.
|
*
|
*
|
*/
|
*/
|
|
|
static int
|
static int
|
make_srec (srec, targ_addr, abfd, sect, sectoff, maxrecsize, flags)
|
make_srec (srec, targ_addr, abfd, sect, sectoff, maxrecsize, flags)
|
char *srec;
|
char *srec;
|
CORE_ADDR targ_addr;
|
CORE_ADDR targ_addr;
|
bfd *abfd;
|
bfd *abfd;
|
asection *sect;
|
asection *sect;
|
int sectoff;
|
int sectoff;
|
int *maxrecsize;
|
int *maxrecsize;
|
int flags;
|
int flags;
|
{
|
{
|
unsigned char checksum;
|
unsigned char checksum;
|
int tmp;
|
int tmp;
|
const static char hextab[] = "0123456789ABCDEF";
|
const static char hextab[] = "0123456789ABCDEF";
|
const static char data_code_table[] = "123";
|
const static char data_code_table[] = "123";
|
const static char term_code_table[] = "987";
|
const static char term_code_table[] = "987";
|
const static char header_code_table[] = "000";
|
const static char header_code_table[] = "000";
|
const static char *formats[] =
|
const static char *formats[] =
|
{"S%c%02X%04X",
|
{"S%c%02X%04X",
|
"S%c%02X%06X",
|
"S%c%02X%06X",
|
"S%c%02X%08X"};
|
"S%c%02X%08X"};
|
char const *code_table;
|
char const *code_table;
|
int addr_size;
|
int addr_size;
|
int payload_size;
|
int payload_size;
|
char *binbuf;
|
char *binbuf;
|
char *p;
|
char *p;
|
|
|
if (sect)
|
if (sect)
|
{
|
{
|
tmp = flags; /* Data or header record */
|
tmp = flags; /* Data or header record */
|
code_table = abfd ? data_code_table : header_code_table;
|
code_table = abfd ? data_code_table : header_code_table;
|
binbuf = alloca (*maxrecsize / 2);
|
binbuf = alloca (*maxrecsize / 2);
|
}
|
}
|
else
|
else
|
{
|
{
|
tmp = flags >> SREC_TERM_SHIFT; /* Term record */
|
tmp = flags >> SREC_TERM_SHIFT; /* Term record */
|
code_table = term_code_table;
|
code_table = term_code_table;
|
}
|
}
|
|
|
if ((tmp & SREC_2_BYTE_ADDR) && (targ_addr <= 0xffff))
|
if ((tmp & SREC_2_BYTE_ADDR) && (targ_addr <= 0xffff))
|
addr_size = 2;
|
addr_size = 2;
|
else if ((tmp & SREC_3_BYTE_ADDR) && (targ_addr <= 0xffffff))
|
else if ((tmp & SREC_3_BYTE_ADDR) && (targ_addr <= 0xffffff))
|
addr_size = 3;
|
addr_size = 3;
|
else if (tmp & SREC_4_BYTE_ADDR)
|
else if (tmp & SREC_4_BYTE_ADDR)
|
addr_size = 4;
|
addr_size = 4;
|
else
|
else
|
internal_error ("make_srec: Bad address (0x%x), or bad flags (0x%x).",
|
internal_error ("make_srec: Bad address (0x%x), or bad flags (0x%x).",
|
targ_addr, flags);
|
targ_addr, flags);
|
|
|
/* Now that we know the address size, we can figure out how much
|
/* Now that we know the address size, we can figure out how much
|
data this record can hold. */
|
data this record can hold. */
|
|
|
if (sect && abfd)
|
if (sect && abfd)
|
{
|
{
|
payload_size = (*maxrecsize - (1 + 1 + 2 + addr_size * 2 + 2)) / 2;
|
payload_size = (*maxrecsize - (1 + 1 + 2 + addr_size * 2 + 2)) / 2;
|
payload_size = min (payload_size, sect->_raw_size - sectoff);
|
payload_size = min (payload_size, sect->_raw_size - sectoff);
|
|
|
bfd_get_section_contents (abfd, sect, binbuf, sectoff, payload_size);
|
bfd_get_section_contents (abfd, sect, binbuf, sectoff, payload_size);
|
}
|
}
|
else
|
else
|
payload_size = 0; /* Term or header packets have no payload */
|
payload_size = 0; /* Term or header packets have no payload */
|
|
|
/* Output the header. */
|
/* Output the header. */
|
|
|
sprintf (srec, formats[addr_size - 2], code_table[addr_size - 2],
|
sprintf (srec, formats[addr_size - 2], code_table[addr_size - 2],
|
addr_size + payload_size + 1, (int) targ_addr);
|
addr_size + payload_size + 1, (int) targ_addr);
|
|
|
/* Note that the checksum is calculated on the raw data, not the
|
/* Note that the checksum is calculated on the raw data, not the
|
hexified data. It includes the length, address and the data
|
hexified data. It includes the length, address and the data
|
portions of the packet. */
|
portions of the packet. */
|
|
|
checksum = 0;
|
checksum = 0;
|
|
|
checksum += (payload_size + addr_size + 1 /* Packet length */
|
checksum += (payload_size + addr_size + 1 /* Packet length */
|
+ (targ_addr & 0xff) /* Address... */
|
+ (targ_addr & 0xff) /* Address... */
|
+ ((targ_addr >> 8) & 0xff)
|
+ ((targ_addr >> 8) & 0xff)
|
+ ((targ_addr >> 16) & 0xff)
|
+ ((targ_addr >> 16) & 0xff)
|
+ ((targ_addr >> 24) & 0xff));
|
+ ((targ_addr >> 24) & 0xff));
|
|
|
p = srec + 1 + 1 + 2 + addr_size * 2;
|
p = srec + 1 + 1 + 2 + addr_size * 2;
|
|
|
/* Build the Srecord. */
|
/* Build the Srecord. */
|
for (tmp = 0; tmp < payload_size; tmp++)
|
for (tmp = 0; tmp < payload_size; tmp++)
|
{
|
{
|
unsigned char k;
|
unsigned char k;
|
|
|
k = binbuf[tmp];
|
k = binbuf[tmp];
|
*p++ = hextab[k >> 4];
|
*p++ = hextab[k >> 4];
|
*p++ = hextab[k & 0xf];
|
*p++ = hextab[k & 0xf];
|
checksum += k;
|
checksum += k;
|
}
|
}
|
|
|
checksum = ~checksum;
|
checksum = ~checksum;
|
|
|
*p++ = hextab[checksum >> 4];
|
*p++ = hextab[checksum >> 4];
|
*p++ = hextab[checksum & 0xf];
|
*p++ = hextab[checksum & 0xf];
|
*p++ = '\r';
|
*p++ = '\r';
|
|
|
*maxrecsize = p - srec;
|
*maxrecsize = p - srec;
|
return payload_size;
|
return payload_size;
|
}
|
}
|
|
|
