zs_kgdb.c revision 1.15.54.1 1 /* $NetBSD: zs_kgdb.c,v 1.15.54.1 2017/04/27 05:36:33 pgoyette Exp $ */
2
3 /*-
4 * Copyright (c) 1996 The NetBSD Foundation, Inc.
5 * All rights reserved.
6 *
7 * This code is derived from software contributed to The NetBSD Foundation
8 * by Gordon W. Ross and Wayne Knowles.
9 *
10 * Redistribution and use in source and binary forms, with or without
11 * modification, are permitted provided that the following conditions
12 * are met:
13 * 1. Redistributions of source code must retain the above copyright
14 * notice, this list of conditions and the following disclaimer.
15 * 2. Redistributions in binary form must reproduce the above copyright
16 * notice, this list of conditions and the following disclaimer in the
17 * documentation and/or other materials provided with the distribution.
18 *
19 * THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS
20 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
21 * TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
22 * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS
23 * BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
24 * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
25 * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
27 * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
28 * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
29 * POSSIBILITY OF SUCH DAMAGE.
30 */
31
32 /*
33 * Hooks for kgdb when attached via the z8530 driver
34 *
35 * To use this, build a kernel with: option KGDB, and
36 * boot that kernel with "-d". (The kernel will call
37 * zs_kgdb_init, kgdb_connect.) When the console prints
38 * "kgdb waiting..." you run "gdb -k kernel" and do:
39 * (gdb) set remotebaud 19200
40 * (gdb) target remote /dev/ttyb
41 */
42
43 #include <sys/cdefs.h>
44 __KERNEL_RCSID(0, "$NetBSD: zs_kgdb.c,v 1.15.54.1 2017/04/27 05:36:33 pgoyette Exp $");
45
46 #include <sys/param.h>
47 #include <sys/systm.h>
48 #include <sys/proc.h>
49 #include <sys/device.h>
50 #include <sys/conf.h>
51 #include <sys/ioctl.h>
52 #include <sys/kernel.h>
53 #include <sys/syslog.h>
54 #include <sys/kgdb.h>
55
56 #include <dev/ic/z8530reg.h>
57 #include <machine/z8530var.h>
58
59 /*
60 * Hooks for kgdb when attached via the z8530 driver
61 *
62 * To use this, build a kernel with: option KGDB, and
63 * boot that kernel with "-d". (The kernel will call
64 * zs_kgdb_init, kgdb_connect.) When the console prints
65 * "kgdb waiting..." you run "gdb -k kernel" and do:
66 * (gdb) set remotebaud 19200
67 * (gdb) target remote /dev/ttyb
68 */
69
70 void zs_kgdb_init (void);
71 void zskgdb (struct zs_chanstate *);
72
73 static void zs_setparam (struct zs_chanstate *, int, int);
74 static struct zsops zsops_kgdb;
75
76 extern struct zschan *zs_get_chan_addr (int, int);
77 extern int zs_getc (void *);
78 extern void zs_putc (void *, int);
79
80 static u_char zs_kgdb_regs[16] = {
81 0, /* 0: CMD (reset, etc.) */
82 0, /* 1: No interrupts yet. */
83 0, /* 2: IVECT */
84 ZSWR3_RX_8 | ZSWR3_RX_ENABLE,
85 ZSWR4_CLK_X16 | ZSWR4_ONESB,
86 ZSWR5_TX_8 | ZSWR5_TX_ENABLE,
87 0, /* 6: TXSYNC/SYNCLO */
88 0, /* 7: RXSYNC/SYNCHI */
89 0, /* 8: alias for data port */
90 ZSWR9_MASTER_IE | ZSWR9_NO_VECTOR,
91 0, /*10: Misc. TX/RX control bits */
92 ZSWR11_TXCLK_BAUD | ZSWR11_RXCLK_BAUD | ZSWR11_TRXC_OUT_ENA,
93 10, /*12: BAUDLO (updated by KGDB_RATE) */
94 0, /*13: BAUDHI (updated by KGDB_RATE) */
95 ZSWR14_BAUD_ENA,
96 ZSWR15_BREAK_IE,
97 };
98
99 static void
100 zs_setparam(struct zs_chanstate *cs, int iena, int rate)
101 {
102 int s, tconst;
103
104 memcpy(cs->cs_preg, zs_kgdb_regs, 16);
105
106 if (iena) {
107 cs->cs_preg[1] = ZSWR1_RIE | ZSWR1_SIE;
108 }
109
110 /* Initialize the speed, etc. */
111 tconst = BPS_TO_TCONST(cs->cs_brg_clk, rate);
112
113 cs->cs_preg[5] |= ZSWR5_DTR | ZSWR5_RTS;
114 cs->cs_preg[12] = tconst;
115 cs->cs_preg[13] = tconst >> 8;
116
117 s = splhigh();
118 zs_loadchannelregs(cs);
119 splx(s);
120 }
121
122 /*
123 * Set up for kgdb; called at boot time before configuration.
124 * KGDB interrupts will be enabled later when zs0 is configured.
125 * Called after cninit(), so printf() etc. works.
126 */
127 void
128 zs_kgdb_init(void)
129 {
130 volatile struct zschan *zc;
131 int channel, unit;
132 extern const struct cdevsw zstty_cdevsw;
133 const struct cdevsw *cdev;
134
135 if ((cdev = cdevsw_lookup_acquire(kgdb_dev)) != &zstty_cdevsw) {
136 if (cdev != NULL)
137 cdevsw_release(cdev);
138 return;
139 }
140
141 unit = (kgdb_dev & 2) ? 1 : 0; /* XXX ??? */
142 channel = kgdb_dev & 1;
143 printf("zs_kgdb_init: attaching to Serial(%d) at %d baud\n",
144 (kgdb_dev & 3), kgdb_rate);
145
146 zc = zs_get_chan_addr(unit, channel);
147
148 /* Attach KGDB comms functions to this device */
149 kgdb_attach(zs_getc, zs_putc, __UNVOLATILE(zc));
150 cdevsw_release(cdev);
151 }
152
153 /*
154 * This is a "hook" called by the MI zstty_attach driver
155 * to allow the tty to be "taken over" for exclusive use by kgdb.
156 * Return non-zero if this is the kgdb port.
157 *
158 * Set the speed to kgdb_rate, CS8, etc.
159 */
160 int
161 zs_check_kgdb(struct zs_chanstate *cs, int dev)
162 {
163
164 if (dev != kgdb_dev)
165 return (0);
166
167 /*
168 * Yes, this is port in use by kgdb.
169 */
170 cs->cs_private = NULL;
171 cs->cs_ops = &zsops_kgdb;
172
173 /* Now set parameters. (interrupts enabled) */
174 zs_setparam(cs, 1, kgdb_rate);
175
176 return (1);
177 }
178
179 /*
180 * KGDB framing character received: enter kernel debugger. This probably
181 * should time out after a few seconds to avoid hanging on spurious input.
182 */
183 void
184 zskgdb(struct zs_chanstate *cs)
185 {
186 int unit = minor(kgdb_dev);
187
188 printf("zstty%d: kgdb interrupt\n", unit);
189 /* This will trap into the debugger. */
190 kgdb_connect(1);
191 }
192
193
194 /****************************************************************
195 * Interface to the lower layer (zscc)
196 ****************************************************************/
197
198 static void zs_kgdb_rxint (struct zs_chanstate *);
199 static void zs_kgdb_stint (struct zs_chanstate *, int);
200 static void zs_kgdb_txint (struct zs_chanstate *);
201 static void zs_kgdb_softint (struct zs_chanstate *);
202
203 static struct zsops zsops_kgdb = {
204 zs_kgdb_rxint, /* receive char available */
205 zs_kgdb_stint, /* external/status */
206 zs_kgdb_txint, /* xmit buffer empty */
207 zs_kgdb_softint, /* process software interrupt */
208 };
209
210 int kgdb_input_lost;
211
212 static void
213 zs_kgdb_rxint(struct zs_chanstate *cs)
214 {
215 register u_char c, rr1;
216
217 /*
218 * First read the status, because reading the received char
219 * destroys the status of this char.
220 */
221 rr1 = zs_read_reg(cs, 1);
222 c = zs_read_data(cs);
223
224 if (rr1 & (ZSRR1_FE | ZSRR1_DO | ZSRR1_PE)) {
225 /* Clear the receive error. */
226 zs_write_csr(cs, ZSWR0_RESET_ERRORS);
227 }
228
229 if (c == KGDB_START) {
230 zskgdb(cs);
231 } else {
232 kgdb_input_lost++;
233 }
234 }
235
236 static void
237 zs_kgdb_txint(register struct zs_chanstate *cs)
238 {
239 register int rr0;
240
241 rr0 = zs_read_csr(cs);
242 zs_write_csr(cs, ZSWR0_RESET_TXINT);
243 }
244
245 static void
246 zs_kgdb_stint(register struct zs_chanstate *cs, int force)
247 {
248 register int rr0;
249
250 rr0 = zs_read_csr(cs);
251 zs_write_csr(cs, ZSWR0_RESET_STATUS);
252
253 /*
254 * Check here for console break, so that we can abort
255 * even when interrupts are locking up the machine.
256 */
257 if (rr0 & ZSRR0_BREAK) {
258 zskgdb(cs);
259 }
260 }
261
262 static void
263 zs_kgdb_softint(struct zs_chanstate *cs)
264 {
265 printf("zs_kgdb_softint?\n");
266 }
267