use COMMAND_HELPER for command helper functions
[openocd.git] / src / jtag / parport.c
index 7311bad80db50b845d310f35fbeabfb49ae4e9a5..a18b3f6afc1f5419f760bcafeea1d29f8d4a1994 100644 (file)
-/***************************************************************************\r
- *   Copyright (C) 2005 by Dominic Rath                                    *\r
- *   Dominic.Rath@gmx.de                                                   *\r
- *                                                                         *\r
- *   This program is free software; you can redistribute it and/or modify  *\r
- *   it under the terms of the GNU General Public License as published by  *\r
- *   the Free Software Foundation; either version 2 of the License, or     *\r
- *   (at your option) any later version.                                   *\r
- *                                                                         *\r
- *   This program is distributed in the hope that it will be useful,       *\r
- *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *\r
- *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *\r
- *   GNU General Public License for more details.                          *\r
- *                                                                         *\r
- *   You should have received a copy of the GNU General Public License     *\r
- *   along with this program; if not, write to the                         *\r
- *   Free Software Foundation, Inc.,                                       *\r
- *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *\r
- ***************************************************************************/\r
-#ifdef HAVE_CONFIG_H\r
-#include "config.h"\r
-#endif\r
-\r
-#include "replacements.h"\r
-\r
-#include "jtag.h"\r
-#include "bitbang.h"\r
-\r
-/* system includes */\r
-// -ino: 060521-1036\r
-#if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)\r
-\r
-#include <sys/types.h>\r
-#include <machine/sysarch.h>\r
-#include <machine/cpufunc.h>\r
-#define ioperm(startport,length,enable)\\r
-  i386_set_ioperm((startport), (length), (enable))\r
-\r
-#else\r
-\r
-#ifdef _WIN32\r
-#include "errno.h"\r
-#endif /* _WIN32 */\r
-\r
-#endif /* __FreeBSD__ */\r
-\r
-#include <string.h>\r
-#include <stdlib.h>\r
-#include <stdio.h>\r
-\r
-#if PARPORT_USE_PPDEV == 1\r
-#if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)\r
-#include <dev/ppbus/ppi.h>\r
-#include <dev/ppbus/ppbconf.h>\r
-#define PPRSTATUS      PPIGSTATUS\r
-#define PPWDATA                PPISDATA\r
-#else\r
-#include <linux/parport.h>\r
-#include <linux/ppdev.h>\r
-#endif\r
-#include <fcntl.h>\r
-#include <sys/ioctl.h>\r
-#else /* not PARPORT_USE_PPDEV */\r
-#ifndef _WIN32\r
-#include <sys/io.h>\r
-#endif\r
-#endif\r
-\r
-#if PARPORT_USE_GIVEIO == 1\r
-#if IS_CYGWIN == 1\r
-#include <windows.h>\r
-#include <errno.h>\r
-#undef ERROR\r
-#endif\r
-#endif\r
-\r
-#include "log.h"\r
-\r
-/* parallel port cable description\r
- */\r
-typedef struct cable_s\r
-{\r
-       char* name;\r
-       u8 TDO_MASK;    /* status port bit containing current TDO value */\r
-       u8 TRST_MASK;   /* data port bit for TRST */\r
-       u8 TMS_MASK;    /* data port bit for TMS */\r
-       u8 TCK_MASK;    /* data port bit for TCK */\r
-       u8 TDI_MASK;    /* data port bit for TDI */\r
-       u8 SRST_MASK;   /* data port bit for SRST */\r
-       u8 OUTPUT_INVERT;       /* data port bits that should be inverted */\r
-       u8 INPUT_INVERT;        /* status port that should be inverted */\r
-       u8 PORT_INIT;   /* initialize data port with this value */\r
-       u8 PORT_EXIT;   /* de-initialize data port with this value */\r
-       u8 LED_MASK;    /* data port bit for LED */\r
-} cable_t;\r
-\r
-cable_t cables[] = \r
-{      \r
-       /* name                                 tdo   trst  tms   tck   tdi   srst  o_inv i_inv init  exit  led */\r
-       { "wiggler",                    0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x01, 0x80, 0x80, 0x80, 0x00 },\r
-       { "wiggler2",                   0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x01, 0x80, 0x80, 0x00, 0x20 },\r
-       { "wiggler_ntrst_inverted",\r
-                                                       0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x11, 0x80, 0x80, 0x80, 0x00 },\r
-       { "old_amt_wiggler",    0x80, 0x01, 0x02, 0x04, 0x08, 0x10, 0x11, 0x80, 0x80, 0x80, 0x00 },\r
-       { "chameleon",                  0x80, 0x00, 0x04, 0x01, 0x02, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00 },\r
-       { "dlc5",                               0x10, 0x00, 0x04, 0x02, 0x01, 0x00, 0x00, 0x00, 0x10, 0x10, 0x00 },\r
-       { "triton",                             0x80, 0x08, 0x04, 0x01, 0x02, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00 },\r
-       { "lattice",                    0x40, 0x10, 0x04, 0x02, 0x01, 0x08, 0x00, 0x00, 0x18, 0x18, 0x00 },\r
-       { "flashlink",                  0x20, 0x10, 0x02, 0x01, 0x04, 0x20, 0x30, 0x20, 0x00, 0x00, 0x00 },\r
-/* Altium Universal JTAG cable. Set the cable to Xilinx Mode and wire to target as follows:\r
-       HARD TCK - Target TCK\r
-       HARD TMS - Target TMS\r
-       HARD TDI - Target TDI\r
-       HARD TDO - Target TDO\r
-       SOFT TCK - Target TRST\r
-       SOFT TDI - Target SRST\r
-*/\r
-       { "altium",                     0x10, 0x20, 0x04, 0x02, 0x01, 0x80, 0x00, 0x00, 0x10, 0x00, 0x08 },\r
-       { NULL,                         0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }\r
-};\r
-\r
-/* configuration */\r
-char* parport_cable = NULL;\r
-u16 parport_port;\r
-static int parport_exit = 0;\r
-\r
-/* interface variables\r
- */\r
-static cable_t* cable;\r
-static u8 dataport_value = 0x0;\r
-\r
-#if PARPORT_USE_PPDEV == 1\r
-static int device_handle;\r
-#else\r
-static unsigned long dataport;\r
-static unsigned long statusport;\r
-#endif\r
-\r
-/* low level command set\r
- */\r
-int parport_read(void);\r
-void parport_write(int tck, int tms, int tdi);\r
-void parport_reset(int trst, int srst);\r
-void parport_led(int on);\r
-\r
-int parport_speed(int speed);\r
-int parport_register_commands(struct command_context_s *cmd_ctx);\r
-int parport_init(void);\r
-int parport_quit(void);\r
-\r
-/* interface commands */\r
-int parport_handle_parport_port_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
-int parport_handle_parport_cable_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
-int parport_handle_write_on_exit_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
-\r
-jtag_interface_t parport_interface = \r
-{\r
-       .name = "parport",\r
-       \r
-       .execute_queue = bitbang_execute_queue,\r
-\r
-       .speed = parport_speed, \r
-       .register_commands = parport_register_commands,\r
-       .init = parport_init,\r
-       .quit = parport_quit,\r
-};\r
-\r
-bitbang_interface_t parport_bitbang =\r
-{\r
-       .read = parport_read,\r
-       .write = parport_write,\r
-       .reset = parport_reset,\r
-       .blink = parport_led\r
-};\r
-\r
-int parport_read(void)\r
-{\r
-       int data = 0;\r
-       \r
-#if PARPORT_USE_PPDEV == 1\r
-       ioctl(device_handle, PPRSTATUS, & data);\r
-#else\r
-       data = inb(statusport);\r
-#endif\r
-\r
-       if ((data ^ cable->INPUT_INVERT) & cable->TDO_MASK)\r
-               return 1;\r
-       else\r
-               return 0;\r
-}\r
-\r
-static inline void parport_write_data(void)\r
-{\r
-       u8 output;\r
-       output = dataport_value ^ cable->OUTPUT_INVERT;\r
-\r
-#if PARPORT_USE_PPDEV == 1\r
-       ioctl(device_handle, PPWDATA, &output);\r
-#else\r
-#if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)\r
-       outb(dataport, output);\r
-#else\r
-       outb(output, dataport);\r
-#endif\r
-#endif\r
-}\r
-\r
-void parport_write(int tck, int tms, int tdi)\r
-{\r
-       int i = jtag_speed + 1;\r
-       \r
-       if (tck)\r
-               dataport_value |= cable->TCK_MASK;\r
-       else\r
-               dataport_value &= ~cable->TCK_MASK;\r
-       \r
-       if (tms)\r
-               dataport_value |= cable->TMS_MASK;\r
-       else\r
-               dataport_value &= ~cable->TMS_MASK;\r
-       \r
-       if (tdi)\r
-               dataport_value |= cable->TDI_MASK;\r
-       else\r
-               dataport_value &= ~cable->TDI_MASK;\r
-               \r
-       while (i-- > 0)\r
-               parport_write_data();\r
-}\r
-\r
-/* (1) assert or (0) deassert reset lines */\r
-void parport_reset(int trst, int srst)\r
-{\r
-       DEBUG("trst: %i, srst: %i", trst, srst);\r
-\r
-       if (trst == 0)\r
-               dataport_value |= cable->TRST_MASK;\r
-       else if (trst == 1)\r
-               dataport_value &= ~cable->TRST_MASK;\r
-\r
-       if (srst == 0)\r
-               dataport_value |= cable->SRST_MASK;\r
-       else if (srst == 1)\r
-               dataport_value &= ~cable->SRST_MASK;\r
-       \r
-       parport_write_data();\r
-}\r
-       \r
-/* turn LED on parport adapter on (1) or off (0) */\r
-void parport_led(int on)\r
-{\r
-       if (on)\r
-               dataport_value |= cable->LED_MASK;\r
-       else\r
-               dataport_value &= ~cable->LED_MASK;\r
-\r
-       parport_write_data();\r
-}\r
-\r
-int parport_speed(int speed)\r
-{\r
-       jtag_speed = speed;\r
-       \r
-       return ERROR_OK;\r
-}\r
-\r
-int parport_register_commands(struct command_context_s *cmd_ctx)\r
-{\r
-       register_command(cmd_ctx, NULL, "parport_port", parport_handle_parport_port_command,\r
-               COMMAND_CONFIG, NULL);\r
-       register_command(cmd_ctx, NULL, "parport_cable", parport_handle_parport_cable_command,\r
-               COMMAND_CONFIG, NULL);\r
-       register_command(cmd_ctx, NULL, "parport_write_on_exit", parport_handle_write_on_exit_command,\r
-               COMMAND_CONFIG, NULL);\r
-\r
-       return ERROR_OK;\r
-}\r
-\r
-#if PARPORT_USE_GIVEIO == 1\r
-int parport_get_giveio_access()\r
-{\r
-    HANDLE h;\r
-    OSVERSIONINFO version;\r
-\r
-    version.dwOSVersionInfoSize = sizeof version;\r
-    if (!GetVersionEx( &version )) {\r
-        errno = EINVAL;\r
-        return -1;\r
-    }\r
-    if (version.dwPlatformId != VER_PLATFORM_WIN32_NT)\r
-        return 0;\r
-\r
-    h = CreateFile( "\\\\.\\giveio", GENERIC_READ, 0, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL );\r
-    if (h == INVALID_HANDLE_VALUE) {\r
-        errno = ENODEV;\r
-        return -1;\r
-    }\r
-\r
-    CloseHandle( h );\r
-\r
-    return 0;\r
-}\r
-#endif\r
-\r
-int parport_init(void)\r
-{\r
-       cable_t *cur_cable;\r
-#if PARPORT_USE_PPDEV == 1\r
-       char buffer[256];\r
-       int i = 0;\r
-#endif\r
-       \r
-       cur_cable = cables;\r
-       \r
-       if ((parport_cable == NULL) || (parport_cable[0] == 0))\r
-       {\r
-               parport_cable = "wiggler";\r
-               WARNING("No parport cable specified, using default 'wiggler'");\r
-       }\r
-       \r
-       while (cur_cable->name)\r
-       {\r
-               if (strcmp(cur_cable->name, parport_cable) == 0)\r
-               {\r
-                       cable = cur_cable;\r
-                       break;\r
-               }\r
-               cur_cable++;\r
-       }\r
-\r
-       if (!cable)\r
-       {\r
-               ERROR("No matching cable found for %s", parport_cable);\r
-               return ERROR_JTAG_INIT_FAILED;\r
-       }\r
-       \r
-       dataport_value = cable->PORT_INIT;\r
-       \r
-#if PARPORT_USE_PPDEV == 1\r
-       if (device_handle > 0)\r
-       {\r
-               ERROR("device is already opened");\r
-               return ERROR_JTAG_INIT_FAILED;\r
-       }\r
-\r
-#if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)\r
-       DEBUG("opening /dev/ppi%d...", parport_port);\r
-\r
-       snprintf(buffer, 256, "/dev/ppi%d", parport_port);\r
-       device_handle = open(buffer, O_WRONLY);\r
-#else /* not __FreeBSD__, __FreeBSD_kernel__ */\r
-       DEBUG("opening /dev/parport%d...", parport_port);\r
-\r
-       snprintf(buffer, 256, "/dev/parport%d", parport_port);\r
-       device_handle = open(buffer, O_WRONLY);\r
-#endif /* __FreeBSD__, __FreeBSD_kernel__ */\r
-\r
-       if (device_handle < 0)\r
-       {\r
-               ERROR("cannot open device. check it exists and that user read and write rights are set");\r
-               return ERROR_JTAG_INIT_FAILED;\r
-       }\r
-\r
-       DEBUG("...open");\r
-\r
-#if !defined(__FreeBSD__) && !defined(__FreeBSD_kernel__)\r
-       i=ioctl(device_handle, PPCLAIM);\r
-       if (i<0)\r
-       {\r
-               ERROR("cannot claim device");\r
-               return ERROR_JTAG_INIT_FAILED;\r
-       }\r
-\r
-       i = PARPORT_MODE_COMPAT;\r
-       i= ioctl(device_handle, PPSETMODE, & i);\r
-       if (i<0)\r
-       {\r
-               ERROR(" cannot set compatible mode to device");\r
-               return ERROR_JTAG_INIT_FAILED;\r
-       }\r
-\r
-       i = IEEE1284_MODE_COMPAT;\r
-       i = ioctl(device_handle, PPNEGOT, & i);\r
-       if (i<0)\r
-       {\r
-               ERROR("cannot set compatible 1284 mode to device");\r
-               return ERROR_JTAG_INIT_FAILED;\r
-       }\r
-#endif /* not __FreeBSD__, __FreeBSD_kernel__ */\r
-\r
-#else /* not PARPORT_USE_PPDEV */\r
-       if (parport_port == 0)\r
-       {\r
-               parport_port = 0x378;\r
-               WARNING("No parport port specified, using default '0x378' (LPT1)");\r
-       }\r
-       \r
-       dataport = parport_port;\r
-       statusport = parport_port + 1;\r
-       \r
-       DEBUG("requesting privileges for parallel port 0x%lx...", dataport);\r
-#if PARPORT_USE_GIVEIO == 1\r
-       if (parport_get_giveio_access() != 0)\r
-#else /* PARPORT_USE_GIVEIO */\r
-       if (ioperm(dataport, 3, 1) != 0)\r
-#endif /* PARPORT_USE_GIVEIO */\r
-       {\r
-               ERROR("missing privileges for direct i/o");\r
-               return ERROR_JTAG_INIT_FAILED;\r
-       }\r
-       DEBUG("...privileges granted");\r
-       \r
-       /* make sure parallel port is in right mode (clear tristate and interrupt */\r
-       #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)\r
-               outb(parport_port + 2, 0x0);\r
-       #else\r
-               outb(0x0, parport_port + 2);\r
-       #endif\r
-       \r
-#endif /* PARPORT_USE_PPDEV */\r
-       \r
-       parport_reset(0, 0);\r
-       parport_write(0, 0, 0);\r
-       parport_led(1);\r
-\r
-       bitbang_interface = &parport_bitbang;   \r
-\r
-       return ERROR_OK;\r
-}\r
-\r
-int parport_quit(void)\r
-{\r
-       parport_led(0);\r
-\r
-       if (parport_exit)\r
-       {\r
-               dataport_value = cable->PORT_EXIT;\r
-               parport_write_data();\r
-       }\r
-       \r
-       if (parport_cable)\r
-       {\r
-               free(parport_cable);\r
-               parport_cable = NULL;\r
-       }\r
-       \r
-       return ERROR_OK;\r
-}\r
-\r
-int parport_handle_parport_port_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
-{\r
-       if (argc == 0)\r
-               return ERROR_OK;\r
-\r
-       /* only if the port wasn't overwritten by cmdline */\r
-       if (parport_port == 0)\r
-               parport_port = strtoul(args[0], NULL, 0);\r
-\r
-       return ERROR_OK;\r
-}\r
-\r
-int parport_handle_parport_cable_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
-{\r
-       if (argc == 0)\r
-               return ERROR_OK;\r
-\r
-       /* only if the cable name wasn't overwritten by cmdline */\r
-       if (parport_cable == 0)\r
-       {\r
-               parport_cable = malloc(strlen(args[0]) + sizeof(char));\r
-               strcpy(parport_cable, args[0]);\r
-       }\r
-\r
-       return ERROR_OK;\r
-}\r
-\r
-int parport_handle_write_on_exit_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
-{\r
-       if (argc != 1)\r
-       {\r
-               command_print(cmd_ctx, "usage: parport_write_on_exit <on|off>");\r
-               return ERROR_OK;\r
-       }\r
-       \r
-       if (strcmp(args[0], "on") == 0)\r
-               parport_exit = 1;\r
-       else if (strcmp(args[0], "off") == 0)\r
-               parport_exit = 0;\r
-       \r
-       return ERROR_OK;\r
-}\r
+/***************************************************************************
+ *   Copyright (C) 2005 by Dominic Rath                                    *
+ *   Dominic.Rath@gmx.de                                                   *
+ *                                                                         *
+ *   Copyright (C) 2008 by Spencer Oliver                                  *
+ *   spen@spen-soft.co.uk                                                  *
+ *                                                                         *
+ *   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.,                                       *
+ *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
+ ***************************************************************************/
+#ifdef HAVE_CONFIG_H
+#include "config.h"
+#endif
+
+#include "interface.h"
+#include "bitbang.h"
+
+/* -ino: 060521-1036 */
+#if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
+#include <machine/sysarch.h>
+#include <machine/cpufunc.h>
+#define ioperm(startport,length,enable)\
+  i386_set_ioperm((startport), (length), (enable))
+#endif /* __FreeBSD__ */
+
+#if PARPORT_USE_PPDEV == 1
+#if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
+#include <dev/ppbus/ppi.h>
+#include <dev/ppbus/ppbconf.h>
+#define PPRSTATUS      PPIGSTATUS
+#define PPWDATA                PPISDATA
+#else
+#include <linux/parport.h>
+#include <linux/ppdev.h>
+#endif
+#include <sys/ioctl.h>
+#else /* not PARPORT_USE_PPDEV */
+#ifndef _WIN32
+#include <sys/io.h>
+#endif
+#endif
+
+#if PARPORT_USE_GIVEIO == 1 && IS_CYGWIN == 1
+#include <windows.h>
+#endif
+
+
+/* parallel port cable description
+ */
+typedef struct cable_s
+{
+       char* name;
+       uint8_t TDO_MASK;       /* status port bit containing current TDO value */
+       uint8_t TRST_MASK;      /* data port bit for TRST */
+       uint8_t TMS_MASK;       /* data port bit for TMS */
+       uint8_t TCK_MASK;       /* data port bit for TCK */
+       uint8_t TDI_MASK;       /* data port bit for TDI */
+       uint8_t SRST_MASK;      /* data port bit for SRST */
+       uint8_t OUTPUT_INVERT;  /* data port bits that should be inverted */
+       uint8_t INPUT_INVERT;   /* status port that should be inverted */
+       uint8_t PORT_INIT;      /* initialize data port with this value */
+       uint8_t PORT_EXIT;      /* de-initialize data port with this value */
+       uint8_t LED_MASK;       /* data port bit for LED */
+} cable_t;
+
+static cable_t cables[] =
+{
+       /* name                                 tdo   trst  tms   tck   tdi   srst  o_inv i_inv init  exit  led */
+       { "wiggler",                    0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x01, 0x80, 0x80, 0x80, 0x00 },
+       { "wiggler2",                   0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x01, 0x80, 0x80, 0x00, 0x20 },
+       { "wiggler_ntrst_inverted",
+                                                       0x80, 0x10, 0x02, 0x04, 0x08, 0x01, 0x11, 0x80, 0x80, 0x80, 0x00 },
+       { "old_amt_wiggler",    0x80, 0x01, 0x02, 0x04, 0x08, 0x10, 0x11, 0x80, 0x80, 0x80, 0x00 },
+       { "arm-jtag",                   0x80, 0x01, 0x02, 0x04, 0x08, 0x10, 0x01, 0x80, 0x80, 0x80, 0x00 },
+       { "chameleon",                  0x80, 0x00, 0x04, 0x01, 0x02, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00 },
+       { "dlc5",                               0x10, 0x00, 0x04, 0x02, 0x01, 0x00, 0x00, 0x00, 0x10, 0x10, 0x00 },
+       { "triton",                             0x80, 0x08, 0x04, 0x01, 0x02, 0x00, 0x00, 0x80, 0x00, 0x00, 0x00 },
+       { "lattice",                    0x40, 0x10, 0x04, 0x02, 0x01, 0x08, 0x00, 0x00, 0x18, 0x18, 0x00 },
+       { "flashlink",                  0x20, 0x10, 0x02, 0x01, 0x04, 0x20, 0x30, 0x20, 0x00, 0x00, 0x00 },
+/* Altium Universal JTAG cable. Set the cable to Xilinx Mode and wire to target as follows:
+       HARD TCK - Target TCK
+       HARD TMS - Target TMS
+       HARD TDI - Target TDI
+       HARD TDO - Target TDO
+       SOFT TCK - Target TRST
+       SOFT TDI - Target SRST
+*/
+       { "altium",                     0x10, 0x20, 0x04, 0x02, 0x01, 0x80, 0x00, 0x00, 0x10, 0x00, 0x08 },
+       { NULL,                         0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00 }
+};
+
+/* configuration */
+static char* parport_cable = NULL;
+static uint16_t parport_port;
+static int parport_exit = 0;
+static uint32_t parport_toggling_time_ns = 1000;
+static int wait_states;
+
+/* interface variables
+ */
+static cable_t* cable;
+static uint8_t dataport_value = 0x0;
+
+#if PARPORT_USE_PPDEV == 1
+static int device_handle;
+#else
+static unsigned long dataport;
+static unsigned long statusport;
+#endif
+
+static int parport_read(void)
+{
+       int data = 0;
+
+#if PARPORT_USE_PPDEV == 1
+       ioctl(device_handle, PPRSTATUS, & data);
+#else
+       data = inb(statusport);
+#endif
+
+       if ((data ^ cable->INPUT_INVERT) & cable->TDO_MASK)
+               return 1;
+       else
+               return 0;
+}
+
+static __inline__ void parport_write_data(void)
+{
+       uint8_t output;
+       output = dataport_value ^ cable->OUTPUT_INVERT;
+
+#if PARPORT_USE_PPDEV == 1
+       ioctl(device_handle, PPWDATA, &output);
+#else
+#if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
+       outb(dataport, output);
+#else
+       outb(output, dataport);
+#endif
+#endif
+}
+
+static void parport_write(int tck, int tms, int tdi)
+{
+       int i = wait_states + 1;
+
+       if (tck)
+               dataport_value |= cable->TCK_MASK;
+       else
+               dataport_value &= ~cable->TCK_MASK;
+
+       if (tms)
+               dataport_value |= cable->TMS_MASK;
+       else
+               dataport_value &= ~cable->TMS_MASK;
+
+       if (tdi)
+               dataport_value |= cable->TDI_MASK;
+       else
+               dataport_value &= ~cable->TDI_MASK;
+
+       while (i-- > 0)
+               parport_write_data();
+}
+
+/* (1) assert or (0) deassert reset lines */
+static void parport_reset(int trst, int srst)
+{
+       LOG_DEBUG("trst: %i, srst: %i", trst, srst);
+
+       if (trst == 0)
+               dataport_value |= cable->TRST_MASK;
+       else if (trst == 1)
+               dataport_value &= ~cable->TRST_MASK;
+
+       if (srst == 0)
+               dataport_value |= cable->SRST_MASK;
+       else if (srst == 1)
+               dataport_value &= ~cable->SRST_MASK;
+
+       parport_write_data();
+}
+
+/* turn LED on parport adapter on (1) or off (0) */
+static void parport_led(int on)
+{
+       if (on)
+               dataport_value |= cable->LED_MASK;
+       else
+               dataport_value &= ~cable->LED_MASK;
+
+       parport_write_data();
+}
+
+static int parport_speed(int speed)
+{
+       wait_states = speed;
+       return ERROR_OK;
+}
+
+static int parport_khz(int khz, int* jtag_speed)
+{
+       if (khz == 0) {
+               LOG_DEBUG("RCLK not supported");
+               return ERROR_FAIL;
+       }
+
+       *jtag_speed = 499999 / (khz * parport_toggling_time_ns);
+       return ERROR_OK;
+}
+
+static int parport_speed_div(int speed, int* khz)
+{
+       uint32_t denominator = (speed + 1) * parport_toggling_time_ns;
+
+       *khz = (499999 + denominator) / denominator;
+       return ERROR_OK;
+}
+
+#if PARPORT_USE_GIVEIO == 1
+static int parport_get_giveio_access(void)
+{
+       HANDLE h;
+       OSVERSIONINFO version;
+
+       version.dwOSVersionInfoSize = sizeof version;
+       if (!GetVersionEx(&version)) {
+               errno = EINVAL;
+               return -1;
+       }
+       if (version.dwPlatformId != VER_PLATFORM_WIN32_NT)
+               return 0;
+
+       h = CreateFile("\\\\.\\giveio", GENERIC_READ, 0, NULL, OPEN_EXISTING, FILE_ATTRIBUTE_NORMAL, NULL);
+       if (h == INVALID_HANDLE_VALUE) {
+               errno = ENODEV;
+               return -1;
+       }
+
+       CloseHandle(h);
+
+       return 0;
+}
+#endif
+
+static bitbang_interface_t parport_bitbang = {
+               .read = &parport_read,
+               .write = &parport_write,
+               .reset = &parport_reset,
+               .blink = &parport_led,
+       };
+
+static int parport_init(void)
+{
+       cable_t *cur_cable;
+#if PARPORT_USE_PPDEV == 1
+       char buffer[256];
+       int i = 0;
+#endif
+
+       cur_cable = cables;
+
+       if ((parport_cable == NULL) || (parport_cable[0] == 0))
+       {
+               parport_cable = "wiggler";
+               LOG_WARNING("No parport cable specified, using default 'wiggler'");
+       }
+
+       while (cur_cable->name)
+       {
+               if (strcmp(cur_cable->name, parport_cable) == 0)
+               {
+                       cable = cur_cable;
+                       break;
+               }
+               cur_cable++;
+       }
+
+       if (!cable)
+       {
+               LOG_ERROR("No matching cable found for %s", parport_cable);
+               return ERROR_JTAG_INIT_FAILED;
+       }
+
+       dataport_value = cable->PORT_INIT;
+
+#if PARPORT_USE_PPDEV == 1
+       if (device_handle > 0)
+       {
+               LOG_ERROR("device is already opened");
+               return ERROR_JTAG_INIT_FAILED;
+       }
+
+#if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
+       LOG_DEBUG("opening /dev/ppi%d...", parport_port);
+
+       snprintf(buffer, 256, "/dev/ppi%d", parport_port);
+       device_handle = open(buffer, O_WRONLY);
+#else /* not __FreeBSD__, __FreeBSD_kernel__ */
+       LOG_DEBUG("opening /dev/parport%d...", parport_port);
+
+       snprintf(buffer, 256, "/dev/parport%d", parport_port);
+       device_handle = open(buffer, O_WRONLY);
+#endif /* __FreeBSD__, __FreeBSD_kernel__ */
+
+       if (device_handle < 0)
+       {
+               int err = errno;
+               LOG_ERROR("cannot open device. check it exists and that user read and write rights are set. errno=%d", err);
+               return ERROR_JTAG_INIT_FAILED;
+       }
+
+       LOG_DEBUG("...open");
+
+#if !defined(__FreeBSD__) && !defined(__FreeBSD_kernel__)
+       i = ioctl(device_handle, PPCLAIM);
+       if (i < 0)
+       {
+               LOG_ERROR("cannot claim device");
+               return ERROR_JTAG_INIT_FAILED;
+       }
+
+       i = PARPORT_MODE_COMPAT;
+       i= ioctl(device_handle, PPSETMODE, & i);
+       if (i < 0)
+       {
+               LOG_ERROR(" cannot set compatible mode to device");
+               return ERROR_JTAG_INIT_FAILED;
+       }
+
+       i = IEEE1284_MODE_COMPAT;
+       i = ioctl(device_handle, PPNEGOT, & i);
+       if (i < 0)
+       {
+               LOG_ERROR("cannot set compatible 1284 mode to device");
+               return ERROR_JTAG_INIT_FAILED;
+       }
+#endif /* not __FreeBSD__, __FreeBSD_kernel__ */
+
+#else /* not PARPORT_USE_PPDEV */
+       if (parport_port == 0)
+       {
+               parport_port = 0x378;
+               LOG_WARNING("No parport port specified, using default '0x378' (LPT1)");
+       }
+
+       dataport = parport_port;
+       statusport = parport_port + 1;
+
+       LOG_DEBUG("requesting privileges for parallel port 0x%lx...", dataport);
+#if PARPORT_USE_GIVEIO == 1
+       if (parport_get_giveio_access() != 0)
+#else /* PARPORT_USE_GIVEIO */
+       if (ioperm(dataport, 3, 1) != 0)
+#endif /* PARPORT_USE_GIVEIO */
+       {
+               LOG_ERROR("missing privileges for direct i/o");
+               return ERROR_JTAG_INIT_FAILED;
+       }
+       LOG_DEBUG("...privileges granted");
+
+       /* make sure parallel port is in right mode (clear tristate and interrupt */
+       #if defined(__FreeBSD__) || defined(__FreeBSD_kernel__)
+               outb(parport_port + 2, 0x0);
+       #else
+               outb(0x0, parport_port + 2);
+       #endif
+
+#endif /* PARPORT_USE_PPDEV */
+
+       parport_reset(0, 0);
+       parport_write(0, 0, 0);
+       parport_led(1);
+
+       bitbang_interface = &parport_bitbang;
+
+       wait_states = jtag_get_speed();
+
+       return ERROR_OK;
+}
+
+static int parport_quit(void)
+{
+       parport_led(0);
+
+       if (parport_exit)
+       {
+               dataport_value = cable->PORT_EXIT;
+               parport_write_data();
+       }
+
+       if (parport_cable)
+       {
+               free(parport_cable);
+               parport_cable = NULL;
+       }
+
+       return ERROR_OK;
+}
+
+COMMAND_HANDLER(parport_handle_parport_port_command)
+{
+       if (argc == 1)
+       {
+               /* only if the port wasn't overwritten by cmdline */
+               if (parport_port == 0)
+               {
+                       COMMAND_PARSE_NUMBER(u16, args[0], parport_port);
+               }
+               else
+               {
+                       LOG_ERROR("The parport port was already configured!");
+                       return ERROR_FAIL;
+               }
+       }
+
+       command_print(cmd_ctx, "parport port = %u", parport_port);
+
+       return ERROR_OK;
+}
+
+COMMAND_HANDLER(parport_handle_parport_cable_command)
+{
+       if (argc == 0)
+               return ERROR_OK;
+
+       /* only if the cable name wasn't overwritten by cmdline */
+       if (parport_cable == 0)
+       {
+               parport_cable = malloc(strlen(args[0]) + sizeof(char));
+               strcpy(parport_cable, args[0]);
+       }
+
+       return ERROR_OK;
+}
+
+COMMAND_HANDLER(parport_handle_write_on_exit_command)
+{
+       if (argc != 1)
+       {
+               command_print(cmd_ctx, "usage: parport_write_on_exit <on | off>");
+               return ERROR_OK;
+       }
+
+       if (strcmp(args[0], "on") == 0)
+               parport_exit = 1;
+       else if (strcmp(args[0], "off") == 0)
+               parport_exit = 0;
+
+       return ERROR_OK;
+}
+
+COMMAND_HANDLER(parport_handle_parport_toggling_time_command)
+{
+       if (argc == 1) {
+               uint32_t ns;
+               int retval = parse_u32(args[0], &ns);
+
+               if (ERROR_OK != retval)
+                       return retval;
+
+               if (ns == 0) {
+                       LOG_ERROR("0 ns is not a valid parport toggling time");
+                       return ERROR_FAIL;
+               }
+
+               parport_toggling_time_ns = ns;
+               wait_states = jtag_get_speed();
+       }
+
+       command_print(cmd_ctx, "parport toggling time = %" PRIu32 " ns",
+                       parport_toggling_time_ns);
+
+       return ERROR_OK;
+}
+
+static int parport_register_commands(struct command_context_s *cmd_ctx)
+{
+       register_command(cmd_ctx, NULL, "parport_port",
+                       parport_handle_parport_port_command, COMMAND_CONFIG,
+                       "either the address of the I/O port "
+                       "or the number of the '/dev/parport' device");
+
+       register_command(cmd_ctx, NULL, "parport_cable",
+                       parport_handle_parport_cable_command, COMMAND_CONFIG,
+                       "the layout of the parallel port cable "
+                       "used to connect to the target");
+
+       register_command(cmd_ctx, NULL, "parport_write_on_exit",
+                       parport_handle_write_on_exit_command, COMMAND_CONFIG,
+                       "configure the parallel driver to write "
+                       "a known value to the parallel interface");
+
+       register_command(cmd_ctx, NULL, "parport_toggling_time",
+                       parport_handle_parport_toggling_time_command, COMMAND_ANY,
+                       "time <ns> it takes for the hardware to toggle TCK");
+
+       return ERROR_OK;
+}
+
+jtag_interface_t parport_interface = {
+       .name =                 "parport",
+       .register_commands =    parport_register_commands,
+       .init =                 parport_init,
+       .quit =                 parport_quit,
+       .khz =                  parport_khz,
+       .speed_div =            parport_speed_div,
+       .speed =                parport_speed,
+       .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)