1 /***************************************************************************
2 * Copyright (C) 2005 by Dominic Rath *
3 * Dominic.Rath@gmx.de *
5 * Copyright (C) 2007,2008 Øyvind Harboe *
6 * oyvind.harboe@zylin.com *
8 * Copyright (C) 2009 Zachary T Welch *
9 * zw@superlucidity.net *
11 * This program is free software; you can redistribute it and/or modify *
12 * it under the terms of the GNU General Public License as published by *
13 * the Free Software Foundation; either version 2 of the License, or *
14 * (at your option) any later version. *
16 * This program is distributed in the hope that it will be useful, *
17 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
18 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
19 * GNU General Public License for more details. *
21 * You should have received a copy of the GNU General Public License *
22 * along with this program. If not, see <http://www.gnu.org/licenses/>. *
23 ***************************************************************************/
25 #ifndef OPENOCD_JTAG_COMMANDS_H
26 #define OPENOCD_JTAG_COMMANDS_H
29 * The inferred type of a scan_command_s structure, indicating whether
30 * the command has the host scan in from the device, the host scan out
31 * to the device, or both.
34 /** From device to host, */
36 /** From host to device, */
38 /** Full-duplex scan. */
43 * The scan_command provide a means of encapsulating a set of scan_field_s
44 * structures that should be scanned in/out to the device.
47 /** instruction/not data scan */
49 /** number of fields in *fields array */
51 /** pointer to an array of data scan fields */
52 struct scan_field
*fields
;
53 /** state in which JTAG commands should finish */
54 tap_state_t end_state
;
57 struct statemove_command
{
58 /** state in which JTAG commands should finish */
59 tap_state_t end_state
;
62 struct pathmove_command
{
63 /** number of states in *path */
65 /** states that have to be passed */
69 struct runtest_command
{
70 /** number of cycles to spend in Run-Test/Idle state */
72 /** state in which JTAG commands should finish */
73 tap_state_t end_state
;
77 struct stableclocks_command
{
78 /** number of clock cycles that should be sent */
83 struct reset_command
{
84 /** Set TRST output: 0 = deassert, 1 = assert, -1 = no change */
86 /** Set SRST output: 0 = deassert, 1 = assert, -1 = no change */
90 struct end_state_command
{
91 /** state in which JTAG commands should finish */
92 tap_state_t end_state
;
95 struct sleep_command
{
96 /** number of microseconds to sleep */
101 * Encapsulates a series of bits to be clocked out, affecting state
102 * and mode of the interface.
104 * In JTAG mode these are clocked out on TMS, using TCK. They may be
105 * used for link resets, transitioning between JTAG and SWD modes, or
106 * to implement JTAG state machine transitions (implementing pathmove
107 * or statemove operations).
109 * In SWD mode these are clocked out on SWDIO, using SWCLK, and are
110 * used for link resets and transitioning between SWD and JTAG modes.
113 /** How many bits should be clocked out. */
115 /** The bits to clock out; the LSB is bit 0 of bits[0]. */
120 * Defines a container type that hold a pointer to a JTAG command
121 * structure of any defined type.
123 union jtag_command_container
{
124 struct scan_command
*scan
;
125 struct statemove_command
*statemove
;
126 struct pathmove_command
*pathmove
;
127 struct runtest_command
*runtest
;
128 struct stableclocks_command
*stableclocks
;
129 struct reset_command
*reset
;
130 struct end_state_command
*end_state
;
131 struct sleep_command
*sleep
;
132 struct tms_command
*tms
;
136 * The type of the @c jtag_command_container contained by a
137 * @c jtag_command_s structure.
139 enum jtag_command_type
{
141 /* JTAG_TLR_RESET's non-minidriver implementation is a
142 * vestige from a statemove cmd. The statemove command
143 * is obsolete and replaced by pathmove.
145 * pathmove does not support reset as one of it's states,
146 * hence the need for an explicit statemove command.
153 JTAG_STABLECLOCKS
= 8,
157 struct jtag_command
{
158 union jtag_command_container cmd
;
159 enum jtag_command_type type
;
160 struct jtag_command
*next
;
163 /** The current queue of jtag_command_s structures. */
164 extern struct jtag_command
*jtag_command_queue
;
166 void *cmd_queue_alloc(size_t size
);
168 void jtag_queue_command(struct jtag_command
*cmd
);
169 void jtag_command_queue_reset(void);
171 enum scan_type
jtag_scan_type(const struct scan_command
*cmd
);
172 int jtag_scan_size(const struct scan_command
*cmd
);
173 int jtag_read_buffer(uint8_t *buffer
, const struct scan_command
*cmd
);
174 int jtag_build_buffer(const struct scan_command
*cmd
, uint8_t **buffer
);
176 #endif /* OPENOCD_JTAG_COMMANDS_H */
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)