cortex_a8/a9: fix some comments
[openocd/ellerodev.git] / src / target / target_request.c
blobec3d48e2603f2f2fe4eaa36eeafaeaef726e79fa
1 /***************************************************************************
2 * Copyright (C) 2007 by Dominic Rath *
3 * Dominic.Rath@gmx.de *
4 * *
5 * Copyright (C) 2007,2008 Øyvind Harboe *
6 * oyvind.harboe@zylin.com *
7 * *
8 * Copyright (C) 2008 by Spencer Oliver *
9 * spen@spen-soft.co.uk *
10 * *
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. *
15 * *
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. *
20 * *
21 * You should have received a copy of the GNU General Public License *
22 * along with this program; if not, write to the *
23 * Free Software Foundation, Inc., *
24 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
25 ***************************************************************************/
26 #ifdef HAVE_CONFIG_H
27 #include "config.h"
28 #endif
30 #include <helper/log.h>
31 #include <helper/binarybuffer.h>
33 #include "target.h"
34 #include "target_request.h"
35 #include "target_type.h"
36 #include "trace.h"
39 static int charmsg_mode = 0;
41 static int target_asciimsg(struct target *target, uint32_t length)
43 char *msg = malloc(DIV_ROUND_UP(length + 1, 4) * 4);
44 struct debug_msg_receiver *c = target->dbgmsg;
46 target->type->target_request_data(target, DIV_ROUND_UP(length, 4), (uint8_t*)msg);
47 msg[length] = 0;
49 LOG_DEBUG("%s", msg);
51 while (c)
53 command_print(c->cmd_ctx, "%s", msg);
54 c = c->next;
57 return ERROR_OK;
60 static int target_charmsg(struct target *target, uint8_t msg)
62 LOG_USER_N("%c", msg);
64 return ERROR_OK;
67 static int target_hexmsg(struct target *target, int size, uint32_t length)
69 uint8_t *data = malloc(DIV_ROUND_UP(length * size, 4) * 4);
70 char line[128];
71 int line_len;
72 struct debug_msg_receiver *c = target->dbgmsg;
73 uint32_t i;
75 LOG_DEBUG("size: %i, length: %i", (int)size, (int)length);
77 target->type->target_request_data(target, DIV_ROUND_UP(length * size, 4), (uint8_t*)data);
79 line_len = 0;
80 for (i = 0; i < length; i++)
82 switch (size)
84 case 4:
85 line_len += snprintf(line + line_len, 128 - line_len, "%8.8" PRIx32 " ", le_to_h_u32(data + (4*i)));
86 break;
87 case 2:
88 line_len += snprintf(line + line_len, 128 - line_len, "%4.4x ", le_to_h_u16(data + (2*i)));
89 break;
90 case 1:
91 line_len += snprintf(line + line_len, 128 - line_len, "%2.2x ", data[i]);
92 break;
95 if ((i%8 == 7) || (i == length - 1))
97 LOG_DEBUG("%s", line);
99 while (c)
101 command_print(c->cmd_ctx, "%s", line);
102 c = c->next;
104 c = target->dbgmsg;
105 line_len = 0;
109 free(data);
111 return ERROR_OK;
114 /* handle requests from the target received by a target specific
115 * side-band channel (e.g. ARM7/9 DCC)
117 int target_request(struct target *target, uint32_t request)
119 target_req_cmd_t target_req_cmd = request & 0xff;
121 if (charmsg_mode) {
122 target_charmsg(target, target_req_cmd);
123 return ERROR_OK;
125 switch (target_req_cmd)
127 case TARGET_REQ_TRACEMSG:
128 trace_point(target, (request & 0xffffff00) >> 8);
129 break;
130 case TARGET_REQ_DEBUGMSG:
131 if (((request & 0xff00) >> 8) == 0)
133 target_asciimsg(target, (request & 0xffff0000) >> 16);
135 else
137 target_hexmsg(target, (request & 0xff00) >> 8, (request & 0xffff0000) >> 16);
139 break;
140 case TARGET_REQ_DEBUGCHAR:
141 target_charmsg(target, (request & 0x00ff0000) >> 16);
142 break;
143 /* case TARGET_REQ_SEMIHOSTING:
144 * break;
146 default:
147 LOG_ERROR("unknown target request: %2.2x", target_req_cmd);
148 break;
151 return ERROR_OK;
154 static int add_debug_msg_receiver(struct command_context *cmd_ctx, struct target *target)
156 struct debug_msg_receiver **p = &target->dbgmsg;
158 if (target == NULL)
159 return ERROR_INVALID_ARGUMENTS;
161 /* see if there's already a list */
162 if (*p)
164 /* find end of linked list */
165 p = &target->dbgmsg;
166 while ((*p)->next)
167 p = &((*p)->next);
168 p = &((*p)->next);
171 /* add new debug message receiver */
172 (*p) = malloc(sizeof(struct debug_msg_receiver));
173 (*p)->cmd_ctx = cmd_ctx;
174 (*p)->next = NULL;
176 /* enable callback */
177 target->dbg_msg_enabled = 1;
179 return ERROR_OK;
182 static struct debug_msg_receiver* find_debug_msg_receiver(struct command_context *cmd_ctx, struct target *target)
184 int do_all_targets = 0;
185 struct debug_msg_receiver **p = &target->dbgmsg;
187 /* if no target has been specified search all of them */
188 if (target == NULL)
190 /* if no targets haven been specified */
191 if (all_targets == NULL)
192 return NULL;
194 target = all_targets;
195 do_all_targets = 1;
200 while (*p)
202 if ((*p)->cmd_ctx == cmd_ctx)
204 return *p;
206 p = &((*p)->next);
209 target = target->next;
210 } while (target && do_all_targets);
212 return NULL;
215 int delete_debug_msg_receiver(struct command_context *cmd_ctx, struct target *target)
217 struct debug_msg_receiver **p;
218 struct debug_msg_receiver *c;
219 int do_all_targets = 0;
221 /* if no target has been specified search all of them */
222 if (target == NULL)
224 /* if no targets haven been specified */
225 if (all_targets == NULL)
226 return ERROR_OK;
228 target = all_targets;
229 do_all_targets = 1;
234 p = &target->dbgmsg;
235 c = *p;
236 while (c)
238 struct debug_msg_receiver *next = c->next;
239 if (c->cmd_ctx == cmd_ctx)
241 *p = next;
242 free(c);
243 if (*p == NULL)
245 /* disable callback */
246 target->dbg_msg_enabled = 0;
248 return ERROR_OK;
250 else
251 p = &(c->next);
252 c = next;
255 target = target->next;
256 } while (target && do_all_targets);
258 return ERROR_OK;
261 COMMAND_HANDLER(handle_target_request_debugmsgs_command)
263 struct target *target = get_current_target(CMD_CTX);
265 int receiving = 0;
267 /* see if reciever is already registered */
268 if (find_debug_msg_receiver(CMD_CTX, target) != NULL)
269 receiving = 1;
271 if (CMD_ARGC > 0)
273 if (!strcmp(CMD_ARGV[0], "enable") || !strcmp(CMD_ARGV[0], "charmsg"))
275 /* don't register if this command context is already receiving */
276 if (!receiving)
278 receiving = 1;
279 add_debug_msg_receiver(CMD_CTX, target);
281 charmsg_mode = !strcmp(CMD_ARGV[0], "charmsg");
283 else if (!strcmp(CMD_ARGV[0], "disable"))
285 /* no need to delete a receiver if none is registered */
286 if (receiving)
288 receiving = 0;
289 delete_debug_msg_receiver(CMD_CTX, target);
292 else
294 command_print(CMD_CTX, "usage: target_request debugmsgs ['enable'|'disable'|'charmsg']");
298 command_print(CMD_CTX, "receiving debug messages from current target %s",
299 (receiving) ? (charmsg_mode?"charmsg":"enabled") : "disabled");
300 return ERROR_OK;
303 static const struct command_registration target_req_exec_command_handlers[] = {
305 .name = "debugmsgs",
306 .handler = handle_target_request_debugmsgs_command,
307 .mode = COMMAND_EXEC,
308 .help = "display and/or modify reception of debug messages from target",
309 .usage = "['enable'|'charmsg'|'disable']",
311 COMMAND_REGISTRATION_DONE
313 static const struct command_registration target_req_command_handlers[] = {
315 .name = "target_request",
316 .mode = COMMAND_ANY,
317 .help = "target request command group",
318 .chain = target_req_exec_command_handlers,
320 COMMAND_REGISTRATION_DONE
323 int target_request_register_commands(struct command_context *cmd_ctx)
325 return register_commands(cmd_ctx, NULL, target_req_command_handlers);