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 SoftPLC Corporation *
12 * Copyright (C) 2009 Zachary T Welch *
13 * zw@superlucidity.net *
15 * This program is free software; you can redistribute it and/or modify *
16 * it under the terms of the GNU General Public License as published by *
17 * the Free Software Foundation; either version 2 of the License, or *
18 * (at your option) any later version. *
20 * This program is distributed in the hope that it will be useful, *
21 * but WITHOUT ANY WARRANTY; without even the implied warranty of *
22 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the *
23 * GNU General Public License for more details. *
25 * You should have received a copy of the GNU General Public License *
26 * along with this program; if not, write to the *
27 * Free Software Foundation, Inc., *
28 * 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. *
29 ***************************************************************************/
35 #include <jtag/jtag.h>
38 struct cmd_queue_page {
39 struct cmd_queue_page *next;
44 #define CMD_QUEUE_PAGE_SIZE (1024 * 1024)
45 static struct cmd_queue_page *cmd_queue_pages;
46 static struct cmd_queue_page *cmd_queue_pages_tail;
48 struct jtag_command *jtag_command_queue;
49 static struct jtag_command **next_command_pointer = &jtag_command_queue;
51 void jtag_queue_command(struct jtag_command *cmd)
53 /* this command goes on the end, so ensure the queue terminates */
56 struct jtag_command **last_cmd = next_command_pointer;
57 assert(NULL != last_cmd);
58 assert(NULL == *last_cmd);
61 /* store location where the next command pointer will be stored */
62 next_command_pointer = &cmd->next;
65 void *cmd_queue_alloc(size_t size)
67 struct cmd_queue_page **p_page = &cmd_queue_pages;
73 * We align/round the *SIZE* per below
74 * so that all pointers returned by
75 * this function are reasonably well
78 * If we did not, then an "odd-length" request would cause the
79 * *next* allocation to be at an *odd* address, and because
80 * this function has the same type of api as malloc() - we
81 * must also return pointers that have the same type of
84 * What I do not/have is a reasonable portable means
87 * The solution here, is based on these suggestions.
88 * http://gcc.gnu.org/ml/gcc-help/2008-12/msg00041.html
91 union worse_case_align {
97 #define ALIGN_SIZE (sizeof(union worse_case_align))
99 /* The alignment process. */
100 size = (size + ALIGN_SIZE - 1) & (~(ALIGN_SIZE - 1));
104 p_page = &cmd_queue_pages_tail;
105 if (CMD_QUEUE_PAGE_SIZE - (*p_page)->used < size)
106 p_page = &((*p_page)->next);
110 *p_page = malloc(sizeof(struct cmd_queue_page));
112 size_t alloc_size = (size < CMD_QUEUE_PAGE_SIZE) ?
113 CMD_QUEUE_PAGE_SIZE : size;
114 (*p_page)->address = malloc(alloc_size);
115 (*p_page)->next = NULL;
116 cmd_queue_pages_tail = *p_page;
119 offset = (*p_page)->used;
120 (*p_page)->used += size;
122 t = (*p_page)->address;
126 static void cmd_queue_free(void)
128 struct cmd_queue_page *page = cmd_queue_pages;
131 struct cmd_queue_page *last = page;
137 cmd_queue_pages = NULL;
138 cmd_queue_pages_tail = NULL;
141 void jtag_command_queue_reset(void)
145 jtag_command_queue = NULL;
146 next_command_pointer = &jtag_command_queue;
149 enum scan_type jtag_scan_type(const struct scan_command *cmd)
154 for (i = 0; i < cmd->num_fields; i++) {
155 if (cmd->fields[i].in_value)
157 if (cmd->fields[i].out_value)
164 int jtag_scan_size(const struct scan_command *cmd)
169 /* count bits in scan command */
170 for (i = 0; i < cmd->num_fields; i++)
171 bit_count += cmd->fields[i].num_bits;
176 int jtag_build_buffer(const struct scan_command *cmd, uint8_t **buffer)
181 bit_count = jtag_scan_size(cmd);
182 *buffer = calloc(1, DIV_ROUND_UP(bit_count, 8));
186 DEBUG_JTAG_IO("%s num_fields: %i",
187 cmd->ir_scan ? "IRSCAN" : "DRSCAN",
190 for (i = 0; i < cmd->num_fields; i++) {
191 if (cmd->fields[i].out_value) {
192 #ifdef _DEBUG_JTAG_IO_
193 char *char_buf = buf_to_str(cmd->fields[i].out_value,
194 (cmd->fields[i].num_bits > DEBUG_JTAG_IOZ)
196 : cmd->fields[i].num_bits, 16);
198 LOG_DEBUG("fields[%i].out_value[%i]: 0x%s", i,
199 cmd->fields[i].num_bits, char_buf);
202 buf_set_buf(cmd->fields[i].out_value, 0, *buffer,
203 bit_count, cmd->fields[i].num_bits);
205 DEBUG_JTAG_IO("fields[%i].out_value[%i]: NULL",
206 i, cmd->fields[i].num_bits);
209 bit_count += cmd->fields[i].num_bits;
212 /*DEBUG_JTAG_IO("bit_count totalling: %i", bit_count); */
217 int jtag_read_buffer(uint8_t *buffer, const struct scan_command *cmd)
223 /* we return ERROR_OK, unless a check fails, or a handler reports a problem */
226 for (i = 0; i < cmd->num_fields; i++) {
227 /* if neither in_value nor in_handler
228 * are specified we don't have to examine this field
230 if (cmd->fields[i].in_value) {
231 int num_bits = cmd->fields[i].num_bits;
232 uint8_t *captured = buf_set_buf(buffer, bit_count,
233 malloc(DIV_ROUND_UP(num_bits, 8)), 0, num_bits);
235 #ifdef _DEBUG_JTAG_IO_
236 char *char_buf = buf_to_str(captured,
237 (num_bits > DEBUG_JTAG_IOZ)
241 LOG_DEBUG("fields[%i].in_value[%i]: 0x%s",
242 i, num_bits, char_buf);
246 if (cmd->fields[i].in_value)
247 buf_cpy(captured, cmd->fields[i].in_value, num_bits);
251 bit_count += cmd->fields[i].num_bits;