1/* Definitions for the Macraigor Systems BDM Wiggler
2   Copyright 1996, 1997, 1998, 2000, 2001 Free Software Foundation, Inc.
3
4   This file is part of GDB.
5
6   This program is free software; you can redistribute it and/or modify
7   it under the terms of the GNU General Public License as published by
8   the Free Software Foundation; either version 2 of the License, or
9   (at your option) any later version.
10
11   This program is distributed in the hope that it will be useful,
12   but WITHOUT ANY WARRANTY; without even the implied warranty of
13   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
14   GNU General Public License for more details.
15
16   You should have received a copy of the GNU General Public License
17   along with this program; if not, write to the Free Software
18   Foundation, Inc., 59 Temple Place - Suite 330,
19   Boston, MA 02111-1307, USA.  */
20
21#ifndef OCD_H
22#define OCD_H
23
24struct mem_attrib;
25struct target_ops;
26
27/* Wiggler serial protocol definitions */
28
29#define DLE 020			/* Quote char */
30#define SYN 026			/* Start of packet */
31#define RAW_SYN ((026 << 8) | 026)	/* get_quoted_char found a naked SYN */
32
33/* Status flags */
34
35#define OCD_FLAG_RESET 0x01	/* Target is being reset */
36#define OCD_FLAG_STOPPED 0x02	/* Target is halted */
37#define OCD_FLAG_BDM 0x04	/* Target is in BDM */
38#define OCD_FLAG_PWF 0x08	/* Power failed */
39#define OCD_FLAG_CABLE_DISC 0x10	/* BDM cable disconnected */
40
41/* Commands */
42
43#define OCD_AYT 0x0		/* Are you there? */
44#define OCD_GET_VERSION 0x1	/* Get Version */
45#define OCD_SET_BAUD_RATE 0x2	/* Set Baud Rate */
46#define OCD_INIT 0x10		/* Initialize Wiggler */
47#define OCD_SET_SPEED 0x11	/* Set Speed */
48#define OCD_GET_STATUS_MASK 0x12	/* Get Status Mask */
49#define OCD_GET_CTRS 0x13	/* Get Error Counters */
50#define OCD_SET_FUNC_CODE 0x14	/* Set Function Code */
51#define OCD_SET_CTL_FLAGS 0x15	/* Set Control Flags */
52#define OCD_SET_BUF_ADDR 0x16	/* Set Register Buffer Address */
53#define OCD_RUN 0x20		/* Run Target from PC */
54#define OCD_RUN_ADDR 0x21	/* Run Target from Specified Address */
55#define OCD_STOP 0x22		/* Stop Target */
56#define OCD_RESET_RUN 0x23	/* Reset Target and Run */
57#define OCD_RESET 0x24		/* Reset Target and Halt */
58#define OCD_STEP 0x25		/* Single step */
59#define OCD_READ_REGS 0x30	/* Read Registers */
60#define OCD_WRITE_REGS 0x31	/* Write Registers */
61#define OCD_READ_MEM 0x32	/* Read Memory */
62#define OCD_WRITE_MEM 0x33	/* Write Memory */
63#define OCD_FILL_MEM 0x34	/* Fill Memory */
64#define OCD_MOVE_MEM 0x35	/* Move Memory */
65
66#define OCD_READ_INT_MEM 0x80	/* Read Internal Memory */
67#define OCD_WRITE_INT_MEM 0x81	/* Write Internal Memory */
68#define OCD_JUMP 0x82		/* Jump to Subroutine */
69
70#define OCD_ERASE_FLASH 0x90	/* Erase flash memory */
71#define OCD_PROGRAM_FLASH 0x91	/* Write flash memory */
72#define OCD_EXIT_MON 0x93	/* Exit the flash programming monitor  */
73#define OCD_ENTER_MON 0x94	/* Enter the flash programming monitor  */
74
75#define OCD_SET_STATUS 0x0a	/* Set status */
76#define OCD_SET_CONNECTION 0xf0	/* Set connection (init Wigglers.dll) */
77#define OCD_LOG_FILE 0xf1	/* Cmd to get Wigglers.dll to log cmds */
78#define OCD_FLAG_STOP 0x0	/* Stop the target, enter BDM */
79#define OCD_FLAG_START 0x01	/* Start the target at PC */
80#define OCD_FLAG_RETURN_STATUS 0x04	/* Return async status */
81
82/* Target type (for OCD_INIT command) */
83
84enum ocd_target_type
85  {
86    OCD_TARGET_CPU32 = 0x0,	/* Moto cpu32 family */
87    OCD_TARGET_CPU16 = 0x1,
88    OCD_TARGET_MOTO_PPC = 0x2,	/* Motorola PPC 5xx/8xx */
89    OCD_TARGET_IBM_PPC = 0x3
90  };				/* IBM PPC 4xx */
91
92void ocd_open (char *name, int from_tty, enum ocd_target_type,
93	       struct target_ops *ops);
94
95void ocd_close (int quitting);
96
97void ocd_detach (char *args, int from_tty);
98
99void ocd_resume (ptid_t ptid, int step, enum target_signal siggnal);
100
101void ocd_prepare_to_store (void);
102
103void ocd_stop (void);
104
105void ocd_files_info (struct target_ops *ignore);
106
107
108int ocd_xfer_memory (CORE_ADDR memaddr, char *myaddr,
109		     int len, int should_write,
110		     struct mem_attrib *attrib,
111		     struct target_ops *target);
112
113void ocd_mourn (void);
114
115void ocd_create_inferior (char *exec_file, char *args, char **env,
116			  int from_tty);
117
118int ocd_thread_alive (ptid_t th);
119
120void ocd_error (char *s, int error_code);
121
122void ocd_kill (void);
123
124void ocd_load (char *args, int from_tty);
125
126unsigned char *ocd_read_bdm_registers (int first_bdm_regno,
127				       int last_bdm_regno, int *reglen);
128
129CORE_ADDR ocd_read_bdm_register (int bdm_regno);
130
131void ocd_write_bdm_registers (int first_bdm_regno,
132			      unsigned char *regptr, int reglen);
133
134void ocd_write_bdm_register (int bdm_regno, CORE_ADDR reg);
135
136int ocd_wait (void);
137
138int ocd_insert_breakpoint (CORE_ADDR addr, char *contents_cache);
139int ocd_remove_breakpoint (CORE_ADDR addr, char *contents_cache);
140
141int ocd_write_bytes (CORE_ADDR memaddr, char *myaddr, int len);
142
143#endif /* OCD_H */
144