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, see <http://www.gnu.org/licenses/>. *
27 ***************************************************************************/
33 #include <jtag/jtag.h>
36 struct cmd_queue_page {
37 struct cmd_queue_page *next;
42 #define CMD_QUEUE_PAGE_SIZE (1024 * 1024)
43 static struct cmd_queue_page *cmd_queue_pages;
44 static struct cmd_queue_page *cmd_queue_pages_tail;
46 struct jtag_command *jtag_command_queue;
47 static struct jtag_command **next_command_pointer = &jtag_command_queue;
49 void jtag_queue_command(struct jtag_command *cmd)
51 /* this command goes on the end, so ensure the queue terminates */
54 struct jtag_command **last_cmd = next_command_pointer;
55 assert(NULL != last_cmd);
56 assert(NULL == *last_cmd);
59 /* store location where the next command pointer will be stored */
60 next_command_pointer = &cmd->next;
63 void *cmd_queue_alloc(size_t size)
65 struct cmd_queue_page **p_page = &cmd_queue_pages;
71 * We align/round the *SIZE* per below
72 * so that all pointers returned by
73 * this function are reasonably well
76 * If we did not, then an "odd-length" request would cause the
77 * *next* allocation to be at an *odd* address, and because
78 * this function has the same type of api as malloc() - we
79 * must also return pointers that have the same type of
82 * What I do not/have is a reasonable portable means
85 * The solution here, is based on these suggestions.
86 * http://gcc.gnu.org/ml/gcc-help/2008-12/msg00041.html
89 union worse_case_align {
95 #define ALIGN_SIZE (sizeof(union worse_case_align))
97 /* The alignment process. */
98 size = (size + ALIGN_SIZE - 1) & (~(ALIGN_SIZE - 1));
102 p_page = &cmd_queue_pages_tail;
103 if (CMD_QUEUE_PAGE_SIZE - (*p_page)->used < size)
104 p_page = &((*p_page)->next);
108 *p_page = malloc(sizeof(struct cmd_queue_page));
110 size_t alloc_size = (size < CMD_QUEUE_PAGE_SIZE) ?
111 CMD_QUEUE_PAGE_SIZE : size;
112 (*p_page)->address = malloc(alloc_size);
113 (*p_page)->next = NULL;
114 cmd_queue_pages_tail = *p_page;
117 offset = (*p_page)->used;
118 (*p_page)->used += size;
120 t = (*p_page)->address;
124 static void cmd_queue_free(void)
126 struct cmd_queue_page *page = cmd_queue_pages;
129 struct cmd_queue_page *last = page;
135 cmd_queue_pages = NULL;
136 cmd_queue_pages_tail = NULL;
139 void jtag_command_queue_reset(void)
143 jtag_command_queue = NULL;
144 next_command_pointer = &jtag_command_queue;
147 enum scan_type jtag_scan_type(const struct scan_command *cmd)
152 for (i = 0; i < cmd->num_fields; i++) {
153 if (cmd->fields[i].in_value)
155 if (cmd->fields[i].out_value)
162 int jtag_scan_size(const struct scan_command *cmd)
167 /* count bits in scan command */
168 for (i = 0; i < cmd->num_fields; i++)
169 bit_count += cmd->fields[i].num_bits;
174 int jtag_build_buffer(const struct scan_command *cmd, uint8_t **buffer)
179 bit_count = jtag_scan_size(cmd);
180 *buffer = calloc(1, DIV_ROUND_UP(bit_count, 8));
184 DEBUG_JTAG_IO("%s num_fields: %i",
185 cmd->ir_scan ? "IRSCAN" : "DRSCAN",
188 for (i = 0; i < cmd->num_fields; i++) {
189 if (cmd->fields[i].out_value) {
190 #ifdef _DEBUG_JTAG_IO_
191 char *char_buf = buf_to_str(cmd->fields[i].out_value,
192 (cmd->fields[i].num_bits > DEBUG_JTAG_IOZ)
194 : cmd->fields[i].num_bits, 16);
196 LOG_DEBUG("fields[%i].out_value[%i]: 0x%s", i,
197 cmd->fields[i].num_bits, char_buf);
200 buf_set_buf(cmd->fields[i].out_value, 0, *buffer,
201 bit_count, cmd->fields[i].num_bits);
203 DEBUG_JTAG_IO("fields[%i].out_value[%i]: NULL",
204 i, cmd->fields[i].num_bits);
207 bit_count += cmd->fields[i].num_bits;
210 /*DEBUG_JTAG_IO("bit_count totalling: %i", bit_count); */
215 int jtag_read_buffer(uint8_t *buffer, const struct scan_command *cmd)
221 /* we return ERROR_OK, unless a check fails, or a handler reports a problem */
224 for (i = 0; i < cmd->num_fields; i++) {
225 /* if neither in_value nor in_handler
226 * are specified we don't have to examine this field
228 if (cmd->fields[i].in_value) {
229 int num_bits = cmd->fields[i].num_bits;
230 uint8_t *captured = buf_set_buf(buffer, bit_count,
231 malloc(DIV_ROUND_UP(num_bits, 8)), 0, num_bits);
233 #ifdef _DEBUG_JTAG_IO_
234 char *char_buf = buf_to_str(captured,
235 (num_bits > DEBUG_JTAG_IOZ)
239 LOG_DEBUG("fields[%i].in_value[%i]: 0x%s",
240 i, num_bits, char_buf);
244 if (cmd->fields[i].in_value)
245 buf_cpy(captured, cmd->fields[i].in_value, num_bits);
249 bit_count += cmd->fields[i].num_bits;