[proxmark3-svn] / client / cmdhf14b.c

//-----------------------------------------------------------------------------
// Copyright (C) 2010 iZsh <izsh at fail0verflow.com>
//
// This code is licensed to you under the terms of the GNU GPL, version 2 or,
// at your option, any later version. See the LICENSE.txt file for the text of
// the license.
//-----------------------------------------------------------------------------
// High frequency ISO14443B commands
//-----------------------------------------------------------------------------

#include <stdio.h>
#include <stdlib.h>
#include <stdbool.h>
#include <string.h>
#include <stdint.h>
#include "iso14443crc.h"
#include "proxmark3.h"
#include "data.h"
#include "graph.h"
#include "util.h"
#include "ui.h"
#include "cmdparser.h"
#include "cmdhf14b.h"
#include "cmdmain.h"
#include "cmdhf14a.h"

static int CmdHelp(const char *Cmd);

int CmdHF14BList(const char *Cmd)
{
	PrintAndLog("Deprecated command, use 'hf list 14b' instead");

	return 0;
}

int CmdHF14BSim(const char *Cmd)
{
  UsbCommand c={CMD_SIMULATE_TAG_ISO_14443B};
  clearCommandBuffer();
  SendCommand(&c);
  return 0;
}

int CmdHF14BSnoop(const char *Cmd)
{
  UsbCommand c = {CMD_SNOOP_ISO_14443B};
  clearCommandBuffer();
  SendCommand(&c);
  return 0;
}

/* New command to read the contents of a SRI512 tag
 * SRI512 tags are ISO14443-B modulated memory tags,
 * this command just dumps the contents of the memory
 */
int CmdSri512Read(const char *Cmd)
{
  UsbCommand c = {CMD_READ_SRI512_TAG, {strtol(Cmd, NULL, 0), 0, 0}};
  clearCommandBuffer();
  SendCommand(&c);
  return 0;
}

/* New command to read the contents of a SRIX4K tag
 * SRIX4K tags are ISO14443-B modulated memory tags,
 * this command just dumps the contents of the memory/
 */
int CmdSrix4kRead(const char *Cmd)
{
  UsbCommand c = {CMD_READ_SRIX4K_TAG, {strtol(Cmd, NULL, 0), 0, 0}};
  clearCommandBuffer();
  SendCommand(&c);
  return 0;
}

int rawClose(void){
	UsbCommand resp;
	UsbCommand c = {CMD_ISO_14443B_COMMAND, {0, 0, 0}};
	clearCommandBuffer();
	SendCommand(&c);
	if (!WaitForResponseTimeout(CMD_ACK,&resp,1000)) {
		return 0;
	}
	return 0;
}

int HF14BCmdRaw(bool reply, bool *crc, bool power, uint8_t *data, uint8_t *datalen, bool verbose){
	UsbCommand resp;
	UsbCommand c = {CMD_ISO_14443B_COMMAND, {0, 0, 0}}; // len,recv,power
	if(*crc)
	{
		uint8_t first, second;
		ComputeCrc14443(CRC_14443_B, data, *datalen, &first, &second);
		data[*datalen] = first;
		data[*datalen + 1] = second;
		*datalen += 2;
	}
	
	c.arg[0] = *datalen;
	c.arg[1] = reply;
	c.arg[2] = power;
	memcpy(c.d.asBytes,data,*datalen);
	clearCommandBuffer();
	SendCommand(&c);
	
	if (!reply) return 1; 

	if (!WaitForResponseTimeout(CMD_ACK,&resp,1000)) {
		if (verbose) PrintAndLog("timeout while waiting for reply.");
		return 0;
	}
	*datalen = resp.arg[0];
	if (verbose) PrintAndLog("received %u octets", *datalen);
	if(*datalen<2) return 0;

	memcpy(data, resp.d.asBytes, *datalen);
	if (verbose) PrintAndLog("%s", sprint_hex(data, *datalen));

	uint8_t first, second;
	ComputeCrc14443(CRC_14443_B, data, *datalen-2, &first, &second);
	if(data[*datalen-2] == first && data[*datalen-1] == second) {
		if (verbose) PrintAndLog("CRC OK");
		*crc = true;
	} else {
		if (verbose) PrintAndLog("CRC failed");
		*crc = false;
	}
	return 1;
}

int CmdHF14BCmdRaw (const char *Cmd) {
	bool reply = true;
	bool crc = false;
	bool power = false;
	char buf[5] = "";
	uint8_t data[100] = {0x00};
	uint8_t datalen = 0;
	unsigned int temp;
	int i = 0;
	if (strlen(Cmd)<3) {
			PrintAndLog("Usage: hf 14b raw [-r] [-c] [-p] <0A 0B 0C ... hex>");
			PrintAndLog("       -r    do not read response");
			PrintAndLog("       -c    calculate and append CRC");
			PrintAndLog("       -p    leave the field on after receive");
			return 0;    
	}

	// strip
	while (*Cmd==' ' || *Cmd=='\t') Cmd++;
	
	while (Cmd[i]!='\0') {
		if (Cmd[i]==' ' || Cmd[i]=='\t') { i++; continue; }
		if (Cmd[i]=='-') {
			switch (Cmd[i+1]) {
				case 'r': 
				case 'R': 
					reply = false;
					break;
				case 'c':
				case 'C':                
					crc = true;
					break;
				case 'p': 
				case 'P': 
					power = true;
					break;
				default:
					PrintAndLog("Invalid option");
					return 0;
			}
			i+=2;
			continue;
		}
		if ((Cmd[i]>='0' && Cmd[i]<='9') ||
		    (Cmd[i]>='a' && Cmd[i]<='f') ||
		    (Cmd[i]>='A' && Cmd[i]<='F') ) {
			buf[strlen(buf)+1]=0;
			buf[strlen(buf)]=Cmd[i];
			i++;
			
			if (strlen(buf)>=2) {
				sscanf(buf,"%x",&temp);
				data[datalen++]=(uint8_t)(temp & 0xff);
				*buf=0;
			}
			continue;
		}
		PrintAndLog("Invalid char on input");
		return 1;
	}
	if (datalen == 0)
	{
		PrintAndLog("Missing data input");
		return 0;
	}

	return HF14BCmdRaw(reply, &crc, power, data, &datalen, true);
}

// print full atqb info
static void print_atqb_resp(uint8_t *data){
	PrintAndLog ("           UID: %s", sprint_hex(data+1,4));
	PrintAndLog ("      App Data: %s", sprint_hex(data+5,4));
	PrintAndLog ("      Protocol: %s", sprint_hex(data+9,3));
	uint8_t BitRate = data[9];
	if (!BitRate) 
		PrintAndLog ("      Bit Rate: 106 kbit/s only PICC <-> PCD");
	if (BitRate & 0x10)
		PrintAndLog ("      Bit Rate: 212 kbit/s PICC -> PCD supported");
	if (BitRate & 0x20)
		PrintAndLog ("      Bit Rate: 424 kbit/s PICC -> PCD supported"); 
	if (BitRate & 0x40)
		PrintAndLog ("      Bit Rate: 847 kbit/s PICC -> PCD supported"); 
	if (BitRate & 0x01)
		PrintAndLog ("      Bit Rate: 212 kbit/s PICC <- PCD supported");
	if (BitRate & 0x02)
		PrintAndLog ("      Bit Rate: 424 kbit/s PICC <- PCD supported"); 
	if (BitRate & 0x04)
		PrintAndLog ("      Bit Rate: 847 kbit/s PICC <- PCD supported"); 
	if (BitRate & 0x80) 
		PrintAndLog ("                Same bit rate <-> required");

	uint16_t maxFrame = data[10]>>4;
	if (maxFrame < 5) 
		maxFrame = 8*maxFrame + 16;
	else if (maxFrame == 5)
		maxFrame = 64;
	else if (maxFrame == 6)
		maxFrame = 96;
	else if (maxFrame == 7)
		maxFrame = 128;
	else if (maxFrame == 8)
		maxFrame = 256;
	else
		maxFrame = 257;

	PrintAndLog ("Max Frame Size: %d%s",maxFrame, (maxFrame == 257) ? "+ RFU" : "");

	uint8_t protocolT = data[10] & 0xF;
	PrintAndLog (" Protocol Type: Protocol is %scompliant with ISO/IEC 14443-4",(protocolT) ? "" : "not " );
	PrintAndLog ("Frame Wait Int: %d", data[11]>>4);
	PrintAndLog (" App Data Code: Application is %s",(data[11]&4) ? "Standard" : "Proprietary");
	PrintAndLog (" Frame Options: NAD is %ssupported",(data[11]&2) ? "" : "not ");
	PrintAndLog (" Frame Options: CID is %ssupported",(data[11]&1) ? "" : "not ");
	
	return;
}

// get SRx chip model (from UID) // from ST Microelectronics
char *get_ST_Chip_Model(uint8_t data){
	static char model[20];
	char *retStr = model;
	memset(model,0, sizeof(model));

	switch (data) {
		case 0x0: sprintf(retStr, "SRIX4K (Special)"); break;
		case 0x2: sprintf(retStr, "SR176"); break;
		case 0x3: sprintf(retStr, "SRIX4K"); break;
		case 0x4: sprintf(retStr, "SRIX512"); break;
		case 0x6: sprintf(retStr, "SRI512"); break;
		case 0x7: sprintf(retStr, "SRI4K"); break;
		case 0xC: sprintf(retStr, "SRT512"); break;
		default : sprintf(retStr, "Unknown"); break;
	}
	return retStr;
}

int print_ST_Lock_info(uint8_t model){
	//assume connection open and tag selected...
	uint8_t data[8] = {0x00};
	uint8_t datalen = 2;
	bool crc = true;
	uint8_t resplen;
	uint8_t	blk1;
	data[0] = 0x08;

	if (model == 0x2) { //SR176 has special command:
		data[1] = 0xf;
		resplen = 4;			
	} else {
		data[1] = 0xff;
		resplen = 6;
	}

	//std read cmd
	if (HF14BCmdRaw(true, &crc, true, data, &datalen, false)==0) return rawClose();

	if (datalen != resplen || !crc) return rawClose();

	PrintAndLog("Chip Write Protection Bits:");
	// now interpret the data
	switch (model){
		case 0x0: //fall through (SRIX4K special)
		case 0x3: //fall through (SRIx4K)
		case 0x7: //             (SRI4K)
			//only need data[3]
			blk1 = 9;
			PrintAndLog("   raw: %s",printBits(1,data+3));
			PrintAndLog(" 07/08: %slocked", blk1, (data[3] & 1) ? "not " : "" );
			for (uint8_t i = 1; i<8; i++){
				PrintAndLog("    %02u: %slocked", blk1, (data[3] & (1 << i)) ? "not " : "" );
				blk1++;
			}
			break;
		case 0x4: //fall through (SRIX512)
		case 0x6: //fall through (SRI512)
		case 0xC: //             (SRT512)
			//need data[2] and data[3]
			blk1 = 0;
			PrintAndLog("   raw: %s",printBits(2,data+2));
			for (uint8_t b=2; b<4; b++){
				for (uint8_t i=0; i<8; i++){
					PrintAndLog("    %02u: %slocked", blk1, (data[b] & (1 << i)) ? "not " : "" );
					blk1++;
				}
			}
			break;
		case 0x2: //             (SR176)
			//need data[2]
			blk1 = 0;
			PrintAndLog("   raw: %s",printBits(1,data+2));
			for (uint8_t i = 0; i<8; i++){
				PrintAndLog(" %02u/%02u: %slocked", blk1, blk1+1, (data[2] & (1 << i)) ? "" : "not " );
				blk1+=2;
			}
			break;
		default:
			return rawClose();
	}
	return 1;
}

// print UID info from SRx chips (ST Microelectronics)
static void print_st_general_info(uint8_t *data){
	//uid = first 8 bytes in data
	PrintAndLog("   UID: %s", sprint_hex(SwapEndian64(data,8,8),8));
	PrintAndLog("   MFG: %02X, %s", data[6], getTagInfo(data[6]));
	PrintAndLog("  Chip: %02X, %s", data[5]>>2, get_ST_Chip_Model(data[5]>>2));
	return;
}

// 14b get and print UID only (general info)
int HF14BStdReader(uint8_t *data, uint8_t *datalen){
	//05 00 00 = find one tag in field
	//1d xx xx xx xx 20 00 08 01 00 = attrib xx=crc
	//a3 = ?  (resp 03 e2 c2)
	//02 = ?  (resp 02 6a d3)
	// 022b (resp 02 67 00 [29  5b])
	// 0200a40400 (resp 02 67 00 [29 5b])
	// 0200a4040c07a0000002480300 (resp 02 67 00 [29 5b])
	// 0200a4040c07a0000002480200 (resp 02 67 00 [29 5b])
	// 0200a4040006a0000000010100 (resp 02 6a 82 [4b 4c])
	// 0200a4040c09d27600002545500200 (resp 02 67 00 [29 5b])
	// 0200a404000cd2760001354b414e4d30310000 (resp 02 6a 82 [4b 4c])
	// 0200a404000ca000000063504b43532d313500 (resp 02 6a 82 [4b 4c])
	// 0200a4040010a000000018300301000000000000000000 (resp 02 6a 82 [4b 4c])
	//03 = ?  (resp 03 [e3 c2])
	//c2 = ?  (resp c2 [66 15])
	//b2 = ?  (resp a3 [e9 67])
	bool crc = true;
	*datalen = 3;
	//std read cmd
	data[0] = 0x05;
	data[1] = 0x00;
	data[2] = 0x08;

	if (HF14BCmdRaw(true, &crc, false, data, datalen, false)==0) return 0;

	if (data[0] != 0x50  || *datalen != 14 || !crc) return 0;

	PrintAndLog ("\n14443-3b tag found:");
	PrintAndLog ("           UID: %s", sprint_hex(data+1,4));

	return 1;
}

// 14b get and print Full Info (as much as we know)
int HF14BStdInfo(uint8_t *data, uint8_t *datalen){
	if (!HF14BStdReader(data,datalen)) return 0;

	//add more info here
	print_atqb_resp(data);

	return 1;
}

// SRx get and print general info about SRx chip from UID
int HF14B_ST_Reader(uint8_t *data, uint8_t *datalen, bool closeCon){
	bool crc = true;
	*datalen = 2;
	//wake cmd
	data[0] = 0x06;
	data[1] = 0x00;

	//leave power on
	// verbose on for now for testing - turn off when functional
	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)==0) return rawClose();

	if (*datalen != 3 || !crc) return rawClose();

	uint8_t chipID = data[0];
	// select
	data[0] = 0x0E;
	data[1] = chipID;
	*datalen = 2;

	//leave power on
	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)==0) return rawClose();

	if (*datalen != 3 || !crc || data[0] != chipID) return rawClose();

	// get uid
	data[0] = 0x0B;
	*datalen = 1;

	//leave power on
	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)==0) return rawClose();
	//power off ?
	if (closeCon) rawClose();

	if (*datalen != 10 || !crc) return 0;

	PrintAndLog("\n14443-3b ST tag found:");
	print_st_general_info(data);
	return 1;
}

// SRx get and print full info (needs more info...)
int HF14B_ST_Info(uint8_t *data, uint8_t *datalen){
	if (!HF14B_ST_Reader(data, datalen, false)) return 0;
	
	//add locking bit information here.
	if (print_ST_Lock_info(data[5]>>2)) 
		rawClose();

	return 1;
}

// test for other 14b type tags (mimic another reader - don't have tags to identify)
int HF14B_Other_Reader(uint8_t *data, uint8_t *datalen){
	bool crc = true;
	*datalen = 4;
	//std read cmd
	data[0] = 0x00;
	data[1] = 0x0b;
	data[2] = 0x3f;
	data[3] = 0x80;

	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)!=0) {
		if (*datalen > 2 || !crc) {
			PrintAndLog ("\n14443-3b tag found:");
			PrintAndLog ("Unknown tag type answered to a 0x000b3f80 command ans:");
			PrintAndLog ("%s",sprint_hex(data,*datalen));
			rawClose();
			return 1;
		}
	}

	crc = false;
	*datalen = 1;
	data[0] = 0x0a;

	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)!=0) {
		if (*datalen > 0) {
			PrintAndLog ("\n14443-3b tag found:");
			PrintAndLog ("Unknown tag type answered to a 0x0A command ans:");
			PrintAndLog ("%s",sprint_hex(data,*datalen));
			rawClose();
			return 1;
		}
	}
	
	crc = false;
	*datalen = 1;
	data[0] = 0x0c;

	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)!=0) {
		if (*datalen > 0) {
			PrintAndLog ("\n14443-3b tag found:");
			PrintAndLog ("Unknown tag type answered to a 0x0C command ans:");
			PrintAndLog ("%s",sprint_hex(data,*datalen));
			rawClose();
			return 1;
		}
	}
	rawClose();
	return 0;
}

// get and print all info known about any known 14b tag
int HF14BInfo(bool verbose){
	uint8_t data[100];
	uint8_t datalen = 5;
	
	// try std 14b (atqb)
	if (HF14BStdInfo(data, &datalen)) return 1;

	// try st 14b
	if (HF14B_ST_Info(data, &datalen)) return 1;

	// try unknown 14b read commands (to be identified later)
	//   could be read of calypso, CEPAS, moneo, or pico pass.
	if (HF14B_Other_Reader(data, &datalen)) return 1;

	if (verbose) PrintAndLog("no 14443B tag found");
	return 0;
}

// menu command to get and print all info known about any known 14b tag
int CmdHF14Binfo(const char *Cmd){
	return HF14BInfo(true);
}

// get and print general info about all known 14b chips
int HF14BReader(bool verbose){
	uint8_t data[100];
	uint8_t datalen = 5;
	
	// try std 14b (atqb)
	if (HF14BStdReader(data, &datalen)) return 1;

	// try st 14b
	if (HF14B_ST_Reader(data, &datalen, true)) return 1;

	// try unknown 14b read commands (to be identified later)
	//   could be read of calypso, CEPAS, moneo, or pico pass.
	if (HF14B_Other_Reader(data, &datalen)) return 1;

	if (verbose) PrintAndLog("no 14443B tag found");
	return 0;
}

// menu command to get and print general info about all known 14b chips
int CmdHF14BReader(const char *Cmd){
	return HF14BReader(true);
}

int CmdSriWrite( const char *Cmd){
/*
 * For SRIX4K  blocks 00 - 7F
 * hf 14b raw -c -p 09 $srix4kwblock $srix4kwdata
 *
 * For SR512  blocks 00 - 0F
 * hf 14b raw -c -p 09 $sr512wblock $sr512wdata
 * 
 * Special block FF =  otp_lock_reg block.
 * Data len 4 bytes-
 */
 	char cmdp = param_getchar(Cmd, 0);
	uint8_t blockno = -1;
	uint8_t data[4] = {0x00};
	bool isSrix4k = true;
	char str[20];	

	if (strlen(Cmd) < 1 || cmdp == 'h' || cmdp == 'H') {
		PrintAndLog("Usage:  hf 14b write <1|2> <BLOCK> <DATA>");
		PrintAndLog("    [1 = SRIX4K]");
		PrintAndLog("    [2 = SRI512]");
		PrintAndLog("    [BLOCK number depends on tag, special block == FF]");
		PrintAndLog("     sample: hf 14b write 1 7F 11223344");
		PrintAndLog("           : hf 14b write 1 FF 11223344");
		PrintAndLog("           : hf 14b write 2 15 11223344");
		PrintAndLog("           : hf 14b write 2 FF 11223344");
		return 0;
	}

	if ( cmdp == '2' )
		isSrix4k = false;
	
	//blockno = param_get8(Cmd, 1);
	
	if ( param_gethex(Cmd,1, &blockno, 2) ) {
		PrintAndLog("Block number must include 2 HEX symbols");
		return 0;
	}
	
	if ( isSrix4k ){
		if ( blockno > 0x7f && blockno != 0xff ){
			PrintAndLog("Block number out of range");
			return 0;
		}		
	} else {
		if ( blockno > 0x0f && blockno != 0xff ){
			PrintAndLog("Block number out of range");
			return 0;
		}		
	}
	
	if (param_gethex(Cmd, 2, data, 8)) {
		PrintAndLog("Data must include 8 HEX symbols");
		return 0;
	}
 
	if ( blockno == 0xff)
		PrintAndLog("[%s] Write special block %02X [ %s ]", (isSrix4k)?"SRIX4K":"SRI512" , blockno,  sprint_hex(data,4) );
	else
		PrintAndLog("[%s] Write block %02X [ %s ]", (isSrix4k)?"SRIX4K":"SRI512", blockno,  sprint_hex(data,4) );
 
	sprintf(str, "-c 09 %02x %02x%02x%02x%02x", blockno, data[0], data[1], data[2], data[3]);

	CmdHF14BCmdRaw(str);
	return 0;
}

static command_t CommandTable[] = 
{
  {"help",        CmdHelp,        1, "This help"},
  {"info",        CmdHF14Binfo,   0, "Find and print details about a 14443B tag"},
  {"list",        CmdHF14BList,   0, "[Deprecated] List ISO 14443B history"},
  {"reader",      CmdHF14BReader, 0, "Act as a 14443B reader to identify a tag"},
  {"sim",         CmdHF14BSim,    0, "Fake ISO 14443B tag"},
  {"snoop",       CmdHF14BSnoop,  0, "Eavesdrop ISO 14443B"},
  {"sri512read",  CmdSri512Read,  0, "Read contents of a SRI512 tag"},
  {"srix4kread",  CmdSrix4kRead,  0, "Read contents of a SRIX4K tag"},
  {"sriwrite",    CmdSriWrite,    0, "Write data to a SRI512 | SRIX4K tag"},
  {"raw",         CmdHF14BCmdRaw, 0, "Send raw hex data to tag"},
  {NULL, NULL, 0, NULL}
};

int CmdHF14B(const char *Cmd)
{
  CmdsParse(CommandTable, Cmd);
  return 0;
}

int CmdHelp(const char *Cmd)
{
  CmdsHelp(CommandTable);
  return 0;
}
Commit	Line	Data
a553f267	1	//-----------------------------------------------------------------------------
	2	// Copyright (C) 2010 iZsh <izsh at fail0verflow.com>
	3	//
	4	// This code is licensed to you under the terms of the GNU GPL, version 2 or,
	5	// at your option, any later version. See the LICENSE.txt file for the text of
	6	// the license.
	7	//-----------------------------------------------------------------------------
	8	// High frequency ISO14443B commands
	9	//-----------------------------------------------------------------------------
	10
7fe9b0b7	11	#include <stdio.h>
	12	#include <stdlib.h>
	13	#include <stdbool.h>
	14	#include <string.h>
	15	#include <stdint.h>
	16	#include "iso14443crc.h"
902cb3c0	17	#include "proxmark3.h"
7fe9b0b7	18	#include "data.h"
7fe9b0b7	19	#include "graph.h"
3fe4ff4f	20	#include "util.h"
7fe9b0b7	21	#include "ui.h"
	22	#include "cmdparser.h"
	23	#include "cmdhf14b.h"
7cf3ef20	24	#include "cmdmain.h"
ff4fdb32	25	#include "cmdhf14a.h"
7fe9b0b7	26
	27	static int CmdHelp(const char *Cmd);
	28
7fe9b0b7	29	int CmdHF14BList(const char *Cmd)
7fe9b0b7	30	{
388c92bd	31	PrintAndLog("Deprecated command, use 'hf list 14b' instead");
7fe9b0b7	32
388c92bd	33	return 0;
7fe9b0b7	34	}
7fe9b0b7	35
132a0217	36	int CmdHF14BSim(const char *Cmd)
7fe9b0b7	37	{
132a0217	38	UsbCommand c={CMD_SIMULATE_TAG_ISO_14443B};
ff4fdb32	39	clearCommandBuffer();
7fe9b0b7	40	SendCommand(&c);
	41	return 0;
	42	}
	43
	44	int CmdHF14BSnoop(const char *Cmd)
	45	{
132a0217	46	UsbCommand c = {CMD_SNOOP_ISO_14443B};
ff4fdb32	47	clearCommandBuffer();
7fe9b0b7	48	SendCommand(&c);
	49	return 0;
	50	}
	51
	52	/* New command to read the contents of a SRI512 tag
	53	* SRI512 tags are ISO14443-B modulated memory tags,
	54	* this command just dumps the contents of the memory
	55	*/
	56	int CmdSri512Read(const char *Cmd)
	57	{
	58	UsbCommand c = {CMD_READ_SRI512_TAG, {strtol(Cmd, NULL, 0), 0, 0}};
ff4fdb32	59	clearCommandBuffer();
7fe9b0b7	60	SendCommand(&c);
	61	return 0;
	62	}
	63
	64	/* New command to read the contents of a SRIX4K tag
	65	* SRIX4K tags are ISO14443-B modulated memory tags,
	66	* this command just dumps the contents of the memory/
	67	*/
	68	int CmdSrix4kRead(const char *Cmd)
	69	{
	70	UsbCommand c = {CMD_READ_SRIX4K_TAG, {strtol(Cmd, NULL, 0), 0, 0}};
ff4fdb32	71	clearCommandBuffer();
7fe9b0b7	72	SendCommand(&c);
	73	return 0;
	74	}
	75
ff4fdb32	76	int rawClose(void){
	77	UsbCommand resp;
	78	UsbCommand c = {CMD_ISO_14443B_COMMAND, {0, 0, 0}};
	79	clearCommandBuffer();
	80	SendCommand(&c);
	81	if (!WaitForResponseTimeout(CMD_ACK,&resp,1000)) {
	82	return 0;
	83	}
	84	return 0;
	85	}
	86
	87	int HF14BCmdRaw(bool reply, bool crc, bool power, uint8_t data, uint8_t *datalen, bool verbose){
	88	UsbCommand resp;
	89	UsbCommand c = {CMD_ISO_14443B_COMMAND, {0, 0, 0}}; // len,recv,power
	90	if(*crc)
	91	{
	92	uint8_t first, second;
	93	ComputeCrc14443(CRC_14443_B, data, *datalen, &first, &second);
	94	data[*datalen] = first;
	95	data[*datalen + 1] = second;
	96	*datalen += 2;
	97	}
	98
	99	c.arg[0] = *datalen;
	100	c.arg[1] = reply;
	101	c.arg[2] = power;
	102	memcpy(c.d.asBytes,data,*datalen);
	103	clearCommandBuffer();
	104	SendCommand(&c);
	105
	106	if (!reply) return 1;
	107
	108	if (!WaitForResponseTimeout(CMD_ACK,&resp,1000)) {
	109	if (verbose) PrintAndLog("timeout while waiting for reply.");
	110	return 0;
	111	}
	112	*datalen = resp.arg[0];
	113	if (verbose) PrintAndLog("received %u octets", *datalen);
	114	if(*datalen<2) return 0;
	115
	116	memcpy(data, resp.d.asBytes, *datalen);
	117	if (verbose) PrintAndLog("%s", sprint_hex(data, *datalen));
	118
	119	uint8_t first, second;
	120	ComputeCrc14443(CRC_14443_B, data, *datalen-2, &first, &second);
	121	if(data[datalen-2] == first && data[datalen-1] == second) {
	122	if (verbose) PrintAndLog("CRC OK");
	123	*crc = true;
	124	} else {
	125	if (verbose) PrintAndLog("CRC failed");
	126	*crc = false;
	127	}
	128	return 1;
	129	}
	130
	131	int CmdHF14BCmdRaw (const char *Cmd) {
	132	bool reply = true;
	133	bool crc = false;
	134	bool power = false;
	135	char buf[5] = "";
	136	uint8_t data[100] = {0x00};
	137	uint8_t datalen = 0;
	138	unsigned int temp;
	139	int i = 0;
140	if (strlen(Cmd)<3) {
141	PrintAndLog("Usage: hf 14b raw [-r] [-c] [-p] <0A 0B 0C ... hex>");
142	PrintAndLog(" -r do not read response");
143	PrintAndLog(" -c calculate and append CRC");
144	PrintAndLog(" -p leave the field on after receive");
145	return 0;
146	}
147
148	// strip
149	while (Cmd==' ' \|\| Cmd=='\t') Cmd++;
150
151	while (Cmd[i]!='\0') {
152	if (Cmd[i]==' ' \|\| Cmd[i]=='\t') { i++; continue; }
153	if (Cmd[i]=='-') {
154	switch (Cmd[i+1]) {
155	case 'r':
156	case 'R':
157	reply = false;
158	break;
159	case 'c':
160	case 'C':
161	crc = true;
162	break;
163	case 'p':
164	case 'P':
165	power = true;
166	break;
167	default:
168	PrintAndLog("Invalid option");
169	return 0;
170	}
171	i+=2;
172	continue;
173	}
174	if ((Cmd[i]>='0' && Cmd[i]<='9') \|\|
175	(Cmd[i]>='a' && Cmd[i]<='f') \|\|
176	(Cmd[i]>='A' && Cmd[i]<='F') ) {
177	buf[strlen(buf)+1]=0;
178	buf[strlen(buf)]=Cmd[i];
179	i++;
180
181	if (strlen(buf)>=2) {
182	sscanf(buf,"%x",&temp);
183	data[datalen++]=(uint8_t)(temp & 0xff);
184	*buf=0;
185	}
186	continue;
187	}
188	PrintAndLog("Invalid char on input");
189	return 1;
190	}
191	if (datalen == 0)
192	{
193	PrintAndLog("Missing data input");
194	return 0;
195	}
196
197	return HF14BCmdRaw(reply, &crc, power, data, &datalen, true);
7cf3ef20	198	}
7cf3ef20	199
b29d55f2	200	// print full atqb info
ff4fdb32	201	static void print_atqb_resp(uint8_t *data){
	202	PrintAndLog (" UID: %s", sprint_hex(data+1,4));
	203	PrintAndLog (" App Data: %s", sprint_hex(data+5,4));
	204	PrintAndLog (" Protocol: %s", sprint_hex(data+9,3));
	205	uint8_t BitRate = data[9];
	206	if (!BitRate)
	207	PrintAndLog (" Bit Rate: 106 kbit/s only PICC <-> PCD");
	208	if (BitRate & 0x10)
	209	PrintAndLog (" Bit Rate: 212 kbit/s PICC -> PCD supported");
	210	if (BitRate & 0x20)
	211	PrintAndLog (" Bit Rate: 424 kbit/s PICC -> PCD supported");
	212	if (BitRate & 0x40)
	213	PrintAndLog (" Bit Rate: 847 kbit/s PICC -> PCD supported");
	214	if (BitRate & 0x01)
	215	PrintAndLog (" Bit Rate: 212 kbit/s PICC <- PCD supported");
	216	if (BitRate & 0x02)
	217	PrintAndLog (" Bit Rate: 424 kbit/s PICC <- PCD supported");
	218	if (BitRate & 0x04)
	219	PrintAndLog (" Bit Rate: 847 kbit/s PICC <- PCD supported");
	220	if (BitRate & 0x80)
	221	PrintAndLog (" Same bit rate <-> required");
	222
	223	uint16_t maxFrame = data[10]>>4;
	224	if (maxFrame < 5)
	225	maxFrame = 8*maxFrame + 16;
	226	else if (maxFrame == 5)
	227	maxFrame = 64;
	228	else if (maxFrame == 6)
	229	maxFrame = 96;
	230	else if (maxFrame == 7)
	231	maxFrame = 128;
	232	else if (maxFrame == 8)
	233	maxFrame = 256;
	234	else
	235	maxFrame = 257;
	236
	237	PrintAndLog ("Max Frame Size: %d%s",maxFrame, (maxFrame == 257) ? "+ RFU" : "");
	238
	239	uint8_t protocolT = data[10] & 0xF;
	240	PrintAndLog (" Protocol Type: Protocol is %scompliant with ISO/IEC 14443-4",(protocolT) ? "" : "not " );
	241	PrintAndLog ("Frame Wait Int: %d", data[11]>>4);
	242	PrintAndLog (" App Data Code: Application is %s",(data[11]&4) ? "Standard" : "Proprietary");
	243	PrintAndLog (" Frame Options: NAD is %ssupported",(data[11]&2) ? "" : "not ");
	244	PrintAndLog (" Frame Options: CID is %ssupported",(data[11]&1) ? "" : "not ");
	245
	246	return;
	247	}
	248
b29d55f2	249	// get SRx chip model (from UID) // from ST Microelectronics
ff4fdb32	250	char *get_ST_Chip_Model(uint8_t data){
	251	static char model[20];
	252	char *retStr = model;
	253	memset(model,0, sizeof(model));
	254
	255	switch (data) {
	256	case 0x0: sprintf(retStr, "SRIX4K (Special)"); break;
	257	case 0x2: sprintf(retStr, "SR176"); break;
	258	case 0x3: sprintf(retStr, "SRIX4K"); break;
	259	case 0x4: sprintf(retStr, "SRIX512"); break;
	260	case 0x6: sprintf(retStr, "SRI512"); break;
	261	case 0x7: sprintf(retStr, "SRI4K"); break;
	262	case 0xC: sprintf(retStr, "SRT512"); break;
	263	default : sprintf(retStr, "Unknown"); break;
	264	}
	265	return retStr;
	266	}
	267
cc34cc7b	268	int print_ST_Lock_info(uint8_t model){
	269	//assume connection open and tag selected...
	270	uint8_t data[8] = {0x00};
	271	uint8_t datalen = 2;
	272	bool crc = true;
	273	uint8_t resplen;
	274	uint8_t blk1;
	275	data[0] = 0x08;
	276
	277	if (model == 0x2) { //SR176 has special command:
	278	data[1] = 0xf;
	279	resplen = 4;
	280	} else {
	281	data[1] = 0xff;
	282	resplen = 6;
	283	}
	284
	285	//std read cmd
	286	if (HF14BCmdRaw(true, &crc, true, data, &datalen, false)==0) return rawClose();
	287
	288	if (datalen != resplen \|\| !crc) return rawClose();
	289
	290	PrintAndLog("Chip Write Protection Bits:");
	291	// now interpret the data
	292	switch (model){
	293	case 0x0: //fall through (SRIX4K special)
	294	case 0x3: //fall through (SRIx4K)
	295	case 0x7: // (SRI4K)
	296	//only need data[3]
	297	blk1 = 9;
8e00825a	298	PrintAndLog(" raw: %s",printBits(1,data+3));
cc34cc7b	299	PrintAndLog(" 07/08: %slocked", blk1, (data[3] & 1) ? "not " : "" );
	300	for (uint8_t i = 1; i<8; i++){
	301	PrintAndLog(" %02u: %slocked", blk1, (data[3] & (1 << i)) ? "not " : "" );
	302	blk1++;
	303	}
	304	break;
	305	case 0x4: //fall through (SRIX512)
	306	case 0x6: //fall through (SRI512)
	307	case 0xC: // (SRT512)
	308	//need data[2] and data[3]
	309	blk1 = 0;
8e00825a	310	PrintAndLog(" raw: %s",printBits(2,data+2));
cc34cc7b	311	for (uint8_t b=2; b<4; b++){
	312	for (uint8_t i=0; i<8; i++){
	313	PrintAndLog(" %02u: %slocked", blk1, (data[b] & (1 << i)) ? "not " : "" );
	314	blk1++;
	315	}
	316	}
	317	break;
	318	case 0x2: // (SR176)
	319	//need data[2]
	320	blk1 = 0;
8e00825a	321	PrintAndLog(" raw: %s",printBits(1,data+2));
cc34cc7b	322	for (uint8_t i = 0; i<8; i++){
	323	PrintAndLog(" %02u/%02u: %slocked", blk1, blk1+1, (data[2] & (1 << i)) ? "" : "not " );
	324	blk1+=2;
	325	}
	326	break;
	327	default:
	328	return rawClose();
	329	}
	330	return 1;
	331	}
	332
b29d55f2	333	// print UID info from SRx chips (ST Microelectronics)
b29d55f2	334	static void print_st_general_info(uint8_t *data){
ff4fdb32	335	//uid = first 8 bytes in data
cc34cc7b	336	PrintAndLog(" UID: %s", sprint_hex(SwapEndian64(data,8,8),8));
	337	PrintAndLog(" MFG: %02X, %s", data[6], getTagInfo(data[6]));
	338	PrintAndLog(" Chip: %02X, %s", data[5]>>2, get_ST_Chip_Model(data[5]>>2));
ff4fdb32	339	return;
	340	}
	341
b29d55f2	342	// 14b get and print UID only (general info)
b29d55f2	343	int HF14BStdReader(uint8_t data, uint8_t datalen){
ff4fdb32	344	//05 00 00 = find one tag in field
	345	//1d xx xx xx xx 20 00 08 01 00 = attrib xx=crc
	346	//a3 = ? (resp 03 e2 c2)
	347	//02 = ? (resp 02 6a d3)
	348	// 022b (resp 02 67 00 [29 5b])
	349	// 0200a40400 (resp 02 67 00 [29 5b])
	350	// 0200a4040c07a0000002480300 (resp 02 67 00 [29 5b])
	351	// 0200a4040c07a0000002480200 (resp 02 67 00 [29 5b])
	352	// 0200a4040006a0000000010100 (resp 02 6a 82 [4b 4c])
	353	// 0200a4040c09d27600002545500200 (resp 02 67 00 [29 5b])
	354	// 0200a404000cd2760001354b414e4d30310000 (resp 02 6a 82 [4b 4c])
	355	// 0200a404000ca000000063504b43532d313500 (resp 02 6a 82 [4b 4c])
	356	// 0200a4040010a000000018300301000000000000000000 (resp 02 6a 82 [4b 4c])
	357	//03 = ? (resp 03 [e3 c2])
	358	//c2 = ? (resp c2 [66 15])
	359	//b2 = ? (resp a3 [e9 67])
	360	bool crc = true;
	361	*datalen = 3;
	362	//std read cmd
	363	data[0] = 0x05;
	364	data[1] = 0x00;
b29d55f2	365	data[2] = 0x08;
ff4fdb32	366
	367	if (HF14BCmdRaw(true, &crc, false, data, datalen, false)==0) return 0;
	368
	369	if (data[0] != 0x50 \|\| *datalen != 14 \|\| !crc) return 0;
	370
	371	PrintAndLog ("\n14443-3b tag found:");
b29d55f2	372	PrintAndLog (" UID: %s", sprint_hex(data+1,4));
ff4fdb32	373
	374	return 1;
	375	}
	376
8a258b58	377	// 14b get and print Full Info (as much as we know)
	378	int HF14BStdInfo(uint8_t data, uint8_t datalen){
	379	if (!HF14BStdReader(data,datalen)) return 0;
b29d55f2	380
8a258b58	381	//add more info here
8a258b58	382	print_atqb_resp(data);
b29d55f2	383
	384	return 1;
	385	}
	386
	387	// SRx get and print general info about SRx chip from UID
cc34cc7b	388	int HF14B_ST_Reader(uint8_t data, uint8_t datalen, bool closeCon){
ff4fdb32	389	bool crc = true;
	390	*datalen = 2;
	391	//wake cmd
	392	data[0] = 0x06;
	393	data[1] = 0x00;
	394
	395	//leave power on
	396	// verbose on for now for testing - turn off when functional
	397	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)==0) return rawClose();
	398
	399	if (*datalen != 3 \|\| !crc) return rawClose();
	400
	401	uint8_t chipID = data[0];
	402	// select
	403	data[0] = 0x0E;
	404	data[1] = chipID;
	405	*datalen = 2;
	406
	407	//leave power on
ff4fdb32	408	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)==0) return rawClose();
	409
	410	if (*datalen != 3 \|\| !crc \|\| data[0] != chipID) return rawClose();
	411
	412	// get uid
	413	data[0] = 0x0B;
	414	*datalen = 1;
	415
cc34cc7b	416	//leave power on
	417	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)==0) return rawClose();
	418	//power off ?
	419	if (closeCon) rawClose();
	420
ff4fdb32	421	if (*datalen != 10 \|\| !crc) return 0;
	422
	423	PrintAndLog("\n14443-3b ST tag found:");
b29d55f2	424	print_st_general_info(data);
ff4fdb32	425	return 1;
	426	}
	427
8a258b58	428	// SRx get and print full info (needs more info...)
8a258b58	429	int HF14B_ST_Info(uint8_t data, uint8_t datalen){
cc34cc7b	430	if (!HF14B_ST_Reader(data, datalen, false)) return 0;
8a258b58	431
8a258b58	432	//add locking bit information here.
cc34cc7b	433	if (print_ST_Lock_info(data[5]>>2))
cc34cc7b	434	rawClose();
8a258b58	435
	436	return 1;
	437	}
	438
ff4fdb32	439	// test for other 14b type tags (mimic another reader - don't have tags to identify)
b29d55f2	440	int HF14B_Other_Reader(uint8_t data, uint8_t datalen){
ff4fdb32	441	bool crc = true;
	442	*datalen = 4;
	443	//std read cmd
	444	data[0] = 0x00;
	445	data[1] = 0x0b;
	446	data[2] = 0x3f;
	447	data[3] = 0x80;
	448
b29d55f2	449	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)!=0) {
ff4fdb32	450	if (*datalen > 2 \|\| !crc) {
	451	PrintAndLog ("\n14443-3b tag found:");
	452	PrintAndLog ("Unknown tag type answered to a 0x000b3f80 command ans:");
	453	PrintAndLog ("%s",sprint_hex(data,*datalen));
cc34cc7b	454	rawClose();
ff4fdb32	455	return 1;
	456	}
	457	}
	458
	459	crc = false;
	460	*datalen = 1;
	461	data[0] = 0x0a;
	462
b29d55f2	463	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)!=0) {
ff4fdb32	464	if (*datalen > 0) {
	465	PrintAndLog ("\n14443-3b tag found:");
	466	PrintAndLog ("Unknown tag type answered to a 0x0A command ans:");
	467	PrintAndLog ("%s",sprint_hex(data,*datalen));
cc34cc7b	468	rawClose();
ff4fdb32	469	return 1;
	470	}
	471	}
	472
	473	crc = false;
	474	*datalen = 1;
	475	data[0] = 0x0c;
	476
b29d55f2	477	if (HF14BCmdRaw(true, &crc, true, data, datalen, false)!=0) {
ff4fdb32	478	if (*datalen > 0) {
	479	PrintAndLog ("\n14443-3b tag found:");
	480	PrintAndLog ("Unknown tag type answered to a 0x0C command ans:");
	481	PrintAndLog ("%s",sprint_hex(data,*datalen));
cc34cc7b	482	rawClose();
ff4fdb32	483	return 1;
	484	}
	485	}
b29d55f2	486	rawClose();
ff4fdb32	487	return 0;
ff4fdb32	488	}
ff4fdb32	489
b29d55f2	490	// get and print all info known about any known 14b tag
ff4fdb32	491	int HF14BInfo(bool verbose){
	492	uint8_t data[100];
	493	uint8_t datalen = 5;
	494
	495	// try std 14b (atqb)
	496	if (HF14BStdInfo(data, &datalen)) return 1;
	497
	498	// try st 14b
	499	if (HF14B_ST_Info(data, &datalen)) return 1;
	500
	501	// try unknown 14b read commands (to be identified later)
	502	// could be read of calypso, CEPAS, moneo, or pico pass.
b29d55f2	503	if (HF14B_Other_Reader(data, &datalen)) return 1;
ff4fdb32	504
	505	if (verbose) PrintAndLog("no 14443B tag found");
	506	return 0;
	507	}
	508
b29d55f2	509	// menu command to get and print all info known about any known 14b tag
ff4fdb32	510	int CmdHF14Binfo(const char *Cmd){
	511	return HF14BInfo(true);
	512	}
3fe4ff4f	513
b29d55f2	514	// get and print general info about all known 14b chips
	515	int HF14BReader(bool verbose){
	516	uint8_t data[100];
	517	uint8_t datalen = 5;
	518
	519	// try std 14b (atqb)
	520	if (HF14BStdReader(data, &datalen)) return 1;
	521
	522	// try st 14b
cc34cc7b	523	if (HF14B_ST_Reader(data, &datalen, true)) return 1;
b29d55f2	524
	525	// try unknown 14b read commands (to be identified later)
	526	// could be read of calypso, CEPAS, moneo, or pico pass.
	527	if (HF14B_Other_Reader(data, &datalen)) return 1;
	528
	529	if (verbose) PrintAndLog("no 14443B tag found");
	530	return 0;
	531	}
	532
	533	// menu command to get and print general info about all known 14b chips
	534	int CmdHF14BReader(const char *Cmd){
	535	return HF14BReader(true);
	536	}
	537
ff4fdb32	538	int CmdSriWrite( const char *Cmd){
3fe4ff4f	539	/*
	540	* For SRIX4K blocks 00 - 7F
	541	* hf 14b raw -c -p 09 $srix4kwblock $srix4kwdata
	542	*
	543	* For SR512 blocks 00 - 0F
	544	* hf 14b raw -c -p 09 $sr512wblock $sr512wdata
	545	*
	546	* Special block FF = otp_lock_reg block.
	547	* Data len 4 bytes-
	548	*/
	549	char cmdp = param_getchar(Cmd, 0);
	550	uint8_t blockno = -1;
	551	uint8_t data[4] = {0x00};
	552	bool isSrix4k = true;
	553	char str[20];
	554
b5be31f9	555	if (strlen(Cmd) < 1 \|\| cmdp == 'h' \|\| cmdp == 'H') {
3fe4ff4f	556	PrintAndLog("Usage: hf 14b write <1\|2> <BLOCK> <DATA>");
b5be31f9	557	PrintAndLog(" [1 = SRIX4K]");
	558	PrintAndLog(" [2 = SRI512]");
	559	PrintAndLog(" [BLOCK number depends on tag, special block == FF]");
	560	PrintAndLog(" sample: hf 14b write 1 7F 11223344");
	561	PrintAndLog(" : hf 14b write 1 FF 11223344");
	562	PrintAndLog(" : hf 14b write 2 15 11223344");
	563	PrintAndLog(" : hf 14b write 2 FF 11223344");
3fe4ff4f	564	return 0;
	565	}
	566
b5be31f9	567	if ( cmdp == '2' )
3fe4ff4f	568	isSrix4k = false;
3fe4ff4f	569
b5be31f9	570	//blockno = param_get8(Cmd, 1);
	571
	572	if ( param_gethex(Cmd,1, &blockno, 2) ) {
	573	PrintAndLog("Block number must include 2 HEX symbols");
	574	return 0;
	575	}
3fe4ff4f	576
	577	if ( isSrix4k ){
	578	if ( blockno > 0x7f && blockno != 0xff ){
	579	PrintAndLog("Block number out of range");
	580	return 0;
	581	}
	582	} else {
	583	if ( blockno > 0x0f && blockno != 0xff ){
	584	PrintAndLog("Block number out of range");
	585	return 0;
	586	}
	587	}
	588
	589	if (param_gethex(Cmd, 2, data, 8)) {
	590	PrintAndLog("Data must include 8 HEX symbols");
	591	return 0;
	592	}
	593
	594	if ( blockno == 0xff)
b5be31f9	595	PrintAndLog("[%s] Write special block %02X [ %s ]", (isSrix4k)?"SRIX4K":"SRI512" , blockno, sprint_hex(data,4) );
3fe4ff4f	596	else
b5be31f9	597	PrintAndLog("[%s] Write block %02X [ %s ]", (isSrix4k)?"SRIX4K":"SRI512", blockno, sprint_hex(data,4) );
3fe4ff4f	598
fe5b3a44	599	sprintf(str, "-c 09 %02x %02x%02x%02x%02x", blockno, data[0], data[1], data[2], data[3]);
b5be31f9	600
3fe4ff4f	601	CmdHF14BCmdRaw(str);
	602	return 0;
	603	}
	604
7fe9b0b7	605	static command_t CommandTable[] =
	606	{
	607	{"help", CmdHelp, 1, "This help"},
b29d55f2	608	{"info", CmdHF14Binfo, 0, "Find and print details about a 14443B tag"},
	609	{"list", CmdHF14BList, 0, "[Deprecated] List ISO 14443B history"},
	610	{"reader", CmdHF14BReader, 0, "Act as a 14443B reader to identify a tag"},
132a0217	611	{"sim", CmdHF14BSim, 0, "Fake ISO 14443B tag"},
132a0217	612	{"snoop", CmdHF14BSnoop, 0, "Eavesdrop ISO 14443B"},
7cf3ef20	613	{"sri512read", CmdSri512Read, 0, "Read contents of a SRI512 tag"},
7cf3ef20	614	{"srix4kread", CmdSrix4kRead, 0, "Read contents of a SRIX4K tag"},
ff4fdb32	615	{"sriwrite", CmdSriWrite, 0, "Write data to a SRI512 \| SRIX4K tag"},
7cf3ef20	616	{"raw", CmdHF14BCmdRaw, 0, "Send raw hex data to tag"},
7fe9b0b7	617	{NULL, NULL, 0, NULL}
	618	};
	619
	620	int CmdHF14B(const char *Cmd)
	621	{
	622	CmdsParse(CommandTable, Cmd);
	623	return 0;
	624	}
	625
	626	int CmdHelp(const char *Cmd)
	627	{
	628	CmdsHelp(CommandTable);
	629	return 0;
	630	}