/* * avrdude - A Downloader/Uploader for AVR device programmers * Copyright (C) 2000-2004 Brian S. Dean * * 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, see . */ /* $Id$ */ #include "ac_cfg.h" #include #include #include #include #include #if defined(HAVE_LIBREADLINE) # include # include #endif #include "avrdude.h" #include "term.h" struct command { char * name; int (*func)(PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); char * desc; }; static int cmd_dump (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_write (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_erase (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_sig (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_part (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_help (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_quit (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_send (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_parms (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_vtarg (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_varef (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_fosc (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_sck (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_spi (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_pgm (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); static int cmd_verbose (PROGRAMMER * pgm, struct avrpart * p, int argc, char *argv[]); struct command cmd[] = { { "dump", cmd_dump, "dump memory : %s " }, { "read", cmd_dump, "alias for dump" }, { "write", cmd_write, "write memory : %s ... " }, { "erase", cmd_erase, "perform a chip erase" }, { "sig", cmd_sig, "display device signature bytes" }, { "part", cmd_part, "display the current part information" }, { "send", cmd_send, "send a raw command : %s " }, { "parms", cmd_parms, "display adjustable parameters (STK500 only)" }, { "vtarg", cmd_vtarg, "set (STK500 only)" }, { "varef", cmd_varef, "set (STK500 only)" }, { "fosc", cmd_fosc, "set (STK500 only)" }, { "sck", cmd_sck, "set (STK500 only)" }, { "spi", cmd_spi, "enter direct SPI mode" }, { "pgm", cmd_pgm, "return to programming mode" }, { "verbose", cmd_verbose, "change verbosity" }, { "help", cmd_help, "help" }, { "?", cmd_help, "help" }, { "quit", cmd_quit, "quit" } }; #define NCMDS (sizeof(cmd)/sizeof(struct command)) static int spi_mode = 0; static int nexttok(char * buf, char ** tok, char ** next) { char * q, * n; q = buf; while (isspace((int)*q)) q++; /* isolate first token */ n = q+1; while (*n && !isspace((int)*n)) n++; if (*n) { *n = 0; n++; } /* find start of next token */ while (isspace((int)*n)) n++; *tok = q; *next = n; return 0; } static int hexdump_line(char * buffer, unsigned char * p, int n, int pad) { char * hexdata = "0123456789abcdef"; char * b; int i, j; b = buffer; j = 0; for (i=0; i> 4]; b[j++] = hexdata[(p[i] & 0x0f)]; if (i < 15) b[j++] = ' '; } for (i=j; i len) n = len; hexdump_line(dst1, p, n, 48); chardump_line(dst2, p, n, 16); fprintf(stdout, "%04x %s |%s|\n", addr, dst1, dst2); len -= n; addr += n; p += n; } return 0; } static int cmd_dump(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { static char prevmem[128] = {0}; char * e; unsigned char * buf; int maxsize; unsigned long i; static unsigned long addr=0; static int len=64; AVRMEM * mem; char * memtype = NULL; int rc; if (!((argc == 2) || (argc == 4))) { avrdude_message(MSG_INFO, "Usage: dump [ ]\n"); return -1; } memtype = argv[1]; if (strncmp(prevmem, memtype, strlen(memtype)) != 0) { addr = 0; len = 64; strncpy(prevmem, memtype, sizeof(prevmem)-1); prevmem[sizeof(prevmem)-1] = 0; } mem = avr_locate_mem(p, memtype); if (mem == NULL) { avrdude_message(MSG_INFO, "\"%s\" memory type not defined for part \"%s\"\n", memtype, p->desc); return -1; } if (argc == 4) { addr = strtoul(argv[2], &e, 0); if (*e || (e == argv[2])) { avrdude_message(MSG_INFO, "%s (dump): can't parse address \"%s\"\n", progname, argv[2]); return -1; } len = strtol(argv[3], &e, 0); if (*e || (e == argv[3])) { avrdude_message(MSG_INFO, "%s (dump): can't parse length \"%s\"\n", progname, argv[3]); return -1; } } maxsize = mem->size; if (addr >= maxsize) { if (argc == 2) { /* wrap around */ addr = 0; } else { avrdude_message(MSG_INFO, "%s (dump): address 0x%05lx is out of range for %s memory\n", progname, addr, mem->desc); return -1; } } /* trim len if nessary to not read past the end of memory */ if ((addr + len) > maxsize) len = maxsize - addr; buf = malloc(len); if (buf == NULL) { avrdude_message(MSG_INFO, "%s (dump): out of memory\n", progname); return -1; } for (i=0; iread_byte(pgm, p, mem, addr+i, &buf[i]); if (rc != 0) { avrdude_message(MSG_INFO, "error reading %s address 0x%05lx of part %s\n", mem->desc, addr+i, p->desc); if (rc == -1) avrdude_message(MSG_INFO, "read operation not supported on memory type \"%s\"\n", mem->desc); return -1; } } hexdump_buf(stdout, addr, buf, len); fprintf(stdout, "\n"); free(buf); addr = addr + len; return 0; } static int cmd_write(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { char * e; int len, maxsize; char * memtype; unsigned long addr, i; unsigned char * buf; unsigned char b; int rc; int werror; int write_mode, start_offset; AVRMEM * mem; if (argc < 4) { avrdude_message(MSG_INFO, "Usage: write \n" " write <...>\n"); return -1; } memtype = argv[1]; mem = avr_locate_mem(p, memtype); if (mem == NULL) { avrdude_message(MSG_INFO, "\"%s\" memory type not defined for part \"%s\"\n", memtype, p->desc); return -1; } maxsize = mem->size; addr = strtoul(argv[2], &e, 0); if (*e || (e == argv[2])) { avrdude_message(MSG_INFO, "%s (write): can't parse address \"%s\"\n", progname, argv[2]); return -1; } if (addr > maxsize) { avrdude_message(MSG_INFO, "%s (write): address 0x%05lx is out of range for %s memory\n", progname, addr, memtype); return -1; } // Figure out how many bytes there is to write to memory if (strcmp(argv[argc - 1], "...") == 0) { write_mode = WRITE_MODE_FILL; len = strtoul(argv[3], &e, 0); if (*e || (e == argv[3])) { avrdude_message(MSG_INFO, "%s (write ...): can't parse address \"%s\"\n", progname, argv[3]); return -1; } } else { write_mode = WRITE_MODE_STANDARD; } buf = malloc(mem->size); if (buf == NULL) { avrdude_message(MSG_INFO, "%s (write): out of memory\n", progname); return -1; } if (write_mode == WRITE_MODE_STANDARD) { start_offset = 3; // Argument number where data to write starts len = argc - start_offset; } else if (write_mode == WRITE_MODE_FILL) start_offset = 4; else { avrdude_message(MSG_INFO, "%s (write): invalid write mode %d\n", progname, write_mode); return -1; } long write_val; int bytes_grown = 0; for (i = start_offset; i < len + start_offset - bytes_grown; i++) { char* ptr = NULL; // Handle the next argument if (i < argc - start_offset + 3) { // Try integers write_val = strtol(argv[i], &e, 0); if (*e || (e == argv[i])) { // Try float float f = strtof(argv[i], &e); ptr = (char*)&f; write_val = ((char)*(ptr+3)<<24) + ((char)*(ptr+2)<<16) + ((char)*(ptr+1)<<8) + (char)*ptr; if (*e || (e == argv[i])) { ptr = NULL; // Try single character if (argv[i][0] == '\'' && argv[i][2] == '\'') { write_val = argv[i][1]; } else { avrdude_message(MSG_INFO, "%s (write): can't parse data \"%s\"\n", progname, argv[i]); free(buf); return -1; } } } } buf[i - start_offset + bytes_grown] = (write_val >> 0) & 0xFF; if (labs(write_val) > 0xFF || ptr) buf[i - start_offset + ++bytes_grown] = (write_val >> 8) & 0xFF; if (labs(write_val) > 0xFFFF || ptr) { buf[i - start_offset + ++bytes_grown] = (write_val >> 16) & 0xFF; buf[i - start_offset + ++bytes_grown] = (write_val >> 24) & 0xFF; } } // When in "fill" mode, the maximum size is already predefined if (write_mode == WRITE_MODE_FILL) bytes_grown = 0; if ((addr + len + bytes_grown) > maxsize) { avrdude_message(MSG_INFO, "%s (write): selected address and # bytes exceed " "range for %s memory\n", progname, memtype); return -1; } pgm->err_led(pgm, OFF); for (werror=0, i=0; i < (len + bytes_grown); i++) { rc = avr_write_byte(pgm, p, mem, addr+i, buf[i]); if (rc) { avrdude_message(MSG_INFO, "%s (write): error writing 0x%02x at 0x%05lx, rc=%d\n", progname, buf[i], addr+i, rc); if (rc == -1) avrdude_message(MSG_INFO, "write operation not supported on memory type \"%s\"\n", mem->desc); werror = 1; } rc = pgm->read_byte(pgm, p, mem, addr+i, &b); if (b != buf[i]) { avrdude_message(MSG_INFO, "%s (write): error writing 0x%02x at 0x%05lx cell=0x%02x\n", progname, buf[i], addr+i, b); werror = 1; } if (werror) { pgm->err_led(pgm, ON); } } free(buf); fprintf(stdout, "\n"); return 0; } static int cmd_send(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { unsigned char cmd[4], res[4]; char * e; int i; int len; if (pgm->cmd == NULL) { avrdude_message(MSG_INFO, "The %s programmer does not support direct ISP commands.\n", pgm->type); return -1; } if (spi_mode && (pgm->spi == NULL)) { avrdude_message(MSG_INFO, "The %s programmer does not support direct SPI transfers.\n", pgm->type); return -1; } if ((argc > 5) || ((argc < 5) && (!spi_mode))) { avrdude_message(MSG_INFO, spi_mode? "Usage: send [ [ []]]\n": "Usage: send \n"); return -1; } /* number of bytes to write at the specified address */ len = argc - 1; /* load command bytes */ for (i=1; ierr_led(pgm, OFF); if (spi_mode) pgm->spi(pgm, cmd, res, argc-1); else pgm->cmd(pgm, cmd, res); /* * display results */ avrdude_message(MSG_INFO, "results:"); for (i=0; ichip_erase(pgm, p); return 0; } static int cmd_part(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { fprintf(stdout, "\n"); avr_display(stdout, p, "", 0); fprintf(stdout, "\n"); return 0; } static int cmd_sig(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { int i; int rc; AVRMEM * m; rc = avr_signature(pgm, p); if (rc != 0) { avrdude_message(MSG_INFO, "error reading signature data, rc=%d\n", rc); } m = avr_locate_mem(p, "signature"); if (m == NULL) { avrdude_message(MSG_INFO, "signature data not defined for device \"%s\"\n", p->desc); } else { fprintf(stdout, "Device signature = 0x"); for (i=0; isize; i++) fprintf(stdout, "%02x", m->buf[i]); fprintf(stdout, "\n\n"); } return 0; } static int cmd_quit(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { /* FUSE bit verify will fail if left in SPI mode */ if (spi_mode) { cmd_pgm(pgm, p, 0, NULL); } return 1; } static int cmd_parms(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { if (pgm->print_parms == NULL) { avrdude_message(MSG_INFO, "%s (parms): the %s programmer does not support " "adjustable parameters\n", progname, pgm->type); return -1; } pgm->print_parms(pgm); return 0; } static int cmd_vtarg(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { int rc; double v; char *endp; if (argc != 2) { avrdude_message(MSG_INFO, "Usage: vtarg \n"); return -1; } v = strtod(argv[1], &endp); if (endp == argv[1]) { avrdude_message(MSG_INFO, "%s (vtarg): can't parse voltage \"%s\"\n", progname, argv[1]); return -1; } if (pgm->set_vtarget == NULL) { avrdude_message(MSG_INFO, "%s (vtarg): the %s programmer cannot set V[target]\n", progname, pgm->type); return -2; } if ((rc = pgm->set_vtarget(pgm, v)) != 0) { avrdude_message(MSG_INFO, "%s (vtarg): failed to set V[target] (rc = %d)\n", progname, rc); return -3; } return 0; } static int cmd_fosc(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { int rc; double v; char *endp; if (argc != 2) { avrdude_message(MSG_INFO, "Usage: fosc [M|k] | off\n"); return -1; } v = strtod(argv[1], &endp); if (endp == argv[1]) { if (strcmp(argv[1], "off") == 0) v = 0.0; else { avrdude_message(MSG_INFO, "%s (fosc): can't parse frequency \"%s\"\n", progname, argv[1]); return -1; } } if (*endp == 'm' || *endp == 'M') v *= 1e6; else if (*endp == 'k' || *endp == 'K') v *= 1e3; if (pgm->set_fosc == NULL) { avrdude_message(MSG_INFO, "%s (fosc): the %s programmer cannot set oscillator frequency\n", progname, pgm->type); return -2; } if ((rc = pgm->set_fosc(pgm, v)) != 0) { avrdude_message(MSG_INFO, "%s (fosc): failed to set oscillator frequency (rc = %d)\n", progname, rc); return -3; } return 0; } static int cmd_sck(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { int rc; double v; char *endp; if (argc != 2) { avrdude_message(MSG_INFO, "Usage: sck \n"); return -1; } v = strtod(argv[1], &endp); if (endp == argv[1]) { avrdude_message(MSG_INFO, "%s (sck): can't parse period \"%s\"\n", progname, argv[1]); return -1; } v *= 1e-6; /* Convert from microseconds to seconds. */ if (pgm->set_sck_period == NULL) { avrdude_message(MSG_INFO, "%s (sck): the %s programmer cannot set SCK period\n", progname, pgm->type); return -2; } if ((rc = pgm->set_sck_period(pgm, v)) != 0) { avrdude_message(MSG_INFO, "%s (sck): failed to set SCK period (rc = %d)\n", progname, rc); return -3; } return 0; } static int cmd_varef(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { int rc; unsigned int chan; double v; char *endp; if (argc != 2 && argc != 3) { avrdude_message(MSG_INFO, "Usage: varef [channel] \n"); return -1; } if (argc == 2) { chan = 0; v = strtod(argv[1], &endp); if (endp == argv[1]) { avrdude_message(MSG_INFO, "%s (varef): can't parse voltage \"%s\"\n", progname, argv[1]); return -1; } } else { chan = strtoul(argv[1], &endp, 10); if (endp == argv[1]) { avrdude_message(MSG_INFO, "%s (varef): can't parse channel \"%s\"\n", progname, argv[1]); return -1; } v = strtod(argv[2], &endp); if (endp == argv[2]) { avrdude_message(MSG_INFO, "%s (varef): can't parse voltage \"%s\"\n", progname, argv[2]); return -1; } } if (pgm->set_varef == NULL) { avrdude_message(MSG_INFO, "%s (varef): the %s programmer cannot set V[aref]\n", progname, pgm->type); return -2; } if ((rc = pgm->set_varef(pgm, chan, v)) != 0) { avrdude_message(MSG_INFO, "%s (varef): failed to set V[aref] (rc = %d)\n", progname, rc); return -3; } return 0; } static int cmd_help(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { int i; fprintf(stdout, "Valid commands:\n\n"); for (i=0; isetpin != NULL) { pgm->setpin(pgm, PIN_AVR_RESET, 1); spi_mode = 1; return 0; } avrdude_message(MSG_INFO, "`spi' command unavailable for this programmer type\n"); return -1; } static int cmd_pgm(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { if (pgm->setpin != NULL) { pgm->setpin(pgm, PIN_AVR_RESET, 0); spi_mode = 0; pgm->initialize(pgm, p); return 0; } avrdude_message(MSG_INFO, "`pgm' command unavailable for this programmer type\n"); return -1; } static int cmd_verbose(PROGRAMMER * pgm, struct avrpart * p, int argc, char * argv[]) { int nverb; char *endp; if (argc != 1 && argc != 2) { avrdude_message(MSG_INFO, "Usage: verbose []\n"); return -1; } if (argc == 1) { avrdude_message(MSG_INFO, "Verbosity level: %d\n", verbose); return 0; } nverb = strtol(argv[1], &endp, 0); if (endp == argv[2]) { avrdude_message(MSG_INFO, "%s: can't parse verbosity level \"%s\"\n", progname, argv[2]); return -1; } if (nverb < 0) { avrdude_message(MSG_INFO, "%s: verbosity level must be positive: %d\n", progname, nverb); return -1; } verbose = nverb; avrdude_message(MSG_INFO, "New verbosity level: %d\n", verbose); return 0; } static int tokenize(char * s, char *** argv) { int i, n, l, k, nargs, offset; int len, slen; char * buf; int bufsize; char ** bufv; char * bufp; char * q, * r; char * nbuf; char ** av; slen = strlen(s); /* * initialize allow for 20 arguments, use realloc to grow this if * necessary */ nargs = 20; bufsize = slen + 20; buf = malloc(bufsize); bufv = (char **) malloc(nargs*sizeof(char *)); for (i=0; i= 1)) add_history(input); return input; #else char input[256]; printf("%s", prompt); if (fgets(input, sizeof(input), stdin)) { /* FIXME: readline strips the '\n', should this too? */ return strdup(input); } else return NULL; #endif } int terminal_mode(PROGRAMMER * pgm, struct avrpart * p) { char * cmdbuf; int i; char * q; int rc; int argc; char ** argv; rc = 0; while ((cmdbuf = terminal_get_input("avrdude> ")) != NULL) { /* * find the start of the command, skipping any white space */ q = cmdbuf; while (*q && isspace((int)*q)) q++; /* skip blank lines and comments */ if (!*q || (*q == '#')) continue; /* tokenize command line */ argc = tokenize(q, &argv); if (argc < 0) { free(cmdbuf); return argc; } fprintf(stdout, ">>> "); for (i=0; i 0) { rc = 0; break; } free(cmdbuf); } return rc; }