1 /***************************************************************************
2 * Copyright (C) 2009 by Simon Qian *
3 * SimonQian@SimonQian.com *
5 * This program is free software; you can redistribute it and/or modify *
6 * it under the terms of the GNU General Public License as published by *
7 * the Free Software Foundation; either version 2 of the License, or *
8 * (at your option) any later version. *
10 * This program is distributed in the hope that it will be useful, *
11 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
12 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
13 * GNU General Public License for more details. *
15 * You should have received a copy of the GNU General Public License *
16 * along with this program; if not, write to the *
17 * Free Software Foundation, Inc., *
18 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
19 ***************************************************************************/
22 /* The specification for SVF is available here:
23 * http://www.asset-intertech.com/support/svf.pdf
24 * Below, this document is refered to as the "SVF spec".
26 * The specification for XSVF is available here:
27 * http://www.xilinx.com/support/documentation/application_notes/xapp503.pdf
28 * Below, this document is refered to as the "XSVF spec".
37 #include "time_support.h"
59 const char *svf_command_name
[14] =
85 const char *svf_trst_mode_name
[4] =
93 char *svf_tap_state_name
[TAP_NUM_STATES
];
95 #define XXR_TDI (1 << 0)
96 #define XXR_TDO (1 << 1)
97 #define XXR_MASK (1 << 2)
98 #define XXR_SMASK (1 << 3)
112 tap_state_t ir_end_state
;
113 tap_state_t dr_end_state
;
114 tap_state_t runtest_run_state
;
115 tap_state_t runtest_end_state
;
116 trst_mode_t trst_mode
;
118 svf_xxr_para_t hir_para
;
119 svf_xxr_para_t hdr_para
;
120 svf_xxr_para_t tir_para
;
121 svf_xxr_para_t tdr_para
;
122 svf_xxr_para_t sir_para
;
123 svf_xxr_para_t sdr_para
;
127 const svf_para_t svf_para_init
=
129 // frequency, ir_end_state, dr_end_state, runtest_run_state, runtest_end_state, trst_mode
130 0, TAP_IDLE
, TAP_IDLE
, TAP_IDLE
, TAP_IDLE
, TRST_Z
,
132 // {len, data_mask, tdi, tdo, mask, smask},
133 {0, 0, NULL
, NULL
, NULL
, NULL
},
135 // {len, data_mask, tdi, tdo, mask, smask},
136 {0, 0, NULL
, NULL
, NULL
, NULL
},
138 // {len, data_mask, tdi, tdo, mask, smask},
139 {0, 0, NULL
, NULL
, NULL
, NULL
},
141 // {len, data_mask, tdi, tdo, mask, smask},
142 {0, 0, NULL
, NULL
, NULL
, NULL
},
144 // {len, data_mask, tdi, tdo, mask, smask},
145 {0, 0, NULL
, NULL
, NULL
, NULL
},
147 // {len, data_mask, tdi, tdo, mask, smask},
148 {0, 0, NULL
, NULL
, NULL
, NULL
},
153 int line_num
; // used to record line number of the check operation
154 // so more information could be printed
155 int enabled
; // check is enabled or not
156 int buffer_offset
; // buffer_offset to buffers
157 int bit_len
; // bit length to check
158 }svf_check_tdo_para_t
;
160 #define SVF_CHECK_TDO_PARA_SIZE 1024
161 static svf_check_tdo_para_t
*svf_check_tdo_para
= NULL
;
162 static int svf_check_tdo_para_index
= 0;
164 #define dimof(a) (sizeof(a) / sizeof((a)[0]))
166 static int svf_read_command_from_file(int fd
);
167 static int svf_check_tdo(void);
168 static int svf_add_check_para(u8 enabled
, int buffer_offset
, int bit_len
);
169 static int svf_run_command(struct command_context_s
*cmd_ctx
, char *cmd_str
);
170 static int handle_svf_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
);
172 static int svf_fd
= 0;
173 static char *svf_command_buffer
= NULL
;
174 static int svf_command_buffer_size
= 0;
175 static int svf_line_number
= 1;
177 static jtag_tap_t
*tap
= NULL
;
178 static tap_state_t last_state
= TAP_RESET
;
180 #define SVF_MAX_BUFFER_SIZE_TO_COMMIT (4 * 1024)
181 static u8
*svf_tdi_buffer
= NULL
, *svf_tdo_buffer
= NULL
, *svf_mask_buffer
= NULL
;
182 static int svf_buffer_index
= 0, svf_buffer_size
= 0;
183 static int svf_quiet
= 0;
186 int svf_register_commands(struct command_context_s
*cmd_ctx
)
188 register_command(cmd_ctx
, NULL
, "svf", handle_svf_command
,
189 COMMAND_EXEC
, "run svf <file>");
194 void svf_free_xxd_para(svf_xxr_para_t
*para
)
198 if (para
->tdi
!= NULL
)
203 if (para
->tdo
!= NULL
)
208 if (para
->mask
!= NULL
)
213 if (para
->smask
!= NULL
)
221 static const char* tap_state_svf_name(tap_state_t state
)
227 case TAP_RESET
: ret
= "RESET"; break;
228 case TAP_IDLE
: ret
= "IDLE"; break;
229 case TAP_DRSELECT
: ret
= "DRSELECT"; break;
230 case TAP_DRCAPTURE
: ret
= "DRCAPTURE"; break;
231 case TAP_DRSHIFT
: ret
= "DRSHIFT"; break;
232 case TAP_DREXIT1
: ret
= "DREXIT1"; break;
233 case TAP_DRPAUSE
: ret
= "DRPAUSE"; break;
234 case TAP_DREXIT2
: ret
= "DREXIT2"; break;
235 case TAP_DRUPDATE
: ret
= "DRUPDATE"; break;
236 case TAP_IRSELECT
: ret
= "IRSELECT"; break;
237 case TAP_IRCAPTURE
: ret
= "IRCAPTURE"; break;
238 case TAP_IRSHIFT
: ret
= "IRSHIFT"; break;
239 case TAP_IREXIT1
: ret
= "IREXIT1"; break;
240 case TAP_IRPAUSE
: ret
= "IRPAUSE"; break;
241 case TAP_IREXIT2
: ret
= "IREXIT2"; break;
242 case TAP_IRUPDATE
: ret
= "IRUPDATE"; break;
243 default: ret
= "???"; break;
249 static int handle_svf_command(struct command_context_s
*cmd_ctx
, char *cmd
, char **args
, int argc
)
251 #define SVF_NUM_OF_OPTIONS 1
252 int command_num
= 0, i
;
256 if ((argc
< 1) || (argc
> (1 + SVF_NUM_OF_OPTIONS
)))
258 command_print(cmd_ctx
, "usage: svf <file> [quiet]");
264 for (i
= 1; i
< argc
; i
++)
266 if (!strcmp(args
[i
], "quiet"))
272 LOG_ERROR("unknown variant for svf: %s", args
[i
]);
274 // no need to free anything now
279 if ((svf_fd
= open(args
[0], O_RDONLY
)) < 0)
281 command_print(cmd_ctx
, "file \"%s\" not found", args
[0]);
283 // no need to free anything now
287 LOG_USER("svf processing file: \"%s\"", args
[0]);
290 time_ago
= timeval_ms();
294 svf_command_buffer_size
= 0;
296 svf_check_tdo_para_index
= 0;
297 svf_check_tdo_para
= malloc(sizeof(svf_check_tdo_para_t
) * SVF_CHECK_TDO_PARA_SIZE
);
298 if (NULL
== svf_check_tdo_para
)
300 LOG_ERROR("not enough memory");
305 svf_buffer_index
= 0;
306 // double the buffer size
307 // in case current command cannot be commited, and next command is a bit scan command
308 // here is 32K bits for this big scan command, it should be enough
309 // buffer will be reallocated if buffer size is not enough
310 svf_tdi_buffer
= (u8
*)malloc(2 * SVF_MAX_BUFFER_SIZE_TO_COMMIT
);
311 if (NULL
== svf_tdi_buffer
)
313 LOG_ERROR("not enough memory");
317 svf_tdo_buffer
= (u8
*)malloc(2 * SVF_MAX_BUFFER_SIZE_TO_COMMIT
);
318 if (NULL
== svf_tdo_buffer
)
320 LOG_ERROR("not enough memory");
324 svf_mask_buffer
= (u8
*)malloc(2 * SVF_MAX_BUFFER_SIZE_TO_COMMIT
);
325 if (NULL
== svf_mask_buffer
)
327 LOG_ERROR("not enough memory");
331 svf_buffer_size
= 2 * SVF_MAX_BUFFER_SIZE_TO_COMMIT
;
333 memcpy(&svf_para
, &svf_para_init
, sizeof(svf_para
));
334 for (i
= 0; i
< (int)dimof(svf_tap_state_name
); i
++)
336 svf_tap_state_name
[i
] = (char *)tap_state_svf_name(i
);
341 while ( ERROR_OK
== svf_read_command_from_file(svf_fd
) )
343 if (ERROR_OK
!= svf_run_command(cmd_ctx
, svf_command_buffer
))
345 LOG_ERROR("fail to run command at line %d", svf_line_number
);
351 if (ERROR_OK
!= jtag_execute_queue())
355 else if (ERROR_OK
!= svf_check_tdo())
361 command_print(cmd_ctx
, "%lld ms used", timeval_ms() - time_ago
);
369 if (svf_command_buffer
)
371 free(svf_command_buffer
);
372 svf_command_buffer
= NULL
;
373 svf_command_buffer_size
= 0;
375 if (svf_check_tdo_para
)
377 free(svf_check_tdo_para
);
378 svf_check_tdo_para
= NULL
;
379 svf_check_tdo_para_index
= 0;
383 free(svf_tdi_buffer
);
384 svf_tdi_buffer
= NULL
;
388 free(svf_tdo_buffer
);
389 svf_tdo_buffer
= NULL
;
393 free(svf_mask_buffer
);
394 svf_mask_buffer
= NULL
;
396 svf_buffer_index
= 0;
399 svf_free_xxd_para(&svf_para
.hdr_para
);
400 svf_free_xxd_para(&svf_para
.hir_para
);
401 svf_free_xxd_para(&svf_para
.tdr_para
);
402 svf_free_xxd_para(&svf_para
.tir_para
);
403 svf_free_xxd_para(&svf_para
.sdr_para
);
404 svf_free_xxd_para(&svf_para
.sir_para
);
408 command_print(cmd_ctx
, "svf file programmed successfully for %d commands", command_num
);
412 command_print(cmd_ctx
, "svf file programmed failed");
418 #define SVFP_CMD_INC_CNT 1024
419 static int svf_read_command_from_file(int fd
)
421 char ch
, *tmp_buffer
= NULL
;
422 int cmd_pos
= 0, cmd_ok
= 0, slash
= 0, comment
= 0;
424 while (!cmd_ok
&& (read(fd
, &ch
, 1) > 0) )
454 if (cmd_pos
>= svf_command_buffer_size
- 1)
456 tmp_buffer
= (char*)malloc(svf_command_buffer_size
+ SVFP_CMD_INC_CNT
); // 1 more byte for '\0'
457 if (NULL
== tmp_buffer
)
459 LOG_ERROR("not enough memory");
462 if (svf_command_buffer_size
> 0)
464 memcpy(tmp_buffer
, svf_command_buffer
, svf_command_buffer_size
);
466 if (svf_command_buffer
!= NULL
)
468 free(svf_command_buffer
);
470 svf_command_buffer
= tmp_buffer
;
471 svf_command_buffer_size
+= SVFP_CMD_INC_CNT
;
474 svf_command_buffer
[cmd_pos
++] = (char)toupper(ch
);
482 svf_command_buffer
[cmd_pos
] = '\0';
491 static int svf_parse_cmd_string(char *str
, int len
, char **argus
, int *num_of_argu
)
493 int pos
= 0, num
= 0, space_found
= 1;
503 LOG_ERROR("fail to parse svf command");
513 argus
[num
++] = &str
[pos
];
526 static int svf_tap_state_is_stable(tap_state_t state
)
528 return ((TAP_RESET
== state
) || (TAP_IDLE
== state
) || (TAP_DRPAUSE
== state
) || (TAP_IRPAUSE
== state
));
531 static int svf_tap_state_is_valid(tap_state_t state
)
533 return state
>= 0 && state
< TAP_NUM_STATES
;
536 static int svf_find_string_in_array(char *str
, char **strs
, int num_of_element
)
540 for (i
= 0; i
< num_of_element
; i
++)
542 if (!strcmp(str
, strs
[i
]))
550 static int svf_adjust_array_length(u8
**arr
, int orig_bit_len
, int new_bit_len
)
552 int new_byte_len
= (new_bit_len
+ 7) >> 3;
554 if ((NULL
== *arr
) || (((orig_bit_len
+ 7) >> 3) < ((new_bit_len
+ 7) >> 3)))
561 *arr
= (u8
*)malloc(new_byte_len
);
564 LOG_ERROR("not enough memory");
567 memset(*arr
, 0, new_byte_len
);
572 static int svf_copy_hexstring_to_binary(char *str
, u8
**bin
, int orig_bit_len
, int bit_len
)
574 int i
, str_len
= strlen(str
), str_byte_len
= (bit_len
+ 3) >> 2, loop_cnt
;
575 u8 ch
, need_write
= 1;
577 if (ERROR_OK
!= svf_adjust_array_length(bin
, orig_bit_len
, bit_len
))
579 LOG_ERROR("fail to adjust length of array");
583 if (str_byte_len
> str_len
)
585 loop_cnt
= str_byte_len
;
592 for (i
= 0; i
< loop_cnt
; i
++)
596 ch
= str
[str_len
- i
- 1];
597 if ((ch
>= '0') && (ch
<= '9'))
601 else if ((ch
>= 'A') && (ch
<= 'F'))
607 LOG_ERROR("invalid hex string");
617 if (i
>= str_byte_len
)
619 // all data written, other data should be all '0's and needn't to be written
623 LOG_ERROR("value execede length");
627 else if (i
== (str_byte_len
- 1))
629 // last data byte, written if valid
630 if ((ch
& ~((1 << (bit_len
- 4 * i
)) - 1)) != 0)
632 LOG_ERROR("value execede length");
643 (*bin
)[i
/ 2] |= ch
<< 4;
657 static int svf_check_tdo(void)
661 for (i
= 0; i
< svf_check_tdo_para_index
; i
++)
663 index
= svf_check_tdo_para
[i
].buffer_offset
;
664 len
= svf_check_tdo_para
[i
].bit_len
;
665 if ((svf_check_tdo_para
[i
].enabled
)
666 && buf_cmp_mask(&svf_tdi_buffer
[index
], &svf_tdo_buffer
[index
], &svf_mask_buffer
[index
], len
))
669 unsigned received
, expected
, tapmask
;
670 if (svf_check_tdo_para
[i
].bit_len
>= 32)
672 bitmask
= 0xFFFFFFFF;
676 bitmask
= (1 << svf_check_tdo_para
[i
].bit_len
) - 1;
678 memcpy(&received
, svf_tdi_buffer
+ index
, sizeof(unsigned));
679 memcpy(&expected
, svf_tdo_buffer
+ index
, sizeof(unsigned));
680 memcpy(&tapmask
, svf_mask_buffer
+ index
, sizeof(unsigned));
681 LOG_ERROR("tdo check error at line %d",
682 svf_check_tdo_para
[i
].line_num
);
683 LOG_ERROR("read = 0x%X, want = 0x%X, mask = 0x%X",
690 svf_check_tdo_para_index
= 0;
695 static int svf_add_check_para(u8 enabled
, int buffer_offset
, int bit_len
)
697 if (svf_check_tdo_para_index
>= SVF_CHECK_TDO_PARA_SIZE
)
699 LOG_ERROR("toooooo many operation undone");
703 svf_check_tdo_para
[svf_check_tdo_para_index
].line_num
= svf_line_number
;
704 svf_check_tdo_para
[svf_check_tdo_para_index
].bit_len
= bit_len
;
705 svf_check_tdo_para
[svf_check_tdo_para_index
].enabled
= enabled
;
706 svf_check_tdo_para
[svf_check_tdo_para_index
].buffer_offset
= buffer_offset
;
707 svf_check_tdo_para_index
++;
712 static int svf_execute_tap(void)
714 if (ERROR_OK
!= jtag_execute_queue())
718 else if (ERROR_OK
!= svf_check_tdo())
723 svf_buffer_index
= 0;
728 // not good to use this
729 extern void* cmd_queue_alloc(size_t size
);
730 extern void jtag_queue_command(jtag_command_t
* cmd
);
732 static int svf_run_command(struct command_context_s
*cmd_ctx
, char *cmd_str
)
734 char *argus
[256], command
;
735 int num_of_argu
= 0, i
;
742 float min_time
, max_time
;
744 svf_xxr_para_t
*xxr_para_tmp
;
748 tap_state_t
*path
= NULL
, state
;
752 LOG_USER("%s", svf_command_buffer
);
755 if (ERROR_OK
!= svf_parse_cmd_string(cmd_str
, strlen(cmd_str
), argus
, &num_of_argu
))
760 command
= svf_find_string_in_array(argus
[0], (char **)svf_command_name
, dimof(svf_command_name
));
765 if (num_of_argu
!= 2)
767 LOG_ERROR("invalid parameter of %s", argus
[0]);
770 i_tmp
= svf_find_string_in_array(argus
[1], (char **)svf_tap_state_name
, dimof(svf_tap_state_name
));
771 if (svf_tap_state_is_stable(i_tmp
))
773 if (command
== ENDIR
)
775 svf_para
.ir_end_state
= i_tmp
;
776 LOG_DEBUG("\tir_end_state = %s", svf_tap_state_name
[svf_para
.ir_end_state
]);
780 svf_para
.dr_end_state
= i_tmp
;
781 LOG_DEBUG("\tdr_end_state = %s", svf_tap_state_name
[svf_para
.dr_end_state
]);
786 LOG_ERROR("%s is not valid state", argus
[1]);
791 if ((num_of_argu
!= 1) && (num_of_argu
!= 3))
793 LOG_ERROR("invalid parameter of %s", argus
[0]);
796 if (1 == num_of_argu
)
798 // TODO: set jtag speed to full speed
799 svf_para
.frequency
= 0;
803 if (strcmp(argus
[2], "HZ"))
805 LOG_ERROR("HZ not found in FREQUENCY command");
808 if (ERROR_OK
!= svf_execute_tap())
812 svf_para
.frequency
= atof(argus
[1]);
813 // TODO: set jtag speed to
814 if (svf_para
.frequency
> 0)
816 command_run_linef(cmd_ctx
, "jtag_khz %d", (int)svf_para
.frequency
/ 1000);
817 LOG_DEBUG("\tfrequency = %f", svf_para
.frequency
);
822 xxr_para_tmp
= &svf_para
.hdr_para
;
825 xxr_para_tmp
= &svf_para
.hir_para
;
828 xxr_para_tmp
= &svf_para
.tdr_para
;
831 xxr_para_tmp
= &svf_para
.tir_para
;
834 xxr_para_tmp
= &svf_para
.sdr_para
;
837 xxr_para_tmp
= &svf_para
.sir_para
;
840 // XXR length [TDI (tdi)] [TDO (tdo)][MASK (mask)] [SMASK (smask)]
841 if ((num_of_argu
> 10) || (num_of_argu
% 2))
843 LOG_ERROR("invalid parameter of %s", argus
[0]);
846 i_tmp
= xxr_para_tmp
->len
;
847 xxr_para_tmp
->len
= atoi(argus
[1]);
848 LOG_DEBUG("\tlength = %d", xxr_para_tmp
->len
);
849 xxr_para_tmp
->data_mask
= 0;
850 for (i
= 2; i
< num_of_argu
; i
+= 2)
852 if ((strlen(argus
[i
+ 1]) < 3) || (argus
[i
+ 1][0] != '(') || (argus
[i
+ 1][strlen(argus
[i
+ 1]) - 1] != ')'))
854 LOG_ERROR("data section error");
857 argus
[i
+ 1][strlen(argus
[i
+ 1]) - 1] = '\0';
858 // TDI, TDO, MASK, SMASK
859 if (!strcmp(argus
[i
], "TDI"))
862 pbuffer_tmp
= &xxr_para_tmp
->tdi
;
863 xxr_para_tmp
->data_mask
|= XXR_TDI
;
865 else if (!strcmp(argus
[i
], "TDO"))
868 pbuffer_tmp
= &xxr_para_tmp
->tdo
;
869 xxr_para_tmp
->data_mask
|= XXR_TDO
;
871 else if (!strcmp(argus
[i
], "MASK"))
874 pbuffer_tmp
= &xxr_para_tmp
->mask
;
875 xxr_para_tmp
->data_mask
|= XXR_MASK
;
877 else if (!strcmp(argus
[i
], "SMASK"))
880 pbuffer_tmp
= &xxr_para_tmp
->smask
;
881 xxr_para_tmp
->data_mask
|= XXR_SMASK
;
885 LOG_ERROR("unknow parameter: %s", argus
[i
]);
888 if (ERROR_OK
!= svf_copy_hexstring_to_binary(&argus
[i
+ 1][1], pbuffer_tmp
, i_tmp
, xxr_para_tmp
->len
))
890 LOG_ERROR("fail to parse hex value");
893 LOG_DEBUG("\t%s = 0x%X", argus
[i
], (**(int**)pbuffer_tmp
) & ((1 << (xxr_para_tmp
->len
)) - 1));
895 // If a command changes the length of the last scan of the same type and the MASK parameter is absent,
896 // the mask pattern used is all cares
897 if (!(xxr_para_tmp
->data_mask
& XXR_MASK
) && (i_tmp
!= xxr_para_tmp
->len
))
899 // MASK not defined and length changed
900 if (ERROR_OK
!= svf_adjust_array_length(&xxr_para_tmp
->mask
, i_tmp
, xxr_para_tmp
->len
))
902 LOG_ERROR("fail to adjust length of array");
905 buf_set_ones(xxr_para_tmp
->mask
, xxr_para_tmp
->len
);
907 // do scan if necessary
910 // check buffer size first, reallocate if necessary
911 i
= svf_para
.hdr_para
.len
+ svf_para
.sdr_para
.len
+ svf_para
.tdr_para
.len
;
912 if ((svf_buffer_size
- svf_buffer_index
) < ((i
+ 7) >> 3))
915 // simply print error message
916 LOG_ERROR("buffer is not enough, report to author");
922 buffer_tmp
= (u8
*)malloc(svf_buffer_index
+ ((i
+ 7) >> 3));
923 if (NULL
== buffer_tmp
)
925 LOG_ERROR("not enough memory");
928 memcpy(buffer_tmp
, svf_tdi_buffer
, svf_buffer_index
);
929 // svf_tdi_buffer isn't NULL here
930 free(svf_tdi_buffer
);
931 svf_tdi_buffer
= buffer_tmp
;
933 buffer_tmp
= (u8
*)malloc(svf_buffer_index
+ ((i
+ 7) >> 3));
934 if (NULL
== buffer_tmp
)
936 LOG_ERROR("not enough memory");
939 memcpy(buffer_tmp
, svf_tdo_buffer
, svf_buffer_index
);
940 // svf_tdo_buffer isn't NULL here
941 free(svf_tdo_buffer
);
942 svf_tdo_buffer
= buffer_tmp
;
944 buffer_tmp
= (u8
*)malloc(svf_buffer_index
+ ((i
+ 7) >> 3));
945 if (NULL
== buffer_tmp
)
947 LOG_ERROR("not enough memory");
950 memcpy(buffer_tmp
, svf_mask_buffer
, svf_buffer_index
);
951 // svf_mask_buffer isn't NULL here
952 free(svf_mask_buffer
);
953 svf_mask_buffer
= buffer_tmp
;
956 svf_buffer_size
= svf_buffer_index
+ ((i
+ 7) >> 3);
962 buf_set_buf(svf_para
.hdr_para
.tdi
, 0, &svf_tdi_buffer
[svf_buffer_index
], i
, svf_para
.hdr_para
.len
);
963 i
+= svf_para
.hdr_para
.len
;
964 buf_set_buf(svf_para
.sdr_para
.tdi
, 0, &svf_tdi_buffer
[svf_buffer_index
], i
, svf_para
.sdr_para
.len
);
965 i
+= svf_para
.sdr_para
.len
;
966 buf_set_buf(svf_para
.tdr_para
.tdi
, 0, &svf_tdi_buffer
[svf_buffer_index
], i
, svf_para
.tdr_para
.len
);
967 i
+= svf_para
.tdr_para
.len
;
970 if (svf_para
.sdr_para
.data_mask
& XXR_TDO
)
972 // assemble dr mask data
974 buf_set_buf(svf_para
.hdr_para
.mask
, 0, &svf_mask_buffer
[svf_buffer_index
], i
, svf_para
.hdr_para
.len
);
975 i
+= svf_para
.hdr_para
.len
;
976 buf_set_buf(svf_para
.sdr_para
.mask
, 0, &svf_mask_buffer
[svf_buffer_index
], i
, svf_para
.sdr_para
.len
);
977 i
+= svf_para
.sdr_para
.len
;
978 buf_set_buf(svf_para
.tdr_para
.mask
, 0, &svf_mask_buffer
[svf_buffer_index
], i
, svf_para
.tdr_para
.len
);
979 i
+= svf_para
.tdr_para
.len
;
980 // assemble dr check data
982 buf_set_buf(svf_para
.hdr_para
.tdo
, 0, &svf_tdo_buffer
[svf_buffer_index
], i
, svf_para
.hdr_para
.len
);
983 i
+= svf_para
.hdr_para
.len
;
984 buf_set_buf(svf_para
.sdr_para
.tdo
, 0, &svf_tdo_buffer
[svf_buffer_index
], i
, svf_para
.sdr_para
.len
);
985 i
+= svf_para
.sdr_para
.len
;
986 buf_set_buf(svf_para
.tdr_para
.tdo
, 0, &svf_tdo_buffer
[svf_buffer_index
], i
, svf_para
.tdr_para
.len
);
987 i
+= svf_para
.tdr_para
.len
;
989 svf_add_check_para(1, svf_buffer_index
, i
);
993 svf_add_check_para(0, svf_buffer_index
, i
);
997 field
.out_value
= &svf_tdi_buffer
[svf_buffer_index
];
999 field
.in_value
= &svf_tdi_buffer
[svf_buffer_index
];
1004 jtag_add_plain_dr_scan(1, &field
, svf_para
.dr_end_state
);
1006 svf_buffer_index
+= (i
+ 7) >> 3;
1007 last_state
= svf_para
.dr_end_state
;
1009 else if (SIR
== command
)
1011 // check buffer size first, reallocate if necessary
1012 i
= svf_para
.hir_para
.len
+ svf_para
.sir_para
.len
+ svf_para
.tir_para
.len
;
1013 if ((svf_buffer_size
- svf_buffer_index
) < ((i
+ 7) >> 3))
1016 // simply print error message
1017 LOG_ERROR("buffer is not enough, report to author");
1022 // reallocate buffer
1023 buffer_tmp
= (u8
*)malloc(svf_buffer_index
+ ((i
+ 7) >> 3));
1024 if (NULL
== buffer_tmp
)
1026 LOG_ERROR("not enough memory");
1029 memcpy(buffer_tmp
, svf_tdi_buffer
, svf_buffer_index
);
1030 // svf_tdi_buffer isn't NULL here
1031 free(svf_tdi_buffer
);
1032 svf_tdi_buffer
= buffer_tmp
;
1034 buffer_tmp
= (u8
*)malloc(svf_buffer_index
+ ((i
+ 7) >> 3));
1035 if (NULL
== buffer_tmp
)
1037 LOG_ERROR("not enough memory");
1040 memcpy(buffer_tmp
, svf_tdo_buffer
, svf_buffer_index
);
1041 // svf_tdo_buffer isn't NULL here
1042 free(svf_tdo_buffer
);
1043 svf_tdo_buffer
= buffer_tmp
;
1045 buffer_tmp
= (u8
*)malloc(svf_buffer_index
+ ((i
+ 7) >> 3));
1046 if (NULL
== buffer_tmp
)
1048 LOG_ERROR("not enough memory");
1051 memcpy(buffer_tmp
, svf_mask_buffer
, svf_buffer_index
);
1052 // svf_mask_buffer isn't NULL here
1053 free(svf_mask_buffer
);
1054 svf_mask_buffer
= buffer_tmp
;
1057 svf_buffer_size
= svf_buffer_index
+ ((i
+ 7) >> 3);
1063 buf_set_buf(svf_para
.hir_para
.tdi
, 0, &svf_tdi_buffer
[svf_buffer_index
], i
, svf_para
.hir_para
.len
);
1064 i
+= svf_para
.hir_para
.len
;
1065 buf_set_buf(svf_para
.sir_para
.tdi
, 0, &svf_tdi_buffer
[svf_buffer_index
], i
, svf_para
.sir_para
.len
);
1066 i
+= svf_para
.sir_para
.len
;
1067 buf_set_buf(svf_para
.tir_para
.tdi
, 0, &svf_tdi_buffer
[svf_buffer_index
], i
, svf_para
.tir_para
.len
);
1068 i
+= svf_para
.tir_para
.len
;
1071 if (svf_para
.sir_para
.data_mask
& XXR_TDO
)
1073 // assemble dr mask data
1075 buf_set_buf(svf_para
.hir_para
.mask
, 0, &svf_mask_buffer
[svf_buffer_index
], i
, svf_para
.hir_para
.len
);
1076 i
+= svf_para
.hir_para
.len
;
1077 buf_set_buf(svf_para
.sir_para
.mask
, 0, &svf_mask_buffer
[svf_buffer_index
], i
, svf_para
.sir_para
.len
);
1078 i
+= svf_para
.sir_para
.len
;
1079 buf_set_buf(svf_para
.tir_para
.mask
, 0, &svf_mask_buffer
[svf_buffer_index
], i
, svf_para
.tir_para
.len
);
1080 i
+= svf_para
.tir_para
.len
;
1081 // assemble dr check data
1083 buf_set_buf(svf_para
.hir_para
.tdo
, 0, &svf_tdo_buffer
[svf_buffer_index
], i
, svf_para
.hir_para
.len
);
1084 i
+= svf_para
.hir_para
.len
;
1085 buf_set_buf(svf_para
.sir_para
.tdo
, 0, &svf_tdo_buffer
[svf_buffer_index
], i
, svf_para
.sir_para
.len
);
1086 i
+= svf_para
.sir_para
.len
;
1087 buf_set_buf(svf_para
.tir_para
.tdo
, 0, &svf_tdo_buffer
[svf_buffer_index
], i
, svf_para
.tir_para
.len
);
1088 i
+= svf_para
.tir_para
.len
;
1090 svf_add_check_para(1, svf_buffer_index
, i
);
1094 svf_add_check_para(0, svf_buffer_index
, i
);
1098 field
.out_value
= &svf_tdi_buffer
[svf_buffer_index
];
1100 field
.in_value
= &svf_tdi_buffer
[svf_buffer_index
];
1105 jtag_add_plain_ir_scan(1, &field
, svf_para
.ir_end_state
);
1107 svf_buffer_index
+= (i
+ 7) >> 3;
1108 last_state
= svf_para
.ir_end_state
;
1113 LOG_ERROR("PIO and PIOMAP are not supported");
1117 // RUNTEST [run_state] run_count run_clk [min_time SEC [MAXIMUM max_time SEC]] [ENDSTATE end_state]
1118 // RUNTEST [run_state] min_time SEC [MAXIMUM max_time SEC] [ENDSTATE end_state]
1119 if ((num_of_argu
< 3) && (num_of_argu
> 11))
1121 LOG_ERROR("invalid parameter of %s", argus
[0]);
1130 i_tmp
= svf_find_string_in_array(argus
[i
], (char **)svf_tap_state_name
, dimof(svf_tap_state_name
));
1131 if (svf_tap_state_is_valid(i_tmp
))
1133 if (svf_tap_state_is_stable(i_tmp
))
1135 svf_para
.runtest_run_state
= i_tmp
;
1137 // When a run_state is specified, the new run_state becomes the default end_state
1138 svf_para
.runtest_end_state
= i_tmp
;
1139 LOG_DEBUG("\trun_state = %s", svf_tap_state_name
[svf_para
.runtest_run_state
]);
1144 LOG_ERROR("%s is not valid state", svf_tap_state_name
[i_tmp
]);
1148 // run_count run_clk
1149 if (((i
+ 2) <= num_of_argu
) && strcmp(argus
[i
+ 1], "SEC"))
1151 if (!strcmp(argus
[i
+ 1], "TCK"))
1153 // clock source is TCK
1154 run_count
= atoi(argus
[i
]);
1155 LOG_DEBUG("\trun_count@TCK = %d", run_count
);
1159 LOG_ERROR("%s not supported for clock", argus
[i
+ 1]);
1165 if (((i
+ 2) <= num_of_argu
) && !strcmp(argus
[i
+ 1], "SEC"))
1167 min_time
= atof(argus
[i
]);
1168 LOG_DEBUG("\tmin_time = %fs", min_time
);
1171 // MAXIMUM max_time SEC
1172 if (((i
+ 3) <= num_of_argu
) && !strcmp(argus
[i
], "MAXIMUM") && !strcmp(argus
[i
+ 2], "SEC"))
1174 max_time
= atof(argus
[i
+ 1]);
1175 LOG_DEBUG("\tmax_time = %fs", max_time
);
1178 // ENDSTATE end_state
1179 if (((i
+ 2) <= num_of_argu
) && !strcmp(argus
[i
], "ENDSTATE"))
1181 i_tmp
= svf_find_string_in_array(argus
[i
+ 1], (char **)svf_tap_state_name
, dimof(svf_tap_state_name
));
1182 if (svf_tap_state_is_stable(i_tmp
))
1184 svf_para
.runtest_end_state
= i_tmp
;
1185 LOG_DEBUG("\tend_state = %s", svf_tap_state_name
[svf_para
.runtest_end_state
]);
1189 LOG_ERROR("%s is not valid state", svf_tap_state_name
[i_tmp
]);
1194 // calculate run_count
1195 if ((0 == run_count
) && (min_time
> 0))
1197 run_count
= min_time
* svf_para
.frequency
;
1199 // all parameter should be parsed
1200 if (i
== num_of_argu
)
1204 // run_state and end_state is checked to be stable state
1207 // enter into run_state if necessary
1208 if (last_state
!= svf_para
.runtest_run_state
)
1210 jtag_command_t
* cmd
= cmd_queue_alloc(sizeof(jtag_command_t
));
1212 jtag_queue_command(cmd
);
1214 cmd
->type
= JTAG_STATEMOVE
;
1215 cmd
->cmd
.statemove
= cmd_queue_alloc(sizeof(statemove_command_t
));
1216 cmd
->cmd
.statemove
->end_state
= svf_para
.runtest_run_state
;
1218 cmd_queue_end_state
= cmd_queue_cur_state
= cmd
->cmd
.statemove
->end_state
;
1221 // call jtag_add_clocks
1222 jtag_add_clocks(run_count
);
1224 if (svf_para
.runtest_end_state
!= svf_para
.runtest_run_state
)
1226 // move to end_state
1227 jtag_command_t
* cmd
= cmd_queue_alloc(sizeof(jtag_command_t
));
1229 jtag_queue_command(cmd
);
1230 cmd
->type
= JTAG_STATEMOVE
;
1231 cmd
->cmd
.statemove
= cmd_queue_alloc(sizeof(statemove_command_t
));
1232 cmd
->cmd
.statemove
->end_state
= svf_para
.runtest_end_state
;
1234 cmd_queue_end_state
= cmd_queue_cur_state
= cmd
->cmd
.statemove
->end_state
;
1236 last_state
= svf_para
.runtest_end_state
;
1238 if (svf_para
.runtest_run_state
!= TAP_IDLE
)
1240 // RUNTEST can only executed in TAP_IDLE
1241 LOG_ERROR("cannot runtest in %s state", svf_tap_state_name
[svf_para
.runtest_run_state
]);
1245 jtag_add_runtest(run_count
, svf_para
.runtest_end_state
);
1251 LOG_ERROR("fail to parse parameter of RUNTEST, %d out of %d is parsed", i
, num_of_argu
);
1256 // STATE [pathstate1 [pathstate2 ...[pathstaten]]] stable_state
1257 if (num_of_argu
< 2)
1259 LOG_ERROR("invalid parameter of %s", argus
[0]);
1262 if (num_of_argu
> 2)
1264 // STATE pathstate1 ... stable_state
1265 path
= (tap_state_t
*)malloc((num_of_argu
- 1) * sizeof(tap_state_t
));
1268 LOG_ERROR("not enough memory");
1271 num_of_argu
--; // num of path
1272 i_tmp
= 1; // path is from patameter 1
1273 for (i
= 0; i
< num_of_argu
; i
++)
1275 path
[i
] = svf_find_string_in_array(argus
[i_tmp
++], (char **)svf_tap_state_name
, dimof(svf_tap_state_name
));
1276 if (!svf_tap_state_is_valid(path
[i
]))
1278 LOG_ERROR("%s is not valid state", svf_tap_state_name
[path
[i
]]);
1281 if (TAP_RESET
== path
[i
])
1285 jtag_add_pathmove(i
, path
);
1288 num_of_argu
-= i
+ 1;
1292 if (num_of_argu
> 0)
1294 // execute last path if necessary
1295 if (svf_tap_state_is_stable(path
[num_of_argu
- 1]))
1297 // last state MUST be stable state
1298 // TODO: call path_move
1299 jtag_add_pathmove(num_of_argu
, path
);
1300 last_state
= path
[num_of_argu
- 1];
1301 LOG_DEBUG("\tmove to %s by path_move", svf_tap_state_name
[path
[num_of_argu
- 1]]);
1305 LOG_ERROR("%s is not valid state", svf_tap_state_name
[path
[num_of_argu
- 1]]);
1309 // no need to keep this memory, in jtag_add_pathmove, path will be duplicated
1318 // STATE stable_state
1319 state
= svf_find_string_in_array(argus
[1], (char **)svf_tap_state_name
, dimof(svf_tap_state_name
));
1320 if (svf_tap_state_is_stable(state
))
1322 // TODO: move to state
1323 jtag_command_t
* cmd
= cmd_queue_alloc(sizeof(jtag_command_t
));
1325 jtag_queue_command(cmd
);
1327 cmd
->type
= JTAG_STATEMOVE
;
1328 cmd
->cmd
.statemove
= cmd_queue_alloc(sizeof(statemove_command_t
));
1329 cmd
->cmd
.statemove
->end_state
= state
;
1331 cmd_queue_end_state
= cmd_queue_cur_state
= cmd
->cmd
.statemove
->end_state
;
1334 LOG_DEBUG("\tmove to %s by state_move", svf_tap_state_name
[state
]);
1338 LOG_ERROR("%s is not valid state", svf_tap_state_name
[state
]);
1345 if (num_of_argu
!= 2)
1347 LOG_ERROR("invalid parameter of %s", argus
[0]);
1350 if (svf_para
.trst_mode
!= TRST_ABSENT
)
1352 if (ERROR_OK
!= svf_execute_tap())
1356 i_tmp
= svf_find_string_in_array(argus
[1], (char **)svf_trst_mode_name
, dimof(svf_trst_mode_name
));
1360 last_state
= TAP_RESET
;
1361 jtag_add_reset(1, 0);
1365 jtag_add_reset(0, 0);
1370 LOG_ERROR("unknown TRST mode: %s", argus
[1]);
1373 svf_para
.trst_mode
= i_tmp
;
1374 LOG_DEBUG("\ttrst_mode = %s", svf_trst_mode_name
[svf_para
.trst_mode
]);
1378 LOG_ERROR("can not accpet TRST command if trst_mode is ABSENT");
1383 LOG_ERROR("invalid svf command: %s", argus
[0]);
1388 if (debug_level
>= LOG_LVL_DEBUG
)
1390 // for convenient debugging, execute tap if possible
1391 if ((svf_buffer_index
> 0) && \
1392 (((command
!= STATE
) && (command
!= RUNTEST
)) || \
1393 ((command
== STATE
) && (num_of_argu
== 2))))
1395 if (ERROR_OK
!= svf_execute_tap())
1400 // output debug info
1401 if ((SIR
== command
) || (SDR
== command
))
1404 memcpy(&read_value
, svf_tdi_buffer
, sizeof(int));
1405 // in debug mode, data is from index 0
1406 int read_mask
= (1 << (svf_check_tdo_para
[0].bit_len
)) - 1;
1407 LOG_DEBUG("\tTDO read = 0x%X", read_value
& read_mask
);
1413 // for fast executing, execute tap if necessary
1414 // half of the buffer is for the next command
1415 if (((svf_buffer_index
>= SVF_MAX_BUFFER_SIZE_TO_COMMIT
) || (svf_check_tdo_para_index
>= SVF_CHECK_TDO_PARA_SIZE
/ 2)) && \
1416 (((command
!= STATE
) && (command
!= RUNTEST
)) || \
1417 ((command
== STATE
) && (num_of_argu
== 2))))
1419 return svf_execute_tap();
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)