1 /* Remote debugging interface for Array Tech RAID controller..
2 Copyright 90, 91, 92, 93, 94, 1995, 1998 Free Software Foundation, Inc.
3 Contributed by Cygnus Support. Written by Rob Savoye for Cygnus.
5 This module talks to a debug monitor called 'MONITOR', which
6 We communicate with MONITOR via either a direct serial line, or a TCP
7 (or possibly TELNET) stream to a terminal multiplexor,
8 which in turn talks to the target board.
10 This file is part of GDB.
12 This program is free software; you can redistribute it and/or modify
13 it under the terms of the GNU General Public License as published by
14 the Free Software Foundation; either version 2 of the License, or
15 (at your option) any later version.
17 This program is distributed in the hope that it will be useful,
18 but WITHOUT ANY WARRANTY; without even the implied warranty of
19 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
20 GNU General Public License for more details.
22 You should have received a copy of the GNU General Public License
23 along with this program; if not, write to the Free Software
24 Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA.
31 #ifdef ANSI_PROTOTYPES
38 #include <sys/types.h>
39 #include "gdb_string.h"
43 #include "remote-utils.h"
47 #define ARRAY_PROMPT ">> "
49 #define SWAP_TARGET_AND_HOST(buffer,len) \
52 if (TARGET_BYTE_ORDER != HOST_BYTE_ORDER) \
55 char *p = (char *)(buffer); \
56 char *q = ((char *)(buffer)) + len - 1; \
57 for (; p < q; p++, q--) \
67 static void debuglogs
PARAMS((int, char *, ...));
68 static void array_open();
69 static void array_close();
70 static void array_detach();
71 static void array_attach();
72 static void array_resume();
73 static void array_fetch_register();
74 static void array_store_register();
75 static void array_fetch_registers();
76 static void array_store_registers();
77 static void array_prepare_to_store();
78 static void array_files_info();
79 static void array_kill();
80 static void array_create_inferior();
81 static void array_mourn_inferior();
82 static void make_gdb_packet();
83 static int array_xfer_memory();
84 static int array_wait();
85 static int array_insert_breakpoint();
86 static int array_remove_breakpoint();
89 static int from_hex();
90 static int array_send_packet();
91 static int array_get_packet();
92 static unsigned long ascii2hexword();
93 static void hexword2ascii();
97 #define LOG_FILE "monitor.log"
98 #if defined (LOG_FILE)
102 static int timeout
= 30;
103 /* Having this larger than 400 causes us to be incompatible with m68k-stub.c
104 and i386-stub.c. Normally, no one would notice because it only matters
105 for writing large chunks of memory (e.g. in downloads). Also, this needs
106 to be more than 400 if required to hold the registers (see below, where
107 we round it up based on REGISTER_BYTES). */
111 * Descriptor for I/O to remote machine. Initialize it to NULL so that
112 * array_open knows that we don't have a file open when the program starts.
114 serial_t array_desc
= NULL
;
117 * this array of registers need to match the indexes used by GDB. The
118 * whole reason this exists is cause the various ROM monitors use
119 * different strings than GDB does, and doesn't support all the
120 * registers either. So, typing "info reg sp" becomes a "r30".
122 extern char *tmp_mips_processor_type
;
123 extern int mips_set_processor_type();
125 static struct target_ops array_ops
;
126 static void init_array_ops(void)
128 array_ops
.to_shortname
= "array";
129 array_ops
.to_longname
=
130 "Debug using the standard GDB remote protocol for the Array Tech target.",
132 "Debug using the standard GDB remote protocol for the Array Tech target.\n\
133 Specify the serial device it is connected to (e.g. /dev/ttya)." ;
134 array_ops
.to_open
= array_open
;
135 array_ops
.to_close
= array_close
;
136 array_ops
.to_attach
= NULL
;
137 array_ops
.to_post_attach
= NULL
;
138 array_ops
.to_require_attach
= NULL
;
139 array_ops
.to_detach
= array_detach
;
140 array_ops
.to_require_detach
= NULL
;
141 array_ops
.to_resume
= array_resume
;
142 array_ops
.to_wait
= array_wait
;
143 array_ops
.to_post_wait
= NULL
;
144 array_ops
.to_fetch_registers
= array_fetch_registers
;
145 array_ops
.to_store_registers
= array_store_registers
;
146 array_ops
.to_prepare_to_store
= array_prepare_to_store
;
147 array_ops
.to_xfer_memory
= array_xfer_memory
;
148 array_ops
.to_files_info
= array_files_info
;
149 array_ops
.to_insert_breakpoint
= array_insert_breakpoint
;
150 array_ops
.to_remove_breakpoint
= array_remove_breakpoint
;
151 array_ops
.to_terminal_init
= 0;
152 array_ops
.to_terminal_inferior
= 0;
153 array_ops
.to_terminal_ours_for_output
= 0;
154 array_ops
.to_terminal_ours
= 0;
155 array_ops
.to_terminal_info
= 0;
156 array_ops
.to_kill
= array_kill
;
157 array_ops
.to_load
= 0;
158 array_ops
.to_lookup_symbol
= 0;
159 array_ops
.to_create_inferior
= array_create_inferior
;
160 array_ops
.to_post_startup_inferior
= NULL
;
161 array_ops
.to_acknowledge_created_inferior
= NULL
;
162 array_ops
.to_clone_and_follow_inferior
= NULL
;
163 array_ops
.to_post_follow_inferior_by_clone
= NULL
;
164 array_ops
.to_insert_fork_catchpoint
= NULL
;
165 array_ops
.to_remove_fork_catchpoint
= NULL
;
166 array_ops
.to_insert_vfork_catchpoint
= NULL
;
167 array_ops
.to_remove_vfork_catchpoint
= NULL
;
168 array_ops
.to_has_forked
= NULL
;
169 array_ops
.to_has_vforked
= NULL
;
170 array_ops
.to_can_follow_vfork_prior_to_exec
= NULL
;
171 array_ops
.to_post_follow_vfork
= NULL
;
172 array_ops
.to_insert_exec_catchpoint
= NULL
;
173 array_ops
.to_remove_exec_catchpoint
= NULL
;
174 array_ops
.to_has_execd
= NULL
;
175 array_ops
.to_reported_exec_events_per_exec_call
= NULL
;
176 array_ops
.to_has_exited
= NULL
;
177 array_ops
.to_mourn_inferior
= array_mourn_inferior
;
178 array_ops
.to_can_run
= 0;
179 array_ops
.to_notice_signals
= 0;
180 array_ops
.to_thread_alive
= 0;
181 array_ops
.to_stop
= 0;
182 array_ops
.to_pid_to_exec_file
= NULL
;
183 array_ops
.to_core_file_to_sym_file
= NULL
;
184 array_ops
.to_stratum
= process_stratum
;
185 array_ops
.DONT_USE
= 0;
186 array_ops
.to_has_all_memory
= 1;
187 array_ops
.to_has_memory
= 1;
188 array_ops
.to_has_stack
= 1;
189 array_ops
.to_has_registers
= 1;
190 array_ops
.to_has_execution
= 1;
191 array_ops
.to_sections
= 0;
192 array_ops
.to_sections_end
= 0;
193 array_ops
.to_magic
= OPS_MAGIC
;
197 * printf_monitor -- send data to monitor. Works just like printf.
200 #ifdef ANSI_PROTOTYPES
201 printf_monitor(char *pattern
, ...)
203 printf_monitor(va_alist
)
211 #ifdef ANSI_PROTOTYPES
212 va_start(args
, pattern
);
216 pattern
= va_arg(args
, char *);
219 vsprintf(buf
, pattern
, args
);
221 debuglogs (1, "printf_monitor(), Sending: \"%s\".", buf
);
223 if (strlen(buf
) > PBUFSIZ
)
224 error ("printf_monitor(): string too long");
225 if (SERIAL_WRITE(array_desc
, buf
, strlen(buf
)))
226 fprintf(stderr
, "SERIAL_WRITE failed: %s\n", safe_strerror(errno
));
229 * write_monitor -- send raw data to monitor.
232 write_monitor(data
, len
)
236 if (SERIAL_WRITE(array_desc
, data
, len
))
237 fprintf(stderr
, "SERIAL_WRITE failed: %s\n", safe_strerror(errno
));
239 *(data
+ len
+1) = '\0';
240 debuglogs (1, "write_monitor(), Sending: \"%s\".", data
);
245 * debuglogs -- deal with debugging info to multiple sources. This takes
246 * two real args, the first one is the level to be compared against
247 * the sr_get_debug() value, the second arg is a printf buffer and args
248 * to be formatted and printed. A CR is added after each string is printed.
251 #ifdef ANSI_PROTOTYPES
252 debuglogs(int level
, char *pattern
, ...)
260 unsigned char buf
[PBUFSIZ
];
261 char newbuf
[PBUFSIZ
];
264 #ifdef ANSI_PROTOTYPES
265 va_start(args
, pattern
);
270 level
= va_arg(args
, int); /* get the debug level */
271 pattern
= va_arg(args
, char *); /* get the printf style pattern */
274 if ((level
<0) || (level
> 100)) {
275 error ("Bad argument passed to debuglogs(), needs debug level");
279 vsprintf(buf
, pattern
, args
); /* format the string */
281 /* convert some characters so it'll look right in the log */
283 for (i
= 0 ; buf
[i
] != '\0'; i
++) {
285 error ("Debug message too long");
287 case '\n': /* newlines */
291 case '\r': /* carriage returns */
295 case '\033': /* escape */
303 case '\b': /* backspace */
307 default: /* no change */
311 if (buf
[i
] < 26) { /* modify control characters */
316 if (buf
[i
] >= 128) { /* modify control characters */
322 *p
= '\0'; /* terminate the string */
324 if (sr_get_debug() > level
)
325 printf_unfiltered ("%s\n", newbuf
);
327 #ifdef LOG_FILE /* write to the monitor log */
328 if (log_file
!= 0x0) {
329 fputs (newbuf
, log_file
);
330 fputc ('\n', log_file
);
336 /* readchar -- read a character from the remote system, doing all the fancy
345 c
= SERIAL_READCHAR(array_desc
, abs(timeout
));
347 if (sr_get_debug() > 5) {
349 debuglogs (5, "readchar: timeout = %d\n", timeout
);
354 putc(c
& 0x7f, log_file
);
360 if (c
== SERIAL_TIMEOUT
) {
362 return c
; /* Polls shouldn't generate timeout errors */
363 error("Timeout reading from remote system.");
365 fputs ("ERROR: Timeout reading from remote system", log_file
);
368 perror_with_name("readchar");
372 * expect -- scan input from the remote system, until STRING is found.
373 * If DISCARD is non-zero, then discard non-matching input, else print
374 * it out. Let the user break out immediately.
377 expect (string
, discard
)
385 debuglogs (1, "Expecting \"%s\".", string
);
389 c
= readchar(timeout
);
395 debuglogs (4, "Matched");
400 fputc_unfiltered (c
, gdb_stdout
);
407 /* Keep discarding input until we see the MONITOR array_cmds->prompt.
409 The convention for dealing with the expect_prompt is that you
411 o *then* wait for the expect_prompt.
413 Thus the last thing that a procedure does with the serial line
414 will be an expect_prompt(). Exception: array_resume does not
415 wait for the expect_prompt, because the terminal is being handed over
416 to the inferior. However, the next thing which happens after that
417 is a array_wait which does wait for the expect_prompt.
418 Note that this includes abnormal exit, e.g. error(). This is
419 necessary to prevent getting into states from which we can't
422 expect_prompt(discard
)
425 expect (ARRAY_PROMPT
, discard
);
429 * junk -- ignore junk characters. Returns a 1 if junk, 0 otherwise
442 if (sr_get_debug() > 5)
443 debuglogs (5, "Ignoring \'%c\'.", ch
);
446 if (sr_get_debug() > 5)
447 debuglogs (5, "Accepting \'%c\'.", ch
);
453 * get_hex_digit -- Get a hex digit from the remote system & return its value.
454 * If ignore is nonzero, ignore spaces, newline & tabs.
457 get_hex_digit(ignore
)
462 ch
= readchar(timeout
);
465 if (sr_get_debug() > 4) {
466 debuglogs (4, "get_hex_digit() got a 0x%x(%c)", ch
, ch
);
468 #ifdef LOG_FILE /* write to the monitor log */
469 if (log_file
!= 0x0) {
470 fputs ("get_hex_digit() got a 0x", log_file
);
471 fputc (ch
, log_file
);
472 fputc ('\n', log_file
);
478 if (ch
>= '0' && ch
<= '9')
480 else if (ch
>= 'A' && ch
<= 'F')
481 return ch
- 'A' + 10;
482 else if (ch
>= 'a' && ch
<= 'f')
483 return ch
- 'a' + 10;
484 else if (ch
== ' ' && ignore
)
488 debuglogs (4, "Invalid hex digit from remote system. (0x%x)", ch
);
489 error("Invalid hex digit from remote system. (0x%x)", ch
);
494 /* get_hex_byte -- Get a byte from monitor and put it in *BYT.
495 * Accept any number leading spaces.
503 val
= get_hex_digit (1) << 4;
504 debuglogs (4, "get_hex_byte() -- Read first nibble 0x%x", val
);
506 val
|= get_hex_digit (0);
507 debuglogs (4, "get_hex_byte() -- Read second nibble 0x%x", val
);
510 debuglogs (4, "get_hex_byte() -- Read a 0x%x", val
);
514 * get_hex_word -- Get N 32-bit words from remote, each preceded by a space,
515 * and put them in registers starting at REGNO.
526 if (HOST_BYTE_ORDER
== BIG_ENDIAN
) {
528 for (i
= 0; i
< 8; i
++)
529 val
= (val
<< 4) + get_hex_digit (i
== 0);
532 for (i
= 7; i
>= 0; i
--)
533 val
= (val
<< 4) + get_hex_digit (i
== 0);
537 debuglogs (4, "get_hex_word() got a 0x%x for a %s host.", val
, (HOST_BYTE_ORDER
== BIG_ENDIAN
) ? "big endian" : "little endian");
542 /* This is called not only when we first attach, but also when the
543 user types "run" after having attached. */
545 array_create_inferior (execfile
, args
, env
)
553 error("Can't pass arguments to remote MONITOR process");
555 if (execfile
== 0 || exec_bfd
== 0)
556 error("No executable file specified");
558 entry_pt
= (int) bfd_get_start_address (exec_bfd
);
560 /* The "process" (board) is already stopped awaiting our commands, and
561 the program is already downloaded. We just set its PC and go. */
563 clear_proceed_status ();
565 /* Tell wait_for_inferior that we've started a new process. */
566 init_wait_for_inferior ();
568 /* Set up the "saved terminal modes" of the inferior
569 based on what modes we are starting it with. */
570 target_terminal_init ();
572 /* Install inferior's terminal modes. */
573 target_terminal_inferior ();
575 /* insert_step_breakpoint (); FIXME, do we need this? */
578 proceed ((CORE_ADDR
)entry_pt
, TARGET_SIGNAL_DEFAULT
, 0);
582 * array_open -- open a connection to a remote debugger.
583 * NAME is the filename used for communication.
585 static int baudrate
= 9600;
586 static char dev_name
[100];
589 array_open(args
, name
, from_tty
)
594 char packet
[PBUFSIZ
];
597 error ("Use `target %s DEVICE-NAME' to use a serial port, or \n\
598 `target %s HOST-NAME:PORT-NUMBER' to use a network connection.", name
, name
);
603 target_preopen (from_tty
);
604 unpush_target (&array_ops
);
606 tmp_mips_processor_type
= "lsi33k"; /* change the default from r3051 */
607 mips_set_processor_type_command ("lsi33k", 0);
609 strcpy(dev_name
, args
);
610 array_desc
= SERIAL_OPEN(dev_name
);
612 if (array_desc
== NULL
)
613 perror_with_name(dev_name
);
615 if (baud_rate
!= -1) {
616 if (SERIAL_SETBAUDRATE (array_desc
, baud_rate
)) {
617 SERIAL_CLOSE (array_desc
);
618 perror_with_name (name
);
622 SERIAL_RAW(array_desc
);
624 #if defined (LOG_FILE)
625 log_file
= fopen (LOG_FILE
, "w");
626 if (log_file
== NULL
)
627 perror_with_name (LOG_FILE
);
628 fprintf_filtered (log_file
, "GDB %s (%s", version
);
629 fprintf_filtered (log_file
, " --target %s)\n", array_ops
.to_shortname
);
630 fprintf_filtered (log_file
, "Remote target %s connected to %s\n\n", array_ops
.to_shortname
, dev_name
);
633 /* see if the target is alive. For a ROM monitor, we can just try to force the
634 expect_prompt to print a few times. For the GDB remote protocol, the application
635 being debugged is sitting at a breakpoint and waiting for GDB to initialize
636 the connection. We force it to give us an empty packet to see if it's alive.
638 debuglogs (3, "Trying to ACK the target's debug stub");
639 /* unless your are on the new hardware, the old board won't initialize
640 because the '@' doesn't flush output like it does on the new ROMS.
642 printf_monitor ("@"); /* ask for the last signal */
643 expect_prompt(1); /* See if we get a expect_prompt */
644 #ifdef TEST_ARRAY /* skip packet for testing */
645 make_gdb_packet (packet
, "?"); /* ask for a bogus packet */
646 if (array_send_packet (packet
) == 0)
647 error ("Couldn't transmit packet\n");
648 printf_monitor ("@\n"); /* force it to flush stdout */
649 expect_prompt(1); /* See if we get a expect_prompt */
651 push_target (&array_ops
);
653 printf("Remote target %s connected to %s\n", array_ops
.to_shortname
, dev_name
);
657 * array_close -- Close out all files and local state before this
658 * target loses control.
662 array_close (quitting
)
665 SERIAL_CLOSE(array_desc
);
668 debuglogs (1, "array_close (quitting=%d)", quitting
);
670 #if defined (LOG_FILE)
672 if (ferror(log_file
))
673 printf_filtered ("Error writing log file.\n");
674 if (fclose(log_file
) != 0)
675 printf_filtered ("Error closing log file.\n");
681 * array_detach -- terminate the open connection to the remote
682 * debugger. Use this when you want to detach and do something
683 * else with your gdb.
686 array_detach (from_tty
)
690 debuglogs (1, "array_detach ()");
692 pop_target(); /* calls array_close to do the real work */
694 printf ("Ending remote %s debugging\n", target_shortname
);
698 * array_attach -- attach GDB to the target.
701 array_attach (args
, from_tty
)
706 printf ("Starting remote %s debugging\n", target_shortname
);
708 debuglogs (1, "array_attach (args=%s)", args
);
710 printf_monitor ("go %x\n");
711 /* swallow the echo. */
712 expect ("go %x\n", 1);
716 * array_resume -- Tell the remote machine to resume.
719 array_resume (pid
, step
, sig
)
721 enum target_signal sig
;
723 debuglogs (1, "array_resume (step=%d, sig=%d)", step
, sig
);
726 printf_monitor ("s\n");
728 printf_monitor ("go\n");
735 * array_wait -- Wait until the remote machine stops, then return,
736 * storing status in status just as `wait' would.
739 array_wait (pid
, status
)
741 struct target_waitstatus
*status
;
743 int old_timeout
= timeout
;
747 serial_ttystate ttystate
;
749 debuglogs(1, "array_wait (), printing extraneous text.");
751 status
->kind
= TARGET_WAITKIND_EXITED
;
752 status
->value
.integer
= 0;
754 timeout
= 0; /* Don't time out -- user program is running. */
756 #if !defined(__GO32__) && !defined(__MSDOS__) && !defined(_WIN32)
757 tty_desc
= SERIAL_FDOPEN (0);
758 ttystate
= SERIAL_GET_TTY_STATE (tty_desc
);
759 SERIAL_RAW (tty_desc
);
762 /* poll on the serial port and the keyboard. */
764 c
= readchar(timeout
);
766 if (c
== *(ARRAY_PROMPT
+ i
)) {
767 if (++i
>= strlen (ARRAY_PROMPT
)) { /* matched the prompt */
768 debuglogs (4, "array_wait(), got the expect_prompt.");
771 } else { /* not the prompt */
774 fputc_unfiltered (c
, gdb_stdout
);
775 gdb_flush (gdb_stdout
);
777 c
= SERIAL_READCHAR(tty_desc
, timeout
);
779 SERIAL_WRITE(array_desc
, &c
, 1);
780 /* do this so it looks like there's keyboard echo */
781 if (c
== 3) /* exit on Control-C */
784 fputc_unfiltered (c
, gdb_stdout
);
785 gdb_flush (gdb_stdout
);
789 SERIAL_SET_TTY_STATE (tty_desc
, ttystate
);
792 debuglogs (4, "array_wait(), got the expect_prompt.");
795 status
->kind
= TARGET_WAITKIND_STOPPED
;
796 status
->value
.sig
= TARGET_SIGNAL_TRAP
;
798 timeout
= old_timeout
;
804 * array_fetch_registers -- read the remote registers into the
808 array_fetch_registers (ignored
)
813 unsigned char packet
[PBUFSIZ
];
814 char regs
[REGISTER_BYTES
];
816 debuglogs (1, "array_fetch_registers (ignored=%d)\n", ignored
);
818 memset (packet
, 0, PBUFSIZ
);
819 /* Unimplemented registers read as all bits zero. */
820 memset (regs
, 0, REGISTER_BYTES
);
821 make_gdb_packet (packet
, "g");
822 if (array_send_packet (packet
) == 0)
823 error ("Couldn't transmit packet\n");
824 if (array_get_packet (packet
) == 0)
825 error ("Couldn't receive packet\n");
826 /* FIXME: read bytes from packet */
827 debuglogs (4, "array_fetch_registers: Got a \"%s\" back\n", packet
);
828 for (regno
= 0; regno
<= PC_REGNUM
+4; regno
++) {
829 /* supply register stores in target byte order, so swap here */
830 /* FIXME: convert from ASCII hex to raw bytes */
831 i
= ascii2hexword (packet
+ (regno
* 8));
832 debuglogs (5, "Adding register %d = %x\n", regno
, i
);
833 SWAP_TARGET_AND_HOST (&i
, 4);
834 supply_register (regno
, (char *)&i
);
839 * This is unused by targets like this one that use a
840 * protocol based on GDB's remote protocol.
843 array_fetch_register (ignored
)
846 array_fetch_registers ();
850 * Get all the registers from the targets. They come back in a large array.
853 array_store_registers (ignored
)
858 char packet
[PBUFSIZ
];
862 debuglogs (1, "array_store_registers()");
864 memset (packet
, 0, PBUFSIZ
);
865 memset (buf
, 0, PBUFSIZ
);
868 /* Unimplemented registers read as all bits zero. */
869 /* FIXME: read bytes from packet */
870 for (regno
= 0; regno
< 41; regno
++) { /* FIXME */
871 /* supply register stores in target byte order, so swap here */
872 /* FIXME: convert from ASCII hex to raw bytes */
873 i
= (unsigned long)read_register (regno
);
874 hexword2ascii (num
, i
);
875 strcpy (buf
+(regno
* 8)+1, num
);
877 *(buf
+ (regno
* 8) + 2) = 0;
878 make_gdb_packet (packet
, buf
);
879 if (array_send_packet (packet
) == 0)
880 error ("Couldn't transmit packet\n");
881 if (array_get_packet (packet
) == 0)
882 error ("Couldn't receive packet\n");
884 registers_changed ();
888 * This is unused by targets like this one that use a
889 * protocol based on GDB's remote protocol.
892 array_store_register (ignored
)
895 array_store_registers ();
898 /* Get ready to modify the registers array. On machines which store
899 individual registers, this doesn't need to do anything. On machines
900 which store all the registers in one fell swoop, this makes sure
901 that registers contains all the registers from the program being
905 array_prepare_to_store ()
907 /* Do nothing, since we can store individual regs */
913 printf ("\tAttached to %s at %d baud.\n",
918 * array_write_inferior_memory -- Copy LEN bytes of data from debugger
919 * memory at MYADDR to inferior's memory at MEMADDR. Returns length moved.
922 array_write_inferior_memory (memaddr
, myaddr
, len
)
924 unsigned char *myaddr
;
929 char packet
[PBUFSIZ
];
934 debuglogs (1, "array_write_inferior_memory (memaddr=0x%x, myaddr=0x%x, len=%d)", memaddr
, myaddr
, len
);
935 memset (buf
, '\0', PBUFSIZ
); /* this also sets the string terminator */
938 *p
++ = 'M'; /* The command to write memory */
939 hexword2ascii (num
, memaddr
); /* convert the address */
940 strcpy (p
, num
); /* copy the address */
942 *p
++ = ','; /* add comma delimeter */
943 hexword2ascii (num
, len
); /* Get the length as a 4 digit number */
948 *p
++ = ':'; /* add the colon delimeter */
949 for (j
= 0; j
< len
; j
++) { /* copy the data in after converting it */
950 *p
++ = tohex ((myaddr
[j
] >> 4) & 0xf);
951 *p
++ = tohex (myaddr
[j
] & 0xf);
954 make_gdb_packet (packet
, buf
);
955 if (array_send_packet (packet
) == 0)
956 error ("Couldn't transmit packet\n");
957 if (array_get_packet (packet
) == 0)
958 error ("Couldn't receive packet\n");
964 * array_read_inferior_memory -- read LEN bytes from inferior memory
965 * at MEMADDR. Put the result at debugger address MYADDR. Returns
969 array_read_inferior_memory(memaddr
, myaddr
, len
)
976 char packet
[PBUFSIZ
];
977 int count
; /* Number of bytes read so far. */
978 unsigned long startaddr
; /* Starting address of this pass. */
979 int len_this_pass
; /* Number of bytes to read in this pass. */
981 debuglogs (1, "array_read_inferior_memory (memaddr=0x%x, myaddr=0x%x, len=%d)", memaddr
, myaddr
, len
);
983 /* Note that this code works correctly if startaddr is just less
984 than UINT_MAX (well, really CORE_ADDR_MAX if there was such a
985 thing). That is, something like
986 array_read_bytes (CORE_ADDR_MAX - 4, foo, 4)
987 works--it never adds len To memaddr and gets 0. */
988 /* However, something like
989 array_read_bytes (CORE_ADDR_MAX - 3, foo, 4)
990 doesn't need to work. Detect it and give up if there's an attempt
992 if (((memaddr
- 1) + len
) < memaddr
) {
997 for (count
= 0, startaddr
= memaddr
; count
< len
; startaddr
+= len_this_pass
)
999 /* Try to align to 16 byte boundry (why?) */
1001 if ((startaddr
% 16) != 0)
1003 len_this_pass
-= startaddr
% 16;
1005 /* Only transfer bytes we need */
1006 if (len_this_pass
> (len
- count
))
1008 len_this_pass
= (len
- count
);
1010 /* Fetch the bytes */
1011 debuglogs (3, "read %d bytes from inferior address %x", len_this_pass
,
1013 sprintf (buf
, "m%08x,%04x", startaddr
, len_this_pass
);
1014 make_gdb_packet (packet
, buf
);
1015 if (array_send_packet (packet
) == 0)
1017 error ("Couldn't transmit packet\n");
1019 if (array_get_packet (packet
) == 0)
1021 error ("Couldn't receive packet\n");
1025 error ("Got no data in the GDB packet\n");
1027 /* Pick packet apart and xfer bytes to myaddr */
1028 debuglogs (4, "array_read_inferior_memory: Got a \"%s\" back\n", packet
);
1029 for (j
= 0; j
< len_this_pass
; j
++)
1031 /* extract the byte values */
1032 myaddr
[count
++] = from_hex (*(packet
+(j
*2))) * 16 + from_hex (*(packet
+(j
*2)+1));
1033 debuglogs (5, "myaddr[%d] set to %x\n", count
-1, myaddr
[count
-1]);
1039 /* FIXME-someday! merge these two. */
1041 array_xfer_memory (memaddr
, myaddr
, len
, write
, target
)
1046 struct target_ops
*target
; /* ignored */
1049 return array_write_inferior_memory (memaddr
, myaddr
, len
);
1051 return array_read_inferior_memory (memaddr
, myaddr
, len
);
1055 array_kill (args
, from_tty
)
1059 return; /* ignore attempts to kill target system */
1062 /* Clean up when a program exits.
1063 The program actually lives on in the remote processor's RAM, and may be
1064 run again without a download. Don't leave it full of breakpoint
1068 array_mourn_inferior ()
1070 remove_breakpoints ();
1071 generic_mourn_inferior (); /* Do all the proper things now */
1074 #define MAX_ARRAY_BREAKPOINTS 16
1076 static CORE_ADDR breakaddr
[MAX_ARRAY_BREAKPOINTS
] = {0};
1079 * array_insert_breakpoint -- add a breakpoint
1082 array_insert_breakpoint (addr
, shadow
)
1088 CORE_ADDR bp_addr
= addr
;
1090 debuglogs (1, "array_insert_breakpoint() addr = 0x%x", addr
);
1091 BREAKPOINT_FROM_PC (&bp_addr
, &bp_size
);
1093 for (i
= 0; i
<= MAX_ARRAY_BREAKPOINTS
; i
++) {
1094 if (breakaddr
[i
] == 0) {
1095 breakaddr
[i
] = addr
;
1096 if (sr_get_debug() > 4)
1097 printf ("Breakpoint at %x\n", addr
);
1098 array_read_inferior_memory (bp_addr
, shadow
, bp_size
);
1099 printf_monitor("b 0x%x\n", addr
);
1105 fprintf(stderr
, "Too many breakpoints (> 16) for monitor\n");
1110 * _remove_breakpoint -- Tell the monitor to remove a breakpoint
1113 array_remove_breakpoint (addr
, shadow
)
1119 debuglogs (1, "array_remove_breakpoint() addr = 0x%x", addr
);
1121 for (i
= 0; i
< MAX_ARRAY_BREAKPOINTS
; i
++) {
1122 if (breakaddr
[i
] == addr
) {
1124 /* some monitors remove breakpoints based on the address */
1125 printf_monitor("bd %x\n", i
);
1130 fprintf(stderr
, "Can't find breakpoint associated with 0x%x\n", addr
);
1137 debuglogs (1, "array_stop()");
1138 printf_monitor("\003");
1143 * array_command -- put a command string, in args, out to MONITOR.
1144 * Output from MONITOR is placed on the users terminal until the
1145 * expect_prompt is seen. FIXME
1148 monitor_command (args
, fromtty
)
1152 debuglogs (1, "monitor_command (args=%s)", args
);
1154 if (array_desc
== NULL
)
1155 error("monitor target not open.");
1158 error("Missing command.");
1160 printf_monitor ("%s\n", args
);
1165 * make_gdb_packet -- make a GDB packet. The data is always ASCII.
1166 * A debug packet whose contents are <data>
1167 * is encapsulated for transmission in the form:
1169 * $ <data> # CSUM1 CSUM2
1171 * <data> must be ASCII alphanumeric and cannot include characters
1172 * '$' or '#'. If <data> starts with two characters followed by
1173 * ':', then the existing stubs interpret this as a sequence number.
1175 * CSUM1 and CSUM2 are ascii hex representation of an 8-bit
1176 * checksum of <data>, the most significant nibble is sent first.
1177 * the hex digits 0-9,a-f are used.
1181 make_gdb_packet (buf
, data
)
1185 unsigned char csum
= 0;
1189 debuglogs (3, "make_gdb_packet(%s)\n", data
);
1190 cnt
= strlen (data
);
1192 error ("make_gdb_packet(): to much data\n");
1194 /* start with the packet header */
1198 /* calculate the checksum */
1199 for (i
= 0; i
< cnt
; i
++) {
1204 /* terminate the data with a '#' */
1207 /* add the checksum as two ascii digits */
1208 *p
++ = tohex ((csum
>> 4) & 0xf);
1209 *p
++ = tohex (csum
& 0xf);
1210 *p
= 0x0; /* Null terminator on string */
1214 * array_send_packet -- send a GDB packet to the target with error handling. We
1215 * get a '+' (ACK) back if the packet is received and the checksum
1216 * matches. Otherwise a '-' (NAK) is returned. It returns a 1 for a
1217 * successful transmition, or a 0 for a failure.
1220 array_send_packet (packet
)
1229 /* scan the packet to make sure it only contains valid characters.
1230 this may sound silly, but sometimes a garbled packet will hang
1231 the target board. We scan the whole thing, then print the error
1234 for (i
= 0; i
< strlen(packet
); i
++) {
1235 debuglogs (5, "array_send_packet(): Scanning \'%c\'\n", packet
[i
]);
1236 /* legit hex numbers or command */
1237 if ((isxdigit(packet
[i
])) || (isalpha(packet
[i
])))
1239 switch (packet
[i
]) {
1242 case '#': /* end of packet */
1243 case '$': /* start of packet */
1245 default: /* bogus character */
1247 debuglogs (4, "array_send_packet(): Found a non-ascii digit \'%c\' in the packet.\n", packet
[i
]);
1253 error ("Can't send packet, found %d non-ascii characters", retries
);
1255 /* ok, try to send the packet */
1257 while (retries
++ <= 10) {
1258 printf_monitor ("%s", packet
);
1260 /* read until either a timeout occurs (-2) or '+' is read */
1261 while (retries
<= 10) {
1262 c
= readchar (-timeout
);
1263 debuglogs (3, "Reading a GDB protocol packet... Got a '%c'\n", c
);
1266 debuglogs (3, "Got Ack\n");
1268 case SERIAL_TIMEOUT
:
1269 debuglogs (3, "Timed out reading serial port\n");
1270 printf_monitor("@"); /* resync with the monitor */
1271 expect_prompt(1); /* See if we get a expect_prompt */
1272 break; /* Retransmit buffer */
1274 debuglogs (3, "Got NAK\n");
1275 printf_monitor("@"); /* resync with the monitor */
1276 expect_prompt(1); /* See if we get a expect_prompt */
1279 /* it's probably an old response, or the echo of our command.
1280 * just gobble up the packet and ignore it.
1282 debuglogs (3, "Got a junk packet\n");
1285 c
= readchar (timeout
);
1288 c
= readchar (timeout
);
1290 c
= readchar (timeout
);
1293 debuglogs (3, "Reading a junk packet, got a \"%s\"\n", junk
);
1294 continue; /* Now, go look for next packet */
1299 debuglogs (3, "Retransmitting packet \"%s\"\n", packet
);
1300 break; /* Here to retransmit */
1307 * array_get_packet -- get a GDB packet from the target. Basically we read till we
1308 * see a '#', then check the checksum. It returns a 1 if it's gotten a
1309 * packet, or a 0 it the packet wasn't transmitted correctly.
1312 array_get_packet (packet
)
1318 unsigned char pktcsum
;
1324 memset (packet
, 1, PBUFSIZ
);
1326 while (retries
<= 10) {
1328 c
= readchar (timeout
);
1329 if (c
== SERIAL_TIMEOUT
) {
1330 debuglogs (3, "array_get_packet: got time out from serial port.\n");
1332 debuglogs (3, "Waiting for a '$', got a %c\n", c
);
1336 while (retries
<= 10) {
1337 c
= readchar (timeout
);
1338 debuglogs (3, "array_get_packet: got a '%c'\n", c
);
1340 case SERIAL_TIMEOUT
:
1341 debuglogs (3, "Timeout in mid-packet, retrying\n");
1344 debuglogs (3, "Saw new packet start in middle of old one\n");
1345 return 0; /* Start a new packet, count retries */
1348 pktcsum
= from_hex (readchar (timeout
)) << 4;
1349 pktcsum
|= from_hex (readchar (timeout
));
1351 debuglogs (3, "\nGDB packet checksum zero, must be a bogus packet\n");
1352 if (csum
== pktcsum
) {
1353 debuglogs (3, "\nGDB packet checksum correct, packet data is \"%s\",\n", packet
);
1354 printf_monitor ("@");
1358 debuglogs (3, "Bad checksum, sentsum=0x%x, csum=0x%x\n", pktcsum
, csum
);
1360 case '*': /* Run length encoding */
1361 debuglogs (5, "Run length encoding in packet\n");
1363 c
= readchar (timeout
);
1365 c
= c
- ' ' + 3; /* Compute repeat count */
1367 if (c
> 0 && c
< 255 && bp
+ c
- 1 < packet
+ PBUFSIZ
- 1) {
1368 memset (bp
, *(bp
- 1), c
);
1373 printf_filtered ("Repeat count %d too large for buffer.\n", c
);
1377 if ((!isxdigit(c
)) && (!ispunct(c
)))
1378 debuglogs (4, "Got a non-ascii digit \'%c\'.\\n", c
);
1379 if (bp
< packet
+ PBUFSIZ
- 1) {
1386 puts_filtered ("Remote packet too long.\n");
1391 return 0; /* exceeded retries */
1395 * ascii2hexword -- convert an ascii number represented by 8 digits to a hex value.
1397 static unsigned long
1406 for (i
= 0; i
< 8; i
++) {
1408 if (mem
[i
] >= 'A' && mem
[i
] <= 'F')
1409 val
= val
+ mem
[i
] - 'A' + 10;
1410 if (mem
[i
] >= 'a' && mem
[i
] <= 'f')
1411 val
= val
+ mem
[i
] - 'a' + 10;
1412 if (mem
[i
] >= '0' && mem
[i
] <= '9')
1413 val
= val
+ mem
[i
] - '0';
1417 debuglogs (4, "ascii2hexword() got a 0x%x from %s(%x).\n", val
, buf
, mem
);
1422 * ascii2hexword -- convert a hex value to an ascii number represented by 8
1426 hexword2ascii (mem
, num
)
1433 debuglogs (4, "hexword2ascii() converting %x ", num
);
1434 for (i
= 7; i
>= 0; i
--) {
1435 mem
[i
] = tohex ((num
>> 4) & 0xf);
1436 mem
[i
] = tohex (num
& 0xf);
1440 debuglogs (4, "\tto a %s", mem
);
1443 /* Convert hex digit A to a number. */
1451 debuglogs (4, "from_hex got a 0x%x(%c)\n",a
,a
);
1452 if (a
>= '0' && a
<= '9')
1454 if (a
>= 'a' && a
<= 'f')
1455 return a
- 'a' + 10;
1456 if (a
>= 'A' && a
<= 'F')
1457 return a
- 'A' + 10;
1459 error ("Reply contains invalid hex digit 0x%x", a
);
1463 /* Convert number NIB to a hex digit. */
1475 * _initialize_remote_monitors -- setup a few addtitional commands that
1476 * are usually only used by monitors.
1479 _initialize_remote_monitors ()
1481 /* generic monitor command */
1482 add_com ("monitor", class_obscure
, monitor_command
,
1483 "Send a command to the debug monitor.");
1488 * _initialize_array -- do any special init stuff for the target.
1491 _initialize_array ()
1494 add_target (&array_ops
);