1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
|
/***************************************************************************
* Copyright (C) 2005 by Dominic Rath *
* Dominic.Rath@gmx.de *
* *
* Copyright (C) 2007,2008 Øyvind Harboe *
* oyvind.harboe@zylin.com *
* *
* Copyright (C) 2009 Zachary T Welch *
* zw@superlucidity.net *
* *
* This program is free software; you can redistribute it and/or modify *
* it under the terms of the GNU General Public License as published by *
* the Free Software Foundation; either version 2 of the License, or *
* (at your option) any later version. *
* *
* This program is distributed in the hope that it will be useful, *
* but WITHOUT ANY WARRANTY; without even the implied warranty of *
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
* GNU General Public License for more details. *
* *
* You should have received a copy of the GNU General Public License *
* along with this program; if not, write to the *
* Free Software Foundation, Inc., *
* 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
***************************************************************************/
#ifndef JTAG_COMMANDS_H
#define JTAG_COMMANDS_H
#include "jtag.h"
/**
* The inferred type of a scan_command_s structure, indicating whether
* the command has the host scan in from the device, the host scan out
* to the device, or both.
*/
enum scan_type {
/// From device to host,
SCAN_IN = 1,
/// From host to device,
SCAN_OUT = 2,
/// Full-duplex scan.
SCAN_IO = 3
};
/**
* The scan_command provide a means of encapsulating a set of scan_field_s
* structures that should be scanned in/out to the device.
*/
struct scan_command {
/// instruction/not data scan
bool ir_scan;
/// number of fields in *fields array
int num_fields;
/// pointer to an array of data scan fields
struct scan_field* fields;
/// state in which JTAG commands should finish
tap_state_t end_state;
};
struct statemove_command {
/// state in which JTAG commands should finish
tap_state_t end_state;
};
struct pathmove_command {
/// number of states in *path
int num_states;
/// states that have to be passed
tap_state_t* path;
};
struct runtest_command {
/// number of cycles to spend in Run-Test/Idle state
int num_cycles;
/// state in which JTAG commands should finish
tap_state_t end_state;
};
struct stableclocks_command {
/// number of clock cycles that should be sent
int num_cycles;
};
struct reset_command {
/// Set TRST output: 0 = deassert, 1 = assert, -1 = no change
int trst;
/// Set SRST output: 0 = deassert, 1 = assert, -1 = no change
int srst;
};
struct end_state_command {
/// state in which JTAG commands should finish
tap_state_t end_state;
};
struct sleep_command {
/// number of microseconds to sleep
uint32_t us;
};
/**
* Defines a container type that hold a pointer to a JTAG command
* structure of any defined type.
*/
union jtag_command_container {
struct scan_command* scan;
struct statemove_command* statemove;
struct pathmove_command* pathmove;
struct runtest_command* runtest;
struct stableclocks_command* stableclocks;
struct reset_command* reset;
struct end_state_command* end_state;
struct sleep_command* sleep;
};
/**
* The type of the @c jtag_command_container contained by a
* @c jtag_command_s structure.
*/
enum jtag_command_type {
JTAG_SCAN = 1,
JTAG_STATEMOVE = 2,
JTAG_RUNTEST = 3,
JTAG_RESET = 4,
JTAG_PATHMOVE = 6,
JTAG_SLEEP = 7,
JTAG_STABLECLOCKS = 8
};
struct jtag_command {
union jtag_command_container cmd;
enum jtag_command_type type;
struct jtag_command *next;
};
/// The current queue of jtag_command_s structures.
extern struct jtag_command* jtag_command_queue;
void* cmd_queue_alloc(size_t size);
void cmd_queue_free(void);
void jtag_queue_command(struct jtag_command *cmd);
void jtag_command_queue_reset(void);
enum scan_type jtag_scan_type(const struct scan_command* cmd);
int jtag_scan_size(const struct scan_command* cmd);
int jtag_read_buffer(uint8_t* buffer, const struct scan_command* cmd);
int jtag_build_buffer(const struct scan_command* cmd, uint8_t** buffer);
#endif // JTAG_COMMANDS_H
|
