git.gag.com Git - fw/openocd/blob - src/jtag/jtag.c

   1 /***************************************************************************\r
   2  *   Copyright (C) 2005 by Dominic Rath                                    *\r
   3  *   Dominic.Rath@gmx.de                                                   *\r
   4  *                                                                         *\r
   5  *   This program is free software; you can redistribute it and/or modify  *\r
   6  *   it under the terms of the GNU General Public License as published by  *\r
   7  *   the Free Software Foundation; either version 2 of the License, or     *\r
   8  *   (at your option) any later version.                                   *\r
   9  *                                                                         *\r
  10  *   This program is distributed in the hope that it will be useful,       *\r
  11  *   but WITHOUT ANY WARRANTY; without even the implied warranty of        *\r
  12  *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *\r
  13  *   GNU General Public License for more details.                          *\r
  14  *                                                                         *\r
  15  *   You should have received a copy of the GNU General Public License     *\r
  16  *   along with this program; if not, write to the                         *\r
  17  *   Free Software Foundation, Inc.,                                       *\r
  18  *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *\r
  19  ***************************************************************************/\r
  20 #ifdef HAVE_CONFIG_H\r
  21 #include "config.h"\r
  22 #endif\r
  23 \r
  24 #include "replacements.h"\r
  25 \r
  26 #include "jtag.h"\r
  27 \r
  28 #include "command.h"\r
  29 #include "log.h"\r
  30 #include "interpreter.h"\r
  31 \r
  32 #include "stdlib.h"\r
  33 #include "string.h"\r
  34 #include <unistd.h>\r
  35 \r
  36 char* tap_state_strings[16] =\r
  37 {\r
  38         "tlr", \r
  39         "sds", "cd", "sd", "e1d", "pd", "e2d", "ud",\r
  40         "rti",\r
  41         "sis", "ci", "si", "e1i", "pi", "e2i", "ui"\r
  42 };\r
  43 \r
  44 typedef struct cmd_queue_page_s\r
  45 {\r
  46         void *address;\r
  47         size_t used;\r
  48         struct cmd_queue_page_s *next;\r
  49 } cmd_queue_page_t;\r
  50 \r
  51 #define CMD_QUEUE_PAGE_SIZE (1024 * 1024)\r
  52 static cmd_queue_page_t *cmd_queue_pages = NULL;\r
  53 \r
  54 /* tap_move[i][j]: tap movement command to go from state i to state j\r
  55  * 0: Test-Logic-Reset\r
  56  * 1: Run-Test/Idle\r
  57  * 2: Shift-DR\r
  58  * 3: Pause-DR\r
  59  * 4: Shift-IR\r
  60  * 5: Pause-IR\r
  61  * \r
  62  * SD->SD and SI->SI have to be caught in interface specific code\r
  63  */\r
  64 u8 tap_move[6][6] =\r
  65 {\r
  66 /*        TLR   RTI   SD    PD    SI    PI             */\r
  67         {0x7f, 0x00, 0x17, 0x0a, 0x1b, 0x16},   /* TLR */\r
  68         {0x7f, 0x00, 0x25, 0x05, 0x2b, 0x0b},   /* RTI */\r
  69         {0x7f, 0x31, 0x00, 0x01, 0x0f, 0x2f},   /* SD  */\r
  70         {0x7f, 0x30, 0x20, 0x17, 0x1e, 0x2f},   /* PD  */\r
  71         {0x7f, 0x31, 0x07, 0x17, 0x00, 0x01},   /* SI  */\r
  72         {0x7f, 0x30, 0x1c, 0x17, 0x20, 0x2f}    /* PI  */\r
  73 };\r
  74 \r
  75 int tap_move_map[16] = {\r
  76         0, -1, -1,  2, -1,  3, -1, -1,\r
  77         1, -1, -1,  4, -1,  5, -1, -1\r
  78 };\r
  79 \r
  80 tap_transition_t tap_transitions[16] =\r
  81 {\r
  82         {TAP_TLR, TAP_RTI},             /* TLR */\r
  83         {TAP_SIS, TAP_CD},              /* SDS */\r
  84         {TAP_E1D, TAP_SD},              /* CD  */\r
  85         {TAP_E1D, TAP_SD},              /* SD  */\r
  86         {TAP_UD,  TAP_PD},              /* E1D */\r
  87         {TAP_E2D, TAP_PD},              /* PD  */\r
  88         {TAP_UD,  TAP_SD},              /* E2D */\r
  89         {TAP_SDS, TAP_RTI},             /* UD  */\r
  90         {TAP_SDS, TAP_RTI},             /* RTI */\r
  91         {TAP_TLR, TAP_CI},              /* SIS */\r
  92         {TAP_E1I, TAP_SI},              /* CI  */\r
  93         {TAP_E1I, TAP_SI},              /* SI  */\r
  94         {TAP_UI,  TAP_PI},              /* E1I */\r
  95         {TAP_E2I, TAP_PI},              /* PI  */\r
  96         {TAP_UI,  TAP_SI},              /* E2I */\r
  97         {TAP_SDS, TAP_RTI}              /* UI  */\r
  98 };\r
  99 \r
 100 char* jtag_event_strings[] =\r
 101 {\r
 102         "SRST asserted",\r
 103         "TRST asserted",\r
 104         "SRST released",\r
 105         "TRST released"\r
 106 };\r
 107 \r
 108 enum tap_state end_state = TAP_TLR;\r
 109 enum tap_state cur_state = TAP_TLR;\r
 110 int jtag_trst = 0;\r
 111 int jtag_srst = 0;\r
 112 \r
 113 jtag_command_t *jtag_command_queue = NULL;\r
 114 jtag_command_t **last_comand_pointer = &jtag_command_queue;\r
 115 jtag_device_t *jtag_devices = NULL;\r
 116 int jtag_num_devices = 0;\r
 117 int jtag_ir_scan_size = 0;\r
 118 enum reset_types jtag_reset_config = RESET_NONE;\r
 119 enum tap_state cmd_queue_end_state = TAP_TLR;\r
 120 enum tap_state cmd_queue_cur_state = TAP_TLR;\r
 121 \r
 122 int jtag_verify_capture_ir = 1;\r
 123 \r
 124 /* how long the OpenOCD should wait before attempting JTAG communication after reset lines deasserted (in ms) */\r
 125 int jtag_nsrst_delay = 0; /* default to no nSRST delay */\r
 126 int jtag_ntrst_delay = 0; /* default to no nTRST delay */ \r
 127 \r
 128 /* maximum number of JTAG devices expected in the chain\r
 129  */\r
 130 #define JTAG_MAX_CHAIN_SIZE 20 \r
 131 \r
 132 /* callbacks to inform high-level handlers about JTAG state changes */\r
 133 jtag_event_callback_t *jtag_event_callbacks;\r
 134 \r
 135 /* jtag interfaces (parport, FTDI-USB, TI-USB, ...)\r
 136  */\r
 137 #if BUILD_PARPORT == 1\r
 138         extern jtag_interface_t parport_interface;\r
 139 #endif\r
 140 \r
 141 #if BUILD_FT2232_FTD2XX == 1\r
 142         extern jtag_interface_t ft2232_interface;\r
 143 #endif\r
 144 \r
 145 #if BUILD_FT2232_LIBFTDI == 1\r
 146         extern jtag_interface_t ft2232_interface;\r
 147 #endif\r
 148 \r
 149 #if BUILD_AMTJTAGACCEL == 1\r
 150         extern jtag_interface_t amt_jtagaccel_interface;\r
 151 #endif\r
 152 \r
 153 #if BUILD_EP93XX == 1\r
 154         extern jtag_interface_t ep93xx_interface;\r
 155 #endif\r
 156 \r
 157 #if BUILD_AT91RM9200 == 1\r
 158         extern jtag_interface_t at91rm9200_interface;\r
 159 #endif\r
 160 \r
 161 #if BUILD_GW16012 == 1\r
 162         extern jtag_interface_t gw16012_interface;\r
 163 #endif\r
 164 \r
 165 #if BUILD_PRESTO_LIBFTDI == 1 || BUILD_PRESTO_FTD2XX == 1\r
 166         extern jtag_interface_t presto_interface;\r
 167 #endif\r
 168 \r
 169 #if BUILD_USBPROG == 1\r
 170         extern jtag_interface_t usbprog_interface;\r
 171 #endif\r
 172 \r
 173 jtag_interface_t *jtag_interfaces[] = {\r
 174 #if BUILD_PARPORT == 1\r
 175         &parport_interface,\r
 176 #endif\r
 177 #if BUILD_FT2232_FTD2XX == 1\r
 178         &ft2232_interface,\r
 179 #endif\r
 180 #if BUILD_FT2232_LIBFTDI == 1\r
 181         &ft2232_interface,\r
 182 #endif\r
 183 #if BUILD_AMTJTAGACCEL == 1\r
 184         &amt_jtagaccel_interface,\r
 185 #endif\r
 186 #if BUILD_EP93XX == 1\r
 187         &ep93xx_interface,\r
 188 #endif\r
 189 #if BUILD_AT91RM9200 == 1\r
 190         &at91rm9200_interface,\r
 191 #endif\r
 192 #if BUILD_GW16012 == 1\r
 193         &gw16012_interface,\r
 194 #endif\r
 195 #if BUILD_PRESTO_LIBFTDI == 1 || BUILD_PRESTO_FTD2XX == 1\r
 196         &presto_interface,\r
 197 #endif\r
 198 #if BUILD_USBPROG == 1\r
 199         &usbprog_interface,\r
 200 #endif\r
 201         NULL,\r
 202 };\r
 203 \r
 204 jtag_interface_t *jtag = NULL;\r
 205 \r
 206 /* configuration */\r
 207 char* jtag_interface = NULL;\r
 208 int jtag_speed = -1;\r
 209 \r
 210 \r
 211 /* forward declarations */\r
 212 int jtag_add_statemove(enum tap_state endstate);\r
 213 int jtag_add_pathmove(int num_states, enum tap_state *path);\r
 214 int jtag_add_runtest(int num_cycles, enum tap_state endstate);\r
 215 int jtag_add_reset(int trst, int srst);\r
 216 int jtag_add_end_state(enum tap_state endstate);\r
 217 int jtag_add_sleep(u32 us);\r
 218 int jtag_execute_queue(void);\r
 219 int jtag_cancel_queue(void);\r
 220 \r
 221 /* jtag commands */\r
 222 int handle_interface_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 223 int handle_jtag_speed_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 224 int handle_jtag_device_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 225 int handle_reset_config_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 226 int handle_jtag_nsrst_delay_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 227 int handle_jtag_ntrst_delay_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 228 \r
 229 int handle_scan_chain_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 230 \r
 231 int handle_endstate_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 232 int handle_jtag_reset_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 233 int handle_runtest_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 234 int handle_statemove_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 235 int handle_irscan_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 236 int handle_drscan_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 237 \r
 238 int handle_verify_ircapture_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc);\r
 239 \r
 240 int jtag_register_event_callback(int (*callback)(enum jtag_event event, void *priv), void *priv)\r
 241 {\r
 242         jtag_event_callback_t **callbacks_p = &jtag_event_callbacks;\r
 243         \r
 244         if (callback == NULL)\r
 245         {\r
 246                 return ERROR_INVALID_ARGUMENTS;\r
 247         }\r
 248         \r
 249         if (*callbacks_p)\r
 250         {\r
 251                 while ((*callbacks_p)->next)\r
 252                         callbacks_p = &((*callbacks_p)->next);\r
 253                 callbacks_p = &((*callbacks_p)->next);\r
 254         }\r
 255         \r
 256         (*callbacks_p) = malloc(sizeof(jtag_event_callback_t));\r
 257         (*callbacks_p)->callback = callback;\r
 258         (*callbacks_p)->priv = priv;\r
 259         (*callbacks_p)->next = NULL;\r
 260         \r
 261         return ERROR_OK;\r
 262 }\r
 263 \r
 264 int jtag_unregister_event_callback(int (*callback)(enum jtag_event event, void *priv))\r
 265 {\r
 266         jtag_event_callback_t **callbacks_p = &jtag_event_callbacks;\r
 267         \r
 268         if (callback == NULL)\r
 269         {\r
 270                 return ERROR_INVALID_ARGUMENTS;\r
 271         }\r
 272                 \r
 273         while (*callbacks_p)\r
 274         {\r
 275                 jtag_event_callback_t **next = &((*callbacks_p)->next);\r
 276                 if ((*callbacks_p)->callback == callback)\r
 277                 {\r
 278                         free(*callbacks_p);\r
 279                         *callbacks_p = *next;\r
 280                 }\r
 281                 callbacks_p = next;\r
 282         }\r
 283         \r
 284         return ERROR_OK;\r
 285 }\r
 286 \r
 287 int jtag_call_event_callbacks(enum jtag_event event)\r
 288 {\r
 289         jtag_event_callback_t *callback = jtag_event_callbacks;\r
 290         \r
 291         DEBUG("jtag event: %s", jtag_event_strings[event]);\r
 292         \r
 293         while (callback)\r
 294         {\r
 295                 callback->callback(event, callback->priv);\r
 296                 callback = callback->next;\r
 297         }\r
 298         \r
 299         return ERROR_OK;\r
 300 }\r
 301 \r
 302 /* returns a pointer to the pointer of the last command in queue\r
 303  * this may be a pointer to the root pointer (jtag_command_queue)\r
 304  * or to the next member of the last but one command\r
 305  */\r
 306 jtag_command_t** jtag_get_last_command_p(void)\r
 307 {\r
 308 /*      jtag_command_t *cmd = jtag_command_queue;\r
 309         \r
 310         if (cmd)\r
 311                 while (cmd->next)\r
 312                         cmd = cmd->next;\r
 313         else\r
 314                 return &jtag_command_queue;\r
 315         \r
 316         return &cmd->next;*/\r
 317         \r
 318         return last_comand_pointer;\r
 319 }\r
 320 \r
 321 /* returns a pointer to the n-th device in the scan chain */\r
 322 jtag_device_t* jtag_get_device(int num)\r
 323 {\r
 324         jtag_device_t *device = jtag_devices;\r
 325         int i = 0;\r
 326 \r
 327         while (device)\r
 328         {\r
 329                 if (num == i)\r
 330                         return device;\r
 331                 device = device->next;\r
 332                 i++;\r
 333         }\r
 334         \r
 335         ERROR("jtag device number %d not defined", num);\r
 336         exit(-1);\r
 337 }\r
 338 \r
 339 void* cmd_queue_alloc(size_t size)\r
 340 {\r
 341         cmd_queue_page_t **p_page = &cmd_queue_pages;\r
 342         int offset;\r
 343 \r
 344         if (*p_page)\r
 345         {\r
 346                 while ((*p_page)->next)\r
 347                         p_page = &((*p_page)->next);\r
 348                 if (CMD_QUEUE_PAGE_SIZE - (*p_page)->used < size)\r
 349                         p_page = &((*p_page)->next);\r
 350         }\r
 351 \r
 352         if (!*p_page)\r
 353         {\r
 354                 *p_page = malloc(sizeof(cmd_queue_page_t));\r
 355                 (*p_page)->used = 0;\r
 356                 (*p_page)->address = malloc(CMD_QUEUE_PAGE_SIZE);\r
 357                 (*p_page)->next = NULL;\r
 358         }\r
 359 \r
 360         offset = (*p_page)->used;\r
 361         (*p_page)->used += size;\r
 362         \r
 363         u8 *t=(u8 *)((*p_page)->address);\r
 364         return t + offset;\r
 365 }\r
 366 \r
 367 void cmd_queue_free()\r
 368 {\r
 369         cmd_queue_page_t *page = cmd_queue_pages;\r
 370 \r
 371         while (page)\r
 372         {\r
 373                 cmd_queue_page_t *last = page;\r
 374                 free(page->address);\r
 375                 page = page->next;\r
 376                 free(last);\r
 377         }\r
 378 \r
 379         cmd_queue_pages = NULL;\r
 380 }\r
 381 \r
 382 int jtag_add_ir_scan(int num_fields, scan_field_t *fields, enum tap_state state)
 383 {\r
 384         jtag_command_t **last_cmd;\r
 385         jtag_device_t *device;\r
 386         int i, j;\r
 387         int scan_size = 0;\r
 388 \r
 389         if (jtag_trst == 1)\r
 390         {\r
 391                 WARNING("JTAG command queued, while TRST is low (TAP in reset)");\r
 392                 return ERROR_JTAG_TRST_ASSERTED;\r
 393         }\r
 394 \r
 395         last_cmd = jtag_get_last_command_p();\r
 396         \r
 397         /* allocate memory for a new list member */\r
 398         *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 399         (*last_cmd)->next = NULL;\r
 400         last_comand_pointer = &((*last_cmd)->next);\r
 401         (*last_cmd)->type = JTAG_SCAN;\r
 402 \r
 403         /* allocate memory for ir scan command */\r
 404         (*last_cmd)->cmd.scan = cmd_queue_alloc(sizeof(scan_command_t));\r
 405         (*last_cmd)->cmd.scan->ir_scan = 1;\r
 406         (*last_cmd)->cmd.scan->num_fields = jtag_num_devices;   /* one field per device */\r
 407         (*last_cmd)->cmd.scan->fields = cmd_queue_alloc(jtag_num_devices * sizeof(scan_field_t));\r
 408         (*last_cmd)->cmd.scan->end_state = state;\r
 409                 \r
 410         if (state != -1)\r
 411                 cmd_queue_end_state = state;\r
 412 \r
 413         if (cmd_queue_cur_state == TAP_TLR && cmd_queue_end_state != TAP_TLR)\r
 414                 jtag_call_event_callbacks(JTAG_TRST_RELEASED);\r
 415         \r
 416         if (cmd_queue_end_state == TAP_TLR)\r
 417                 jtag_call_event_callbacks(JTAG_TRST_ASSERTED);\r
 418         \r
 419         cmd_queue_cur_state = cmd_queue_end_state;\r
 420                 \r
 421         for (i = 0; i < jtag_num_devices; i++)\r
 422         {\r
 423                 int found = 0;\r
 424                 device = jtag_get_device(i);\r
 425                 scan_size = device->ir_length;\r
 426                 (*last_cmd)->cmd.scan->fields[i].device = i;\r
 427                 (*last_cmd)->cmd.scan->fields[i].num_bits = scan_size;\r
 428                 (*last_cmd)->cmd.scan->fields[i].in_value = NULL;\r
 429                 (*last_cmd)->cmd.scan->fields[i].in_handler = NULL;     /* disable verification by default */\r
 430 \r
 431                 /* search the list */\r
 432                 for (j = 0; j < num_fields; j++)\r
 433                 {\r
 434                         if (i == fields[j].device)\r
 435                         {\r
 436                                 found = 1;\r
 437                                 (*last_cmd)->cmd.scan->fields[i].out_value = buf_cpy(fields[j].out_value, cmd_queue_alloc(CEIL(scan_size, 8)), scan_size);\r
 438                                 (*last_cmd)->cmd.scan->fields[i].out_mask = buf_cpy(fields[j].out_mask, cmd_queue_alloc(CEIL(scan_size, 8)), scan_size);\r
 439                         \r
 440                                 if (jtag_verify_capture_ir)\r
 441                                 {\r
 442                                         if (fields[j].in_handler==NULL)\r
 443                                         {\r
 444                                                 jtag_set_check_value((*last_cmd)->cmd.scan->fields+i, device->expected, device->expected_mask, NULL);\r
 445                                         } else\r
 446                                         {\r
 447                                                 (*last_cmd)->cmd.scan->fields[i].in_handler = fields[j].in_handler;\r
 448                                                 (*last_cmd)->cmd.scan->fields[i].in_handler_priv = fields[j].in_handler_priv;\r
 449                                                 (*last_cmd)->cmd.scan->fields[i].in_check_value = device->expected; \r
 450                                                 (*last_cmd)->cmd.scan->fields[i].in_check_mask = device->expected_mask;\r
 451                                         }\r
 452                                 }\r
 453                                 \r
 454                                 device->bypass = 0;\r
 455                                 break;\r
 456                         }\r
 457                 }\r
 458         \r
 459                 if (!found)\r
 460                 {\r
 461                         /* if a device isn't listed, set it to BYPASS */\r
 462                         (*last_cmd)->cmd.scan->fields[i].out_value = buf_set_ones(cmd_queue_alloc(CEIL(scan_size, 8)), scan_size);\r
 463                         (*last_cmd)->cmd.scan->fields[i].out_mask = NULL;\r
 464                         device->bypass = 1;\r
 465                 \r
 466                 }\r
 467                 \r
 468                 /* update device information */\r
 469                 buf_cpy((*last_cmd)->cmd.scan->fields[i].out_value, jtag_get_device(i)->cur_instr, scan_size);\r
 470         }\r
 471         \r
 472         return ERROR_OK;\r
 473 }\r
 474 \r
 475 int jtag_add_plain_ir_scan(int num_fields, scan_field_t *fields, enum tap_state state)
 476 {\r
 477         jtag_command_t **last_cmd;\r
 478         int i;\r
 479 \r
 480         if (jtag_trst == 1)\r
 481         {\r
 482                 WARNING("JTAG command queued, while TRST is low (TAP in reset)");\r
 483                 return ERROR_JTAG_TRST_ASSERTED;\r
 484         }\r
 485 \r
 486         last_cmd = jtag_get_last_command_p();\r
 487         \r
 488         /* allocate memory for a new list member */\r
 489         *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 490         (*last_cmd)->next = NULL;\r
 491         last_comand_pointer = &((*last_cmd)->next);\r
 492         (*last_cmd)->type = JTAG_SCAN;\r
 493 \r
 494         /* allocate memory for ir scan command */\r
 495         (*last_cmd)->cmd.scan = cmd_queue_alloc(sizeof(scan_command_t));\r
 496         (*last_cmd)->cmd.scan->ir_scan = 1;\r
 497         (*last_cmd)->cmd.scan->num_fields = num_fields;\r
 498         (*last_cmd)->cmd.scan->fields = cmd_queue_alloc(num_fields * sizeof(scan_field_t));\r
 499         (*last_cmd)->cmd.scan->end_state = state;\r
 500 \r
 501         if (state != -1)\r
 502                 cmd_queue_end_state = state;\r
 503 \r
 504         if (cmd_queue_cur_state == TAP_TLR && cmd_queue_end_state != TAP_TLR)\r
 505                 jtag_call_event_callbacks(JTAG_TRST_RELEASED);\r
 506         \r
 507         if (cmd_queue_end_state == TAP_TLR)\r
 508                 jtag_call_event_callbacks(JTAG_TRST_ASSERTED);\r
 509                 \r
 510         cmd_queue_cur_state = cmd_queue_end_state;\r
 511         \r
 512         for (i = 0; i < num_fields; i++)\r
 513         {\r
 514                 int num_bits = fields[i].num_bits;\r
 515                 int num_bytes = CEIL(fields[i].num_bits, 8);\r
 516                 (*last_cmd)->cmd.scan->fields[i].device = fields[i].device;\r
 517                 (*last_cmd)->cmd.scan->fields[i].num_bits = num_bits;\r
 518                 (*last_cmd)->cmd.scan->fields[i].out_value = buf_cpy(fields[i].out_value, cmd_queue_alloc(num_bytes), num_bits);\r
 519                 (*last_cmd)->cmd.scan->fields[i].out_mask = buf_cpy(fields[i].out_mask, cmd_queue_alloc(num_bytes), num_bits);\r
 520                 (*last_cmd)->cmd.scan->fields[i].in_value = fields[i].in_value;\r
 521                 (*last_cmd)->cmd.scan->fields[i].in_check_value = fields[i].in_check_value;\r
 522                 (*last_cmd)->cmd.scan->fields[i].in_check_mask = fields[i].in_check_mask;\r
 523                 (*last_cmd)->cmd.scan->fields[i].in_handler = NULL;\r
 524                 (*last_cmd)->cmd.scan->fields[i].in_handler_priv = NULL;\r
 525         }\r
 526         return ERROR_OK;\r
 527 }\r
 528 \r
 529 int jtag_add_dr_scan(int num_fields, scan_field_t *fields, enum tap_state state)
 530 {\r
 531         int i, j;\r
 532         int bypass_devices = 0;\r
 533         int field_count = 0;\r
 534         jtag_command_t **last_cmd = jtag_get_last_command_p();\r
 535         jtag_device_t *device = jtag_devices;\r
 536         int scan_size;\r
 537 \r
 538         if (jtag_trst == 1)\r
 539         {\r
 540                 WARNING("JTAG command queued, while TRST is low (TAP in reset)");\r
 541                 return ERROR_JTAG_TRST_ASSERTED;\r
 542         }\r
 543 \r
 544         /* count devices in bypass */\r
 545         while (device)\r
 546         {\r
 547                 if (device->bypass)\r
 548                         bypass_devices++;\r
 549                 device = device->next;\r
 550         }\r
 551         \r
 552         /* allocate memory for a new list member */\r
 553         *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 554         last_comand_pointer = &((*last_cmd)->next);\r
 555         (*last_cmd)->next = NULL;\r
 556         (*last_cmd)->type = JTAG_SCAN;\r
 557 \r
 558         /* allocate memory for dr scan command */\r
 559         (*last_cmd)->cmd.scan = cmd_queue_alloc(sizeof(scan_command_t));\r
 560         (*last_cmd)->cmd.scan->ir_scan = 0;\r
 561         (*last_cmd)->cmd.scan->num_fields = num_fields + bypass_devices;\r
 562         (*last_cmd)->cmd.scan->fields = cmd_queue_alloc((num_fields + bypass_devices) * sizeof(scan_field_t));\r
 563         (*last_cmd)->cmd.scan->end_state = state;\r
 564         \r
 565         if (state != -1)\r
 566                 cmd_queue_end_state = state;\r
 567 \r
 568         if (cmd_queue_cur_state == TAP_TLR && cmd_queue_end_state != TAP_TLR)\r
 569                 jtag_call_event_callbacks(JTAG_TRST_RELEASED);\r
 570         \r
 571         if (cmd_queue_end_state == TAP_TLR)\r
 572                 jtag_call_event_callbacks(JTAG_TRST_ASSERTED);\r
 573                         \r
 574         cmd_queue_cur_state = cmd_queue_end_state;\r
 575         \r
 576         for (i = 0; i < jtag_num_devices; i++)\r
 577         {\r
 578                 int found = 0;\r
 579                 (*last_cmd)->cmd.scan->fields[field_count].device = i;\r
 580         \r
 581                 for (j = 0; j < num_fields; j++)\r
 582                 {\r
 583                         if (i == fields[j].device)\r
 584                         {\r
 585                                 found = 1;\r
 586                                 scan_size = fields[j].num_bits;\r
 587                                 (*last_cmd)->cmd.scan->fields[field_count].num_bits = scan_size;\r
 588                                 (*last_cmd)->cmd.scan->fields[field_count].out_value = buf_cpy(fields[j].out_value, cmd_queue_alloc(CEIL(scan_size, 8)), scan_size);\r
 589                                 (*last_cmd)->cmd.scan->fields[field_count].out_mask = buf_cpy(fields[j].out_mask, cmd_queue_alloc(CEIL(scan_size, 8)), scan_size);\r
 590                                 (*last_cmd)->cmd.scan->fields[field_count].in_value = fields[j].in_value;\r
 591                                 (*last_cmd)->cmd.scan->fields[field_count].in_check_value = fields[j].in_check_value;\r
 592                                 (*last_cmd)->cmd.scan->fields[field_count].in_check_mask = fields[j].in_check_mask;\r
 593                                 (*last_cmd)->cmd.scan->fields[field_count].in_handler = fields[j].in_handler;\r
 594                                 (*last_cmd)->cmd.scan->fields[field_count++].in_handler_priv = fields[j].in_handler_priv;\r
 595                         }\r
 596                 }\r
 597                 if (!found)\r
 598                 {\r
 599                         /* if a device isn't listed, the BYPASS register should be selected */\r
 600                         if (!jtag_get_device(i)->bypass)\r
 601                         {\r
 602                                 ERROR("BUG: no scan data for a device not in BYPASS");\r
 603                                 exit(-1);\r
 604                         }\r
 605         \r
 606                         /* program the scan field to 1 bit length, and ignore it's value */\r
 607                         (*last_cmd)->cmd.scan->fields[field_count].num_bits = 1;\r
 608                         (*last_cmd)->cmd.scan->fields[field_count].out_value = NULL;\r
 609                         (*last_cmd)->cmd.scan->fields[field_count].out_mask = NULL;\r
 610                         (*last_cmd)->cmd.scan->fields[field_count].in_value = NULL;\r
 611                         (*last_cmd)->cmd.scan->fields[field_count].in_check_value = NULL;\r
 612                         (*last_cmd)->cmd.scan->fields[field_count].in_check_mask = NULL;\r
 613                         (*last_cmd)->cmd.scan->fields[field_count].in_handler = NULL;\r
 614                         (*last_cmd)->cmd.scan->fields[field_count++].in_handler_priv = NULL;\r
 615                 }\r
 616                 else\r
 617                 {\r
 618                         /* if a device is listed, the BYPASS register must not be selected */\r
 619                         if (jtag_get_device(i)->bypass)\r
 620                         {\r
 621                                 WARNING("scan data for a device in BYPASS");\r
 622                         }\r
 623                 }\r
 624         }\r
 625         return ERROR_OK;\r
 626 }\r
 627 \r
 628 \r
 629 int jtag_add_plain_dr_scan(int num_fields, scan_field_t *fields, enum tap_state state)
 630 {\r
 631         int i;\r
 632         jtag_command_t **last_cmd = jtag_get_last_command_p();\r
 633         \r
 634         if (jtag_trst == 1)\r
 635         {\r
 636                 WARNING("JTAG command queued, while TRST is low (TAP in reset)");\r
 637                 return ERROR_JTAG_TRST_ASSERTED;\r
 638         }\r
 639 \r
 640         /* allocate memory for a new list member */\r
 641         *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 642         last_comand_pointer = &((*last_cmd)->next);\r
 643         (*last_cmd)->next = NULL;\r
 644         (*last_cmd)->type = JTAG_SCAN;\r
 645 \r
 646         /* allocate memory for scan command */\r
 647         (*last_cmd)->cmd.scan = cmd_queue_alloc(sizeof(scan_command_t));\r
 648         (*last_cmd)->cmd.scan->ir_scan = 0;\r
 649         (*last_cmd)->cmd.scan->num_fields = num_fields;\r
 650         (*last_cmd)->cmd.scan->fields = cmd_queue_alloc(num_fields * sizeof(scan_field_t));\r
 651         (*last_cmd)->cmd.scan->end_state = state;\r
 652                 \r
 653         if (state != -1)\r
 654                 cmd_queue_end_state = state;\r
 655 \r
 656         if (cmd_queue_cur_state == TAP_TLR && cmd_queue_end_state != TAP_TLR)\r
 657                 jtag_call_event_callbacks(JTAG_TRST_RELEASED);\r
 658         \r
 659         if (cmd_queue_end_state == TAP_TLR)\r
 660                 jtag_call_event_callbacks(JTAG_TRST_ASSERTED);\r
 661                         \r
 662         cmd_queue_cur_state = cmd_queue_end_state;\r
 663         \r
 664         for (i = 0; i < num_fields; i++)\r
 665         {\r
 666                 int num_bits = fields[i].num_bits;\r
 667                 int num_bytes = CEIL(fields[i].num_bits, 8);\r
 668                 (*last_cmd)->cmd.scan->fields[i].device = fields[i].device;\r
 669                 (*last_cmd)->cmd.scan->fields[i].num_bits = num_bits;\r
 670                 (*last_cmd)->cmd.scan->fields[i].out_value = buf_cpy(fields[i].out_value, cmd_queue_alloc(num_bytes), num_bits);\r
 671                 (*last_cmd)->cmd.scan->fields[i].out_mask = buf_cpy(fields[i].out_mask, cmd_queue_alloc(num_bytes), num_bits);\r
 672                 (*last_cmd)->cmd.scan->fields[i].in_value = fields[i].in_value;\r
 673                 (*last_cmd)->cmd.scan->fields[i].in_check_value = fields[i].in_check_value;\r
 674                 (*last_cmd)->cmd.scan->fields[i].in_check_mask = fields[i].in_check_mask;\r
 675                 (*last_cmd)->cmd.scan->fields[i].in_handler = fields[i].in_handler;\r
 676                 (*last_cmd)->cmd.scan->fields[i].in_handler_priv = fields[i].in_handler_priv;\r
 677         }\r
 678 \r
 679         return ERROR_OK;\r
 680 }\r
 681 int jtag_add_statemove(enum tap_state state)\r
 682 {\r
 683         jtag_command_t **last_cmd = jtag_get_last_command_p();\r
 684         \r
 685         if (jtag_trst == 1)\r
 686         {\r
 687                 WARNING("JTAG command queued, while TRST is low (TAP in reset)");\r
 688                 return ERROR_JTAG_TRST_ASSERTED;\r
 689         }\r
 690 \r
 691         /* allocate memory for a new list member */\r
 692         *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 693         last_comand_pointer = &((*last_cmd)->next);\r
 694         (*last_cmd)->next = NULL;\r
 695         (*last_cmd)->type = JTAG_STATEMOVE;\r
 696 \r
 697         (*last_cmd)->cmd.statemove = cmd_queue_alloc(sizeof(statemove_command_t));\r
 698         (*last_cmd)->cmd.statemove->end_state = state;\r
 699         \r
 700         if (state != -1)\r
 701                 cmd_queue_end_state = state;\r
 702 \r
 703         if (cmd_queue_cur_state == TAP_TLR && cmd_queue_end_state != TAP_TLR)\r
 704                 jtag_call_event_callbacks(JTAG_TRST_RELEASED);\r
 705         \r
 706         if (cmd_queue_end_state == TAP_TLR)\r
 707                 jtag_call_event_callbacks(JTAG_TRST_ASSERTED);\r
 708                         \r
 709         cmd_queue_cur_state = cmd_queue_end_state;\r
 710         \r
 711         return ERROR_OK;\r
 712 }\r
 713 \r
 714 int jtag_add_pathmove(int num_states, enum tap_state *path)\r
 715 {\r
 716         jtag_command_t **last_cmd = jtag_get_last_command_p();\r
 717         int i;\r
 718         \r
 719         if (jtag_trst == 1)\r
 720         {\r
 721                 WARNING("JTAG command queued, while TRST is low (TAP in reset)");\r
 722                 return ERROR_JTAG_TRST_ASSERTED;\r
 723         }\r
 724         \r
 725         /* the last state has to be a stable state */\r
 726         if (tap_move_map[path[num_states - 1]] == -1)\r
 727         {\r
 728                 ERROR("TAP path doesn't finish in a stable state");\r
 729                 return ERROR_JTAG_NOT_IMPLEMENTED;\r
 730         }\r
 731         \r
 732         /* allocate memory for a new list member */\r
 733         *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 734         last_comand_pointer = &((*last_cmd)->next);\r
 735         (*last_cmd)->next = NULL;\r
 736         (*last_cmd)->type = JTAG_PATHMOVE;\r
 737 \r
 738         (*last_cmd)->cmd.pathmove = cmd_queue_alloc(sizeof(pathmove_command_t));\r
 739         (*last_cmd)->cmd.pathmove->num_states = num_states;\r
 740         (*last_cmd)->cmd.pathmove->path = cmd_queue_alloc(sizeof(enum tap_state) * num_states);\r
 741         \r
 742         for (i = 0; i < num_states; i++)\r
 743                 (*last_cmd)->cmd.pathmove->path[i] = path[i];\r
 744 \r
 745         if (cmd_queue_cur_state == TAP_TLR && cmd_queue_end_state != TAP_TLR)\r
 746                 jtag_call_event_callbacks(JTAG_TRST_RELEASED);\r
 747         \r
 748         if (cmd_queue_end_state == TAP_TLR)\r
 749                 jtag_call_event_callbacks(JTAG_TRST_ASSERTED);\r
 750         \r
 751         cmd_queue_cur_state = path[num_states - 1];\r
 752         \r
 753         return ERROR_OK;\r
 754 }\r
 755 \r
 756 int jtag_add_runtest(int num_cycles, enum tap_state state)\r
 757 {\r
 758         jtag_command_t **last_cmd = jtag_get_last_command_p();\r
 759         \r
 760         if (jtag_trst == 1)\r
 761         {\r
 762                 WARNING("JTAG command queued, while TRST is low (TAP in reset)");\r
 763                 return ERROR_JTAG_TRST_ASSERTED;\r
 764         }\r
 765 \r
 766         /* allocate memory for a new list member */\r
 767         *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 768         (*last_cmd)->next = NULL;\r
 769         last_comand_pointer = &((*last_cmd)->next);\r
 770         (*last_cmd)->type = JTAG_RUNTEST;\r
 771 \r
 772         (*last_cmd)->cmd.runtest = cmd_queue_alloc(sizeof(runtest_command_t));\r
 773         (*last_cmd)->cmd.runtest->num_cycles = num_cycles;\r
 774         (*last_cmd)->cmd.runtest->end_state = state;\r
 775         \r
 776         if (state != -1)\r
 777                 cmd_queue_end_state = state;\r
 778 \r
 779         if (cmd_queue_cur_state == TAP_TLR && cmd_queue_end_state != TAP_TLR)\r
 780                 jtag_call_event_callbacks(JTAG_TRST_RELEASED);\r
 781         \r
 782         if (cmd_queue_end_state == TAP_TLR)\r
 783                 jtag_call_event_callbacks(JTAG_TRST_ASSERTED);\r
 784                         \r
 785         cmd_queue_cur_state = cmd_queue_end_state;\r
 786         \r
 787         return ERROR_OK;\r
 788 }\r
 789 \r
 790 int jtag_add_reset(int req_trst, int req_srst)\r
 791 {\r
 792         int trst_with_tms = 0;\r
 793         \r
 794         jtag_command_t **last_cmd = jtag_get_last_command_p();\r
 795         \r
 796         if (req_trst == -1)\r
 797                 req_trst = jtag_trst;\r
 798         \r
 799         if (req_srst == -1)\r
 800                 req_srst = jtag_srst;\r
 801 \r
 802         /* Make sure that jtag_reset_config allows the requested reset */\r
 803         /* if SRST pulls TRST, we can't fulfill srst == 1 with trst == 0 */\r
 804         if (((jtag_reset_config & RESET_SRST_PULLS_TRST) && (req_srst == 1)) && (req_trst == 0))\r
 805                 return ERROR_JTAG_RESET_WOULD_ASSERT_TRST;\r
 806                 \r
 807         /* if TRST pulls SRST, we reset with TAP T-L-R */\r
 808         if (((jtag_reset_config & RESET_TRST_PULLS_SRST) && (req_trst == 1)) && (req_srst == 0))\r
 809         {\r
 810                 req_trst = 0;\r
 811                 trst_with_tms = 1;\r
 812         }\r
 813         \r
 814         if (req_srst && !(jtag_reset_config & RESET_HAS_SRST))\r
 815         {\r
 816                 ERROR("requested nSRST assertion, but the current configuration doesn't support this");\r
 817                 return ERROR_JTAG_RESET_CANT_SRST;\r
 818         }\r
 819         \r
 820         if (req_trst && !(jtag_reset_config & RESET_HAS_TRST))\r
 821         {\r
 822                 req_trst = 0;\r
 823                 trst_with_tms = 1;\r
 824         }\r
 825         \r
 826         /* allocate memory for a new list member */\r
 827         *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 828         (*last_cmd)->next = NULL;\r
 829         last_comand_pointer = &((*last_cmd)->next);\r
 830         (*last_cmd)->type = JTAG_RESET;\r
 831 \r
 832         (*last_cmd)->cmd.reset = cmd_queue_alloc(sizeof(reset_command_t));\r
 833         (*last_cmd)->cmd.reset->trst = req_trst;\r
 834         (*last_cmd)->cmd.reset->srst = req_srst;\r
 835 \r
 836         jtag_trst = req_trst;\r
 837         jtag_srst = req_srst;\r
 838 \r
 839         if (jtag_srst)\r
 840         {\r
 841                 jtag_call_event_callbacks(JTAG_SRST_ASSERTED);\r
 842         }\r
 843         else\r
 844         {\r
 845                 jtag_call_event_callbacks(JTAG_SRST_RELEASED);\r
 846                 if (jtag_nsrst_delay)\r
 847                         jtag_add_sleep(jtag_nsrst_delay * 1000);\r
 848         }\r
 849         \r
 850         if (trst_with_tms)\r
 851         {\r
 852                 last_cmd = &((*last_cmd)->next);\r
 853                 \r
 854                 /* allocate memory for a new list member */\r
 855                 *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 856                 (*last_cmd)->next = NULL;\r
 857                 last_comand_pointer = &((*last_cmd)->next);\r
 858                 (*last_cmd)->type = JTAG_STATEMOVE;\r
 859 \r
 860                 (*last_cmd)->cmd.statemove = cmd_queue_alloc(sizeof(statemove_command_t));\r
 861                 (*last_cmd)->cmd.statemove->end_state = TAP_TLR;\r
 862                 \r
 863                 jtag_call_event_callbacks(JTAG_TRST_ASSERTED);\r
 864                 cmd_queue_cur_state = TAP_TLR;\r
 865                 cmd_queue_end_state = TAP_TLR;\r
 866                 \r
 867                 return ERROR_OK;\r
 868         }\r
 869         else\r
 870         {\r
 871                 if (jtag_trst)\r
 872                 {\r
 873                         /* we just asserted nTRST, so we're now in Test-Logic-Reset,\r
 874                          * and inform possible listeners about this\r
 875                          */\r
 876                         cmd_queue_cur_state = TAP_TLR;\r
 877                         jtag_call_event_callbacks(JTAG_TRST_ASSERTED);\r
 878                 }\r
 879                 else\r
 880                 {\r
 881                         /* the nTRST line got deasserted, so we're still in Test-Logic-Reset,\r
 882                          * but we might want to add a delay to give the TAP time to settle\r
 883                          */\r
 884                         if (jtag_ntrst_delay)\r
 885                                 jtag_add_sleep(jtag_ntrst_delay * 1000);\r
 886                 }\r
 887         }\r
 888 \r
 889         return ERROR_OK;\r
 890 }\r
 891 \r
 892 int jtag_add_end_state(enum tap_state state)\r
 893 {\r
 894         jtag_command_t **last_cmd = jtag_get_last_command_p();\r
 895         \r
 896         /* allocate memory for a new list member */\r
 897         *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 898         (*last_cmd)->next = NULL;\r
 899         last_comand_pointer = &((*last_cmd)->next);\r
 900         (*last_cmd)->type = JTAG_END_STATE;\r
 901 \r
 902         (*last_cmd)->cmd.end_state = cmd_queue_alloc(sizeof(end_state_command_t));\r
 903         (*last_cmd)->cmd.end_state->end_state = state;\r
 904 \r
 905         if (state != -1)\r
 906                 cmd_queue_end_state = state;\r
 907         \r
 908         return ERROR_OK;\r
 909 }\r
 910 \r
 911 int jtag_add_sleep(u32 us)\r
 912 {\r
 913         jtag_command_t **last_cmd = jtag_get_last_command_p();\r
 914         \r
 915         /* allocate memory for a new list member */\r
 916         *last_cmd = cmd_queue_alloc(sizeof(jtag_command_t));\r
 917         (*last_cmd)->next = NULL;\r
 918         last_comand_pointer = &((*last_cmd)->next);\r
 919         (*last_cmd)->type = JTAG_SLEEP;\r
 920 \r
 921         (*last_cmd)->cmd.sleep = cmd_queue_alloc(sizeof(sleep_command_t));\r
 922         (*last_cmd)->cmd.sleep->us = us;\r
 923         \r
 924         return ERROR_OK;\r
 925 }\r
 926 \r
 927 int jtag_scan_size(scan_command_t *cmd)\r
 928 {\r
 929         int bit_count = 0;\r
 930         int i;\r
 931 \r
 932         /* count bits in scan command */\r
 933         for (i = 0; i < cmd->num_fields; i++)\r
 934         {\r
 935                 bit_count += cmd->fields[i].num_bits;\r
 936         }\r
 937 \r
 938         return bit_count;\r
 939 }\r
 940 \r
 941 int jtag_build_buffer(scan_command_t *cmd, u8 **buffer)\r
 942 {\r
 943         int bit_count = 0;\r
 944         int i;\r
 945         \r
 946         bit_count = jtag_scan_size(cmd);\r
 947         *buffer = malloc(CEIL(bit_count, 8));\r
 948         \r
 949         bit_count = 0;\r
 950 \r
 951         for (i = 0; i < cmd->num_fields; i++)\r
 952         {\r
 953                 if (cmd->fields[i].out_value)\r
 954                 {\r
 955 #ifdef _DEBUG_JTAG_IO_\r
 956                         char* char_buf = buf_to_str(cmd->fields[i].out_value, (cmd->fields[i].num_bits > 64) ? 64 : cmd->fields[i].num_bits, 16);\r
 957 #endif\r
 958                         buf_set_buf(cmd->fields[i].out_value, 0, *buffer, bit_count, cmd->fields[i].num_bits);\r
 959 #ifdef _DEBUG_JTAG_IO_\r
 960                         DEBUG("fields[%i].out_value: 0x%s", i, char_buf);\r
 961                         free(char_buf);\r
 962 #endif\r
 963                 }\r
 964                 \r
 965                 bit_count += cmd->fields[i].num_bits;\r
 966         }\r
 967 \r
 968         return bit_count;\r
 969 \r
 970 }\r
 971 \r
 972 int jtag_read_buffer(u8 *buffer, scan_command_t *cmd)\r
 973 {\r
 974         int i;\r
 975         int bit_count = 0;\r
 976         int retval;\r
 977         \r
 978         /* we return ERROR_OK, unless a check fails, or a handler reports a problem */\r
 979         retval = ERROR_OK;\r
 980         \r
 981         for (i = 0; i < cmd->num_fields; i++)\r
 982         {\r
 983                 /* if neither in_value nor in_handler\r
 984                  * are specified we don't have to examine this field\r
 985                  */\r
 986                 if (cmd->fields[i].in_value || cmd->fields[i].in_handler)\r
 987                 {\r
 988                         int num_bits = cmd->fields[i].num_bits;\r
 989                         u8 *captured = buf_set_buf(buffer, bit_count, malloc(CEIL(num_bits, 8)), 0, num_bits);\r
 990                         \r
 991 #ifdef _DEBUG_JTAG_IO_\r
 992                         char *char_buf;\r
 993 \r
 994                         char_buf = buf_to_str(captured, (num_bits > 64) ? 64 : num_bits, 16);\r
 995                         DEBUG("fields[%i].in_value: 0x%s", i, char_buf);\r
 996                         free(char_buf);\r
 997 #endif\r
 998                         \r
 999                         if (cmd->fields[i].in_value)\r
1000                         {\r
1001                                 buf_cpy(captured, cmd->fields[i].in_value, num_bits);\r
1002                                 \r
1003                                 if (cmd->fields[i].in_handler)\r
1004                                 {\r
1005                                         if (cmd->fields[i].in_handler(cmd->fields[i].in_value, cmd->fields[i].in_handler_priv, cmd->fields+i) != ERROR_OK)\r
1006                                         {\r
1007                                                 WARNING("in_handler reported a failed check");\r
1008                                                 retval = ERROR_JTAG_QUEUE_FAILED;\r
1009                                         }\r
1010                                 }\r
1011                         }\r
1012                         \r
1013                         /* no in_value specified, but a handler takes care of the scanned data */\r
1014                         if (cmd->fields[i].in_handler && (!cmd->fields[i].in_value))\r
1015                         {\r
1016                                 if (cmd->fields[i].in_handler(captured, cmd->fields[i].in_handler_priv, cmd->fields+i) != ERROR_OK)\r
1017                                 {\r
1018                                         /* We're going to call the error:handler later, but if the in_handler\r
1019                                          * reported an error we report this failure upstream\r
1020                                          */\r
1021                                         WARNING("in_handler reported a failed check");\r
1022                                         retval = ERROR_JTAG_QUEUE_FAILED;\r
1023                                 }\r
1024                         }\r
1025 \r
1026                         free(captured);\r
1027                 }\r
1028                 bit_count += cmd->fields[i].num_bits;\r
1029         }\r
1030 \r
1031         return retval;\r
1032 }\r
1033 \r
1034 int jtag_check_value(u8 *captured, void *priv, scan_field_t *field)\r
1035 {\r
1036         int retval = ERROR_OK;\r
1037         int num_bits = field->num_bits;\r
1038         \r
1039         int compare_failed = 0;\r
1040         \r
1041         if (field->in_check_mask)\r
1042                 compare_failed = buf_cmp_mask(captured, field->in_check_value, field->in_check_mask, num_bits);\r
1043         else\r
1044                 compare_failed = buf_cmp(captured, field->in_check_value, num_bits);\r
1045         \r
1046         if (compare_failed)\r
1047                 {\r
1048                 /* An error handler could have caught the failing check\r
1049                  * only report a problem when there wasn't a handler, or if the handler\r
1050                  * acknowledged the error\r
1051                  */ \r
1052                 if (compare_failed)\r
1053                 {\r
1054                         char *captured_char = buf_to_str(captured, (num_bits > 64) ? 64 : num_bits, 16);\r
1055                         char *in_check_value_char = buf_to_str(field->in_check_value, (num_bits > 64) ? 64 : num_bits, 16);\r
1056 \r
1057                         if (field->in_check_mask)\r
1058                         {\r
1059                                 char *in_check_mask_char;\r
1060                                 in_check_mask_char = buf_to_str(field->in_check_mask, (num_bits > 64) ? 64 : num_bits, 16);\r
1061                                 WARNING("value captured during scan didn't pass the requested check: captured: 0x%s check_value: 0x%s check_mask: 0x%s", captured_char, in_check_value_char, in_check_mask_char);\r
1062                                 free(in_check_mask_char);\r
1063                         }\r
1064                         else\r
1065                         {\r
1066                                 WARNING("value captured during scan didn't pass the requested check: captured: 0x%s check_value: 0x%s", captured_char, in_check_value_char);\r
1067                         }\r
1068 \r
1069                         free(captured_char);\r
1070                         free(in_check_value_char);\r
1071                         \r
1072                         retval = ERROR_JTAG_QUEUE_FAILED;\r
1073                 }\r
1074                 \r
1075         }\r
1076         return retval;\r
1077 }\r
1078 \r
1079 /* \r
1080   set up checking of this field using the in_handler. The values passed in must be valid until\r
1081   after jtag_execute() has completed.\r
1082  */\r
1083 void jtag_set_check_value(scan_field_t *field, u8 *value, u8 *mask, error_handler_t *in_error_handler)\r
1084 {\r
1085         if (value)\r
1086                 field->in_handler = jtag_check_value;\r
1087         else\r
1088                 field->in_handler = NULL;       /* No check, e.g. embeddedice uses value==NULL to indicate no check */\r
1089         field->in_handler_priv = NULL;  /* this will be filled in at the invocation site to point to the field duplicate */ \r
1090         field->in_check_value = value;\r
1091         field->in_check_mask = mask;\r
1092 }\r
1093 \r
1094 enum scan_type jtag_scan_type(scan_command_t *cmd)\r
1095 {\r
1096         int i;\r
1097         int type = 0;\r
1098         \r
1099         for (i = 0; i < cmd->num_fields; i++)\r
1100         {\r
1101                 if (cmd->fields[i].in_value || cmd->fields[i].in_handler)\r
1102                         type |= SCAN_IN;\r
1103                 if (cmd->fields[i].out_value)\r
1104                         type |= SCAN_OUT;\r
1105         }\r
1106 \r
1107         return type;\r
1108 }\r
1109 \r
1110 int jtag_execute_queue(void)\r
1111 {\r
1112         int retval;\r
1113 \r
1114         retval = jtag->execute_queue();\r
1115         \r
1116         cmd_queue_free();\r
1117 \r
1118         jtag_command_queue = NULL;\r
1119         last_comand_pointer = &jtag_command_queue;\r
1120 \r
1121         return retval;\r
1122 }\r
1123 \r
1124 int jtag_reset_callback(enum jtag_event event, void *priv)\r
1125 {\r
1126         jtag_device_t *device = priv;\r
1127 \r
1128         DEBUG("-");\r
1129         \r
1130         if (event == JTAG_TRST_ASSERTED)\r
1131         {\r
1132                 buf_set_ones(device->cur_instr, device->ir_length);\r
1133                 device->bypass = 1;\r
1134         }\r
1135         \r
1136         return ERROR_OK;\r
1137 }\r
1138 \r
1139 void jtag_sleep(u32 us)\r
1140 {\r
1141         usleep(us);\r
1142 }\r
1143 \r
1144 /* Try to examine chain layout according to IEEE 1149.1 §12\r
1145  */\r
1146 int jtag_examine_chain()\r
1147 {\r
1148         jtag_device_t *device = jtag_devices;\r
1149         scan_field_t field;\r
1150         u8 idcode_buffer[JTAG_MAX_CHAIN_SIZE * 4];\r
1151         int i;\r
1152         int bit_count;\r
1153         int device_count = 0;\r
1154         u8 zero_check = 0x0;\r
1155         u8 one_check = 0xff;\r
1156         \r
1157         field.device = 0;\r
1158         field.num_bits = sizeof(idcode_buffer) * 8;\r
1159         field.out_value = idcode_buffer;\r
1160         field.out_mask = NULL;\r
1161         field.in_value = idcode_buffer;\r
1162         field.in_check_value = NULL;\r
1163         field.in_check_mask = NULL;\r
1164         field.in_handler = NULL;\r
1165         field.in_handler_priv = NULL;\r
1166         \r
1167         for (i = 0; i < JTAG_MAX_CHAIN_SIZE; i++)\r
1168         {\r
1169                 buf_set_u32(idcode_buffer, i * 32, 32, 0x000000FF);\r
1170         }\r
1171         \r
1172         jtag_add_plain_dr_scan(1, &field, TAP_TLR);\r
1173         jtag_execute_queue();\r
1174         \r
1175         for (i = 0; i < JTAG_MAX_CHAIN_SIZE * 4; i++)\r
1176         {\r
1177                 zero_check |= idcode_buffer[i];\r
1178                 one_check &= idcode_buffer[i];\r
1179         }\r
1180         \r
1181         /* if there wasn't a single non-zero bit or if all bits were one, the scan isn't valid */\r
1182         if ((zero_check == 0x00) || (one_check == 0xff))\r
1183         {\r
1184                 ERROR("JTAG communication failure, check connection, JTAG interface, target power etc.");\r
1185                 return ERROR_JTAG_INIT_FAILED;\r
1186         }\r
1187         \r
1188         for (bit_count = 0; bit_count < (JTAG_MAX_CHAIN_SIZE * 32) - 31;)\r
1189         {\r
1190                 u32 idcode = buf_get_u32(idcode_buffer, bit_count, 32);\r
1191                 if ((idcode & 1) == 0)\r
1192                 {\r
1193                         /* LSB must not be 0, this indicates a device in bypass */\r
1194                         device_count++;\r
1195                         \r
1196                         bit_count += 1;\r
1197                 }\r
1198                 else\r
1199                 {\r
1200                         u32 manufacturer;\r
1201                         u32 part;\r
1202                         u32 version;\r
1203                         \r
1204                         if (idcode == 0x000000FF)\r
1205                         {\r
1206                                 /* End of chain (invalid manufacturer ID) */\r
1207                                 break;\r
1208                         }\r
1209                         \r
1210                         if (device)\r
1211                         {\r
1212                                 device->idcode = idcode;\r
1213                                 device = device->next;\r
1214                         }\r
1215                         device_count++;\r
1216                         \r
1217                         manufacturer = (idcode & 0xffe) >> 1;\r
1218                         part = (idcode & 0xffff000) >> 12;\r
1219                         version = (idcode & 0xf0000000) >> 28;\r
1220 \r
1221                         INFO("JTAG device found: 0x%8.8x (Manufacturer: 0x%3.3x, Part: 0x%4.4x, Version: 0x%1.1x)", \r
1222                                 idcode, manufacturer, part, version);\r
1223                         \r
1224                         bit_count += 32;\r
1225                 }\r
1226         }\r
1227         \r
1228         /* see if number of discovered devices matches configuration */\r
1229         if (device_count != jtag_num_devices)\r
1230         {\r
1231                 ERROR("number of discovered devices in JTAG chain (%i) doesn't match configuration (%i)", \r
1232                         device_count, jtag_num_devices);\r
1233                 ERROR("check the config file and ensure proper JTAG communication (connections, speed, ...)");\r
1234                 return ERROR_JTAG_INIT_FAILED;\r
1235         }\r
1236         \r
1237         return ERROR_OK;\r
1238 }\r
1239 \r
1240 int jtag_validate_chain()\r
1241 {\r
1242         jtag_device_t *device = jtag_devices;\r
1243         int total_ir_length = 0;\r
1244         u8 *ir_test = NULL;\r
1245         scan_field_t field;\r
1246         int chain_pos = 0;\r
1247         \r
1248         while (device)\r
1249         {\r
1250                 total_ir_length += device->ir_length;\r
1251                 device = device->next;\r
1252         }\r
1253         \r
1254         total_ir_length += 2;\r
1255         ir_test = malloc(CEIL(total_ir_length, 8));\r
1256         buf_set_ones(ir_test, total_ir_length);\r
1257         \r
1258         field.device = 0;\r
1259         field.num_bits = total_ir_length;\r
1260         field.out_value = ir_test;\r
1261         field.out_mask = NULL;\r
1262         field.in_value = ir_test;\r
1263         field.in_check_value = NULL;\r
1264         field.in_check_mask = NULL;\r
1265         field.in_handler = NULL;\r
1266         field.in_handler_priv = NULL;\r
1267         \r
1268         jtag_add_plain_ir_scan(1, &field, TAP_TLR);\r
1269         jtag_execute_queue();\r
1270         \r
1271         device = jtag_devices;\r
1272         while (device)\r
1273         {\r
1274                 if (buf_get_u32(ir_test, chain_pos, 2) != 0x1)\r
1275                 {\r
1276                         char *cbuf = buf_to_str(ir_test, total_ir_length, 16);\r
1277                         ERROR("Error validating JTAG scan chain, IR mismatch, scan returned 0x%s", cbuf);\r
1278                         free(cbuf);\r
1279                         free(ir_test);\r
1280                         return ERROR_JTAG_INIT_FAILED;\r
1281                 }\r
1282                 chain_pos += device->ir_length;\r
1283                 device = device->next;\r
1284         }\r
1285         \r
1286         if (buf_get_u32(ir_test, chain_pos, 2) != 0x3)\r
1287         {\r
1288                 char *cbuf = buf_to_str(ir_test, total_ir_length, 16);\r
1289                 ERROR("Error validating JTAG scan chain, IR mismatch, scan returned 0x%s", cbuf);\r
1290                 free(cbuf);\r
1291                 free(ir_test);\r
1292                 return ERROR_JTAG_INIT_FAILED;\r
1293         }\r
1294         \r
1295         free(ir_test);\r
1296         \r
1297         return ERROR_OK;\r
1298 }\r
1299 \r
1300 int jtag_register_commands(struct command_context_s *cmd_ctx)\r
1301 {\r
1302         register_command(cmd_ctx, NULL, "interface", handle_interface_command,\r
1303                 COMMAND_CONFIG, NULL);\r
1304         register_command(cmd_ctx, NULL, "jtag_speed", handle_jtag_speed_command,\r
1305                 COMMAND_ANY, "set jtag speed (if supported) <speed>");\r
1306         register_command(cmd_ctx, NULL, "jtag_device", handle_jtag_device_command,\r
1307                 COMMAND_CONFIG, "jtag_device <ir_length> <ir_expected> <ir_mask>");\r
1308         register_command(cmd_ctx, NULL, "reset_config", handle_reset_config_command,\r
1309                 COMMAND_CONFIG, NULL);\r
1310         register_command(cmd_ctx, NULL, "jtag_nsrst_delay", handle_jtag_nsrst_delay_command,\r
1311                 COMMAND_CONFIG, NULL);\r
1312         register_command(cmd_ctx, NULL, "jtag_ntrst_delay", handle_jtag_ntrst_delay_command,\r
1313                 COMMAND_CONFIG, NULL);\r
1314                 \r
1315         register_command(cmd_ctx, NULL, "scan_chain", handle_scan_chain_command,\r
1316                 COMMAND_EXEC, "print current scan chain configuration");\r
1317 \r
1318         register_command(cmd_ctx, NULL, "endstate", handle_endstate_command,\r
1319                 COMMAND_EXEC, "finish JTAG operations in <tap_state>");\r
1320         register_command(cmd_ctx, NULL, "jtag_reset", handle_jtag_reset_command,\r
1321                 COMMAND_EXEC, "toggle reset lines <trst> <srst>");\r
1322         register_command(cmd_ctx, NULL, "runtest", handle_runtest_command,\r
1323                 COMMAND_EXEC, "move to Run-Test/Idle, and execute <num_cycles>");\r
1324         register_command(cmd_ctx, NULL, "statemove", handle_statemove_command,\r
1325                 COMMAND_EXEC, "move to current endstate or [tap_state]");\r
1326         register_command(cmd_ctx, NULL, "irscan", handle_irscan_command,\r
1327                 COMMAND_EXEC, "execute IR scan <device> <instr> [dev2] [instr2] ...");\r
1328         register_command(cmd_ctx, NULL, "drscan", handle_drscan_command,\r
1329                 COMMAND_EXEC, "execute DR scan <device> <var> [dev2] [var2] ...");\r
1330 \r
1331         register_command(cmd_ctx, NULL, "verify_ircapture", handle_verify_ircapture_command,\r
1332                 COMMAND_ANY, "verify value captured during Capture-IR <enable|disable>");\r
1333         return ERROR_OK;\r
1334 }\r
1335 \r
1336 int jtag_init(struct command_context_s *cmd_ctx)\r
1337 {\r
1338         int i, validate_tries = 0;\r
1339         \r
1340         DEBUG("-");\r
1341 \r
1342         if (jtag_speed == -1)\r
1343                 jtag_speed = 0;\r
1344         \r
1345         if (jtag_interface && (jtag_interface[0] != 0))\r
1346                 /* configuration var 'jtag_interface' is set, and not empty */\r
1347                 for (i = 0; jtag_interfaces[i]; i++)\r
1348                 {\r
1349                         if (strcmp(jtag_interface, jtag_interfaces[i]->name) == 0)\r
1350                         {\r
1351                                 jtag_device_t *device;\r
1352                                 device = jtag_devices;\r
1353         \r
1354                                 if (jtag_interfaces[i]->init() != ERROR_OK)\r
1355                                         return ERROR_JTAG_INIT_FAILED;\r
1356                                 jtag = jtag_interfaces[i];\r
1357 \r
1358                                 jtag_ir_scan_size = 0;\r
1359                                 jtag_num_devices = 0;\r
1360                                 while (device != NULL)\r
1361                                 {\r
1362                                         jtag_ir_scan_size += device->ir_length;\r
1363                                         jtag_num_devices++;\r
1364                                         device = device->next;\r
1365                                 }\r
1366                                 \r
1367                                 jtag_add_statemove(TAP_TLR);\r
1368                                 jtag_execute_queue();\r
1369 \r
1370                                 /* examine chain first, as this could discover the real chain layout */\r
1371                                 if (jtag_examine_chain() != ERROR_OK)\r
1372                                 {\r
1373                                         ERROR("trying to validate configured JTAG chain anyway...");\r
1374                                 }\r
1375                                 \r
1376                                 while (jtag_validate_chain() != ERROR_OK)\r
1377                                 {\r
1378                                         validate_tries++;\r
1379                                         if (validate_tries > 5)\r
1380                                         {\r
1381                                                 ERROR("Could not validate JTAG chain, exit");\r
1382                                                 jtag = NULL;\r
1383                                                 return ERROR_JTAG_INVALID_INTERFACE;\r
1384                                         }\r
1385                                         usleep(10000);\r
1386                                 }\r
1387 \r
1388                                 return ERROR_OK;\r
1389                         }\r
1390                 }\r
1391         \r
1392         /* no valid interface was found (i.e. the configuration option,\r
1393          * didn't match one of the compiled-in interfaces\r
1394          */\r
1395         ERROR("No valid jtag interface found (%s)", jtag_interface);\r
1396         ERROR("compiled-in jtag interfaces:");\r
1397         for (i = 0; jtag_interfaces[i]; i++)\r
1398         {\r
1399                 ERROR("%i: %s", i, jtag_interfaces[i]->name);\r
1400         }\r
1401         \r
1402         jtag = NULL;\r
1403         return ERROR_JTAG_INVALID_INTERFACE;\r
1404 }\r
1405 \r
1406 int handle_interface_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1407 {\r
1408         int i;\r
1409         \r
1410         /* only if the configuration var isn't overwritten from cmdline */\r
1411         if (!jtag_interface)\r
1412         {\r
1413                 if (args[0] && (args[0][0] != 0))\r
1414                 {\r
1415                         for (i=0; jtag_interfaces[i]; i++)\r
1416                         {\r
1417                                 if (strcmp(args[0], jtag_interfaces[i]->name) == 0)\r
1418                                 {\r
1419                                         if (jtag_interfaces[i]->register_commands(cmd_ctx) != ERROR_OK)\r
1420                                                 exit(-1);\r
1421                                 \r
1422                                         jtag_interface = jtag_interfaces[i]->name;\r
1423                 \r
1424                                         return ERROR_OK;\r
1425                                 }\r
1426                         }\r
1427                 }\r
1428                 \r
1429                 /* remember the requested interface name, so we can complain about it later */\r
1430                 jtag_interface = strdup(args[0]);\r
1431                 DEBUG("'interface' command didn't specify a valid interface");\r
1432         }\r
1433         \r
1434         return ERROR_OK;\r
1435 }\r
1436 \r
1437 int handle_jtag_device_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1438 {\r
1439         jtag_device_t **last_device_p = &jtag_devices;\r
1440 \r
1441         if (*last_device_p)\r
1442         {\r
1443                 while ((*last_device_p)->next)\r
1444                         last_device_p = &((*last_device_p)->next);\r
1445                 last_device_p = &((*last_device_p)->next);\r
1446         }\r
1447 \r
1448         if (argc < 3)\r
1449                 return ERROR_OK;\r
1450 \r
1451         *last_device_p = malloc(sizeof(jtag_device_t));\r
1452         (*last_device_p)->ir_length = strtoul(args[0], NULL, 0);\r
1453 \r
1454         (*last_device_p)->expected = malloc((*last_device_p)->ir_length);\r
1455         buf_set_u32((*last_device_p)->expected, 0, (*last_device_p)->ir_length, strtoul(args[1], NULL, 0));\r
1456         (*last_device_p)->expected_mask = malloc((*last_device_p)->ir_length);\r
1457         buf_set_u32((*last_device_p)->expected_mask, 0, (*last_device_p)->ir_length, strtoul(args[2], NULL, 0));\r
1458 \r
1459         (*last_device_p)->cur_instr = malloc((*last_device_p)->ir_length);\r
1460         (*last_device_p)->bypass = 1;\r
1461         buf_set_ones((*last_device_p)->cur_instr, (*last_device_p)->ir_length);\r
1462         \r
1463         (*last_device_p)->next = NULL;\r
1464         \r
1465         jtag_register_event_callback(jtag_reset_callback, (*last_device_p));\r
1466         \r
1467         jtag_num_devices++;\r
1468 \r
1469         return ERROR_OK;\r
1470 }\r
1471 \r
1472 int handle_scan_chain_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1473 {\r
1474         jtag_device_t *device = jtag_devices;\r
1475         int device_count = 0;\r
1476         \r
1477         while (device)\r
1478         {\r
1479                 u32 expected, expected_mask, cur_instr;\r
1480                 expected = buf_get_u32(device->expected, 0, device->ir_length);\r
1481                 expected_mask = buf_get_u32(device->expected_mask, 0, device->ir_length);\r
1482                 cur_instr = buf_get_u32(device->cur_instr, 0, device->ir_length);\r
1483                 command_print(cmd_ctx, "%i: idcode: 0x%8.8x ir length %i, ir capture 0x%x, ir mask 0x%x, current instruction 0x%x", device_count, device->idcode, device->ir_length, expected, expected_mask, cur_instr);\r
1484                 device = device->next;\r
1485                 device_count++;\r
1486         }\r
1487 \r
1488         return ERROR_OK;\r
1489 }\r
1490 \r
1491 int handle_reset_config_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1492 {\r
1493         if (argc >= 1)\r
1494         {\r
1495                 if (strcmp(args[0], "none") == 0)\r
1496                         jtag_reset_config = RESET_NONE;\r
1497                 else if (strcmp(args[0], "trst_only") == 0)\r
1498                         jtag_reset_config = RESET_HAS_TRST;\r
1499                 else if (strcmp(args[0], "srst_only") == 0)\r
1500                         jtag_reset_config = RESET_HAS_SRST;\r
1501                 else if (strcmp(args[0], "trst_and_srst") == 0)\r
1502                         jtag_reset_config = RESET_TRST_AND_SRST;\r
1503                 else\r
1504                 {\r
1505                         ERROR("invalid reset_config argument, defaulting to none");\r
1506                         jtag_reset_config = RESET_NONE;\r
1507                         return ERROR_INVALID_ARGUMENTS;\r
1508                 }\r
1509         }\r
1510         \r
1511         if (argc >= 2)\r
1512         {\r
1513                 if (strcmp(args[1], "srst_pulls_trst") == 0)\r
1514                         jtag_reset_config |= RESET_SRST_PULLS_TRST;\r
1515                 else if (strcmp(args[1], "trst_pulls_srst") == 0)\r
1516                         jtag_reset_config |= RESET_TRST_PULLS_SRST;\r
1517                 else if (strcmp(args[1], "combined") == 0)\r
1518                         jtag_reset_config |= RESET_SRST_PULLS_TRST | RESET_TRST_PULLS_SRST;\r
1519                 else if (strcmp(args[1], "separate") == 0)\r
1520                         jtag_reset_config &= ~(RESET_SRST_PULLS_TRST | RESET_TRST_PULLS_SRST);\r
1521                 else\r
1522                 {\r
1523                         ERROR("invalid reset_config argument, defaulting to none");\r
1524                         jtag_reset_config = RESET_NONE;\r
1525                         return ERROR_INVALID_ARGUMENTS;\r
1526                 }\r
1527         }\r
1528         \r
1529         if (argc >= 3)\r
1530         {\r
1531                 if (strcmp(args[2], "trst_open_drain") == 0)\r
1532                         jtag_reset_config |= RESET_TRST_OPEN_DRAIN;\r
1533                 else if (strcmp(args[2], "trst_push_pull") == 0)\r
1534                         jtag_reset_config &= ~RESET_TRST_OPEN_DRAIN;\r
1535                 else\r
1536                 {\r
1537                         ERROR("invalid reset_config argument, defaulting to none");\r
1538                         jtag_reset_config = RESET_NONE;\r
1539                         return ERROR_INVALID_ARGUMENTS;\r
1540                 }\r
1541         }\r
1542 \r
1543         if (argc >= 4)\r
1544         {\r
1545                 if (strcmp(args[3], "srst_push_pull") == 0)\r
1546                         jtag_reset_config |= RESET_SRST_PUSH_PULL;\r
1547                 else if (strcmp(args[3], "srst_open_drain") == 0)\r
1548                         jtag_reset_config &= ~RESET_SRST_PUSH_PULL;\r
1549                 else\r
1550                 {\r
1551                         ERROR("invalid reset_config argument, defaulting to none");\r
1552                         jtag_reset_config = RESET_NONE;\r
1553                         return ERROR_INVALID_ARGUMENTS;\r
1554                 }\r
1555         }\r
1556         \r
1557         return ERROR_OK;\r
1558 }\r
1559 \r
1560 int handle_jtag_nsrst_delay_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1561 {\r
1562         if (argc < 1)\r
1563         {\r
1564                 ERROR("jtag_nsrst_delay <ms> command takes one required argument");\r
1565                 exit(-1);\r
1566         }\r
1567         else\r
1568         {\r
1569                 jtag_nsrst_delay = strtoul(args[0], NULL, 0);\r
1570         }\r
1571         \r
1572         return ERROR_OK;\r
1573 }\r
1574 \r
1575 int handle_jtag_ntrst_delay_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1576 {\r
1577         if (argc < 1)\r
1578         {\r
1579                 ERROR("jtag_ntrst_delay <ms> command takes one required argument");\r
1580                 exit(-1);\r
1581         }\r
1582         else\r
1583         {\r
1584                 jtag_ntrst_delay = strtoul(args[0], NULL, 0);\r
1585         }\r
1586         \r
1587         return ERROR_OK;\r
1588 }\r
1589 \r
1590 int handle_jtag_speed_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1591 {\r
1592         if (argc == 0)\r
1593                 command_print(cmd_ctx, "jtag_speed: %i", jtag_speed);\r
1594 \r
1595         if (argc > 0)\r
1596         {\r
1597                 /* this command can be called during CONFIG, \r
1598                  * in which case jtag isn't initialized */\r
1599                 if (jtag)\r
1600                         jtag->speed(strtoul(args[0], NULL, 0));\r
1601                 else\r
1602                         jtag_speed = strtoul(args[0], NULL, 0);\r
1603         }\r
1604 \r
1605         return ERROR_OK;\r
1606 }\r
1607 \r
1608 int handle_endstate_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1609 {\r
1610         enum tap_state state;\r
1611 \r
1612         if (argc < 1)\r
1613         {\r
1614                 return ERROR_COMMAND_SYNTAX_ERROR;\r
1615         }\r
1616         else\r
1617         {\r
1618                 for (state = 0; state < 16; state++)\r
1619                 {\r
1620                         if (strcmp(args[0], tap_state_strings[state]) == 0)\r
1621                         {\r
1622                                 jtag_add_end_state(state);\r
1623                                 jtag_execute_queue();\r
1624                         }\r
1625                 }\r
1626         }\r
1627         command_print(cmd_ctx, "current endstate: %s", tap_state_strings[end_state]);\r
1628         \r
1629         return ERROR_OK;\r
1630 }\r
1631 \r
1632 int handle_jtag_reset_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1633 {\r
1634         int trst = -1;\r
1635         int srst = -1;\r
1636         int retval;\r
1637         \r
1638         if (argc < 1)\r
1639         {\r
1640                 return ERROR_COMMAND_SYNTAX_ERROR;\r
1641 \r
1642         }\r
1643 \r
1644         if (args[0][0] == '1')\r
1645                 trst = 1;\r
1646         else if (args[0][0] == '0')\r
1647                 trst = 0;\r
1648         else\r
1649         {\r
1650                 return ERROR_COMMAND_SYNTAX_ERROR;\r
1651         }\r
1652 \r
1653         if (args[1][0] == '1')\r
1654                 srst = 1;\r
1655         else if (args[1][0] == '0')\r
1656                 srst = 0;\r
1657         else\r
1658         {\r
1659                 return ERROR_COMMAND_SYNTAX_ERROR;\r
1660         }\r
1661 \r
1662         if ((retval = jtag_add_reset(trst, srst)) != ERROR_OK)\r
1663         {\r
1664                 switch (retval)\r
1665                 {\r
1666                         case ERROR_JTAG_RESET_WOULD_ASSERT_TRST:\r
1667                                 command_print(cmd_ctx, "requested reset would assert trst\nif this is acceptable, use jtag_reset 1 %c", args[1][0]);\r
1668                                 break;\r
1669                         case ERROR_JTAG_RESET_CANT_SRST:\r
1670                                 command_print(cmd_ctx, "can't assert srst because the current reset_config doesn't support it");\r
1671                                 break;\r
1672                         default:\r
1673                                 command_print(cmd_ctx, "unknown error");\r
1674                 }\r
1675         }\r
1676         jtag_execute_queue();\r
1677 \r
1678         return ERROR_OK;\r
1679 }\r
1680 \r
1681 int handle_runtest_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1682 {\r
1683         if (argc < 1)\r
1684         {\r
1685                 return ERROR_COMMAND_SYNTAX_ERROR;\r
1686         }\r
1687 \r
1688         jtag_add_runtest(strtol(args[0], NULL, 0), -1);\r
1689         jtag_execute_queue();\r
1690 \r
1691         return ERROR_OK;\r
1692 \r
1693 }\r
1694 \r
1695 int handle_statemove_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1696 {\r
1697         enum tap_state state;\r
1698 \r
1699         state = -1;\r
1700         if (argc == 1)\r
1701         {\r
1702                 for (state = 0; state < 16; state++)\r
1703                 {\r
1704                         if (strcmp(args[0], tap_state_strings[state]) == 0)\r
1705                         {\r
1706                                 break;\r
1707                         }\r
1708                 }\r
1709         }\r
1710 \r
1711         jtag_add_statemove(state);\r
1712         jtag_execute_queue();\r
1713 \r
1714         return ERROR_OK;\r
1715 \r
1716 }\r
1717 \r
1718 int handle_irscan_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1719 {\r
1720         int i;\r
1721         scan_field_t *fields;\r
1722         \r
1723         if ((argc < 2) || (argc % 2))\r
1724         {\r
1725                 return ERROR_COMMAND_SYNTAX_ERROR;\r
1726         }\r
1727 \r
1728         fields = malloc(sizeof(scan_field_t) * argc / 2);\r
1729         \r
1730         for (i = 0; i < argc / 2; i++)\r
1731         {\r
1732                 int device = strtoul(args[i*2], NULL, 0);\r
1733                 int field_size = jtag_get_device(device)->ir_length;\r
1734                 fields[i].device = device;\r
1735                 fields[i].out_value = malloc(CEIL(field_size, 8));\r
1736                 buf_set_u32(fields[i].out_value, 0, field_size, strtoul(args[i*2+1], NULL, 0));\r
1737                 fields[i].out_mask = NULL;\r
1738                 fields[i].in_value = NULL;\r
1739                 fields[i].in_check_mask = NULL;\r
1740                 fields[i].in_handler = NULL;\r
1741                 fields[i].in_handler_priv = NULL;\r
1742         }\r
1743 \r
1744         jtag_add_ir_scan(argc / 2, fields, -1);\r
1745         jtag_execute_queue();\r
1746 \r
1747         for (i = 0; i < argc / 2; i++)\r
1748                 free(fields[i].out_value);\r
1749 \r
1750         free (fields);\r
1751 \r
1752         return ERROR_OK;\r
1753 }\r
1754 \r
1755 int handle_drscan_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1756 {\r
1757         scan_field_t *fields;\r
1758         int num_fields = 0;\r
1759         int field_count = 0;\r
1760         var_t *var;\r
1761         int i, j;\r
1762         \r
1763         if ((argc < 2) || (argc % 2))\r
1764         {\r
1765                 return ERROR_COMMAND_SYNTAX_ERROR;\r
1766         }\r
1767 \r
1768         for (i = 0; i < argc; i+=2)\r
1769         {\r
1770                 var = get_var_by_namenum(args[i+1]);\r
1771                 if (var)\r
1772                 {\r
1773                         num_fields += var->num_fields;\r
1774                 }\r
1775                 else\r
1776                 {\r
1777                         command_print(cmd_ctx, "variable %s doesn't exist", args[i+1]);\r
1778                         return ERROR_OK;\r
1779                 }\r
1780         }\r
1781 \r
1782         fields = malloc(sizeof(scan_field_t) * num_fields);\r
1783 \r
1784         for (i = 0; i < argc; i+=2)\r
1785         {\r
1786                 var = get_var_by_namenum(args[i+1]);\r
1787         \r
1788                 for (j = 0; j < var->num_fields; j++)\r
1789                 {\r
1790                         fields[field_count].device = strtol(args[i], NULL, 0);\r
1791                         fields[field_count].num_bits = var->fields[j].num_bits;\r
1792                         fields[field_count].out_value = malloc(CEIL(var->fields[j].num_bits, 8));\r
1793                         buf_set_u32(fields[field_count].out_value, 0, var->fields[j].num_bits, var->fields[j].value);\r
1794                         fields[field_count].out_mask = NULL;\r
1795                         fields[field_count].in_value = fields[field_count].out_value;\r
1796                         fields[field_count].in_check_mask = NULL;\r
1797                         fields[field_count].in_check_value = NULL;\r
1798                         fields[field_count].in_handler = field_le_to_host;\r
1799                         fields[field_count++].in_handler_priv = &(var->fields[j]);\r
1800                 }\r
1801         }\r
1802 \r
1803         jtag_add_dr_scan(num_fields, fields, -1);\r
1804         jtag_execute_queue();\r
1805         \r
1806         for (i = 0; i < argc / 2; i++)\r
1807                 free(fields[i].out_value);\r
1808 \r
1809         free(fields);\r
1810 \r
1811         return ERROR_OK;\r
1812 }\r
1813 \r
1814 int handle_verify_ircapture_command(struct command_context_s *cmd_ctx, char *cmd, char **args, int argc)\r
1815 {\r
1816         if (argc == 1)\r
1817         {\r
1818                 if (strcmp(args[0], "enable") == 0)\r
1819                 {\r
1820                         jtag_verify_capture_ir = 1;\r
1821                 }\r
1822                 else if (strcmp(args[0], "disable") == 0)\r
1823                 {\r
1824                         jtag_verify_capture_ir = 0;\r
1825                 } else\r
1826                 {\r
1827                         return ERROR_COMMAND_SYNTAX_ERROR;\r
1828                 }\r
1829         } else if (argc != 0)\r
1830         {\r
1831                 return ERROR_COMMAND_SYNTAX_ERROR;\r
1832         }\r
1833         \r
1834         command_print(cmd_ctx, "verify Capture-IR is %s", (jtag_verify_capture_ir) ? "enabled": "disabled");\r
1835         \r
1836         return ERROR_OK;\r
1837 }\r