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) 2008 Richard Missenden *
9 * richard.missenden@googlemail.com *
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, write to the *
23 * Free Software Foundation, Inc., *
24 * 59 Temple Place - Suite 330, Boston, MA 02111-1307, USA. *
25 ***************************************************************************/
32 #include <jtag/driver.h>
33 #include <jtag/jtag.h>
34 #include <helper/ioutil.h>
35 #include <helper/configuration.h>
36 #include <xsvf/xsvf.h>
38 #include <flash/nor/core.h>
39 #include <flash/nand/core.h>
41 #include <flash/mflash.h>
43 #include <server/server.h>
44 #include <server/gdb_server.h>
45 #include <server/httpd.h>
52 #define OPENOCD_VERSION \
53 "Open On-Chip Debugger " VERSION RELSTR " (" PKGBLDDATE ")"
55 /* Give TELNET a way to find out what version this is */
56 COMMAND_HANDLER(handle_version_command
)
59 return ERROR_COMMAND_SYNTAX_ERROR
;
61 command_print(CMD_CTX
, OPENOCD_VERSION
);
66 static int log_target_callback_event_handler(struct target
*target
, enum target_event event
, void *priv
)
70 case TARGET_EVENT_GDB_START
:
73 case TARGET_EVENT_GDB_END
:
76 case TARGET_EVENT_HALTED
:
79 /* do not display information when debugger caused the halt */
80 target_arch_state(target
);
90 static bool init_at_startup
= true;
92 COMMAND_HANDLER(handle_noinit_command
)
95 return ERROR_COMMAND_SYNTAX_ERROR
;
96 init_at_startup
= false;
100 /* OpenOCD can't really handle failure of this command. Patches welcome! :-) */
101 COMMAND_HANDLER(handle_init_command
)
105 return ERROR_COMMAND_SYNTAX_ERROR
;
108 static int initialized
= 0;
114 retval
= command_run_line(CMD_CTX
, "target init");
115 if (ERROR_OK
!= retval
)
118 if ((retval
= adapter_init(CMD_CTX
)) != ERROR_OK
)
120 /* we must be able to set up the debug adapter */
123 LOG_DEBUG("Debug Adapter init complete");
125 /* Try to initialize & examine the JTAG chain at this point,
126 * but continue startup regardless. Note that platforms
127 * need to be able to provide JTAG event handlers that use
128 * a variety of JTAG operations in order to do that...
130 command_context_mode(CMD_CTX
, COMMAND_EXEC
);
131 if (command_run_line(CMD_CTX
, "jtag init") == ERROR_OK
)
133 LOG_DEBUG("Examining targets...");
134 if (target_examine() != ERROR_OK
)
135 LOG_DEBUG("target examination failed");
138 LOG_WARNING("jtag initialization failed; try 'jtag init' again.");
139 command_context_mode(CMD_CTX
, COMMAND_CONFIG
);
141 if (command_run_line(CMD_CTX
, "flash init") != ERROR_OK
)
144 if (command_run_line(CMD_CTX
, "mflash init") != ERROR_OK
)
147 if (command_run_line(CMD_CTX
, "nand init") != ERROR_OK
)
150 if (command_run_line(CMD_CTX
, "pld init") != ERROR_OK
)
152 command_context_mode(CMD_CTX
, COMMAND_EXEC
);
154 /* initialize telnet subsystem */
155 gdb_target_add_all(all_targets
);
157 target_register_event_callback(log_target_callback_event_handler
, CMD_CTX
);
162 static const struct command_registration openocd_command_handlers
[] = {
165 .handler
= &handle_version_command
,
167 .help
= "show program version",
171 .handler
= &handle_noinit_command
,
172 .mode
= COMMAND_CONFIG
,
173 .help
= "Prevent 'init' from being called at startup.",
177 .handler
= &handle_init_command
,
179 .help
= "Initializes configured targets and servers. "
180 "Changes command mode from CONFIG to EXEC. "
181 "Unless 'noinit' is called, this command is "
182 "called automatically at the end of startup.",
185 COMMAND_REGISTRATION_DONE
188 int openocd_register_commands(struct command_context
*cmd_ctx
)
190 return register_commands(cmd_ctx
, NULL
, openocd_command_handlers
);
193 struct command_context
*global_cmd_ctx
;
195 /* NB! this fn can be invoked outside this file for non PC hosted builds */
196 struct command_context
*setup_command_handler(Jim_Interp
*interp
)
199 LOG_DEBUG("log_init: complete");
201 const char *startup
= openocd_startup_tcl
;
202 struct command_context
*cmd_ctx
= command_init(startup
, interp
);
204 /* register subsystem commands */
205 typedef int (*command_registrant_t
)(struct command_context
*cmd_ctx
);
206 static const command_registrant_t command_registrants
[] = {
207 &openocd_register_commands
,
208 &server_register_commands
,
209 &gdb_register_commands
,
210 &log_register_commands
,
211 &interface_register_commands
,
212 &jtag_register_commands
,
213 &xsvf_register_commands
,
214 &svf_register_commands
,
215 &target_register_commands
,
216 &flash_register_commands
,
217 &nand_register_commands
,
218 &pld_register_commands
,
219 &mflash_register_commands
,
222 for (unsigned i
= 0; NULL
!= command_registrants
[i
]; i
++)
224 int retval
= (*command_registrants
[i
])(cmd_ctx
);
225 if (ERROR_OK
!= retval
)
227 command_done(cmd_ctx
);
231 LOG_DEBUG("command registration: complete");
233 LOG_OUTPUT(OPENOCD_VERSION
"\n"
234 "Licensed under GNU GPL v2\n");
236 global_cmd_ctx
= cmd_ctx
;
241 /* normally this is the main() function entry, but if OpenOCD is linked
242 * into application, then this fn will not be invoked, but rather that
243 * application will have it's own implementation of main(). */
244 int openocd_main(int argc
, char *argv
[])
248 /* initialize commandline interface */
249 struct command_context
*cmd_ctx
;
251 cmd_ctx
= setup_command_handler(NULL
);
253 if (ioutil_init(cmd_ctx
) != ERROR_OK
)
256 LOG_OUTPUT("For bug reports, read\n\t"
257 "http://openocd.berlios.de/doc/doxygen/bugs.html"
260 command_context_mode(cmd_ctx
, COMMAND_CONFIG
);
261 command_set_output_handler(cmd_ctx
, configuration_output_handler
, NULL
);
263 if (parse_cmdline_args(cmd_ctx
, argc
, argv
) != ERROR_OK
)
266 if (server_preinit() != ERROR_OK
)
269 ret
= parse_config_file(cmd_ctx
);
273 if (httpd_start(cmd_ctx
) != ERROR_OK
)
276 ret
= server_init(cmd_ctx
);
282 ret
= command_run_line(cmd_ctx
, "init");
287 /* handle network connections */
289 server_loop(cmd_ctx
);
295 unregister_all_commands(cmd_ctx
, NULL
);
297 /* free commandline interface */
298 command_done(cmd_ctx
);