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"
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 FILE *instream;
132 extern struct ext_format ext_format_i960; /* i960-tdep.c */
134 extern char ninStopWhy ();
136 int nindy_initial_brk; /* nonzero if want to send an initial BREAK to nindy */
137 int nindy_old_protocol; /* nonzero if want to use old protocol */
138 char *nindy_ttyname; /* name of tty to talk to nindy on, or null */
140 #define DLE '\020' /* Character NINDY sends to indicate user program has
145 /* From nindy-share/nindy.c. */
146 extern serial_t nindy_serial;
148 static int have_regs = 0; /* 1 iff regs read since i960 last halted */
149 static int regs_changed = 0; /* 1 iff regs were modified since last read */
151 extern char *exists();
154 nindy_fetch_registers PARAMS ((int));
157 nindy_store_registers PARAMS ((int));
159 static char *savename;
162 nindy_close (quitting)
165 if (nindy_serial != NULL)
166 SERIAL_CLOSE (nindy_serial);
174 /* Open a connection to a remote debugger.
175 FIXME, there should be a way to specify the various options that are
176 now specified with gdb command-line options. (baud_rate, old_protocol,
179 nindy_open (name, from_tty)
180 char *name; /* "/dev/ttyXX", "ttyXX", or "XX": tty to be opened */
186 error_no_arg ("serial port device name");
188 target_preopen (from_tty);
192 have_regs = regs_changed = 0;
193 nindy_dcache = dcache_init(ninMemGet, ninMemPut);
195 /* Allow user to interrupt the following -- we could hang if there's
196 no NINDY at the other end of the remote tty. */
198 sprintf(baudrate, "%d", sr_get_baud_rate());
199 ninConnect(name, baudrate,
200 nindy_initial_brk, !from_tty, nindy_old_protocol);
203 if (nindy_serial == NULL)
205 perror_with_name (name);
208 savename = savestring (name, strlen (name));
209 push_target (&nindy_ops);
210 target_fetch_registers(-1);
213 /* User-initiated quit of nindy operations. */
216 nindy_detach (name, from_tty)
221 error ("Too many arguments");
228 printf("\tAttached to %s at %d bps%s%s.\n", savename,
230 nindy_old_protocol? " in old protocol": "",
231 nindy_initial_brk? " with initial break": "");
234 /* Return the number of characters in the buffer before
235 the first DLE character. */
240 char *buf; /* Character buffer; NOT '\0'-terminated */
241 int n; /* Number of characters in buffer */
245 for ( i = 0; i < n; i++ ){
246 if ( buf[i] == DLE ){
253 /* Tell the remote machine to resume. */
256 nindy_resume (pid, step, siggnal)
257 int pid, step, siggnal;
259 if (siggnal != 0 && siggnal != stop_signal)
260 error ("Can't send signals to remote NINDY targets.");
262 dcache_flush(nindy_dcache);
264 nindy_store_registers (-1);
271 /* FIXME, we can probably use the normal terminal_inferior stuff here.
272 We have to do terminal_inferior and then set up the passthrough
273 settings initially. Thereafter, terminal_ours and terminal_inferior
274 will automatically swap the settings around for us. */
276 struct clean_up_tty_args {
277 serial_ttystate state;
282 clean_up_tty (ptrarg)
285 struct clean_up_tty_args *args = (struct clean_up_tty_args *) ptrarg;
286 SERIAL_SET_TTY_STATE (args->serial, args->state);
289 You may need to reset the 80960 and/or reload your program.\n");
292 /* Wait until the remote machine stops. While waiting, operate in passthrough
293 * mode; i.e., pass everything NINDY sends to stdout, and everything from
296 * Return to caller, storing status in 'status' just as `wait' would.
304 char buf[500]; /* FIXME, what is "500" here? */
306 unsigned char stop_exit;
307 unsigned char stop_code;
308 struct clean_up_tty_args tty_args;
309 struct cleanup *old_cleanups;
310 long ip_value, fp_value, sp_value; /* Reg values from stop */
312 WSETEXIT( (*status), 0 );
314 /* OPERATE IN PASSTHROUGH MODE UNTIL NINDY SENDS A DLE CHARACTER */
316 /* Save current tty attributes, and restore them when done. */
317 tty_args.serial = SERIAL_FDOPEN (0);
318 tty_args.state = SERIAL_GET_TTY_STATE (tty_args.serial);
319 old_cleanups = make_cleanup (clean_up_tty, &tty_args);
321 /* Pass input from keyboard to NINDY as it arrives. NINDY will interpret
322 <CR> and perform echo. */
323 /* This used to set CBREAK and clear ECHO and CRMOD. I hope this is close
325 SERIAL_RAW (tty_args.serial);
329 /* Wait for input on either the remote port or stdin. */
332 FD_SET (nindy_serial->fd, &fds);
333 if (select (nindy_serial->fd + 1, &fds, 0, 0, 0) <= 0)
336 /* Pass input through to correct place */
337 if (FD_ISSET (0, &fds))
340 n = read (0, buf, sizeof (buf));
343 SERIAL_WRITE (nindy_serial, buf, n );
347 if (FD_ISSET (nindy_serial->fd, &fds))
349 /* Input on remote */
350 n = read (nindy_serial->fd, buf, sizeof (buf));
353 /* Write out any characters in buffer preceding DLE */
354 i = non_dle( buf, n );
362 /* There *was* a DLE in the buffer */
363 stop_exit = ninStopWhy(&stop_code,
364 &ip_value, &fp_value, &sp_value);
365 if (!stop_exit && (stop_code == STOP_SRQ))
373 /* Get out of loop */
374 supply_register (IP_REGNUM,
376 supply_register (FP_REGNUM,
378 supply_register (SP_REGNUM,
387 do_cleanups (old_cleanups);
391 /* User program exited */
392 WSETEXIT ((*status), stop_code);
401 /* Breakpoint or single stepping. */
405 /* The target is not running Unix, and its faults/traces do
406 not map nicely into Unix signals. Make sure they do not
407 get confused with Unix signals by numbering them with
408 values higher than the highest legal Unix signal. code
409 in i960_print_fault(), called via PRINT_RANDOM_SIGNAL,
410 will interpret the value. */
414 WSETSTOP ((*status), stop_code);
419 /* Read the remote registers into the block REGS. */
421 /* This is the block that ninRegsGet and ninRegsPut handles. */
423 char local_regs[16 * 4];
424 char global_regs[16 * 4];
428 char fp_as_double[4 * 8];
432 nindy_fetch_registers(regno)
435 struct nindy_regs nindy_regs;
440 ninRegsGet( (char *) &nindy_regs );
443 memcpy (®isters[REGISTER_BYTE (R0_REGNUM)], nindy_regs.local_regs, 16*4);
444 memcpy (®isters[REGISTER_BYTE (G0_REGNUM)], nindy_regs.global_regs, 16*4);
445 memcpy (®isters[REGISTER_BYTE (PCW_REGNUM)], nindy_regs.pcw_acw, 2*4);
446 memcpy (®isters[REGISTER_BYTE (IP_REGNUM)], nindy_regs.ip, 1*4);
447 memcpy (®isters[REGISTER_BYTE (TCW_REGNUM)], nindy_regs.tcw, 1*4);
448 for (regnum = FP0_REGNUM; regnum < FP0_REGNUM + 4; regnum++) {
449 dub = unpack_double (builtin_type_double,
450 &nindy_regs.fp_as_double[8 * (regnum - FP0_REGNUM)],
452 /* dub now in host byte order */
453 double_to_ieee_extended (&ext_format_i960, &dub,
454 ®isters[REGISTER_BYTE (regnum)]);
457 registers_fetched ();
461 nindy_prepare_to_store()
463 /* Fetch all regs if they aren't already here. */
464 read_register_bytes (0, NULL, REGISTER_BYTES);
468 nindy_store_registers(regno)
471 struct nindy_regs nindy_regs;
475 memcpy (nindy_regs.local_regs, ®isters[REGISTER_BYTE (R0_REGNUM)], 16*4);
476 memcpy (nindy_regs.global_regs, ®isters[REGISTER_BYTE (G0_REGNUM)], 16*4);
477 memcpy (nindy_regs.pcw_acw, ®isters[REGISTER_BYTE (PCW_REGNUM)], 2*4);
478 memcpy (nindy_regs.ip, ®isters[REGISTER_BYTE (IP_REGNUM)], 1*4);
479 memcpy (nindy_regs.tcw, ®isters[REGISTER_BYTE (TCW_REGNUM)], 1*4);
480 /* Float regs. Only works on IEEE_FLOAT hosts. FIXME! */
481 for (regnum = FP0_REGNUM; regnum < FP0_REGNUM + 4; regnum++) {
482 ieee_extended_to_double (&ext_format_i960,
483 ®isters[REGISTER_BYTE (regnum)], &dub);
484 /* dub now in host byte order */
485 /* FIXME-someday, the arguments to unpack_double are backward.
486 It expects a target double and returns a host; we pass the opposite.
487 This mostly works but not quite. */
488 dub = unpack_double (builtin_type_double, (char *)&dub, &inv);
489 /* dub now in target byte order */
490 memcpy (&nindy_regs.fp_as_double[8 * (regnum - FP0_REGNUM)], &dub, 8);
494 ninRegsPut( (char *) &nindy_regs );
498 /* Read a word from remote address ADDR and return it.
499 * This goes through the data cache.
502 nindy_fetch_word (addr)
505 return dcache_fetch (nindy_dcache, addr);
508 /* Write a word WORD into remote address ADDR.
509 This goes through the data cache. */
512 nindy_store_word (addr, word)
516 dcache_poke (nindy_dcache, addr, word);
519 /* Copy LEN bytes to or from inferior's memory starting at MEMADDR
520 to debugger memory starting at MYADDR. Copy to inferior if
521 WRITE is nonzero. Returns the length copied.
523 This is stolen almost directly from infptrace.c's child_xfer_memory,
524 which also deals with a word-oriented memory interface. Sometime,
525 FIXME, rewrite this to not use the word-oriented routines. */
528 nindy_xfer_inferior_memory(memaddr, myaddr, len, write, target)
533 struct target_ops *target; /* ignored */
536 /* Round starting address down to longword boundary. */
537 register CORE_ADDR addr = memaddr & - sizeof (int);
538 /* Round ending address up; get number of longwords that makes. */
540 = (((memaddr + len) - addr) + sizeof (int) - 1) / sizeof (int);
541 /* Allocate buffer of that many longwords. */
542 register int *buffer = (int *) alloca (count * sizeof (int));
546 /* Fill start and end extra bytes of buffer with existing memory data. */
548 if (addr != memaddr || len < (int)sizeof (int)) {
549 /* Need part of initial word -- fetch it. */
550 buffer[0] = nindy_fetch_word (addr);
553 if (count > 1) /* FIXME, avoid if even boundary */
556 = nindy_fetch_word (addr + (count - 1) * sizeof (int));
559 /* Copy data to be written over corresponding part of buffer */
561 memcpy ((char *) buffer + (memaddr & (sizeof (int) - 1)), myaddr, len);
563 /* Write the entire buffer. */
565 for (i = 0; i < count; i++, addr += sizeof (int))
568 nindy_store_word (addr, buffer[i]);
575 /* Read all the longwords */
576 for (i = 0; i < count; i++, addr += sizeof (int))
579 buffer[i] = nindy_fetch_word (addr);
585 /* Copy appropriate bytes out of the buffer. */
586 memcpy (myaddr, (char *) buffer + (memaddr & (sizeof (int) - 1)), len);
592 nindy_create_inferior (execfile, args, env)
601 error ("Can't pass arguments to remote NINDY process");
603 if (execfile == 0 || exec_bfd == 0)
604 error ("No exec file specified");
606 entry_pt = (int) bfd_get_start_address (exec_bfd);
610 #ifdef CREATE_INFERIOR_HOOK
611 CREATE_INFERIOR_HOOK (pid);
614 /* The "process" (board) is already stopped awaiting our commands, and
615 the program is already downloaded. We just set its PC and go. */
617 inferior_pid = pid; /* Needed for wait_for_inferior below */
619 clear_proceed_status ();
621 /* Tell wait_for_inferior that we've started a new process. */
622 init_wait_for_inferior ();
624 /* Set up the "saved terminal modes" of the inferior
625 based on what modes we are starting it with. */
626 target_terminal_init ();
628 /* Install inferior's terminal modes. */
629 target_terminal_inferior ();
631 /* insert_step_breakpoint (); FIXME, do we need this? */
632 proceed ((CORE_ADDR)entry_pt, -1, 0); /* Let 'er rip... */
636 reset_command(args, from_tty)
640 if (nindy_serial == NULL)
642 error( "No target system to reset -- use 'target nindy' command.");
644 if ( query("Really reset the target system?",0,0) )
646 SERIAL_SEND_BREAK (nindy_serial);
647 tty_flush (nindy_serial);
652 nindy_kill (args, from_tty)
656 return; /* Ignore attempts to kill target system */
659 /* Clean up when a program exits.
661 The program actually lives on in the remote processor's RAM, and may be
662 run again without a download. Don't leave it full of breakpoint
666 nindy_mourn_inferior ()
668 remove_breakpoints ();
669 unpush_target (&nindy_ops);
670 generic_mourn_inferior (); /* Do all the proper things now */
673 /* Pass the args the way catch_errors wants them. */
675 nindy_open_stub (arg)
686 target_load (arg, 1);
690 /* This routine is run as a hook, just before the main command loop is
691 entered. If gdb is configured for the i960, but has not had its
692 nindy target specified yet, this will loop prompting the user to do so.
694 Unlike the loop provided by Intel, we actually let the user get out
695 of this with a RETURN. This is useful when e.g. simply examining
696 an i960 object file on the host system. */
699 nindy_before_main_loop ()
704 while (current_target != &nindy_ops) { /* remote tty not specified yet */
705 if ( instream == stdin ){
706 printf("\nAttach /dev/ttyNN -- specify NN, or \"quit\" to quit: ");
709 fgets( ttyname, sizeof(ttyname)-1, stdin );
711 /* Strip leading and trailing whitespace */
712 for ( p = ttyname; isspace(*p); p++ ){
716 return; /* User just hit spaces or return, wants out */
718 for ( p2= p; !isspace(*p2) && (*p2 != '\0'); p2++ ){
722 if ( STREQ("quit",p) ){
726 if (catch_errors (nindy_open_stub, p, "", RETURN_MASK_ALL))
728 /* Now that we have a tty open for talking to the remote machine,
729 download the executable file if one was specified. */
732 catch_errors (load_stub, bfd_get_filename (exec_bfd), "",
739 /* Define the target subroutine names */
741 struct target_ops nindy_ops = {
742 "nindy", "Remote serial target in i960 NINDY-specific protocol",
743 "Use a remote i960 system running NINDY connected by a serial line.\n\
744 Specify the name of the device the serial line is connected to.\n\
745 The speed (baud rate), whether to use the old NINDY protocol,\n\
746 and whether to send a break on startup, are controlled by options\n\
747 specified when you started GDB.",
748 nindy_open, nindy_close,
753 nindy_fetch_registers, nindy_store_registers,
754 nindy_prepare_to_store,
755 nindy_xfer_inferior_memory, nindy_files_info,
756 0, 0, /* insert_breakpoint, remove_breakpoint, */
757 0, 0, 0, 0, 0, /* Terminal crud */
760 0, /* lookup_symbol */
761 nindy_create_inferior,
762 nindy_mourn_inferior,
764 0, /* notice_signals */
765 process_stratum, 0, /* next */
766 1, 1, 1, 1, 1, /* all mem, mem, stack, regs, exec */
767 0, 0, /* Section pointers */
768 OPS_MAGIC, /* Always the last thing */
774 add_target (&nindy_ops);
775 add_com ("reset", class_obscure, reset_command,
776 "Send a 'break' to the remote target system.\n\
777 Only useful if the target has been equipped with a circuit\n\
778 to perform a hard reset when a break is detected.");