mspdebug/ui/main.c

494 lines
11 KiB
C
Raw Normal View History

/* MSPDebug - debugging tool for MSP430 MCUs
2013-07-18 00:23:02 +00:00
* Copyright (C) 2009-2013 Daniel Beer
*
* 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., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA
*/
#include <stdio.h>
#include <ctype.h>
#include <stdlib.h>
#include <string.h>
#include <unistd.h>
2010-05-18 23:48:01 +00:00
#include <getopt.h>
#include "dis.h"
#include "device.h"
#include "binfile.h"
#include "stab.h"
2010-01-08 05:03:51 +00:00
#include "util.h"
#include "usbutil.h"
#include "gdb.h"
2010-04-08 01:15:30 +00:00
#include "rtools.h"
#include "sym.h"
2010-04-10 02:35:36 +00:00
#include "devcmd.h"
2010-05-01 05:54:10 +00:00
#include "expr.h"
2010-08-13 03:14:15 +00:00
#include "opdb.h"
2010-08-13 04:40:58 +00:00
#include "reader.h"
#include "output.h"
2012-10-08 21:03:10 +00:00
#include "output_util.h"
#include "simio.h"
#include "ctrlc.h"
2010-04-30 04:01:03 +00:00
#include "sim.h"
#include "bsl.h"
#include "fet.h"
2010-05-19 00:08:50 +00:00
#include "vector.h"
2010-05-18 23:48:01 +00:00
#include "fet_db.h"
#include "fet_olimex_db.h"
#include "flash_bsl.h"
2011-06-06 03:47:52 +00:00
#include "gdbc.h"
#include "tilib.h"
2012-07-18 00:26:55 +00:00
#include "goodfet.h"
#include "input.h"
2012-10-09 02:42:54 +00:00
#include "input_async.h"
#include "pif.h"
2010-04-30 04:57:57 +00:00
#ifdef __CYGWIN__
#include <sys/cygwin.h>
#endif
#define OPT_NO_RC 0x01
#define OPT_EMBEDDED 0x02
struct cmdline_args {
const char *driver_name;
const char *alt_config;
int flags;
struct device_args devarg;
};
static const struct device_class *const driver_table[] = {
&device_rf2500,
&device_olimex,
&device_olimex_v1,
&device_olimex_iso,
&device_olimex_iso_mk2,
&device_sim,
&device_uif,
&device_bsl,
2011-06-06 03:47:52 +00:00
&device_flash_bsl,
&device_gdbc,
2012-07-18 00:26:55 +00:00
&device_tilib,
&device_goodfet,
&device_pif
};
static const char *version_text =
2013-07-18 00:23:02 +00:00
"MSPDebug version 0.22 - debugging tool for MSP430 MCUs\n"
"Copyright (C) 2009-2013 Daniel Beer <dlbeer@gmail.com>\n"
"This is free software; see the source for copying conditions. There is NO\n"
"warranty; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR "
"PURPOSE.\n";
static void usage(const char *progname)
{
int i;
printc("Usage: %s [options] <driver> [command ...]\n"
"\n"
" -q\n"
" Start in quiet mode.\n"
" -d device\n"
" Connect via the given tty device, rather than USB.\n"
" -U bus:dev\n"
" Specify a particular USB device to connect to.\n"
" -s serial\n"
" Specify a particular device serial number to connect to.\n"
2010-01-04 09:34:23 +00:00
" -j\n"
2010-06-15 01:13:51 +00:00
" Use JTAG, rather than Spy-Bi-Wire (UIF devices only).\n"
" -v voltage\n"
" Set the supply voltage, in millivolts.\n"
2010-04-08 02:43:19 +00:00
" -n\n"
" Do not read a configuration file on startup.\n"
" -C <file>\n"
" Load an alternative configuration file.\n"
2010-09-17 14:15:33 +00:00
" --long-password\n"
" Send 32-byte IVT as BSL password (flash-bsl only)\n"
2010-05-18 23:48:01 +00:00
" --help\n"
2010-04-08 02:43:19 +00:00
" Show this help text.\n"
2010-05-18 23:48:01 +00:00
" --fet-list\n"
" Show a list of devices supported by the FET driver.\n"
" --fet-force-id string\n"
" Override the device ID returned by the FET.\n"
" --fet-skip-close\n"
" Skip the JTAG close procedure when using the FET driver.\n"
" --usb-list\n"
" Show a list of available USB devices.\n"
" --force-reset\n"
" Force target reset in initialization sequence.\n"
" --allow-fw-update\n"
" Update FET firmware (tilib only) if necessary.\n"
" --require-fw-update <image.txt>\n"
" Require FET firmware update. The required image format depends\n"
" on the driver.\n"
" --version\n"
" Show copyright and version information.\n"
" --embedded\n"
" Run in embedded mode.\n"
2010-01-04 09:34:23 +00:00
"\n"
"Most drivers connect by default via USB, unless told otherwise via the\n"
"-d option. By default, the first USB device found is opened.\n"
"\n"
"If commands are given, they will be executed. Otherwise, an interactive\n"
"command reader is started.\n\n",
progname);
printc("Available drivers are:\n");
for (i = 0; i < ARRAY_LEN(driver_table); i++) {
const struct device_class *drv = driver_table[i];
printc(" %s\n %s\n", drv->name, drv->help);
}
}
static void process_rc_file(const char *config)
2010-04-08 02:43:19 +00:00
{
char text[256];
if (!config) {
if (!access(".mspdebug", F_OK)) {
config = ".mspdebug";
} else {
const char *home = getenv("HOME");
if (home) {
snprintf(text, sizeof(text), "%s/.mspdebug",
home);
if (!access(text, F_OK))
config = text;
}
}
}
if (config)
process_file(config, 0);
2010-04-08 02:43:19 +00:00
}
2010-05-19 00:08:50 +00:00
static int add_fet_device(void *user_data, const struct fet_db_record *r)
2010-05-18 23:48:01 +00:00
{
2010-05-19 00:08:50 +00:00
struct vector *v = (struct vector *)user_data;
return vector_push(v, &r->name, 1);
}
static int add_fet_olimex_device(void *user_data, const char *name)
{
struct vector *v = (struct vector *)user_data;
return vector_push(v, &name, 1);
}
2010-05-19 00:08:50 +00:00
static int list_devices(void)
{
struct vector v;
vector_init(&v, sizeof(const char *));
if (fet_db_enum(add_fet_device, &v) < 0) {
pr_error("couldn't allocate memory");
2010-05-19 00:08:50 +00:00
vector_destroy(&v);
return -1;
}
printc("Devices supported by FET driver:\n");
namelist_print(&v);
2010-05-19 00:08:50 +00:00
vector_destroy(&v);
vector_init(&v, sizeof(const char *));
if (fet_olimex_db_enum(add_fet_olimex_device, &v) < 0) {
pr_error("couldn't allocate memory");
vector_destroy(&v);
return -1;
}
printc("\n");
printc("Devices supported by Olimex FET driver:\n");
namelist_print(&v);
vector_destroy(&v);
2010-05-18 23:48:01 +00:00
return 0;
}
2010-04-29 03:56:47 +00:00
static int parse_cmdline_args(int argc, char **argv,
struct cmdline_args *args)
{
enum {
LOPT_HELP = 0x100,
LOPT_FET_LIST,
LOPT_FET_FORCE_ID,
LOPT_FET_SKIP_CLOSE,
LOPT_USB_LIST,
LOPT_VERSION,
LOPT_LONG_PASSWORD,
LOPT_FORCE_RESET,
LOPT_ALLOW_FW_UPDATE,
LOPT_REQUIRE_FW_UPDATE,
LOPT_EMBEDDED
};
2011-11-15 11:28:37 +00:00
static const struct option longopts[] = {
{"help", 0, 0, LOPT_HELP},
{"fet-list", 0, 0, LOPT_FET_LIST},
{"fet-force-id", 1, 0, LOPT_FET_FORCE_ID},
{"fet-skip-close", 0, 0, LOPT_FET_SKIP_CLOSE},
{"usb-list", 0, 0, LOPT_USB_LIST},
{"version", 0, 0, LOPT_VERSION},
{"long-password", 0, 0, LOPT_LONG_PASSWORD},
{"force-reset", 0, 0, LOPT_FORCE_RESET},
{"allow-fw-update", 0, 0, LOPT_ALLOW_FW_UPDATE},
{"require-fw-update", 1, 0, LOPT_REQUIRE_FW_UPDATE},
{"embedded", 0, 0, LOPT_EMBEDDED},
2010-05-18 23:48:01 +00:00
{NULL, 0, 0, 0}
};
int opt;
int want_usb = 0;
2010-05-18 23:48:01 +00:00
while ((opt = getopt_long(argc, argv, "d:jv:nU:s:qC:",
2010-05-18 23:48:01 +00:00
longopts, NULL)) >= 0)
switch (opt) {
case 'C':
args->alt_config = optarg;
break;
case 'q':
{
2011-11-15 11:28:37 +00:00
static const union opdb_value v = {
.boolean = 1
};
opdb_set("quiet", &v);
}
break;
case LOPT_EMBEDDED:
args->flags |= OPT_EMBEDDED;
break;
case LOPT_ALLOW_FW_UPDATE:
args->devarg.flags |= DEVICE_FLAG_DO_FWUPDATE;
break;
case LOPT_USB_LIST:
usb_init();
usb_find_busses();
usb_find_devices();
usbutil_list();
exit(0);
case 'd':
args->devarg.path = optarg;
args->devarg.flags |= DEVICE_FLAG_TTY;
break;
case LOPT_REQUIRE_FW_UPDATE:
args->devarg.require_fwupdate = optarg;
break;
case 'U':
args->devarg.path = optarg;
want_usb = 1;
break;
case 's':
args->devarg.requested_serial = optarg;
break;
case LOPT_FET_LIST:
2010-05-19 00:08:50 +00:00
exit(list_devices());
2010-05-18 23:48:01 +00:00
case LOPT_FET_FORCE_ID:
args->devarg.forced_chip_id = optarg;
break;
case LOPT_FET_SKIP_CLOSE:
args->devarg.flags |= DEVICE_FLAG_SKIP_CLOSE;
break;
case LOPT_HELP:
usage(argv[0]);
exit(0);
case LOPT_VERSION:
printc("%s", version_text);
exit(0);
case 'v':
args->devarg.vcc_mv = atoi(optarg);
break;
2010-01-04 09:34:23 +00:00
case 'j':
args->devarg.flags |= DEVICE_FLAG_JTAG;
2010-01-04 09:34:23 +00:00
break;
2010-04-08 02:43:19 +00:00
case 'n':
args->flags |= OPT_NO_RC;
2010-04-08 02:43:19 +00:00
break;
case LOPT_LONG_PASSWORD:
args->devarg.flags |= DEVICE_FLAG_LONG_PW;
break;
case LOPT_FORCE_RESET:
args->devarg.flags |= DEVICE_FLAG_FORCE_RESET;
break;
2010-03-17 05:40:03 +00:00
case '?':
printc_err("Try --help for usage information.\n");
return -1;
}
if (want_usb && (args->devarg.flags & DEVICE_FLAG_TTY)) {
printc_err("You can't simultaneously specify a serial and "
"a USB device.\n");
return -1;
}
if (optind >= argc) {
printc_err("You need to specify a driver. Try --help for "
"a list.\n");
2010-03-17 05:40:03 +00:00
return -1;
}
args->driver_name = argv[optind];
optind++;
2010-03-17 05:40:03 +00:00
2010-04-29 03:56:47 +00:00
return 0;
}
2010-08-13 04:40:58 +00:00
int setup_driver(struct cmdline_args *args)
2010-04-30 04:01:03 +00:00
{
int i;
2010-04-30 04:01:03 +00:00
i = 0;
while (i < ARRAY_LEN(driver_table) &&
strcasecmp(driver_table[i]->name, args->driver_name))
i++;
if (i >= ARRAY_LEN(driver_table)) {
printc_err("Unknown driver: %s. Try --help for a list.\n",
args->driver_name);
2010-08-13 04:40:58 +00:00
return -1;
}
if (stab_init() < 0)
2010-08-13 04:40:58 +00:00
return -1;
2010-05-01 06:34:43 +00:00
device_default = driver_table[i]->open(&args->devarg);
if (!device_default) {
stab_exit();
2010-08-13 04:40:58 +00:00
return -1;
2010-04-30 04:01:03 +00:00
}
2010-08-13 04:40:58 +00:00
return 0;
2010-04-30 04:01:03 +00:00
}
#ifdef __Windows__
static int sockets_init(void)
{
WSADATA data;
if (WSAStartup(MAKEWORD(2, 2), &data)) {
printc_err("Winsock init failed");
return -1;
}
return 0;
}
static void sockets_exit(void)
{
WSACleanup();
}
#else
static int sockets_init(void) { return 0; }
static void sockets_exit(void) { }
#endif
2010-04-29 03:56:47 +00:00
int main(int argc, char **argv)
{
struct cmdline_args args = {0};
int ret = 0;
setvbuf(stderr, NULL, _IOFBF, 0);
setvbuf(stdout, NULL, _IOFBF, 0);
opdb_reset();
ctrlc_init();
2010-04-29 03:56:47 +00:00
args.devarg.vcc_mv = 3000;
args.devarg.requested_serial = NULL;
2010-04-29 03:56:47 +00:00
if (parse_cmdline_args(argc, argv, &args) < 0)
goto fail_parse;
2010-04-29 03:56:47 +00:00
2012-10-09 02:42:54 +00:00
if (args.flags & OPT_EMBEDDED)
input_module = &input_async;
if (input_module->init() < 0)
goto fail_input;
output_set_embedded(args.flags & OPT_EMBEDDED);
if (sockets_init() < 0) {
ret = -1;
goto fail_sockets;
}
printc_dbg("%s\n", version_text);
if (setup_driver(&args) < 0) {
ret = -1;
goto fail_driver;
}
2010-04-21 04:56:56 +00:00
2012-08-09 03:33:56 +00:00
if (device_probe_id(device_default) < 0)
printc_err("warning: device ID probe failed\n");
simio_init();
if (!(args.flags & OPT_NO_RC))
process_rc_file(args.alt_config);
/* Process commands */
if (optind < argc) {
2010-04-08 01:15:30 +00:00
while (optind < argc) {
2010-08-13 04:40:58 +00:00
if (process_command(argv[optind++]) < 0) {
2010-04-08 01:15:30 +00:00
ret = -1;
break;
}
}
} else {
2010-08-13 04:40:58 +00:00
reader_loop();
}
simio_exit();
2011-03-15 00:12:48 +00:00
device_destroy();
stab_exit();
fail_driver:
sockets_exit();
fail_sockets:
input_module->exit();
fail_input:
fail_parse:
/* We need to do this on Windows, because in embedded mode we
* may still have a running background thread for input. If so,
* returning from main() won't cause the process to terminate.
*/
#if defined(__CYGWIN__)
cygwin_internal(CW_EXIT_PROCESS,
(ret == 0) ? EXIT_SUCCESS : EXIT_FAILURE, 1);
#elif defined(__Windows__)
ExitProcess(ret);
#endif
2010-04-08 01:15:30 +00:00
return ret;
}