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 "floatformat.h"
113 #include <sys/file.h>
116 #include "nindy-share/env.h"
117 #include "nindy-share/stop.h"
120 #include "remote-utils.h"
122 static DCACHE
*nindy_dcache
;
125 extern char *getenv();
126 extern char *mktemp();
128 extern void generic_mourn_inferior ();
130 extern struct target_ops nindy_ops
;
131 extern GDB_FILE
*instream
;
133 extern char ninStopWhy ();
134 extern int ninMemGet ();
135 extern int ninMemPut ();
137 int nindy_initial_brk
; /* nonzero if want to send an initial BREAK to nindy */
138 int nindy_old_protocol
; /* nonzero if want to use old protocol */
139 char *nindy_ttyname
; /* name of tty to talk to nindy on, or null */
141 #define DLE '\020' /* Character NINDY sends to indicate user program has
146 /* From nindy-share/nindy.c. */
147 extern serial_t nindy_serial
;
149 static int have_regs
= 0; /* 1 iff regs read since i960 last halted */
150 static int regs_changed
= 0; /* 1 iff regs were modified since last read */
152 extern char *exists();
155 nindy_fetch_registers
PARAMS ((int));
158 nindy_store_registers
PARAMS ((int));
160 static char *savename
;
163 nindy_close (quitting
)
166 if (nindy_serial
!= NULL
)
167 SERIAL_CLOSE (nindy_serial
);
175 /* Open a connection to a remote debugger.
176 FIXME, there should be "set" commands for the options that are
177 now specified with gdb command-line options (old_protocol,
180 nindy_open (name
, from_tty
)
181 char *name
; /* "/dev/ttyXX", "ttyXX", or "XX": tty to be opened */
187 error_no_arg ("serial port device name");
189 target_preopen (from_tty
);
193 have_regs
= regs_changed
= 0;
194 nindy_dcache
= dcache_init(ninMemGet
, ninMemPut
);
196 /* Allow user to interrupt the following -- we could hang if there's
197 no NINDY at the other end of the remote tty. */
199 /* If baud_rate is -1, then ninConnect will not recognize the baud rate
200 and will deal with the situation in a (more or less) reasonable
202 sprintf(baudrate
, "%d", baud_rate
);
203 ninConnect(name
, baudrate
,
204 nindy_initial_brk
, !from_tty
, nindy_old_protocol
);
207 if (nindy_serial
== NULL
)
209 perror_with_name (name
);
212 savename
= savestring (name
, strlen (name
));
213 push_target (&nindy_ops
);
214 target_fetch_registers(-1);
217 /* User-initiated quit of nindy operations. */
220 nindy_detach (name
, from_tty
)
225 error ("Too many arguments");
232 /* FIXME: this lies about the baud rate if we autobauded. */
233 printf_unfiltered("\tAttached to %s at %d bits per second%s%s.\n", savename
,
235 nindy_old_protocol
? " in old protocol": "",
236 nindy_initial_brk
? " with initial break": "");
239 /* Return the number of characters in the buffer before
240 the first DLE character. */
245 char *buf
; /* Character buffer; NOT '\0'-terminated */
246 int n
; /* Number of characters in buffer */
250 for ( i
= 0; i
< n
; i
++ ){
251 if ( buf
[i
] == DLE
){
258 /* Tell the remote machine to resume. */
261 nindy_resume (pid
, step
, siggnal
)
263 enum target_signal siggnal
;
265 if (siggnal
!= TARGET_SIGNAL_0
&& siggnal
!= stop_signal
)
266 warning ("Can't send signals to remote NINDY targets.");
268 dcache_flush(nindy_dcache
);
270 nindy_store_registers (-1);
277 /* FIXME, we can probably use the normal terminal_inferior stuff here.
278 We have to do terminal_inferior and then set up the passthrough
279 settings initially. Thereafter, terminal_ours and terminal_inferior
280 will automatically swap the settings around for us. */
282 struct clean_up_tty_args
{
283 serial_ttystate state
;
286 static struct clean_up_tty_args tty_args
;
289 clean_up_tty (ptrarg
)
292 struct clean_up_tty_args
*args
= (struct clean_up_tty_args
*) ptrarg
;
293 SERIAL_SET_TTY_STATE (args
->serial
, args
->state
);
295 warning ("\n\nYou may need to reset the 80960 and/or reload your program.\n");
298 /* Recover from ^Z or ^C while remote process is running */
299 static void (*old_ctrlc
)();
301 static void (*old_ctrlz
)();
307 SERIAL_SET_TTY_STATE (tty_args
.serial
, tty_args
.state
);
308 free (tty_args
.state
);
310 signal(SIGINT
, old_ctrlc
);
312 signal(SIGTSTP
, old_ctrlz
);
314 error("\n\nYou may need to reset the 80960 and/or reload your program.\n");
317 /* Wait until the remote machine stops. While waiting, operate in passthrough
318 * mode; i.e., pass everything NINDY sends to gdb_stdout, and everything from
321 * Return to caller, storing status in 'status' just as `wait' would.
325 nindy_wait( pid
, status
)
327 struct target_waitstatus
*status
;
333 unsigned char stop_exit
;
334 unsigned char stop_code
;
335 struct cleanup
*old_cleanups
;
336 long ip_value
, fp_value
, sp_value
; /* Reg values from stop */
338 status
->kind
= TARGET_WAITKIND_EXITED
;
339 status
->value
.integer
= 0;
341 /* OPERATE IN PASSTHROUGH MODE UNTIL NINDY SENDS A DLE CHARACTER */
343 /* Save current tty attributes, and restore them when done. */
344 tty_args
.serial
= SERIAL_FDOPEN (0);
345 tty_args
.state
= SERIAL_GET_TTY_STATE (tty_args
.serial
);
346 old_ctrlc
= signal( SIGINT
, clean_up_int
);
348 old_ctrlz
= signal( SIGTSTP
, clean_up_int
);
351 old_cleanups
= make_cleanup (clean_up_tty
, &tty_args
);
353 /* Pass input from keyboard to NINDY as it arrives. NINDY will interpret
354 <CR> and perform echo. */
355 /* This used to set CBREAK and clear ECHO and CRMOD. I hope this is close
357 SERIAL_RAW (tty_args
.serial
);
361 /* Input on remote */
362 c
= SERIAL_READCHAR (nindy_serial
, -1);
363 if (c
== SERIAL_ERROR
)
365 error ("Cannot read from serial line");
367 else if (c
== 0x1b) /* ESC */
369 c
= SERIAL_READCHAR (nindy_serial
, -1);
372 else if (c
!= 0x10) /* DLE */
373 /* Write out any characters preceding DLE */
380 stop_exit
= ninStopWhy(&stop_code
,
381 &ip_value
, &fp_value
, &sp_value
);
382 if (!stop_exit
&& (stop_code
== STOP_SRQ
))
390 /* Get out of loop */
391 supply_register (IP_REGNUM
,
393 supply_register (FP_REGNUM
,
395 supply_register (SP_REGNUM
,
402 SERIAL_SET_TTY_STATE (tty_args
.serial
, tty_args
.state
);
403 free (tty_args
.state
);
404 discard_cleanups (old_cleanups
);
408 status
->kind
= TARGET_WAITKIND_EXITED
;
409 status
->value
.integer
= stop_code
;
413 /* nindy has some special stop code need to be handled */
414 if (stop_code
== STOP_GDB_BPT
)
415 stop_code
= TRACE_STEP
;
416 status
->kind
= TARGET_WAITKIND_STOPPED
;
417 status
->value
.sig
= i960_fault_to_signal (stop_code
);
422 /* Read the remote registers into the block REGS. */
424 /* This is the block that ninRegsGet and ninRegsPut handles. */
426 char local_regs
[16 * 4];
427 char global_regs
[16 * 4];
431 char fp_as_double
[4 * 8];
435 nindy_fetch_registers(regno
)
438 struct nindy_regs nindy_regs
;
443 ninRegsGet( (char *) &nindy_regs
);
446 memcpy (®isters
[REGISTER_BYTE (R0_REGNUM
)], nindy_regs
.local_regs
, 16*4);
447 memcpy (®isters
[REGISTER_BYTE (G0_REGNUM
)], nindy_regs
.global_regs
, 16*4);
448 memcpy (®isters
[REGISTER_BYTE (PCW_REGNUM
)], nindy_regs
.pcw_acw
, 2*4);
449 memcpy (®isters
[REGISTER_BYTE (IP_REGNUM
)], nindy_regs
.ip
, 1*4);
450 memcpy (®isters
[REGISTER_BYTE (TCW_REGNUM
)], nindy_regs
.tcw
, 1*4);
451 for (regnum
= FP0_REGNUM
; regnum
< FP0_REGNUM
+ 4; regnum
++) {
452 dub
= unpack_double (builtin_type_double
,
453 &nindy_regs
.fp_as_double
[8 * (regnum
- FP0_REGNUM
)],
455 /* dub now in host byte order */
456 floatformat_from_double (&floatformat_i960_ext
, &dub
,
457 ®isters
[REGISTER_BYTE (regnum
)]);
460 registers_fetched ();
464 nindy_prepare_to_store()
466 /* Fetch all regs if they aren't already here. */
467 read_register_bytes (0, NULL
, REGISTER_BYTES
);
471 nindy_store_registers(regno
)
474 struct nindy_regs nindy_regs
;
478 memcpy (nindy_regs
.local_regs
, ®isters
[REGISTER_BYTE (R0_REGNUM
)], 16*4);
479 memcpy (nindy_regs
.global_regs
, ®isters
[REGISTER_BYTE (G0_REGNUM
)], 16*4);
480 memcpy (nindy_regs
.pcw_acw
, ®isters
[REGISTER_BYTE (PCW_REGNUM
)], 2*4);
481 memcpy (nindy_regs
.ip
, ®isters
[REGISTER_BYTE (IP_REGNUM
)], 1*4);
482 memcpy (nindy_regs
.tcw
, ®isters
[REGISTER_BYTE (TCW_REGNUM
)], 1*4);
483 for (regnum
= FP0_REGNUM
; regnum
< FP0_REGNUM
+ 4; regnum
++)
485 floatformat_to_double (&floatformat_i960_ext
,
486 ®isters
[REGISTER_BYTE (regnum
)], &dub
);
487 store_floating (&nindy_regs
.fp_as_double
[8 * (regnum
- FP0_REGNUM
)],
488 REGISTER_VIRTUAL_SIZE (regnum
),
493 ninRegsPut( (char *) &nindy_regs
);
497 /* Read a word from remote address ADDR and return it.
498 * This goes through the data cache.
501 nindy_fetch_word (addr
)
504 return dcache_fetch (nindy_dcache
, addr
);
507 /* Write a word WORD into remote address ADDR.
508 This goes through the data cache. */
511 nindy_store_word (addr
, word
)
515 dcache_poke (nindy_dcache
, addr
, word
);
518 /* Copy LEN bytes to or from inferior's memory starting at MEMADDR
519 to debugger memory starting at MYADDR. Copy to inferior if
520 WRITE is nonzero. Returns the length copied.
522 This is stolen almost directly from infptrace.c's child_xfer_memory,
523 which also deals with a word-oriented memory interface. Sometime,
524 FIXME, rewrite this to not use the word-oriented routines. */
527 nindy_xfer_inferior_memory(memaddr
, myaddr
, len
, write
, target
)
532 struct target_ops
*target
; /* ignored */
535 /* Round starting address down to longword boundary. */
536 register CORE_ADDR addr
= memaddr
& - sizeof (int);
537 /* Round ending address up; get number of longwords that makes. */
539 = (((memaddr
+ len
) - addr
) + sizeof (int) - 1) / sizeof (int);
540 /* Allocate buffer of that many longwords. */
541 register int *buffer
= (int *) alloca (count
* sizeof (int));
545 /* Fill start and end extra bytes of buffer with existing memory data. */
547 if (addr
!= memaddr
|| len
< (int)sizeof (int)) {
548 /* Need part of initial word -- fetch it. */
549 buffer
[0] = nindy_fetch_word (addr
);
552 if (count
> 1) /* FIXME, avoid if even boundary */
555 = nindy_fetch_word (addr
+ (count
- 1) * sizeof (int));
558 /* Copy data to be written over corresponding part of buffer */
560 memcpy ((char *) buffer
+ (memaddr
& (sizeof (int) - 1)), myaddr
, len
);
562 /* Write the entire buffer. */
564 for (i
= 0; i
< count
; i
++, addr
+= sizeof (int))
567 nindy_store_word (addr
, buffer
[i
]);
574 /* Read all the longwords */
575 for (i
= 0; i
< count
; i
++, addr
+= sizeof (int))
578 buffer
[i
] = nindy_fetch_word (addr
);
584 /* Copy appropriate bytes out of the buffer. */
585 memcpy (myaddr
, (char *) buffer
+ (memaddr
& (sizeof (int) - 1)), len
);
591 nindy_create_inferior (execfile
, args
, env
)
600 error ("Can't pass arguments to remote NINDY process");
602 if (execfile
== 0 || exec_bfd
== 0)
603 error ("No exec file specified");
605 entry_pt
= (int) bfd_get_start_address (exec_bfd
);
609 /* The "process" (board) is already stopped awaiting our commands, and
610 the program is already downloaded. We just set its PC and go. */
612 inferior_pid
= pid
; /* Needed for wait_for_inferior below */
614 clear_proceed_status ();
616 /* Tell wait_for_inferior that we've started a new process. */
617 init_wait_for_inferior ();
619 /* Set up the "saved terminal modes" of the inferior
620 based on what modes we are starting it with. */
621 target_terminal_init ();
623 /* Install inferior's terminal modes. */
624 target_terminal_inferior ();
626 /* insert_step_breakpoint (); FIXME, do we need this? */
628 proceed ((CORE_ADDR
)entry_pt
, TARGET_SIGNAL_DEFAULT
, 0);
632 reset_command(args
, from_tty
)
636 if (nindy_serial
== NULL
)
638 error( "No target system to reset -- use 'target nindy' command.");
640 if ( query("Really reset the target system?",0,0) )
642 SERIAL_SEND_BREAK (nindy_serial
);
643 tty_flush (nindy_serial
);
648 nindy_kill (args
, from_tty
)
652 return; /* Ignore attempts to kill target system */
655 /* Clean up when a program exits.
657 The program actually lives on in the remote processor's RAM, and may be
658 run again without a download. Don't leave it full of breakpoint
662 nindy_mourn_inferior ()
664 remove_breakpoints ();
665 unpush_target (&nindy_ops
);
666 generic_mourn_inferior (); /* Do all the proper things now */
669 /* Pass the args the way catch_errors wants them. */
671 nindy_open_stub (arg
)
679 nindy_load( filename
, from_tty
)
684 /* Can't do unix style forking on a VMS system, so we'll use bfd to do
688 bfd
*file
= bfd_openr(filename
,0);
691 perror_with_name(filename
);
695 if (!bfd_check_format(file
, bfd_object
))
697 error("can't prove it's an object file\n");
701 for ( s
= file
->sections
; s
; s
=s
->next
)
703 if (s
->flags
& SEC_LOAD
)
705 char *buffer
= xmalloc(s
->_raw_size
);
706 bfd_get_section_contents(file
, s
, buffer
, 0, s
->_raw_size
);
707 printf("Loading section %s, size %x vma %x\n",
711 ninMemPut(s
->vma
, buffer
, s
->_raw_size
);
722 target_load (arg
, 1);
726 /* This routine is run as a hook, just before the main command loop is
727 entered. If gdb is configured for the i960, but has not had its
728 nindy target specified yet, this will loop prompting the user to do so.
730 Unlike the loop provided by Intel, we actually let the user get out
731 of this with a RETURN. This is useful when e.g. simply examining
732 an i960 object file on the host system. */
735 nindy_before_main_loop ()
740 while (target_stack
->target_ops
!= &nindy_ops
) /* What is this crap??? */
741 { /* remote tty not specified yet */
742 if ( instream
== stdin
){
743 printf_unfiltered("\nAttach /dev/ttyNN -- specify NN, or \"quit\" to quit: ");
744 gdb_flush( gdb_stdout
);
746 fgets( ttyname
, sizeof(ttyname
)-1, stdin
);
748 /* Strip leading and trailing whitespace */
749 for ( p
= ttyname
; isspace(*p
); p
++ ){
753 return; /* User just hit spaces or return, wants out */
755 for ( p2
= p
; !isspace(*p2
) && (*p2
!= '\0'); p2
++ ){
759 if ( STREQ("quit",p
) ){
763 if (catch_errors (nindy_open_stub
, p
, "", RETURN_MASK_ALL
))
765 /* Now that we have a tty open for talking to the remote machine,
766 download the executable file if one was specified. */
769 catch_errors (load_stub
, bfd_get_filename (exec_bfd
), "",
776 /* Define the target subroutine names */
778 struct target_ops nindy_ops
= {
779 "nindy", "Remote serial target in i960 NINDY-specific protocol",
780 "Use a remote i960 system running NINDY connected by a serial line.\n\
781 Specify the name of the device the serial line is connected to.\n\
782 The speed (baud rate), whether to use the old NINDY protocol,\n\
783 and whether to send a break on startup, are controlled by options\n\
784 specified when you started GDB.",
785 nindy_open
, nindy_close
,
790 nindy_fetch_registers
, nindy_store_registers
,
791 nindy_prepare_to_store
,
792 nindy_xfer_inferior_memory
, nindy_files_info
,
793 memory_insert_breakpoint
,
794 memory_remove_breakpoint
,
795 0, 0, 0, 0, 0, /* Terminal crud */
798 0, /* lookup_symbol */
799 nindy_create_inferior
,
800 nindy_mourn_inferior
,
802 0, /* notice_signals */
804 process_stratum
, 0, /* next */
805 1, 1, 1, 1, 1, /* all mem, mem, stack, regs, exec */
806 0, 0, /* Section pointers */
807 OPS_MAGIC
, /* Always the last thing */
813 add_target (&nindy_ops
);
814 add_com ("reset", class_obscure
, reset_command
,
815 "Send a 'break' to the remote target system.\n\
816 Only useful if the target has been equipped with a circuit\n\
817 to perform a hard reset when a break is detected.");