1 /***************************************************************************
2 * Copyright (C) 2005 by Dominic Rath *
3 * Dominic.Rath@gmx.de *
5 * Copyright (C) 2008 by Spencer Oliver *
6 * spen@spen-soft.co.uk *
8 * This program is free software; you can redistribute it and/or modify *
9 * it under the terms of the GNU General Public License as published by *
10 * the Free Software Foundation; either version 2 of the License, or *
11 * (at your option) any later version. *
13 * This program is distributed in the hope that it will be useful, *
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
16 * GNU General Public License for more details. *
18 * You should have received a copy of the GNU General Public License *
19 * along with this program. If not, see <http://www.gnu.org/licenses/>. *
20 ***************************************************************************/
26 #include <jtag/interface.h>
29 /* -ino: 060521-1036 */
30 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
31 #include <machine/sysarch.h>
32 #include <machine/cpufunc.h>
33 #define ioperm(startport, length, enable)\
34 i386_set_ioperm((startport), (length), (enable))
35 #endif /* __FreeBSD__ */
37 #if PARPORT_USE_PPDEV == 1
38 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
39 #include <dev/ppbus/ppi.h>
40 #include <dev/ppbus/ppbconf.h>
41 #define PPRSTATUS PPIGSTATUS
42 #define PPWDATA PPISDATA
44 #include <linux/parport.h>
45 #include <linux/ppdev.h>
47 #include <sys/ioctl.h>
48 #else /* not PARPORT_USE_PPDEV */
54 #if PARPORT_USE_GIVEIO == 1 && IS_CYGWIN == 1
58 /* parallel port cable description
62 uint8_t TDO_MASK
; /* status port bit containing current TDO value */
63 uint8_t TRST_MASK
; /* data port bit for TRST */
64 uint8_t TMS_MASK
; /* data port bit for TMS */
65 uint8_t TCK_MASK
; /* data port bit for TCK */
66 uint8_t TDI_MASK
; /* data port bit for TDI */
67 uint8_t SRST_MASK
; /* data port bit for SRST */
68 uint8_t OUTPUT_INVERT
; /* data port bits that should be inverted */
69 uint8_t INPUT_INVERT
; /* status port that should be inverted */
70 uint8_t PORT_INIT
; /* initialize data port with this value */
71 uint8_t PORT_EXIT
; /* de-initialize data port with this value */
72 uint8_t LED_MASK
; /* data port bit for LED */
75 static const struct cable cables
[] = {
76 /* name tdo trst tms tck tdi srst o_inv i_inv init exit led */
77 { "wiggler", 0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x01, 0x80, 0x80, 0x80, 0x00 },
78 { "wiggler2", 0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x01, 0x80, 0x80, 0x00, 0x20 },
79 { "wiggler_ntrst_inverted", 0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x11, 0x80, 0x80, 0x80, 0x00 },
80 { "old_amt_wiggler", 0x80, 0x01, 0x02, 0x04, 0x08, 0x10, 0x11, 0x80, 0x80, 0x80, 0x00 },
81 { "arm-jtag", 0x80, 0x01, 0x02, 0x04, 0x08, 0x10, 0x01, 0x80, 0x80, 0x80, 0x00 },
82 { "chameleon", 0x80, 0x00, 0x04, 0x01, 0x02, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00 },
83 { "dlc5", 0x10, 0x00, 0x04, 0x02, 0x01, 0x00, 0x00, 0x00, 0x10, 0x10, 0x00 },
84 { "triton", 0x80, 0x08, 0x04, 0x01, 0x02, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00 },
85 { "lattice", 0x40, 0x10, 0x04, 0x02, 0x01, 0x08, 0x00, 0x00, 0x18, 0x18, 0x00 },
86 { "flashlink", 0x20, 0x10, 0x02, 0x01, 0x04, 0x20, 0x30, 0x20, 0x00, 0x00, 0x00 },
87 /* Altium Universal JTAG cable. Set the cable to Xilinx Mode and wire to target as follows:
92 SOFT TCK - Target TRST
93 SOFT TDI - Target SRST
95 { "altium", 0x10, 0x20, 0x04, 0x02, 0x01, 0x80, 0x00, 0x00, 0x10, 0x00, 0x08 },
96 { "aspo", 0x10, 0x01, 0x04, 0x08, 0x02, 0x10, 0x17, 0x00, 0x17, 0x17, 0x00 },
97 { NULL
, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }
101 static char *parport_cable
;
102 static uint16_t parport_port
;
103 static bool parport_exit
;
104 static uint32_t parport_toggling_time_ns
= 1000;
105 static int wait_states
;
107 /* interface variables
109 static const struct cable
*cable
;
110 static uint8_t dataport_value
;
112 #if PARPORT_USE_PPDEV == 1
113 static int device_handle
;
115 static unsigned long dataport
;
116 static unsigned long statusport
;
119 static int parport_read(void)
123 #if PARPORT_USE_PPDEV == 1
124 ioctl(device_handle
, PPRSTATUS
, &data
);
126 data
= inb(statusport
);
129 if ((data
^ cable
->INPUT_INVERT
) & cable
->TDO_MASK
)
135 static inline void parport_write_data(void)
138 output
= dataport_value
^ cable
->OUTPUT_INVERT
;
140 #if PARPORT_USE_PPDEV == 1
141 ioctl(device_handle
, PPWDATA
, &output
);
143 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
144 outb(dataport
, output
);
146 outb(output
, dataport
);
151 static void parport_write(int tck
, int tms
, int tdi
)
153 int i
= wait_states
+ 1;
156 dataport_value
|= cable
->TCK_MASK
;
158 dataport_value
&= ~cable
->TCK_MASK
;
161 dataport_value
|= cable
->TMS_MASK
;
163 dataport_value
&= ~cable
->TMS_MASK
;
166 dataport_value
|= cable
->TDI_MASK
;
168 dataport_value
&= ~cable
->TDI_MASK
;
171 parport_write_data();
174 /* (1) assert or (0) deassert reset lines */
175 static void parport_reset(int trst
, int srst
)
177 LOG_DEBUG("trst: %i, srst: %i", trst
, srst
);
180 dataport_value
|= cable
->TRST_MASK
;
182 dataport_value
&= ~cable
->TRST_MASK
;
185 dataport_value
|= cable
->SRST_MASK
;
187 dataport_value
&= ~cable
->SRST_MASK
;
189 parport_write_data();
192 /* turn LED on parport adapter on (1) or off (0) */
193 static void parport_led(int on
)
196 dataport_value
|= cable
->LED_MASK
;
198 dataport_value
&= ~cable
->LED_MASK
;
200 parport_write_data();
203 static int parport_speed(int speed
)
209 static int parport_khz(int khz
, int *jtag_speed
)
212 LOG_DEBUG("RCLK not supported");
216 *jtag_speed
= 499999 / (khz
* parport_toggling_time_ns
);
220 static int parport_speed_div(int speed
, int *khz
)
222 uint32_t denominator
= (speed
+ 1) * parport_toggling_time_ns
;
224 *khz
= (499999 + denominator
) / denominator
;
228 #if PARPORT_USE_GIVEIO == 1
229 static int parport_get_giveio_access(void)
232 OSVERSIONINFO version
;
234 version
.dwOSVersionInfoSize
= sizeof version
;
235 if (!GetVersionEx(&version
)) {
239 if (version
.dwPlatformId
!= VER_PLATFORM_WIN32_NT
)
242 h
= CreateFile("\\\\.\\giveio", GENERIC_READ
, 0, NULL
, OPEN_EXISTING
, FILE_ATTRIBUTE_NORMAL
, NULL
);
243 if (h
== INVALID_HANDLE_VALUE
) {
254 static struct bitbang_interface parport_bitbang
= {
255 .read
= &parport_read
,
256 .write
= &parport_write
,
257 .reset
= &parport_reset
,
258 .blink
= &parport_led
,
261 static int parport_init(void)
263 const struct cable
*cur_cable
;
264 #if PARPORT_USE_PPDEV == 1
270 if (parport_cable
== NULL
) {
271 parport_cable
= strdup("wiggler");
272 LOG_WARNING("No parport cable specified, using default 'wiggler'");
275 while (cur_cable
->name
) {
276 if (strcmp(cur_cable
->name
, parport_cable
) == 0) {
284 LOG_ERROR("No matching cable found for %s", parport_cable
);
285 return ERROR_JTAG_INIT_FAILED
;
288 dataport_value
= cable
->PORT_INIT
;
290 #if PARPORT_USE_PPDEV == 1
291 if (device_handle
> 0) {
292 LOG_ERROR("device is already opened");
293 return ERROR_JTAG_INIT_FAILED
;
296 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
297 LOG_DEBUG("opening /dev/ppi%d...", parport_port
);
299 snprintf(buffer
, 256, "/dev/ppi%d", parport_port
);
300 device_handle
= open(buffer
, O_WRONLY
);
301 #else /* not __FreeBSD__, __FreeBSD_kernel__ */
302 LOG_DEBUG("opening /dev/parport%d...", parport_port
);
304 snprintf(buffer
, 256, "/dev/parport%d", parport_port
);
305 device_handle
= open(buffer
, O_WRONLY
);
306 #endif /* __FreeBSD__, __FreeBSD_kernel__ */
308 if (device_handle
< 0) {
310 LOG_ERROR("cannot open device. check it exists and that user read and write rights are set. errno=%d", err
);
311 return ERROR_JTAG_INIT_FAILED
;
314 LOG_DEBUG("...open");
316 #if !defined(__FreeBSD__) && !defined(__FreeBSD_kernel__)
317 int i
= ioctl(device_handle
, PPCLAIM
);
320 LOG_ERROR("cannot claim device");
321 return ERROR_JTAG_INIT_FAILED
;
324 i
= PARPORT_MODE_COMPAT
;
325 i
= ioctl(device_handle
, PPSETMODE
, &i
);
327 LOG_ERROR(" cannot set compatible mode to device");
328 return ERROR_JTAG_INIT_FAILED
;
331 i
= IEEE1284_MODE_COMPAT
;
332 i
= ioctl(device_handle
, PPNEGOT
, &i
);
334 LOG_ERROR("cannot set compatible 1284 mode to device");
335 return ERROR_JTAG_INIT_FAILED
;
337 #endif /* not __FreeBSD__, __FreeBSD_kernel__ */
339 #else /* not PARPORT_USE_PPDEV */
340 if (parport_port
== 0) {
341 parport_port
= 0x378;
342 LOG_WARNING("No parport port specified, using default '0x378' (LPT1)");
345 dataport
= parport_port
;
346 statusport
= parport_port
+ 1;
348 LOG_DEBUG("requesting privileges for parallel port 0x%lx...", dataport
);
349 #if PARPORT_USE_GIVEIO == 1
350 if (parport_get_giveio_access() != 0) {
351 #else /* PARPORT_USE_GIVEIO */
352 if (ioperm(dataport
, 3, 1) != 0) {
353 #endif /* PARPORT_USE_GIVEIO */
354 LOG_ERROR("missing privileges for direct i/o");
355 return ERROR_JTAG_INIT_FAILED
;
357 LOG_DEBUG("...privileges granted");
359 /* make sure parallel port is in right mode (clear tristate and interrupt */
360 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
361 outb(parport_port
+ 2, 0x0);
363 outb(0x0, parport_port
+ 2);
366 #endif /* PARPORT_USE_PPDEV */
369 parport_write(0, 0, 0);
372 bitbang_interface
= &parport_bitbang
;
377 static int parport_quit(void)
382 dataport_value
= cable
->PORT_EXIT
;
383 parport_write_data();
388 parport_cable
= NULL
;
394 COMMAND_HANDLER(parport_handle_parport_port_command
)
397 /* only if the port wasn't overwritten by cmdline */
398 if (parport_port
== 0)
399 COMMAND_PARSE_NUMBER(u16
, CMD_ARGV
[0], parport_port
);
401 LOG_ERROR("The parport port was already configured!");
406 command_print(CMD_CTX
, "parport port = 0x%" PRIx16
"", parport_port
);
411 COMMAND_HANDLER(parport_handle_parport_cable_command
)
416 /* only if the cable name wasn't overwritten by cmdline */
417 if (parport_cable
== 0) {
418 /* REVISIT first verify that it's listed in cables[] ... */
419 parport_cable
= malloc(strlen(CMD_ARGV
[0]) + sizeof(char));
420 strcpy(parport_cable
, CMD_ARGV
[0]);
423 /* REVISIT it's probably worth returning the current value ... */
428 COMMAND_HANDLER(parport_handle_write_on_exit_command
)
431 return ERROR_COMMAND_SYNTAX_ERROR
;
433 COMMAND_PARSE_ON_OFF(CMD_ARGV
[0], parport_exit
);
438 COMMAND_HANDLER(parport_handle_parport_toggling_time_command
)
442 int retval
= parse_u32(CMD_ARGV
[0], &ns
);
444 if (ERROR_OK
!= retval
)
448 LOG_ERROR("0 ns is not a valid parport toggling time");
452 parport_toggling_time_ns
= ns
;
453 retval
= jtag_get_speed(&wait_states
);
454 if (retval
!= ERROR_OK
) {
455 /* if jtag_get_speed fails then the clock_mode
456 * has not been configured, this happens if parport_toggling_time is
457 * called before the adapter speed is set */
458 LOG_INFO("no parport speed set - defaulting to zero wait states");
463 command_print(CMD_CTX
, "parport toggling time = %" PRIu32
" ns",
464 parport_toggling_time_ns
);
469 static const struct command_registration parport_command_handlers
[] = {
471 .name
= "parport_port",
472 .handler
= parport_handle_parport_port_command
,
473 .mode
= COMMAND_CONFIG
,
474 .help
= "Display the address of the I/O port (e.g. 0x378) "
475 "or the number of the '/dev/parport' device used. "
476 "If a parameter is provided, first change that port.",
477 .usage
= "[port_number]",
480 .name
= "parport_cable",
481 .handler
= parport_handle_parport_cable_command
,
482 .mode
= COMMAND_CONFIG
,
483 .help
= "Set the layout of the parallel port cable "
484 "used to connect to the target.",
485 /* REVISIT there's no way to list layouts we know ... */
489 .name
= "parport_write_on_exit",
490 .handler
= parport_handle_write_on_exit_command
,
491 .mode
= COMMAND_CONFIG
,
492 .help
= "Configure the parallel driver to write "
493 "a known value to the parallel interface on exit.",
494 .usage
= "('on'|'off')",
497 .name
= "parport_toggling_time",
498 .handler
= parport_handle_parport_toggling_time_command
,
499 .mode
= COMMAND_CONFIG
,
500 .help
= "Displays or assigns how many nanoseconds it "
501 "takes for the hardware to toggle TCK.",
502 .usage
= "[nanoseconds]",
504 COMMAND_REGISTRATION_DONE
507 struct jtag_interface parport_interface
= {
509 .supported
= DEBUG_CAP_TMS_SEQ
,
510 .commands
= parport_command_handlers
,
512 .init
= parport_init
,
513 .quit
= parport_quit
,
515 .speed_div
= parport_speed_div
,
516 .speed
= parport_speed
,
517 .execute_queue
= bitbang_execute_queue
,
Linking to existing account procedure
If you already have an account and want to add another login method
you
MUST first sign in with your existing account and
then change URL to read
https://review.openocd.org/login/?link
to get to this page again but this time it'll work for linking. Thank you.
SSH host keys fingerprints
1024 SHA256:YKx8b7u5ZWdcbp7/4AeXNaqElP49m6QrwfXaqQGJAOk gerrit-code-review@openocd.zylin.com (DSA)
384 SHA256:jHIbSQa4REvwCFG4cq5LBlBLxmxSqelQPem/EXIrxjk gerrit-code-review@openocd.org (ECDSA)
521 SHA256:UAOPYkU9Fjtcao0Ul/Rrlnj/OsQvt+pgdYSZ4jOYdgs gerrit-code-review@openocd.org (ECDSA)
256 SHA256:A13M5QlnozFOvTllybRZH6vm7iSt0XLxbA48yfc2yfY gerrit-code-review@openocd.org (ECDSA)
256 SHA256:spYMBqEYoAOtK7yZBrcwE8ZpYt6b68Cfh9yEVetvbXg gerrit-code-review@openocd.org (ED25519)
+--[ED25519 256]--+
|=.. |
|+o.. . |
|*.o . . |
|+B . . . |
|Bo. = o S |
|Oo.+ + = |
|oB=.* = . o |
| =+=.+ + E |
|. .=o . o |
+----[SHA256]-----+
2048 SHA256:0Onrb7/PHjpo6iVZ7xQX2riKN83FJ3KGU0TvI0TaFG4 gerrit-code-review@openocd.zylin.com (RSA)