1 /***************************************************************************
2 * Copyright (C) 2007 by Benedikt Sauter sauter@ixbat.de *
3 * based on Dominic Rath's amt_jtagaccel.c *
5 * usbprog is a free programming adapter. You can easily install *
6 * different firmware versions from an "online pool" over USB. *
7 * The adapter can be used for programming and debugging AVR and ARM *
8 * processors, as USB to RS232 converter, as JTAG interface or as *
9 * simple I/O interface (5 lines). *
11 * http://www.embedded-projects.net/usbprog *
13 * This program is free software; you can redistribute it and/or modify *
14 * it under the terms of the GNU General Public License as published by *
15 * the Free Software Foundation; either version 2 of the License, or *
16 * (at your option) any later version. *
18 * This program is distributed in the hope that it will be useful, *
19 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
20 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
21 * GNU General Public License for more details. *
23 * You should have received a copy of the GNU General Public License *
24 * along with this program; if not, write to the *
25 * Free Software Foundation, Inc., *
26 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
27 ***************************************************************************/
33 #include "replacements.h"
51 int usbprog_execute_queue(void);
52 int usbprog_speed(int speed
);
53 int usbprog_register_commands(struct command_context_s
*cmd_ctx
);
54 int usbprog_init(void);
55 int usbprog_quit(void);
58 void usbprog_end_state(enum tap_state state
);
59 void usbprog_state_move(void);
60 void usbprog_path_move(pathmove_command_t
*cmd
);
61 void usbprog_runtest(int num_cycles
);
62 void usbprog_scan(int ir_scan
, enum scan_type type
, u8
*buffer
, int scan_size
);
64 jtag_interface_t usbprog_interface
=
67 .execute_queue
= usbprog_execute_queue
,
68 .support_pathmove
= 0,
69 .speed
= usbprog_speed
,
70 .register_commands
= usbprog_register_commands
,
75 #define UNKOWN_COMMAND 0x00
76 #define PORT_DIRECTION 0x01
79 #define PORT_SETBIT 0x04
80 #define PORT_GETBIT 0x05
81 #define WRITE_TDI 0x06
83 #define WRITE_AND_READ 0x08
84 #define WRITE_TMS 0x09
85 #define WRITE_TMS_CHAIN 0x0A
89 struct usb_dev_handle
* usb_handle
;
92 struct usbprog_jtag
* usbprog_jtag_handle
;
94 struct usbprog_jtag
* usbprog_jtag_open();
95 void usbprog_jtag_close(struct usbprog_jtag
*usbprog_jtag
);
96 void usbprog_jtag_init(struct usbprog_jtag
*usbprog_jtag
);
97 unsigned char usbprog_jtag_message(struct usbprog_jtag
*usbprog_jtag
, char *msg
, int msglen
);
100 void usbprog_jtag_read_tdo(struct usbprog_jtag
*usbprog_jtag
, char * buffer
, int size
);
101 void usbprog_jtag_write_tdi(struct usbprog_jtag
*usbprog_jtag
, char * buffer
, int size
);
102 void usbprog_jtag_write_and_read(struct usbprog_jtag
*usbprog_jtag
, char * buffer
, int size
);
103 void usbprog_jtag_write_tms(struct usbprog_jtag
*usbprog_jtag
, char tms_scan
);
107 void usbprog_jtag_tms_collect(char tms_scan
);
108 void usbprog_jtag_tms_send(struct usbprog_jtag
*usbprog_jtag
);
110 void usbprog_write(int tck
, int tms
, int tdi
);
111 void usbprog_reset(int trst
, int srst
);
113 void usbprog_jtag_set_direction(struct usbprog_jtag
*usbprog_jtag
, unsigned char direction
);
114 void usbprog_jtag_write_slice(struct usbprog_jtag
*usbprog_jtag
,unsigned char value
);
115 unsigned char usbprog_jtag_get_port(struct usbprog_jtag
*usbprog_jtag
);
116 void usbprog_jtag_set_bit(struct usbprog_jtag
*usbprog_jtag
,int bit
, int value
);
117 int usbprog_jtag_get_bit(struct usbprog_jtag
*usbprog_jtag
, int bit
);
119 int usbprog_speed(int speed
)
124 int usbprog_register_commands(struct command_context_s
*cmd_ctx
)
130 int usbprog_execute_queue(void)
132 jtag_command_t
*cmd
= jtag_command_queue
; /* currently processed command */
142 #ifdef _DEBUG_JTAG_IO_
143 DEBUG("end_state: %i", cmd
->cmd
.end_state
->end_state
);
145 if (cmd
->cmd
.end_state
->end_state
!= -1)
146 usbprog_end_state(cmd
->cmd
.end_state
->end_state
);
149 #ifdef _DEBUG_JTAG_IO_
150 DEBUG("reset trst: %i srst %i", cmd
->cmd
.reset
->trst
, cmd
->cmd
.reset
->srst
);
152 if (cmd
->cmd
.reset
->trst
== 1)
156 usbprog_reset(cmd
->cmd
.reset
->trst
, cmd
->cmd
.reset
->srst
);
159 #ifdef _DEBUG_JTAG_IO_
160 DEBUG("runtest %i cycles, end in %i", cmd
->cmd
.runtest
->num_cycles
, cmd
->cmd
.runtest
->end_state
);
162 if (cmd
->cmd
.runtest
->end_state
!= -1)
163 usbprog_end_state(cmd
->cmd
.runtest
->end_state
);
164 usbprog_runtest(cmd
->cmd
.runtest
->num_cycles
);
167 #ifdef _DEBUG_JTAG_IO_
168 DEBUG("statemove end in %i", cmd
->cmd
.statemove
->end_state
);
170 if (cmd
->cmd
.statemove
->end_state
!= -1)
171 usbprog_end_state(cmd
->cmd
.statemove
->end_state
);
172 usbprog_state_move();
175 #ifdef _DEBUG_JTAG_IO_
176 DEBUG("pathmove: %i states, end in %i", cmd
->cmd
.pathmove
->num_states
,
177 cmd
->cmd
.pathmove
->path
[cmd
->cmd
.pathmove
->num_states
- 1]);
179 usbprog_path_move(cmd
->cmd
.pathmove
);
182 #ifdef _DEBUG_JTAG_IO_
183 DEBUG("scan end in %i", cmd
->cmd
.scan
->end_state
);
185 if (cmd
->cmd
.scan
->end_state
!= -1)
186 usbprog_end_state(cmd
->cmd
.scan
->end_state
);
187 scan_size
= jtag_build_buffer(cmd
->cmd
.scan
, &buffer
);
188 type
= jtag_scan_type(cmd
->cmd
.scan
);
189 usbprog_scan(cmd
->cmd
.scan
->ir_scan
, type
, buffer
, scan_size
);
190 if (jtag_read_buffer(buffer
, cmd
->cmd
.scan
) != ERROR_OK
)
191 return ERROR_JTAG_QUEUE_FAILED
;
196 #ifdef _DEBUG_JTAG_IO_
197 DEBUG("sleep %i", cmd
->cmd
.sleep
->us
);
199 jtag_sleep(cmd
->cmd
.sleep
->us
);
202 ERROR("BUG: unknown JTAG command type encountered");
212 int usbprog_init(void)
214 usbprog_jtag_handle
= usbprog_jtag_open();
217 if(usbprog_jtag_handle
==0){
218 ERROR("Can't find USB JTAG Interface! Please check connection and permissions.");
219 return ERROR_JTAG_INIT_FAILED
;
222 INFO("USB JTAG Interface ready!");
224 usbprog_jtag_init(usbprog_jtag_handle
);
226 usbprog_write(0, 0, 0);
231 int usbprog_quit(void)
237 /*************** jtag execute commands **********************/
238 void usbprog_end_state(enum tap_state state
)
240 if (tap_move_map
[state
] != -1)
244 ERROR("BUG: %i is not a valid end state", state
);
250 void usbprog_state_move(void) {
253 u8 tms_scan
= TAP_MOVE(cur_state
, end_state
);
255 usbprog_jtag_write_tms(usbprog_jtag_handle
,(char)tms_scan
);
256 for (i
= 0; i
< 7; i
++)
258 tms
= (tms_scan
>> i
) & 1;
261 cur_state
= end_state
;
265 void usbprog_path_move(pathmove_command_t
*cmd
)
267 int num_states
= cmd
->num_states
;
273 if (tap_transitions
[cur_state
].low
== cmd
->path
[state_count
])
276 usbprog_write(0, 0, 0);
277 usbprog_write(1, 0, 0);
279 else if (tap_transitions
[cur_state
].high
== cmd
->path
[state_count
])
282 usbprog_write(0, 1, 0);
283 usbprog_write(1, 1, 0);
287 ERROR("BUG: %s -> %s isn't a valid TAP transition", tap_state_strings
[cur_state
], tap_state_strings
[cmd
->path
[state_count
]]);
291 cur_state
= cmd
->path
[state_count
];
296 end_state
= cur_state
;
300 void usbprog_runtest(int num_cycles
)
304 enum tap_state saved_end_state
= end_state
;
307 /* only do a state_move when we're not already in RTI */
308 if (cur_state
!= TAP_RTI
)
310 usbprog_end_state(TAP_RTI
);
311 usbprog_state_move();
314 /* execute num_cycles */
317 usbprog_write(0, 0, 0);
320 usbprog_jtag_tms_send(usbprog_jtag_handle
);
323 for (i
= 0; i
< num_cycles
; i
++)
325 usbprog_write(1, 0, 0);
326 usbprog_write(0, 0, 0);
329 /* finish in end_state */
331 usbprog_end_state(saved_end_state);
332 if (cur_state != end_state)
333 usbprog_state_move();
339 void usbprog_scan(int ir_scan
, enum scan_type type
, u8
*buffer
, int scan_size
)
341 enum tap_state saved_end_state
= end_state
;
345 usbprog_end_state(TAP_SI
);
347 usbprog_end_state(TAP_SD
);
349 usbprog_state_move();
350 usbprog_end_state(saved_end_state
);
352 usbprog_jtag_tms_send(usbprog_jtag_handle
);
354 if (type
== SCAN_OUT
) {
355 usbprog_jtag_write_tdi(usbprog_jtag_handle
,buffer
, scan_size
);
357 if (type
== SCAN_IN
) {
358 usbprog_jtag_read_tdo(usbprog_jtag_handle
,buffer
, scan_size
);
360 if (type
== SCAN_IO
) {
361 usbprog_jtag_write_and_read(usbprog_jtag_handle
,buffer
, scan_size
);
369 if (cur_state
!= end_state
)
370 usbprog_state_move();
373 /*************** jtag wrapper functions *********************/
375 void usbprog_write(int tck
, int tms
, int tdi
)
377 unsigned char output_value
=0x00;
380 output_value
|= (1<<TMS_BIT
);
382 output_value
|= (1<<TDI_BIT
);
384 output_value
|= (1<<TCK_BIT
);
386 usbprog_jtag_write_slice(usbprog_jtag_handle
,output_value
);
389 /* (1) assert or (0) deassert reset lines */
390 void usbprog_reset(int trst
, int srst
)
392 DEBUG("trst: %i, srst: %i", trst
, srst
);
395 usbprog_jtag_set_bit(usbprog_jtag_handle
,5,0);
397 usbprog_jtag_set_bit(usbprog_jtag_handle
,5,1);
400 usbprog_jtag_set_bit(usbprog_jtag_handle
,4,0);
402 usbprog_jtag_set_bit(usbprog_jtag_handle
,4,1);
407 /*************** jtag lowlevel functions ********************/
410 struct usbprog_jtag
* usbprog_jtag_open()
412 struct usb_bus
*busses
;
413 struct usb_dev_handle
* usb_handle
;
415 struct usb_device
*dev
;
417 struct usbprog_jtag
* tmp
;
419 tmp
= (struct usbprog_jtag
*)malloc(sizeof(struct usbprog_jtag
));
426 busses
= usb_get_busses();
428 /* find usbprog_jtag device in usb bus */
430 for (bus
= busses
; bus
; bus
= bus
->next
){
431 for (dev
= bus
->devices
; dev
; dev
= dev
->next
){
432 /* condition for sucessfully hit (too bad, I only check the vendor id)*/
433 if (dev
->descriptor
.idVendor
== VID
&& dev
->descriptor
.idProduct
== PID
) {
434 tmp
->usb_handle
= usb_open(dev
);
435 usb_set_configuration (tmp
->usb_handle
,dev
->config
[0].bConfigurationValue
);
436 usb_claim_interface(tmp
->usb_handle
, 0);
437 usb_set_altinterface(tmp
->usb_handle
,0);
446 void usbprog_jtag_close(struct usbprog_jtag
*usbprog_jtag
)
448 usb_close(usbprog_jtag
->usb_handle
);
453 unsigned char usbprog_jtag_message(struct usbprog_jtag
*usbprog_jtag
, char *msg
, int msglen
)
455 int res
= usb_bulk_write(usbprog_jtag
->usb_handle
,3,msg
,msglen
,100);
459 res
= usb_bulk_read(usbprog_jtag
->usb_handle
,0x82, msg
, 2, 100);
461 return (unsigned char)msg
[1];
470 void usbprog_jtag_init(struct usbprog_jtag
*usbprog_jtag
)
472 usbprog_jtag_set_direction(usbprog_jtag
, 0xFE);
476 void usbprog_jtag_write_and_read(struct usbprog_jtag
*usbprog_jtag
, char * buffer
, int size
)
478 char tmp
[64]; // fastes packet size for usb controller
479 int send_bits
,bufindex
=0,fillindex
=0,i
,j
,complete
=size
,loops
;
482 // 61 byte can be transfered (488 bit)
495 tmp
[0] = WRITE_AND_READ
;
496 tmp
[1] = (char)(send_bits
>>8); // high
497 tmp
[2] = (char)(send_bits
); // low
500 for(i
=0;i
< loops
;i
++) {
501 tmp
[3+i
]=buffer
[bufindex
];
505 usb_bulk_write(usbprog_jtag
->usb_handle
,3,tmp
,64,1000);
507 while(usb_bulk_read(usbprog_jtag
->usb_handle
,0x82, tmp
, 64, 1000) < 1);
509 for(i
=0;i
<loops
;i
++) {
511 buffer
[fillindex
++] = swap
;
517 void usbprog_jtag_read_tdo(struct usbprog_jtag
*usbprog_jtag
, char * buffer
, int size
)
519 char tmp
[64]; // fastes packet size for usb controller
520 int send_bits
,bufindex
=0,fillindex
=0,i
,j
,complete
=size
,loops
;
523 // 61 byte can be transfered (488 bit)
536 tmp
[0] = WRITE_AND_READ
;
537 tmp
[1] = (char)(send_bits
>>8); // high
538 tmp
[2] = (char)(send_bits
); // low
540 usb_bulk_write(usbprog_jtag
->usb_handle
,3,tmp
,3,1000);
542 while(usb_bulk_read(usbprog_jtag
->usb_handle
,0x82, tmp
, 64, 10) < 1);
544 for(i
=0;i
<loops
;i
++) {
546 buffer
[fillindex
++] = swap
;
551 void usbprog_jtag_write_tdi(struct usbprog_jtag
*usbprog_jtag
, char * buffer
, int size
)
553 char tmp
[64]; // fastes packet size for usb controller
554 int send_bits
,bufindex
=0,fillindex
=0,i
,j
,complete
=size
,loops
;
556 // 61 byte can be transfered (488 bit)
570 tmp
[1] = (char)(send_bits
>>8); // high
571 tmp
[2] = (char)(send_bits
); // low
574 for(i
=0;i
< loops
;i
++) {
575 tmp
[3+i
]=buffer
[bufindex
];
578 usb_bulk_write(usbprog_jtag
->usb_handle
,3,tmp
,64,1000);
583 void usbprog_jtag_write_tms(struct usbprog_jtag
*usbprog_jtag
, char tms_scan
)
585 usbprog_jtag_tms_collect(tms_scan
);
589 void usbprog_jtag_set_direction(struct usbprog_jtag
*usbprog_jtag
, unsigned char direction
)
592 tmp
[0] = PORT_DIRECTION
;
593 tmp
[1] = (char)direction
;
594 usbprog_jtag_message(usbprog_jtag
,tmp
,2);
597 void usbprog_jtag_write_slice(struct usbprog_jtag
*usbprog_jtag
,unsigned char value
)
601 tmp
[1] = (char)value
;
602 usbprog_jtag_message(usbprog_jtag
,tmp
,2);
605 unsigned char usbprog_jtag_get_port(struct usbprog_jtag
*usbprog_jtag
)
610 return usbprog_jtag_message(usbprog_jtag
,tmp
,2);
614 void usbprog_jtag_set_bit(struct usbprog_jtag
*usbprog_jtag
,int bit
, int value
)
617 tmp
[0] = PORT_SETBIT
;
623 usbprog_jtag_message(usbprog_jtag
,tmp
,3);
626 int usbprog_jtag_get_bit(struct usbprog_jtag
*usbprog_jtag
, int bit
)
629 tmp
[0] = PORT_GETBIT
;
632 if(usbprog_jtag_message(usbprog_jtag
,tmp
,2)>0)
638 void usbprog_jtag_tms_collect(char tms_scan
){
639 tms_chain
[tms_chain_index
]=tms_scan
;
643 void usbprog_jtag_tms_send(struct usbprog_jtag
*usbprog_jtag
){
645 if(tms_chain_index
>0) {
646 char tmp
[tms_chain_index
+2];
647 tmp
[0] = WRITE_TMS_CHAIN
;
648 tmp
[1] = (char)(tms_chain_index
);
649 for(i
=0;i
<tms_chain_index
+1;i
++)
650 tmp
[2+i
] = tms_chain
[i
];
651 usb_bulk_write(usbprog_jtag
->usb_handle
,3,tmp
,tms_chain_index
+2,1000);
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)