diff options
Diffstat (limited to 'gdb/remote-mips.c')
| -rw-r--r-- | gdb/remote-mips.c | 1246 |
1 files changed, 1246 insertions, 0 deletions
diff --git a/gdb/remote-mips.c b/gdb/remote-mips.c new file mode 100644 index 0000000..6c559f1 --- /dev/null +++ b/gdb/remote-mips.c @@ -0,0 +1,1246 @@ +/* Remote debugging interface for MIPS remote debugging protocol. + Copyright 1993 Free Software Foundation, Inc. + Contributed by Cygnus Support. Written by Ian Lance Taylor + <ian@cygnus.com>. + +This file is part of GDB. + +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 +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +You should have received a copy of the GNU General Public License +along with this program; if not, write to the Free Software +Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA. */ + +#include "defs.h" +#include "inferior.h" +#include "bfd.h" +#include "wait.h" +#include "gdbcmd.h" +#include "gdbcore.h" +#include "serial.h" +#include "target.h" + +#include <signal.h> + +/* Prototypes for local functions. */ + +static int +mips_readchar PARAMS ((int timeout)); + +static int +mips_receive_header PARAMS ((unsigned char *hdr, int *pgarbage, int ch, + int timeout)); + +static int +mips_receive_trailer PARAMS ((unsigned char *trlr, int *pgarbage, int *pch, + int timeout)); + +static int mips_cksum PARAMS ((const unsigned char *hdr, + const unsigned char *data, + int len)); + +static void +mips_send_packet PARAMS ((const char *s)); + +static int +mips_receive_packet PARAMS ((char *buff)); + +static int +mips_request PARAMS ((char cmd, unsigned int addr, unsigned int data, + int *perr)); + +static void +mips_open PARAMS ((char *name, int from_tty)); + +static void +mips_close PARAMS ((int quitting)); + +static void +mips_detach PARAMS ((char *args, int from_tty)); + +static void +mips_resume PARAMS ((int step, int siggnal)); + +static int +mips_wait PARAMS ((WAITTYPE *status)); + +static int +mips_map_regno PARAMS ((int regno)); + +static void +mips_fetch_registers PARAMS ((int regno)); + +static void +mips_prepare_to_store PARAMS ((void)); + +static void +mips_store_registers PARAMS ((int regno)); + +static int +mips_fetch_word PARAMS ((CORE_ADDR addr)); + +static void +mips_store_word PARAMS ((CORE_ADDR addr, int value)); + +static int +mips_xfer_memory PARAMS ((CORE_ADDR memaddr, char *myaddr, int len, + int write, struct target_ops *ignore)); + +static void +mips_files_info PARAMS ((struct target_ops *ignore)); + +static void +mips_load PARAMS ((char *args, int from_tty)); + +static void +mips_create_inferior PARAMS ((char *execfile, char *args, char **env)); + +static void +mips_mourn_inferior PARAMS ((void)); + +/* A forward declaration. */ +extern struct target_ops mips_ops; + +/* The MIPS remote debugging interface is built on top of a simple + packet protocol. Each packet is organized as follows: + + SYN The first character is always a SYN (ASCII 026, or ^V). SYN + may not appear anywhere else in the packet. Any time a SYN is + seen, a new packet should be assumed to have begun. + + TYPE_LEN + This byte contains the upper five bits of the logical length + of the data section, plus a single bit indicating whether this + is a data packet or an acknowledgement. The documentation + indicates that this bit is 1 for a data packet, but the actual + board uses 1 for an acknowledgement. The value of the byte is + 0x40 + (ack ? 0x20 : 0) + (len >> 6) + (we always have 0 <= len < 1024). Acknowledgement packets do + not carry data, and must have a data length of 0. + + LEN1 This byte contains the lower six bits of the logical length of + the data section. The value is + 0x40 + (len & 0x3f) + + SEQ This byte contains the six bit sequence number of the packet. + The value is + 0x40 + seq + An acknowlegment packet contains the sequence number of the + packet being acknowledged plus 1 module 64. Data packets are + transmitted in sequence. There may only be one outstanding + unacknowledged data packet at a time. The sequence numbers + are independent in each direction. If an acknowledgement for + the previous packet is received (i.e., an acknowledgement with + the sequence number of the packet just sent) the packet just + sent should be retransmitted. If no acknowledgement is + received within a timeout period, the packet should be + retransmitted. This has an unfortunate failure condition on a + high-latency line, as a delayed acknowledgement may lead to an + endless series of duplicate packets. + + DATA The actual data bytes follow. The following characters are + escaped inline with DLE (ASCII 020, or ^P): + SYN (026) DLE S + DLE (020) DLE D + ^C (003) DLE C + ^S (023) DLE s + ^Q (021) DLE q + The additional DLE characters are not counted in the logical + length stored in the TYPE_LEN and LEN1 bytes. + + CSUM1 + CSUM2 + CSUM3 + These bytes contain an 18 bit checksum of the complete + contents of the packet excluding the SEQ byte and the + CSUM[123] bytes. The checksum is simply the twos complement + addition of all the bytes treated as unsigned characters. The + values of the checksum bytes are: + CSUM1: 0x40 + ((cksum >> 12) & 0x3f) + CSUM2: 0x40 + ((cksum >> 6) & 0x3f) + CSUM3: 0x40 + (cksum & 0x3f) + + It happens that the MIPS remote debugging protocol always + communicates with ASCII strings. Because of this, this + implementation doesn't bother to handle the DLE quoting mechanism, + since it will never be required. */ + +/* The SYN character which starts each packet. */ +#define SYN '\026' + +/* The 0x40 used to offset each packet (this value ensures that all of + the header and trailer bytes, other than SYN, are printable ASCII + characters). */ +#define HDR_OFFSET 0x40 + +/* The indices of the bytes in the packet header. */ +#define HDR_INDX_SYN 0 +#define HDR_INDX_TYPE_LEN 1 +#define HDR_INDX_LEN1 2 +#define HDR_INDX_SEQ 3 +#define HDR_LENGTH 4 + +/* The data/ack bit in the TYPE_LEN header byte. */ +#define TYPE_LEN_DA_BIT 0x20 +#define TYPE_LEN_DATA 0 +#define TYPE_LEN_ACK TYPE_LEN_DA_BIT + +/* How to compute the header bytes. */ +#define HDR_SET_SYN(data, len, seq) (SYN) +#define HDR_SET_TYPE_LEN(data, len, seq) \ + (HDR_OFFSET \ + + ((data) ? TYPE_LEN_DATA : TYPE_LEN_ACK) \ + + (((len) >> 6) & 0x1f)) +#define HDR_SET_LEN1(data, len, seq) (HDR_OFFSET + ((len) & 0x3f)) +#define HDR_SET_SEQ(data, len, seq) (HDR_OFFSET + (seq)) + +/* Check that a header byte is reasonable. */ +#define HDR_CHECK(ch) (((ch) & HDR_OFFSET) == HDR_OFFSET) + +/* Get data from the header. These macros evaluate their argument + multiple times. */ +#define HDR_IS_DATA(hdr) \ + (((hdr)[HDR_INDX_TYPE_LEN] & TYPE_LEN_DA_BIT) == TYPE_LEN_DATA) +#define HDR_GET_LEN(hdr) \ + ((((hdr)[HDR_INDX_TYPE_LEN] & 0x1f) << 6) + (((hdr)[HDR_INDX_LEN1] & 0x3f))) +#define HDR_GET_SEQ(hdr) ((hdr)[HDR_INDX_SEQ] & 0x3f) + +/* The maximum data length. */ +#define DATA_MAXLEN 1023 + +/* The trailer offset. */ +#define TRLR_OFFSET HDR_OFFSET + +/* The indices of the bytes in the packet trailer. */ +#define TRLR_INDX_CSUM1 0 +#define TRLR_INDX_CSUM2 1 +#define TRLR_INDX_CSUM3 2 +#define TRLR_LENGTH 3 + +/* How to compute the trailer bytes. */ +#define TRLR_SET_CSUM1(cksum) (TRLR_OFFSET + (((cksum) >> 12) & 0x3f)) +#define TRLR_SET_CSUM2(cksum) (TRLR_OFFSET + (((cksum) >> 6) & 0x3f)) +#define TRLR_SET_CSUM3(cksum) (TRLR_OFFSET + (((cksum) ) & 0x3f)) + +/* Check that a trailer byte is reasonable. */ +#define TRLR_CHECK(ch) (((ch) & TRLR_OFFSET) == TRLR_OFFSET) + +/* Get data from the trailer. This evaluates its argument multiple + times. */ +#define TRLR_GET_CKSUM(trlr) \ + ((((trlr)[TRLR_INDX_CSUM1] & 0x3f) << 12) \ + + (((trlr)[TRLR_INDX_CSUM2] & 0x3f) << 6) \ + + ((trlr)[TRLR_INDX_CSUM3] & 0x3f)) + +/* The sequence number modulos. */ +#define SEQ_MODULOS (64) + +/* Set to 1 if the target is open. */ +static int mips_is_open; + +/* The next sequence number to send. */ +static int mips_send_seq; + +/* The next sequence number we expect to receive. */ +static int mips_receive_seq; + +/* The time to wait before retransmitting a packet, in seconds. */ +static int mips_retransmit_wait = 3; + +/* The number of times to try retransmitting a packet before giving up. */ +static int mips_send_retries = 10; + +/* The number of garbage characters to accept when looking for an + SYN for the next packet. */ +static int mips_syn_garbage = 1050; + +/* The time to wait for a packet, in seconds. */ +static int mips_receive_wait = 30; + +/* Set if we have sent a packet to the board but have not yet received + a reply. */ +static int mips_need_reply = 0; + +/* This can be set to get debugging with ``set remotedebug''. */ +static int mips_debug = 0; + +/* Read a character from the remote, aborting on error. Returns -2 on + timeout (since that's what serial_readchar returns). */ + +static int +mips_readchar (timeout) + int timeout; +{ + int ch; + + ch = serial_readchar (timeout); + if (ch == EOF) + error ("End of file from remote"); + if (ch == -3) + error ("Error reading from remote: %s", safe_strerror (errno)); + if (mips_debug > 1) + { + if (ch != -2) + printf_filtered ("Read '%c' %d 0x%x\n", ch, ch, ch); + else + printf_filtered ("Timed out in read\n"); + } + return ch; +} + +/* Get a packet header, putting the data in the supplied buffer. + PGARBAGE is a pointer to the number of garbage characters received + so far. CH is the last character received. Returns 0 for success, + or -1 for timeout. */ + +static int +mips_receive_header (hdr, pgarbage, ch, timeout) + unsigned char *hdr; + int *pgarbage; + int ch; + int timeout; +{ + int i; + + while (1) + { + /* Wait for a SYN. mips_syn_garbage is intended to prevent + sitting here indefinitely if the board sends us one garbage + character per second. ch may already have a value from the + last time through the loop. */ + while (ch != SYN) + { + ch = mips_readchar (timeout); + if (ch == -2) + return -1; + if (ch != SYN) + { + /* Printing the character here lets the user of gdb see + what the program is outputting, if the debugging is + being done on the console port. FIXME: Perhaps this + should be filtered? */ + putchar (ch); + + ++*pgarbage; + if (*pgarbage > mips_syn_garbage) + error ("Remote debugging protocol failure"); + } + } + + /* Get the packet header following the SYN. */ + for (i = 1; i < HDR_LENGTH; i++) + { + ch = mips_readchar (timeout); + if (ch == -2) + return -1; + + /* Make sure this is a header byte. */ + if (ch == SYN || ! HDR_CHECK (ch)) + break; + + hdr[i] = ch; + } + + /* If we got the complete header, we can return. Otherwise we + loop around and keep looking for SYN. */ + if (i >= HDR_LENGTH) + return 0; + } +} + +/* Get a packet header, putting the data in the supplied buffer. + PGARBAGE is a pointer to the number of garbage characters received + so far. The last character read is returned in *PCH. Returns 0 + for success, -1 for timeout, -2 for error. */ + +static int +mips_receive_trailer (trlr, pgarbage, pch, timeout) + unsigned char *trlr; + int *pgarbage; + int *pch; + int timeout; +{ + int i; + int ch; + + for (i = 0; i < TRLR_LENGTH; i++) + { + ch = mips_readchar (timeout); + *pch = ch; + if (ch == -2) + return -1; + if (! TRLR_CHECK (ch)) + return -2; + trlr[i] = ch; + } + return 0; +} + +/* Get the checksum of a packet. HDR points to the packet header. + DATA points to the packet data. LEN is the length of DATA. */ + +static int +mips_cksum (hdr, data, len) + const unsigned char *hdr; + const unsigned char *data; + int len; +{ + register const unsigned char *p; + register int c; + register int cksum; + + cksum = 0; + + /* The initial SYN is not included in the checksum. */ + c = HDR_LENGTH - 1; + p = hdr + 1; + while (c-- != 0) + cksum += *p++; + + c = len; + p = data; + while (c-- != 0) + cksum += *p++; + + return cksum; +} + +/* Send a packet containing the given ASCII string. */ + +static void +mips_send_packet (s) + const char *s; +{ + unsigned int len; + unsigned char *packet; + register int cksum; + int try; + + len = strlen (s); + if (len > DATA_MAXLEN) + error ("MIPS protocol data packet too long: %s", s); + + packet = (unsigned char *) alloca (HDR_LENGTH + len + TRLR_LENGTH + 1); + + packet[HDR_INDX_SYN] = HDR_SET_SYN (1, len, mips_send_seq); + packet[HDR_INDX_TYPE_LEN] = HDR_SET_TYPE_LEN (1, len, mips_send_seq); + packet[HDR_INDX_LEN1] = HDR_SET_LEN1 (1, len, mips_send_seq); + packet[HDR_INDX_SEQ] = HDR_SET_SEQ (1, len, mips_send_seq); + + memcpy (packet + HDR_LENGTH, s, len); + + cksum = mips_cksum (packet, packet + HDR_LENGTH, len); + packet[HDR_LENGTH + len + TRLR_INDX_CSUM1] = TRLR_SET_CSUM1 (cksum); + packet[HDR_LENGTH + len + TRLR_INDX_CSUM2] = TRLR_SET_CSUM2 (cksum); + packet[HDR_LENGTH + len + TRLR_INDX_CSUM3] = TRLR_SET_CSUM3 (cksum); + + /* Increment the sequence number. This will set mips_send_seq to + the sequence number we expect in the acknowledgement. */ + mips_send_seq = (mips_send_seq + 1) % SEQ_MODULOS; + + /* We can only have one outstanding data packet, so we just wait for + the acknowledgement here. Keep retransmitting the packet until + we get one, or until we've tried too many times. */ + for (try = 0; try < mips_send_retries; try++) + { + int garbage; + int ch; + + if (mips_debug > 0) + { + packet[HDR_LENGTH + len + TRLR_LENGTH] = '\0'; + printf_filtered ("Writing \"%s\"\n", packet + 1); + } + + if (serial_write (packet, HDR_LENGTH + len + TRLR_LENGTH) == 0) + error ("write to target failed: %s", safe_strerror (errno)); + + garbage = 0; + ch = 0; + while (1) + { + unsigned char hdr[HDR_LENGTH + 1]; + unsigned char trlr[TRLR_LENGTH + 1]; + int err; + int seq; + + /* Get the packet header. If we time out, resend the data + packet. */ + err = mips_receive_header (hdr, &garbage, ch, mips_retransmit_wait); + if (err != 0) + break; + + ch = 0; + + /* If we get a data packet, assume it is a duplicate and + ignore it. FIXME: If the acknowledgement is lost, this + data packet may be the packet the remote sends after the + acknowledgement. */ + if (HDR_IS_DATA (hdr)) + continue; + + /* If the length is not 0, this is a garbled packet. */ + if (HDR_GET_LEN (hdr) != 0) + continue; + + /* Get the packet trailer. */ + err = mips_receive_trailer (trlr, &garbage, &ch, + mips_retransmit_wait); + + /* If we timed out, resend the data packet. */ + if (err == -1) + break; + + /* If we got a bad character, reread the header. */ + if (err != 0) + continue; + + /* If the checksum does not match the trailer checksum, this + is a bad packet; ignore it. */ + if (mips_cksum (hdr, (unsigned char *) NULL, 0) + != TRLR_GET_CKSUM (trlr)) + continue; + + if (mips_debug > 0) + { + hdr[HDR_LENGTH] = '\0'; + trlr[TRLR_LENGTH] = '\0'; + printf_filtered ("Got ack %d \"%s%s\"\n", + HDR_GET_SEQ (hdr), hdr, trlr); + } + + /* If this ack is for the current packet, we're done. */ + seq = HDR_GET_SEQ (hdr); + if (seq == mips_send_seq) + return; + + /* If this ack is for the last packet, resend the current + packet. */ + if ((seq + 1) % SEQ_MODULOS == mips_send_seq) + break; + + /* Otherwise this is a bad ack; ignore it. Increment the + garbage count to ensure that we do not stay in this loop + forever. */ + ++garbage; + } + } + + error ("Remote did not acknowledge packet"); +} + +/* Receive and acknowledge a packet, returning the data in BUFF (which + should be DATA_MAXLEN + 1 bytes). The protocol documentation + implies that only the sender retransmits packets, so this code just + waits silently for a packet. It returns the length of the received + packet. */ + +static int +mips_receive_packet (buff) + char *buff; +{ + int ch; + int garbage; + int len; + unsigned char ack[HDR_LENGTH + TRLR_LENGTH + 1]; + int cksum; + + ch = 0; + garbage = 0; + while (1) + { + unsigned char hdr[HDR_LENGTH]; + unsigned char trlr[TRLR_LENGTH]; + int i; + int err; + + if (mips_receive_header (hdr, &garbage, ch, mips_receive_wait) != 0) + error ("Timed out waiting for remote packet"); + + ch = 0; + + /* An acknowledgement is probably a duplicate; ignore it. */ + if (! HDR_IS_DATA (hdr)) + { + if (mips_debug > 0) + printf_filtered ("Ignoring unexpected ACK\n"); + continue; + } + + /* If this is the wrong sequence number, ignore it. */ + if (HDR_GET_SEQ (hdr) != mips_receive_seq) + { + if (mips_debug > 0) + printf_filtered ("Ignoring sequence number %d (want %d)\n", + HDR_GET_SEQ (hdr), mips_receive_seq); + continue; + } + + len = HDR_GET_LEN (hdr); + + for (i = 0; i < len; i++) + { + int rch; + + rch = mips_readchar (mips_receive_wait); + if (rch == SYN) + { + ch = SYN; + break; + } + if (rch == -2) + error ("Timed out waiting for remote packet"); + buff[i] = rch; + } + + if (i < len) + { + if (mips_debug > 0) + printf_filtered ("Got new SYN after %d chars (wanted %d)\n", + i, len); + continue; + } + + err = mips_receive_trailer (trlr, &garbage, &ch, mips_receive_wait); + if (err == -1) + error ("Timed out waiting for packet"); + if (err == -2) + { + if (mips_debug > 0) + printf_filtered ("Got SYN when wanted trailer\n"); + continue; + } + + if (mips_cksum (hdr, buff, len) == TRLR_GET_CKSUM (trlr)) + break; + + if (mips_debug > 0) + printf_filtered ("Bad checksum; data %d, trailer %d\n", + mips_cksum (hdr, buff, len), + TRLR_GET_CKSUM (trlr)); + + /* The checksum failed. Send an acknowledgement for the + previous packet to tell the remote to resend the packet. */ + ack[HDR_INDX_SYN] = HDR_SET_SYN (0, 0, mips_receive_seq); + ack[HDR_INDX_TYPE_LEN] = HDR_SET_TYPE_LEN (0, 0, mips_receive_seq); + ack[HDR_INDX_LEN1] = HDR_SET_LEN1 (0, 0, mips_receive_seq); + ack[HDR_INDX_SEQ] = HDR_SET_SEQ (0, 0, mips_receive_seq); + + cksum = mips_cksum (ack, (unsigned char *) NULL, 0); + + ack[HDR_LENGTH + TRLR_INDX_CSUM1] = TRLR_SET_CSUM1 (cksum); + ack[HDR_LENGTH + TRLR_INDX_CSUM2] = TRLR_SET_CSUM2 (cksum); + ack[HDR_LENGTH + TRLR_INDX_CSUM3] = TRLR_SET_CSUM3 (cksum); + + if (mips_debug > 0) + { + ack[HDR_LENGTH + TRLR_LENGTH] = '\0'; + printf_filtered ("Writing ack %d \"%s\"\n", mips_receive_seq, + ack + 1); + } + + if (serial_write (ack, HDR_LENGTH + TRLR_LENGTH) == 0) + error ("write to target failed: %s", safe_strerror (errno)); + } + + if (mips_debug > 0) + { + buff[len] = '\0'; + printf_filtered ("Got packet \"%s\"\n", buff); + } + + /* We got the packet. Send an acknowledgement. */ + mips_receive_seq = (mips_receive_seq + 1) % SEQ_MODULOS; + + ack[HDR_INDX_SYN] = HDR_SET_SYN (0, 0, mips_receive_seq); + ack[HDR_INDX_TYPE_LEN] = HDR_SET_TYPE_LEN (0, 0, mips_receive_seq); + ack[HDR_INDX_LEN1] = HDR_SET_LEN1 (0, 0, mips_receive_seq); + ack[HDR_INDX_SEQ] = HDR_SET_SEQ (0, 0, mips_receive_seq); + + cksum = mips_cksum (ack, (unsigned char *) NULL, 0); + + ack[HDR_LENGTH + TRLR_INDX_CSUM1] = TRLR_SET_CSUM1 (cksum); + ack[HDR_LENGTH + TRLR_INDX_CSUM2] = TRLR_SET_CSUM2 (cksum); + ack[HDR_LENGTH + TRLR_INDX_CSUM3] = TRLR_SET_CSUM3 (cksum); + + if (mips_debug > 0) + { + ack[HDR_LENGTH + TRLR_LENGTH] = '\0'; + printf_filtered ("Writing ack %d \"%s\"\n", mips_receive_seq, + ack + 1); + } + + if (serial_write (ack, HDR_LENGTH + TRLR_LENGTH) == 0) + error ("write to target failed: %s", safe_strerror (errno)); + + return len; +} + +/* Optionally send a request to the remote system and optionally wait + for the reply. This implements the remote debugging protocol, + which is built on top of the packet protocol defined above. Each + request has an ADDR argument and a DATA argument. The following + requests are defined: + + \0 don't send a request; just wait for a reply + i read word from instruction space at ADDR + d read word from data space at ADDR + I write DATA to instruction space at ADDR + D write DATA to data space at ADDR + r read register number ADDR + R set register number ADDR to value DATA + c continue execution (if ADDR != 1, set pc to ADDR) + s single step (if ADDR != 1, set pc to ADDR) + + The read requests return the value requested. The write requests + return the previous value in the changed location. The execution + requests return a UNIX wait value (the approximate signal which + caused execution to stop is in the upper eight bits). + + If PERR is not NULL, this function waits for a reply. If an error + occurs, it sets *PERR to 1 and sets errno according to what the + target board reports. */ + +static int +mips_request (cmd, addr, data, perr) + char cmd; + unsigned int addr; + unsigned int data; + int *perr; +{ + char buff[DATA_MAXLEN + 1]; + int len; + int rpid; + char rcmd; + int rerrflg; + int rresponse; + + if (cmd != '\0') + { + if (mips_need_reply) + fatal ("mips_request: Trying to send command before reply"); + sprintf (buff, "0x0 %c 0x%x 0x%x", cmd, addr, data); + mips_send_packet (buff); + mips_need_reply = 1; + } + + if (perr == (int *) NULL) + return 0; + + if (! mips_need_reply) + fatal ("mips_request: Trying to get reply before command"); + + mips_need_reply = 0; + + len = mips_receive_packet (buff); + buff[len] = '\0'; + + if (sscanf (buff, "0x%x %c 0x%x 0x%x", + &rpid, &rcmd, &rerrflg, &rresponse) != 4 + || rpid != 0 + || (cmd != '\0' && rcmd != cmd)) + error ("Bad response from remote board"); + + if (rerrflg != 0) + { + *perr = 1; + + /* FIXME: This will returns MIPS errno numbers, which may or may + not be the same as errno values used on other systems. If + they stick to common errno values, they will be the same, but + if they don't, they must be translated. */ + errno = rresponse; + + return 0; + } + + *perr = 0; + return rresponse; +} + +/* Open a connection to the remote board. */ + +static void +mips_open (name, from_tty) + char *name; + int from_tty; +{ + int err; + char cr; + char buff[DATA_MAXLEN + 1]; + + if (name == 0) + error ( +"To open a MIPS remote debugging connection, you need to specify what serial\n\ +device is attached to the target board (e.g., /dev/ttya)."); + + target_preopen (from_tty); + + if (mips_is_open) + mips_close (0); + + if (serial_open (name) == 0) + perror_with_name (name); + + mips_is_open = 1; + + /* The board seems to want to send us a packet. I don't know what + it means. */ + cr = '\r'; + serial_write (&cr, 1); + mips_receive_packet (buff); + + /* If this doesn't call error, we have connected; we don't care if + the request itself succeeds or fails. */ + mips_request ('r', (unsigned int) 0, (unsigned int) 0, &err); + + if (from_tty) + printf ("Remote MIPS debugging using %s\n", name); + push_target (&mips_ops); /* Switch to using remote target now */ + + start_remote (); /* Initialize gdb process mechanisms */ +} + +/* Close a connection to the remote board. */ + +static void +mips_close (quitting) + int quitting; +{ + if (mips_is_open) + { + /* Get the board out of remote debugging mode. */ + mips_request ('x', (unsigned int) 0, (unsigned int) 0, + (int *) NULL); + serial_close (); + mips_is_open = 0; + } +} + +/* Detach from the remote board. */ + +static void +mips_detach (args, from_tty) + char *args; + int from_tty; +{ + if (args) + error ("Argument given to \"detach\" when remotely debugging."); + + pop_target (); + if (from_tty) + printf ("Ending remote MIPS debugging.\n"); +} + +/* Tell the target board to resume. This does not wait for a reply + from the board. */ + +static void +mips_resume (step, siggnal) + int step, siggnal; +{ + if (siggnal) + error ("Can't send signals to a remote system. Try `handle %d ignore'.", + siggnal); + + mips_request (step ? 's' : 'c', + (unsigned int) read_register (PC_REGNUM), + (unsigned int) 0, + (int *) NULL); +} + +/* Wait until the remote stops, and return a wait status. */ + +static int +mips_wait (status) + WAITTYPE *status; +{ + int rstatus; + int err; + + /* If we have not sent a single step or continue command, then the + board is waiting for us to do something. Return a status + indicating that it is stopped. */ + if (! mips_need_reply) + { + WSETSTOP (*status, SIGTRAP); + return 0; + } + + rstatus = mips_request ('\0', (unsigned int) 0, (unsigned int) 0, &err); + if (err) + error ("Remote failure: %s", safe_strerror (errno)); + + /* FIXME: The target board uses numeric signal values which are + those used on MIPS systems. If the host uses different signal + values, we need to translate here. I believe all Unix systems + use the same values for the signals the board can return, which + are: SIGINT, SIGSEGV, SIGBUS, SIGILL, SIGFPE, SIGTRAP. */ + + /* FIXME: The target board uses a standard Unix wait status int. If + the host system does not, we must translate here. */ + + *status = rstatus; + + return 0; +} + +/* We have to map between the register numbers used by gdb and the + register numbers used by the debugging protocol. This function + assumes that we are using tm-mips.h. */ + +#define REGNO_OFFSET 96 + +static int +mips_map_regno (regno) + int regno; +{ + if (regno < 32) + return regno; + if (regno >= FP0_REGNUM && regno < FP0_REGNUM + 32) + return regno - FP0_REGNUM + 32; + switch (regno) + { + case PC_REGNUM: + return REGNO_OFFSET + 0; + case CAUSE_REGNUM: + return REGNO_OFFSET + 1; + case HI_REGNUM: + return REGNO_OFFSET + 2; + case LO_REGNUM: + return REGNO_OFFSET + 3; + case FCRCS_REGNUM: + return REGNO_OFFSET + 4; + case FCRIR_REGNUM: + return REGNO_OFFSET + 5; + default: + /* FIXME: Is there a way to get the status register? */ + return 0; + } +} + +/* Fetch the remote registers. */ + +static void +mips_fetch_registers (regno) + int regno; +{ + REGISTER_TYPE val; + int err; + + if (regno == -1) + { + for (regno = 0; regno < NUM_REGS; regno++) + mips_fetch_registers (regno); + return; + } + + val = mips_request ('r', (unsigned int) mips_map_regno (regno), + (unsigned int) 0, &err); + if (err) + error ("Can't read register %d: %s", regno, safe_strerror (errno)); + + /* We got the number the register holds, but gdb expects to see a + value in the target byte ordering. */ + SWAP_TARGET_AND_HOST (val, sizeof (REGISTER_TYPE)); + supply_register (regno, (char *) &val); +} + +/* Prepare to store registers. The MIPS protocol can store individual + registers, so this function doesn't have to do anything. */ + +static void +mips_prepare_to_store () +{ +} + +/* Store remote register(s). */ + +static void +mips_store_registers (regno) + int regno; +{ + int err; + + if (regno == -1) + { + for (regno = 0; regno < NUM_REGS; regno++) + mips_store_registers (regno); + return; + } + + mips_request ('R', (unsigned int) mips_map_regno (regno), + (unsigned int) read_register (regno), + &err); + if (err) + error ("Can't write register %d: %s", regno, safe_strerror (errno)); +} + +/* Fetch a word from the target board. */ + +static int +mips_fetch_word (addr) + CORE_ADDR addr; +{ + int val; + int err; + + val = mips_request ('d', (unsigned int) addr, (unsigned int) 0, &err); + if (err) + { + /* Data space failed; try instruction space. */ + val = mips_request ('i', (unsigned int) addr, (unsigned int) 0, &err); + if (err) + error ("Can't read address 0x%x: %s", addr, safe_strerror (errno)); + } + return val; +} + +/* Store a word to the target board. */ + +static void +mips_store_word (addr, val) + CORE_ADDR addr; + int val; +{ + int err; + + mips_request ('D', (unsigned int) addr, (unsigned int) val, &err); + if (err) + { + /* Data space failed; try instruction space. */ + mips_request ('I', (unsigned int) addr, (unsigned int) val, &err); + if (err) + error ("Can't write address 0x%x: %s", addr, safe_strerror (errno)); + } +} + +/* Read or write LEN bytes from inferior memory at MEMADDR, + transferring to or from debugger address MYADDR. Write to inferior + if SHOULD_WRITE is nonzero. Returns length of data written or + read; 0 for error. Note that protocol gives us the correct value + for a longword, since it transfers values in ASCII. We want the + byte values, so we have to swap the longword values. */ + +static int +mips_xfer_memory (memaddr, myaddr, len, write, ignore) + CORE_ADDR memaddr; + char *myaddr; + int len; + int write; + struct target_ops *ignore; +{ + register int i; + /* Round starting address down to longword boundary. */ + register CORE_ADDR addr = memaddr &~ 3; + /* Round ending address up; get number of longwords that makes. */ + register int count = (((memaddr + len) - addr) + 3) / 4; + /* Allocate buffer of that many longwords. */ + register unsigned int *buffer = (unsigned int *) alloca (count * 4); + + if (write) + { + /* Fill start and end extra bytes of buffer with existing data. */ + if (addr != memaddr || len < 4) + { + /* Need part of initial word -- fetch it. */ + buffer[0] = mips_fetch_word (addr); + SWAP_TARGET_AND_HOST (buffer, 4); + } + + if (count > 1) /* FIXME, avoid if even boundary */ + { + buffer[count - 1] = mips_fetch_word (addr + (count - 1) * 4); + SWAP_TARGET_AND_HOST (buffer + (count - 1) * 4, 4); + } + + /* Copy data to be written over corresponding part of buffer */ + + memcpy ((char *) buffer + (memaddr & 3), myaddr, len); + + /* Write the entire buffer. */ + + for (i = 0; i < count; i++, addr += 4) + { + SWAP_TARGET_AND_HOST (buffer + i, 4); + mips_store_word (addr, buffer[i]); + } + } + else + { + /* Read all the longwords */ + for (i = 0; i < count; i++, addr += 4) + { + buffer[i] = mips_fetch_word (addr); + SWAP_TARGET_AND_HOST (buffer + i, 4); + QUIT; + } + + /* Copy appropriate bytes out of the buffer. */ + memcpy (myaddr, (char *) buffer + (memaddr & (sizeof (int) - 1)), len); + } + return len; +} + +/* Print info on this target. */ + +static void +mips_files_info (ignore) + struct target_ops *ignore; +{ + printf ("Debugging a MIPS board over a serial line.\n"); +} + +/* Load an executable onto the board. */ + +static void +mips_load (args, from_tty) + char *args; + int from_tty; +{ + bfd *abfd; + asection *s; + int err; + + abfd = bfd_openr (args, 0); + if (abfd == (bfd *) NULL) + error ("Unable to open file %s", args); + + if (bfd_check_format (abfd, bfd_object) == 0) + error ("%s: Not an object file", args); + + for (s = abfd->sections; s != (asection *) NULL; s = s->next) + { + if ((s->flags & SEC_LOAD) != 0) + { + bfd_size_type size; + + size = bfd_get_section_size_before_reloc (s); + if (size > 0) + { + char *buffer; + struct cleanup *old_chain; + bfd_vma vma; + + buffer = xmalloc (size); + old_chain = make_cleanup (free, buffer); + + vma = bfd_get_section_vma (abfd, s); + printf_filtered ("Loading section %s, size 0x%x vma 0x%x\n", + bfd_get_section_name (abfd, s), size, vma); + bfd_get_section_contents (abfd, s, buffer, 0, size); + mips_xfer_memory (vma, buffer, size, 1, &mips_ops); + + do_cleanups (old_chain); + } + } + } + + mips_request ('R', (unsigned int) mips_map_regno (PC_REGNUM), + (unsigned int) abfd->start_address, + &err); + if (err) + error ("Can't write PC register: %s", safe_strerror (errno)); + + bfd_close (abfd); + + /* FIXME: Should we call symbol_file_add here? */ +} + +/* Start running on the target board. */ + +static void +mips_create_inferior (execfile, args, env) + char *execfile; + char *args; + char **env; +{ + CORE_ADDR entry_pt; + + /* FIXME: Actually, we probably could pass arguments. */ + if (args && *args) + error ("Can't pass arguments to remote MIPS board."); + + if (execfile == 0 || exec_bfd == 0) + error ("No exec file specified"); + + entry_pt = (CORE_ADDR) bfd_get_start_address (exec_bfd); + + init_wait_for_inferior (); + + proceed (entry_pt, -1, 0); +} + +/* Clean up after a process. Actually nothing to do. */ + +static void +mips_mourn_inferior () +{ + generic_mourn_inferior (); +} + +/* The target vector. */ + +struct target_ops mips_ops = +{ + "mips", /* to_shortname */ + "Remote MIPS debugging over serial line", /* to_longname */ + "Debug a board using the MIPS remote debugging protocol over a serial line.\n\ +Specify the serial device it is connected to (e.g., /dev/ttya).", /* to_doc */ + mips_open, /* to_open */ + mips_close, /* to_close */ + NULL, /* to_attach */ + mips_detach, /* to_detach */ + mips_resume, /* to_resume */ + mips_wait, /* to_wait */ + mips_fetch_registers, /* to_fetch_registers */ + mips_store_registers, /* to_store_registers */ + mips_prepare_to_store, /* to_prepare_to_store */ + mips_xfer_memory, /* to_xfer_memory */ + mips_files_info, /* to_files_info */ + NULL, /* to_insert_breakpoint */ + NULL, /* to_remove_breakpoint */ + NULL, /* to_terminal_init */ + NULL, /* to_terminal_inferior */ + NULL, /* to_terminal_ours_for_output */ + NULL, /* to_terminal_ours */ + NULL, /* to_terminal_info */ + NULL, /* to_kill */ + mips_load, /* to_load */ + NULL, /* to_lookup_symbol */ + mips_create_inferior, /* to_create_inferior */ + mips_mourn_inferior, /* to_mourn_inferior */ + NULL, /* to_can_run */ + NULL, /* to_notice_signals */ + process_stratum, /* to_stratum */ + NULL, /* to_next */ + 1, /* to_has_all_memory */ + 1, /* to_has_memory */ + 1, /* to_has_stack */ + 1, /* to_has_registers */ + 1, /* to_has_execution */ + NULL, /* sections */ + NULL, /* sections_end */ + OPS_MAGIC /* to_magic */ +}; + +void +_initialize_remote_mips () +{ + add_target (&mips_ops); + + add_show_from_set ( + add_set_cmd ("remotedebug", no_class, var_zinteger, (char *) &mips_debug, + "Set debugging of remote MIPS serial I/O.\n\ +When non-zero, each packet sent or received with the remote target\n\ +is displayed. Higher numbers produce more debugging.", &setlist), + &showlist); +} |