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, write to the *
20 * Free Software Foundation, Inc., *
21 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
22 ***************************************************************************/
27 #include "interface.h"
30 /* -ino: 060521-1036 */
31 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
32 #include <machine/sysarch.h>
33 #include <machine/cpufunc.h>
34 #define ioperm(startport,length,enable)\
35 i386_set_ioperm((startport), (length), (enable))
36 #endif /* __FreeBSD__ */
38 #if PARPORT_USE_PPDEV == 1
39 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
40 #include <dev/ppbus/ppi.h>
41 #include <dev/ppbus/ppbconf.h>
42 #define PPRSTATUS PPIGSTATUS
43 #define PPWDATA PPISDATA
45 #include <linux/parport.h>
46 #include <linux/ppdev.h>
48 #include <sys/ioctl.h>
49 #else /* not PARPORT_USE_PPDEV */
55 #if PARPORT_USE_GIVEIO == 1 && IS_CYGWIN == 1
60 /* parallel port cable description
64 uint8_t TDO_MASK
; /* status port bit containing current TDO value */
65 uint8_t TRST_MASK
; /* data port bit for TRST */
66 uint8_t TMS_MASK
; /* data port bit for TMS */
67 uint8_t TCK_MASK
; /* data port bit for TCK */
68 uint8_t TDI_MASK
; /* data port bit for TDI */
69 uint8_t SRST_MASK
; /* data port bit for SRST */
70 uint8_t OUTPUT_INVERT
; /* data port bits that should be inverted */
71 uint8_t INPUT_INVERT
; /* status port that should be inverted */
72 uint8_t PORT_INIT
; /* initialize data port with this value */
73 uint8_t PORT_EXIT
; /* de-initialize data port with this value */
74 uint8_t LED_MASK
; /* data port bit for LED */
77 static struct cable cables
[] =
79 /* name tdo trst tms tck tdi srst o_inv i_inv init exit led */
80 { "wiggler", 0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x01, 0x80, 0x80, 0x80, 0x00 },
81 { "wiggler2", 0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x01, 0x80, 0x80, 0x00, 0x20 },
82 { "wiggler_ntrst_inverted",
83 0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x11, 0x80, 0x80, 0x80, 0x00 },
84 { "old_amt_wiggler", 0x80, 0x01, 0x02, 0x04, 0x08, 0x10, 0x11, 0x80, 0x80, 0x80, 0x00 },
85 { "arm-jtag", 0x80, 0x01, 0x02, 0x04, 0x08, 0x10, 0x01, 0x80, 0x80, 0x80, 0x00 },
86 { "chameleon", 0x80, 0x00, 0x04, 0x01, 0x02, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00 },
87 { "dlc5", 0x10, 0x00, 0x04, 0x02, 0x01, 0x00, 0x00, 0x00, 0x10, 0x10, 0x00 },
88 { "triton", 0x80, 0x08, 0x04, 0x01, 0x02, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00 },
89 { "lattice", 0x40, 0x10, 0x04, 0x02, 0x01, 0x08, 0x00, 0x00, 0x18, 0x18, 0x00 },
90 { "flashlink", 0x20, 0x10, 0x02, 0x01, 0x04, 0x20, 0x30, 0x20, 0x00, 0x00, 0x00 },
91 /* Altium Universal JTAG cable. Set the cable to Xilinx Mode and wire to target as follows:
96 SOFT TCK - Target TRST
97 SOFT TDI - Target SRST
99 { "altium", 0x10, 0x20, 0x04, 0x02, 0x01, 0x80, 0x00, 0x00, 0x10, 0x00, 0x08 },
100 { NULL
, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }
104 static char* parport_cable
= NULL
;
105 static uint16_t parport_port
;
106 static int parport_exit
= 0;
107 static uint32_t parport_toggling_time_ns
= 1000;
108 static int wait_states
;
110 /* interface variables
112 static struct cable
* cable
;
113 static uint8_t dataport_value
= 0x0;
115 #if PARPORT_USE_PPDEV == 1
116 static int device_handle
;
118 static unsigned long dataport
;
119 static unsigned long statusport
;
122 static int parport_read(void)
126 #if PARPORT_USE_PPDEV == 1
127 ioctl(device_handle
, PPRSTATUS
, & data
);
129 data
= inb(statusport
);
132 if ((data
^ cable
->INPUT_INVERT
) & cable
->TDO_MASK
)
138 static __inline__
void parport_write_data(void)
141 output
= dataport_value
^ cable
->OUTPUT_INVERT
;
143 #if PARPORT_USE_PPDEV == 1
144 ioctl(device_handle
, PPWDATA
, &output
);
146 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
147 outb(dataport
, output
);
149 outb(output
, dataport
);
154 static void parport_write(int tck
, int tms
, int tdi
)
156 int i
= wait_states
+ 1;
159 dataport_value
|= cable
->TCK_MASK
;
161 dataport_value
&= ~cable
->TCK_MASK
;
164 dataport_value
|= cable
->TMS_MASK
;
166 dataport_value
&= ~cable
->TMS_MASK
;
169 dataport_value
|= cable
->TDI_MASK
;
171 dataport_value
&= ~cable
->TDI_MASK
;
174 parport_write_data();
177 /* (1) assert or (0) deassert reset lines */
178 static void parport_reset(int trst
, int srst
)
180 LOG_DEBUG("trst: %i, srst: %i", trst
, srst
);
183 dataport_value
|= cable
->TRST_MASK
;
185 dataport_value
&= ~cable
->TRST_MASK
;
188 dataport_value
|= cable
->SRST_MASK
;
190 dataport_value
&= ~cable
->SRST_MASK
;
192 parport_write_data();
195 /* turn LED on parport adapter on (1) or off (0) */
196 static void parport_led(int on
)
199 dataport_value
|= cable
->LED_MASK
;
201 dataport_value
&= ~cable
->LED_MASK
;
203 parport_write_data();
206 static int parport_speed(int speed
)
212 static int parport_khz(int khz
, int* jtag_speed
)
215 LOG_DEBUG("RCLK not supported");
219 *jtag_speed
= 499999 / (khz
* parport_toggling_time_ns
);
223 static int parport_speed_div(int speed
, int* khz
)
225 uint32_t denominator
= (speed
+ 1) * parport_toggling_time_ns
;
227 *khz
= (499999 + denominator
) / denominator
;
231 #if PARPORT_USE_GIVEIO == 1
232 static int parport_get_giveio_access(void)
235 OSVERSIONINFO version
;
237 version
.dwOSVersionInfoSize
= sizeof version
;
238 if (!GetVersionEx(&version
)) {
242 if (version
.dwPlatformId
!= VER_PLATFORM_WIN32_NT
)
245 h
= CreateFile("\\\\.\\giveio", GENERIC_READ
, 0, NULL
, OPEN_EXISTING
, FILE_ATTRIBUTE_NORMAL
, NULL
);
246 if (h
== INVALID_HANDLE_VALUE
) {
257 static struct bitbang_interface parport_bitbang
= {
258 .read
= &parport_read
,
259 .write
= &parport_write
,
260 .reset
= &parport_reset
,
261 .blink
= &parport_led
,
264 static int parport_init(void)
266 struct cable
*cur_cable
;
267 #if PARPORT_USE_PPDEV == 1
274 if ((parport_cable
== NULL
) || (parport_cable
[0] == 0))
276 parport_cable
= "wiggler";
277 LOG_WARNING("No parport cable specified, using default 'wiggler'");
280 while (cur_cable
->name
)
282 if (strcmp(cur_cable
->name
, parport_cable
) == 0)
292 LOG_ERROR("No matching cable found for %s", parport_cable
);
293 return ERROR_JTAG_INIT_FAILED
;
296 dataport_value
= cable
->PORT_INIT
;
298 #if PARPORT_USE_PPDEV == 1
299 if (device_handle
> 0)
301 LOG_ERROR("device is already opened");
302 return ERROR_JTAG_INIT_FAILED
;
305 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
306 LOG_DEBUG("opening /dev/ppi%d...", parport_port
);
308 snprintf(buffer
, 256, "/dev/ppi%d", parport_port
);
309 device_handle
= open(buffer
, O_WRONLY
);
310 #else /* not __FreeBSD__, __FreeBSD_kernel__ */
311 LOG_DEBUG("opening /dev/parport%d...", parport_port
);
313 snprintf(buffer
, 256, "/dev/parport%d", parport_port
);
314 device_handle
= open(buffer
, O_WRONLY
);
315 #endif /* __FreeBSD__, __FreeBSD_kernel__ */
317 if (device_handle
< 0)
320 LOG_ERROR("cannot open device. check it exists and that user read and write rights are set. errno=%d", err
);
321 return ERROR_JTAG_INIT_FAILED
;
324 LOG_DEBUG("...open");
326 #if !defined(__FreeBSD__) && !defined(__FreeBSD_kernel__)
327 i
= ioctl(device_handle
, PPCLAIM
);
330 LOG_ERROR("cannot claim device");
331 return ERROR_JTAG_INIT_FAILED
;
334 i
= PARPORT_MODE_COMPAT
;
335 i
= ioctl(device_handle
, PPSETMODE
, & i
);
338 LOG_ERROR(" cannot set compatible mode to device");
339 return ERROR_JTAG_INIT_FAILED
;
342 i
= IEEE1284_MODE_COMPAT
;
343 i
= ioctl(device_handle
, PPNEGOT
, & i
);
346 LOG_ERROR("cannot set compatible 1284 mode to device");
347 return ERROR_JTAG_INIT_FAILED
;
349 #endif /* not __FreeBSD__, __FreeBSD_kernel__ */
351 #else /* not PARPORT_USE_PPDEV */
352 if (parport_port
== 0)
354 parport_port
= 0x378;
355 LOG_WARNING("No parport port specified, using default '0x378' (LPT1)");
358 dataport
= parport_port
;
359 statusport
= parport_port
+ 1;
361 LOG_DEBUG("requesting privileges for parallel port 0x%lx...", dataport
);
362 #if PARPORT_USE_GIVEIO == 1
363 if (parport_get_giveio_access() != 0)
364 #else /* PARPORT_USE_GIVEIO */
365 if (ioperm(dataport
, 3, 1) != 0)
366 #endif /* PARPORT_USE_GIVEIO */
368 LOG_ERROR("missing privileges for direct i/o");
369 return ERROR_JTAG_INIT_FAILED
;
371 LOG_DEBUG("...privileges granted");
373 /* make sure parallel port is in right mode (clear tristate and interrupt */
374 #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
375 outb(parport_port
+ 2, 0x0);
377 outb(0x0, parport_port
+ 2);
380 #endif /* PARPORT_USE_PPDEV */
383 parport_write(0, 0, 0);
386 bitbang_interface
= &parport_bitbang
;
388 wait_states
= jtag_get_speed();
393 static int parport_quit(void)
399 dataport_value
= cable
->PORT_EXIT
;
400 parport_write_data();
406 parport_cable
= NULL
;
412 COMMAND_HANDLER(parport_handle_parport_port_command
)
416 /* only if the port wasn't overwritten by cmdline */
417 if (parport_port
== 0)
419 COMMAND_PARSE_NUMBER(u16
, args
[0], parport_port
);
423 LOG_ERROR("The parport port was already configured!");
428 command_print(cmd_ctx
, "parport port = %u", parport_port
);
433 COMMAND_HANDLER(parport_handle_parport_cable_command
)
438 /* only if the cable name wasn't overwritten by cmdline */
439 if (parport_cable
== 0)
441 parport_cable
= malloc(strlen(args
[0]) + sizeof(char));
442 strcpy(parport_cable
, args
[0]);
448 COMMAND_HANDLER(parport_handle_write_on_exit_command
)
452 command_print(cmd_ctx
, "usage: parport_write_on_exit <on | off>");
456 if (strcmp(args
[0], "on") == 0)
458 else if (strcmp(args
[0], "off") == 0)
464 COMMAND_HANDLER(parport_handle_parport_toggling_time_command
)
468 int retval
= parse_u32(args
[0], &ns
);
470 if (ERROR_OK
!= retval
)
474 LOG_ERROR("0 ns is not a valid parport toggling time");
478 parport_toggling_time_ns
= ns
;
479 wait_states
= jtag_get_speed();
482 command_print(cmd_ctx
, "parport toggling time = %" PRIu32
" ns",
483 parport_toggling_time_ns
);
488 static int parport_register_commands(struct command_context_s
*cmd_ctx
)
490 register_command(cmd_ctx
, NULL
, "parport_port",
491 parport_handle_parport_port_command
, COMMAND_CONFIG
,
492 "either the address of the I/O port "
493 "or the number of the '/dev/parport' device");
495 register_command(cmd_ctx
, NULL
, "parport_cable",
496 parport_handle_parport_cable_command
, COMMAND_CONFIG
,
497 "the layout of the parallel port cable "
498 "used to connect to the target");
500 register_command(cmd_ctx
, NULL
, "parport_write_on_exit",
501 parport_handle_write_on_exit_command
, COMMAND_CONFIG
,
502 "configure the parallel driver to write "
503 "a known value to the parallel interface");
505 register_command(cmd_ctx
, NULL
, "parport_toggling_time",
506 parport_handle_parport_toggling_time_command
, COMMAND_ANY
,
507 "time <ns> it takes for the hardware to toggle TCK");
512 struct jtag_interface parport_interface
= {
514 .register_commands
= parport_register_commands
,
515 .init
= parport_init
,
516 .quit
= parport_quit
,
518 .speed_div
= parport_speed_div
,
519 .speed
= parport_speed
,
520 .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)