You cannot select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
206 lines
6.7 KiB
C
206 lines
6.7 KiB
C
/*
|
|
* $Id$
|
|
*
|
|
* Copyright (C) 2002, 2003 ETC s.r.o.
|
|
*
|
|
* 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., 59 Temple Place - Suite 330, Boston, MA
|
|
* 02111-1307, USA.
|
|
*
|
|
* Written by Marcel Telka <marcel@telka.sk>, 2002, 2003.
|
|
*
|
|
*/
|
|
|
|
#ifdef HAVE_CONFIG_H
|
|
#include <config.h>
|
|
#endif
|
|
|
|
#include <stdio.h>
|
|
#include <string.h>
|
|
|
|
#include "cable.h"
|
|
#include "flash.h"
|
|
|
|
void
|
|
help( const char *cmd )
|
|
{
|
|
if (!cmd)
|
|
printf(
|
|
"Command list:\n"
|
|
"\n"
|
|
"quit exit from %s\n"
|
|
"help display this help\n"
|
|
"frequency setup JTAG frequency\n"
|
|
"cable select JTAG cable\n"
|
|
"detect detect parts on the JTAG chain\n"
|
|
"discovery discovery unknown parts in the JTAG chain\n"
|
|
"print display JTAG chain list/status\n"
|
|
"instruction change active instruction for a part\n"
|
|
"shift shift data/instruction register through JTAG chain\n"
|
|
"dr display active data register for a part\n"
|
|
"detectflash detect parameters of flash chip attached to a part\n"
|
|
"readmem read content of the memory and write it to file\n"
|
|
"flashmem burn flash memory with data from a file\n"
|
|
"set set external signal value\n"
|
|
"\n"
|
|
"Type \"help COMMAND\" for details about particular command.\n", PACKAGE
|
|
);
|
|
else if (strcmp( cmd, "quit" ) == 0)
|
|
printf(
|
|
"Usage: quit\n"
|
|
"Exit from %s.\n", PACKAGE
|
|
);
|
|
else if (strcmp( cmd, "help" ) == 0)
|
|
printf(
|
|
"Usage: help [COMMAND]\n"
|
|
"Print short help for COMMAND, or list of available commands.\n"
|
|
);
|
|
else if (strcmp( cmd, "frequency" ) == 0)
|
|
printf(
|
|
"Usage: frequency FREQ\n"
|
|
"Change TCK frequency to FREQ.\n"
|
|
"\n"
|
|
"FREQ is in hertz. It's a maximum TCK frequency for JTAG interface.\n"
|
|
"In some cases the TCK frequency is less than FREQ, but the frequency\n"
|
|
"is never more than FREQ. Maximum supported frequency depends on JTAG\n"
|
|
"adapter.\n"
|
|
"\n"
|
|
"FREQ must be an unsigned integer. Minimum allowed frequency is 1 Hz.\n"
|
|
"Use 0 for FREQ to disable frequency limit.\n"
|
|
);
|
|
else if (strcmp( cmd, "cable" ) == 0) {
|
|
int i;
|
|
|
|
printf(
|
|
"Usage: cable parallel PORTADDR CABLE\n"
|
|
"Select JTAG cable connected to parallel port.\n"
|
|
"\n"
|
|
"PORTADDR parallel port address (e.g. 0x378)\n"
|
|
"CABLE cable type\n"
|
|
"\n"
|
|
"List of supported cables:\n"
|
|
"none No cable connected\n"
|
|
);
|
|
|
|
for (i = 0; cable_drivers[i]; i++)
|
|
printf( "%-14s%s\n", cable_drivers[i]->name, cable_drivers[i]->description );
|
|
} else if (strcmp( cmd, "detect" ) == 0)
|
|
printf(
|
|
"Usage: detect\n"
|
|
"Detect parts on the JTAG chain.\n"
|
|
"\n"
|
|
"Output from this command is a list of the detected parts.\n"
|
|
"If no parts are detected other commands may not work properly.\n"
|
|
);
|
|
else if (strcmp( cmd, "discovery" ) == 0)
|
|
printf(
|
|
"Usage: discovery FILENAME\n"
|
|
"Discovery unknown parts in the JTAG chain.\n"
|
|
"\n"
|
|
"Detail output (report) is directed to the FILENAME.\n"
|
|
"'discovery' attempt to detect these parameters of an unknown JTAG\n"
|
|
"chain:\n"
|
|
" 1. JTAG chain size (number of parts in the chain)\n"
|
|
" 2. IR (instruction register) length\n"
|
|
" 3. DR (data register) length for all possible instructions\n"
|
|
"\n"
|
|
"Warning: This may be dangerous for some parts (especially, if the\n"
|
|
"part doesn't have TRST signal).\n"
|
|
);
|
|
else if (strcmp( cmd, "print" ) == 0)
|
|
printf(
|
|
"Usage: print\n"
|
|
"Display JTAG chain status.\n"
|
|
"\n"
|
|
"Display list of the parts connected to the JTAG chain including\n"
|
|
"part number and current (active) instruction and data register.\n"
|
|
);
|
|
else if (strcmp( cmd, "instruction" ) == 0)
|
|
printf(
|
|
"Usage: instruction PART INSTRUCTION\n"
|
|
"Change active INSTRUCTION for a PART.\n"
|
|
"\n"
|
|
"PART part number (see print command)\n"
|
|
"INSTRUCTION instruction name (e.g. BYPASS)\n"
|
|
);
|
|
else if (strcmp( cmd, "shift" ) == 0)
|
|
printf(
|
|
"Usage: shift ir\n"
|
|
"Usage: shift dr\n"
|
|
"Shift instruction or data register through JTAG chain.\n"
|
|
);
|
|
else if (strcmp( cmd, "dr" ) == 0)
|
|
printf(
|
|
"Usage: dr PART [DIR]\n"
|
|
"Display input or output data register content.\n"
|
|
"\n"
|
|
"PART part number (see print command)\n"
|
|
"DIR requested data register; possible values: 'in' for\n"
|
|
" input and 'out' for output; default is 'out'\n"
|
|
);
|
|
else if (strcmp( cmd, "detectflash" ) == 0)
|
|
printf(
|
|
"Usage: detectflash\n"
|
|
"Detect flash memory type connected to part.\n"
|
|
"\n"
|
|
"Only detects flash connected to part 0. Part 0 must support\n"
|
|
"bus operations.\n"
|
|
);
|
|
else if (strcmp( cmd, "readmem" ) == 0)
|
|
printf(
|
|
"Usage: readmem ADDR LEN FILENAME\n"
|
|
"Copy device memory content starting with ADDR to FILENAME file.\n"
|
|
"\n"
|
|
"ADDR start address of the copied memory area\n"
|
|
"LEN copied memory length\n"
|
|
"FILENAME name of the output file\n"
|
|
"\n"
|
|
"ADDR and LEN could be in decimal or hexadecimal (prefixed with 0x) form.\n"
|
|
"\n"
|
|
"readmem works only with part 0. Part 0 must support bus operations.\n"
|
|
);
|
|
else if (strcmp( cmd, "flashmem" ) == 0) {
|
|
int i;
|
|
printf(
|
|
"Usage: flashmem ADDR FILENAME\n"
|
|
"Usage: flashmem msbin FILENAME\n"
|
|
"Program FILENAME content to flash memory.\n"
|
|
"\n"
|
|
"ADDR target addres for raw binary image\n"
|
|
"FILENAME name of the input file\n"
|
|
"msbin FILENAME is in MS .bin format (for WinCE)\n"
|
|
"\n"
|
|
"ADDR could be in decimal or hexadecimal (prefixed with 0x) form.\n"
|
|
"\n"
|
|
"flashmem works only with part 0. Part 0 must support bus operations.\n"
|
|
"Supported Flash Memories\n"
|
|
);
|
|
for (i = 0; flash_drivers[i]; i++)
|
|
printf( "%s\n %s\n", flash_drivers[i]->name, flash_drivers[i]->description );
|
|
}
|
|
else if (strcmp( cmd, "set" ) == 0)
|
|
printf(
|
|
"Usage: set signal PART SIGNAL DIR [DATA]\n"
|
|
"Set signal state in input BSR (Boundary Scan Register).\n"
|
|
"\n"
|
|
"PART part number (see print command)\n"
|
|
"SIGNAL signal name (from JTAG declaration file)\n"
|
|
"DIR requested signal direction; possible values: 'in' or 'out'\n"
|
|
"DATA desired output signal value ('0' or '1'); used only if DIR\n"
|
|
" is 'out'\n"
|
|
);
|
|
else
|
|
printf( "Invalid command.\n" );
|
|
}
|