1 /* Memory-access and commands for remote NINDY process, for GDB.
2 Copyright 1990, 1991, 1992, 1993 Free Software Foundation, Inc.
3 Contributed by Intel Corporation. Modified from remote.c by Chris Benenati.
5 GDB is distributed in the hope that it will be useful, but WITHOUT ANY
6 WARRANTY. No author or distributor accepts responsibility to anyone
7 for the consequences of using it or for whether it serves any
8 particular purpose or works at all, unless he says so in writing.
9 Refer to the GDB General Public License for full details.
11 Everyone is granted permission to copy, modify and redistribute GDB,
12 but only under the conditions described in the GDB General Public
13 License. A copy of this license is supposed to have been given to you
14 along with GDB so you can know your rights and responsibilities. It
15 should be in a file named COPYING. Among other things, the copyright
16 notice and this notice must be preserved on all copies.
18 In other words, go ahead and share GDB, but don't try to stop
19 anyone else from sharing it farther. Help stamp out software hoarding!
23 Except for the data cache routines, this file bears little resemblence
24 to remote.c. A new (although similar) protocol has been specified, and
25 portions of the code are entirely dependent on having an i80960 with a
26 NINDY ROM monitor at the other end of the line.
29 /*****************************************************************************
31 * REMOTE COMMUNICATION PROTOCOL BETWEEN GDB960 AND THE NINDY ROM MONITOR.
37 * As far as NINDY is concerned, GDB is always in one of two modes: command
38 * mode or passthrough mode.
40 * In command mode (the default) pre-defined packets containing requests
41 * are sent by GDB to NINDY. NINDY never talks except in reponse to a request.
43 * Once the the user program is started, GDB enters passthrough mode, to give
44 * the user program access to the terminal. GDB remains in this mode until
45 * NINDY indicates that the program has stopped.
51 * GDB writes all input received from the keyboard directly to NINDY, and writes
52 * all characters received from NINDY directly to the monitor.
54 * Keyboard input is neither buffered nor echoed to the monitor.
56 * GDB remains in passthrough mode until NINDY sends a single ^P character,
57 * to indicate that the user process has stopped.
60 * GDB assumes NINDY performs a 'flushreg' when the user program stops.
66 * All info (except for message ack and nak) is transferred between gdb
67 * and the remote processor in messages of the following format:
72 * # is a literal character
74 * <info> ASCII information; all numeric information is in the
75 * form of hex digits ('0'-'9' and lowercase 'a'-'f').
78 * is a pair of ASCII hex digits representing an 8-bit
79 * checksum formed by adding together each of the
80 * characters in <info>.
82 * The receiver of a message always sends a single character to the sender
83 * to indicate that the checksum was good ('+') or bad ('-'); the sender
84 * re-transmits the entire message over until a '+' is received.
86 * In response to a command NINDY always sends back either data or
87 * a result code of the form "Xnn", where "nn" are hex digits and "X00"
88 * means no errors. (Exceptions: the "s" and "c" commands don't respond.)
90 * SEE THE HEADER OF THE FILE "gdb.c" IN THE NINDY MONITOR SOURCE CODE FOR A
91 * FULL DESCRIPTION OF LEGAL COMMANDS.
93 * SEE THE FILE "stop.h" IN THE NINDY MONITOR SOURCE CODE FOR A LIST
96 ***************************************************************************/
100 #include <sys/types.h>
104 #include "inferior.h"
110 #include "ieee-float.h"
113 #include <sys/file.h>
116 #include "nindy-share/env.h"
117 #include "nindy-share/stop.h"
121 static DCACHE
*nindy_dcache
;
124 extern char *getenv();
125 extern char *mktemp();
127 extern void generic_mourn_inferior ();
129 extern struct target_ops nindy_ops
;
130 extern FILE *instream
;
131 extern struct ext_format ext_format_i960
; /* i960-tdep.c */
133 extern char ninStopWhy ();
135 int nindy_initial_brk
; /* nonzero if want to send an initial BREAK to nindy */
136 int nindy_old_protocol
; /* nonzero if want to use old protocol */
137 char *nindy_ttyname
; /* name of tty to talk to nindy on, or null */
139 #define DLE '\020' /* Character NINDY sends to indicate user program has
144 /* From nindy-share/nindy.c. */
145 extern serial_t nindy_serial
;
147 static int have_regs
= 0; /* 1 iff regs read since i960 last halted */
148 static int regs_changed
= 0; /* 1 iff regs were modified since last read */
150 extern char *exists();
153 nindy_fetch_registers
PARAMS ((int));
156 nindy_store_registers
PARAMS ((int));
158 static char *savename
;
161 nindy_close (quitting
)
164 if (nindy_serial
!= NULL
)
165 SERIAL_CLOSE (nindy_serial
);
173 /* Open a connection to a remote debugger.
174 FIXME, there should be a way to specify the various options that are
175 now specified with gdb command-line options. (baud_rate, old_protocol,
178 nindy_open (name
, from_tty
)
179 char *name
; /* "/dev/ttyXX", "ttyXX", or "XX": tty to be opened */
184 error_no_arg ("serial port device name");
186 target_preopen (from_tty
);
190 have_regs
= regs_changed
= 0;
191 nindy_dcache
= dcache_init(ninMemGet
, ninMemPut
);
193 /* Allow user to interrupt the following -- we could hang if there's
194 no NINDY at the other end of the remote tty. */
196 ninConnect(name
, baud_rate
? baud_rate
: "9600",
197 nindy_initial_brk
, !from_tty
, nindy_old_protocol
);
200 if (nindy_serial
== NULL
)
202 perror_with_name (name
);
205 savename
= savestring (name
, strlen (name
));
206 push_target (&nindy_ops
);
207 target_fetch_registers(-1);
210 /* User-initiated quit of nindy operations. */
213 nindy_detach (name
, from_tty
)
218 error ("Too many arguments");
225 printf("\tAttached to %s at %s bps%s%s.\n", savename
,
226 baud_rate
? baud_rate
: "9600",
227 nindy_old_protocol
? " in old protocol": "",
228 nindy_initial_brk
? " with initial break": "");
231 /* Return the number of characters in the buffer before
232 the first DLE character. */
237 char *buf
; /* Character buffer; NOT '\0'-terminated */
238 int n
; /* Number of characters in buffer */
242 for ( i
= 0; i
< n
; i
++ ){
243 if ( buf
[i
] == DLE
){
250 /* Tell the remote machine to resume. */
253 nindy_resume (pid
, step
, siggnal
)
254 int pid
, step
, siggnal
;
256 if (siggnal
!= 0 && siggnal
!= stop_signal
)
257 error ("Can't send signals to remote NINDY targets.");
259 dcache_flush(nindy_dcache
);
261 nindy_store_registers (-1);
268 /* FIXME, we can probably use the normal terminal_inferior stuff here.
269 We have to do terminal_inferior and then set up the passthrough
270 settings initially. Thereafter, terminal_ours and terminal_inferior
271 will automatically swap the settings around for us. */
273 struct clean_up_tty_args
{
274 serial_ttystate state
;
279 clean_up_tty (ptrarg
)
282 struct clean_up_tty_args
*args
= (struct clean_up_tty_args
*) ptrarg
;
283 SERIAL_SET_TTY_STATE (args
->serial
, args
->state
);
286 You may need to reset the 80960 and/or reload your program.\n");
289 /* Wait until the remote machine stops. While waiting, operate in passthrough
290 * mode; i.e., pass everything NINDY sends to stdout, and everything from
293 * Return to caller, storing status in 'status' just as `wait' would.
301 char buf
[500]; /* FIXME, what is "500" here? */
303 unsigned char stop_exit
;
304 unsigned char stop_code
;
305 struct clean_up_tty_args tty_args
;
306 struct cleanup
*old_cleanups
;
307 long ip_value
, fp_value
, sp_value
; /* Reg values from stop */
309 WSETEXIT( (*status
), 0 );
311 /* OPERATE IN PASSTHROUGH MODE UNTIL NINDY SENDS A DLE CHARACTER */
313 /* Save current tty attributes, and restore them when done. */
314 tty_args
.serial
= SERIAL_FDOPEN (0);
315 tty_args
.state
= SERIAL_GET_TTY_STATE (tty_args
.serial
);
316 old_cleanups
= make_cleanup (clean_up_tty
, &tty_args
);
318 /* Pass input from keyboard to NINDY as it arrives. NINDY will interpret
319 <CR> and perform echo. */
320 /* This used to set CBREAK and clear ECHO and CRMOD. I hope this is close
322 SERIAL_RAW (tty_args
.serial
);
326 /* Wait for input on either the remote port or stdin. */
329 FD_SET (nindy_serial
->fd
, &fds
);
330 if (select (nindy_serial
->fd
+ 1, &fds
, 0, 0, 0) <= 0)
333 /* Pass input through to correct place */
334 if (FD_ISSET (0, &fds
))
337 n
= read (0, buf
, sizeof (buf
));
340 SERIAL_WRITE (nindy_serial
, buf
, n
);
344 if (FD_ISSET (nindy_serial
->fd
, &fds
))
346 /* Input on remote */
347 n
= read (nindy_serial
->fd
, buf
, sizeof (buf
));
350 /* Write out any characters in buffer preceding DLE */
351 i
= non_dle( buf
, n
);
359 /* There *was* a DLE in the buffer */
360 stop_exit
= ninStopWhy(&stop_code
,
361 &ip_value
, &fp_value
, &sp_value
);
362 if (!stop_exit
&& (stop_code
== STOP_SRQ
))
370 /* Get out of loop */
371 supply_register (IP_REGNUM
,
373 supply_register (FP_REGNUM
,
375 supply_register (SP_REGNUM
,
384 do_cleanups (old_cleanups
);
388 /* User program exited */
389 WSETEXIT ((*status
), stop_code
);
398 /* Breakpoint or single stepping. */
402 /* The target is not running Unix, and its faults/traces do
403 not map nicely into Unix signals. Make sure they do not
404 get confused with Unix signals by numbering them with
405 values higher than the highest legal Unix signal. code
406 in i960_print_fault(), called via PRINT_RANDOM_SIGNAL,
407 will interpret the value. */
411 WSETSTOP ((*status
), stop_code
);
416 /* Read the remote registers into the block REGS. */
418 /* This is the block that ninRegsGet and ninRegsPut handles. */
420 char local_regs
[16 * 4];
421 char global_regs
[16 * 4];
425 char fp_as_double
[4 * 8];
429 nindy_fetch_registers(regno
)
432 struct nindy_regs nindy_regs
;
437 ninRegsGet( (char *) &nindy_regs
);
440 memcpy (®isters
[REGISTER_BYTE (R0_REGNUM
)], nindy_regs
.local_regs
, 16*4);
441 memcpy (®isters
[REGISTER_BYTE (G0_REGNUM
)], nindy_regs
.global_regs
, 16*4);
442 memcpy (®isters
[REGISTER_BYTE (PCW_REGNUM
)], nindy_regs
.pcw_acw
, 2*4);
443 memcpy (®isters
[REGISTER_BYTE (IP_REGNUM
)], nindy_regs
.ip
, 1*4);
444 memcpy (®isters
[REGISTER_BYTE (TCW_REGNUM
)], nindy_regs
.tcw
, 1*4);
445 for (regnum
= FP0_REGNUM
; regnum
< FP0_REGNUM
+ 4; regnum
++) {
446 dub
= unpack_double (builtin_type_double
,
447 &nindy_regs
.fp_as_double
[8 * (regnum
- FP0_REGNUM
)],
449 /* dub now in host byte order */
450 double_to_ieee_extended (&ext_format_i960
, &dub
,
451 ®isters
[REGISTER_BYTE (regnum
)]);
454 registers_fetched ();
458 nindy_prepare_to_store()
460 /* Fetch all regs if they aren't already here. */
461 read_register_bytes (0, NULL
, REGISTER_BYTES
);
465 nindy_store_registers(regno
)
468 struct nindy_regs nindy_regs
;
472 memcpy (nindy_regs
.local_regs
, ®isters
[REGISTER_BYTE (R0_REGNUM
)], 16*4);
473 memcpy (nindy_regs
.global_regs
, ®isters
[REGISTER_BYTE (G0_REGNUM
)], 16*4);
474 memcpy (nindy_regs
.pcw_acw
, ®isters
[REGISTER_BYTE (PCW_REGNUM
)], 2*4);
475 memcpy (nindy_regs
.ip
, ®isters
[REGISTER_BYTE (IP_REGNUM
)], 1*4);
476 memcpy (nindy_regs
.tcw
, ®isters
[REGISTER_BYTE (TCW_REGNUM
)], 1*4);
477 /* Float regs. Only works on IEEE_FLOAT hosts. FIXME! */
478 for (regnum
= FP0_REGNUM
; regnum
< FP0_REGNUM
+ 4; regnum
++) {
479 ieee_extended_to_double (&ext_format_i960
,
480 ®isters
[REGISTER_BYTE (regnum
)], &dub
);
481 /* dub now in host byte order */
482 /* FIXME-someday, the arguments to unpack_double are backward.
483 It expects a target double and returns a host; we pass the opposite.
484 This mostly works but not quite. */
485 dub
= unpack_double (builtin_type_double
, (char *)&dub
, &inv
);
486 /* dub now in target byte order */
487 memcpy (&nindy_regs
.fp_as_double
[8 * (regnum
- FP0_REGNUM
)], &dub
, 8);
491 ninRegsPut( (char *) &nindy_regs
);
495 /* Read a word from remote address ADDR and return it.
496 * This goes through the data cache.
499 nindy_fetch_word (addr
)
502 return dcache_fetch (nindy_dcache
, addr
);
505 /* Write a word WORD into remote address ADDR.
506 This goes through the data cache. */
509 nindy_store_word (addr
, word
)
513 dcache_poke (nindy_dcache
, addr
, word
);
516 /* Copy LEN bytes to or from inferior's memory starting at MEMADDR
517 to debugger memory starting at MYADDR. Copy to inferior if
518 WRITE is nonzero. Returns the length copied.
520 This is stolen almost directly from infptrace.c's child_xfer_memory,
521 which also deals with a word-oriented memory interface. Sometime,
522 FIXME, rewrite this to not use the word-oriented routines. */
525 nindy_xfer_inferior_memory(memaddr
, myaddr
, len
, write
, target
)
530 struct target_ops
*target
; /* ignored */
533 /* Round starting address down to longword boundary. */
534 register CORE_ADDR addr
= memaddr
& - sizeof (int);
535 /* Round ending address up; get number of longwords that makes. */
537 = (((memaddr
+ len
) - addr
) + sizeof (int) - 1) / sizeof (int);
538 /* Allocate buffer of that many longwords. */
539 register int *buffer
= (int *) alloca (count
* sizeof (int));
543 /* Fill start and end extra bytes of buffer with existing memory data. */
545 if (addr
!= memaddr
|| len
< (int)sizeof (int)) {
546 /* Need part of initial word -- fetch it. */
547 buffer
[0] = nindy_fetch_word (addr
);
550 if (count
> 1) /* FIXME, avoid if even boundary */
553 = nindy_fetch_word (addr
+ (count
- 1) * sizeof (int));
556 /* Copy data to be written over corresponding part of buffer */
558 memcpy ((char *) buffer
+ (memaddr
& (sizeof (int) - 1)), myaddr
, len
);
560 /* Write the entire buffer. */
562 for (i
= 0; i
< count
; i
++, addr
+= sizeof (int))
565 nindy_store_word (addr
, buffer
[i
]);
572 /* Read all the longwords */
573 for (i
= 0; i
< count
; i
++, addr
+= sizeof (int))
576 buffer
[i
] = nindy_fetch_word (addr
);
582 /* Copy appropriate bytes out of the buffer. */
583 memcpy (myaddr
, (char *) buffer
+ (memaddr
& (sizeof (int) - 1)), len
);
589 nindy_create_inferior (execfile
, args
, env
)
598 error ("Can't pass arguments to remote NINDY process");
600 if (execfile
== 0 || exec_bfd
== 0)
601 error ("No exec file specified");
603 entry_pt
= (int) bfd_get_start_address (exec_bfd
);
607 #ifdef CREATE_INFERIOR_HOOK
608 CREATE_INFERIOR_HOOK (pid
);
611 /* The "process" (board) is already stopped awaiting our commands, and
612 the program is already downloaded. We just set its PC and go. */
614 inferior_pid
= pid
; /* Needed for wait_for_inferior below */
616 clear_proceed_status ();
618 /* Tell wait_for_inferior that we've started a new process. */
619 init_wait_for_inferior ();
621 /* Set up the "saved terminal modes" of the inferior
622 based on what modes we are starting it with. */
623 target_terminal_init ();
625 /* Install inferior's terminal modes. */
626 target_terminal_inferior ();
628 /* insert_step_breakpoint (); FIXME, do we need this? */
629 proceed ((CORE_ADDR
)entry_pt
, -1, 0); /* Let 'er rip... */
633 reset_command(args
, from_tty
)
637 if (nindy_serial
== NULL
)
639 error( "No target system to reset -- use 'target nindy' command.");
641 if ( query("Really reset the target system?",0,0) )
643 SERIAL_SEND_BREAK (nindy_serial
);
644 tty_flush (nindy_serial
);
649 nindy_kill (args
, from_tty
)
653 return; /* Ignore attempts to kill target system */
656 /* Clean up when a program exits.
658 The program actually lives on in the remote processor's RAM, and may be
659 run again without a download. Don't leave it full of breakpoint
663 nindy_mourn_inferior ()
665 remove_breakpoints ();
666 unpush_target (&nindy_ops
);
667 generic_mourn_inferior (); /* Do all the proper things now */
670 /* Pass the args the way catch_errors wants them. */
672 nindy_open_stub (arg
)
683 target_load (arg
, 1);
687 /* This routine is run as a hook, just before the main command loop is
688 entered. If gdb is configured for the i960, but has not had its
689 nindy target specified yet, this will loop prompting the user to do so.
691 Unlike the loop provided by Intel, we actually let the user get out
692 of this with a RETURN. This is useful when e.g. simply examining
693 an i960 object file on the host system. */
696 nindy_before_main_loop ()
701 while (current_target
!= &nindy_ops
) { /* remote tty not specified yet */
702 if ( instream
== stdin
){
703 printf("\nAttach /dev/ttyNN -- specify NN, or \"quit\" to quit: ");
706 fgets( ttyname
, sizeof(ttyname
)-1, stdin
);
708 /* Strip leading and trailing whitespace */
709 for ( p
= ttyname
; isspace(*p
); p
++ ){
713 return; /* User just hit spaces or return, wants out */
715 for ( p2
= p
; !isspace(*p2
) && (*p2
!= '\0'); p2
++ ){
719 if ( STREQ("quit",p
) ){
723 if (catch_errors (nindy_open_stub
, p
, "", RETURN_MASK_ALL
))
725 /* Now that we have a tty open for talking to the remote machine,
726 download the executable file if one was specified. */
729 catch_errors (load_stub
, bfd_get_filename (exec_bfd
), "",
736 /* Define the target subroutine names */
738 struct target_ops nindy_ops
= {
739 "nindy", "Remote serial target in i960 NINDY-specific protocol",
740 "Use a remote i960 system running NINDY connected by a serial line.\n\
741 Specify the name of the device the serial line is connected to.\n\
742 The speed (baud rate), whether to use the old NINDY protocol,\n\
743 and whether to send a break on startup, are controlled by options\n\
744 specified when you started GDB.",
745 nindy_open
, nindy_close
,
750 nindy_fetch_registers
, nindy_store_registers
,
751 nindy_prepare_to_store
,
752 nindy_xfer_inferior_memory
, nindy_files_info
,
753 0, 0, /* insert_breakpoint, remove_breakpoint, */
754 0, 0, 0, 0, 0, /* Terminal crud */
757 0, /* lookup_symbol */
758 nindy_create_inferior
,
759 nindy_mourn_inferior
,
761 0, /* notice_signals */
762 process_stratum
, 0, /* next */
763 1, 1, 1, 1, 1, /* all mem, mem, stack, regs, exec */
764 0, 0, /* Section pointers */
765 OPS_MAGIC
, /* Always the last thing */
771 add_target (&nindy_ops
);
772 add_com ("reset", class_obscure
, reset_command
,
773 "Send a 'break' to the remote target system.\n\
774 Only useful if the target has been equipped with a circuit\n\
775 to perform a hard reset when a break is detected.");