Subversion Repositories usb_fpga_1_15

/*!
   Java host software API of ZTEX EZ-USB FX2 SDK
   Copyright (C) 2009-2011 ZTEX GmbH.
   http://www.ztex.de
 
   This program is free software; you can redistribute it and/or modify
   it under the terms of the GNU General Public License version 3 as
   published by the Free Software Foundation.
 
   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 http://www.gnu.org/licenses/.
!*/
 
/* 
    Reads an ihx file
*/
package ztex;
 
import java.io.*;
import java.util.*;
import java.net.*;
/**
  * A class representing a firmware image loaded from an ihx (Intel Hex format) file.
  */
public class IhxFile {
 
/**
  * This array stores the firmware image.
  * Values <0 and >255 mean that the data is undefined.
  */
    public short ihxData[] = new short[65536];
 
// ******* readHexDigit ********************************************************
    private static final int readHexDigit( InputStream in ) throws IOException, IhxParseException {
        int b = in.read();
	if ( b>=(byte) '0' && b<=(byte) '9' )
	    return b-(byte) '0';
	if ( b>=(byte) 'a' && b<=(byte) 'f' )
	    return 10+b-(byte) 'a';
	if ( b>=(byte) 'A' && b<=(byte) 'F' )
	    return 10+b-(byte) 'A';
	if ( b == -1 )
	    throw new IhxParseException( "Inexpected end of file" );
	throw new IhxParseException( "Hex digit expected: " + (char) b );
    }
 
// ******* readHexByte *********************************************************
    private static final int readHexByte(InputStream in) throws IOException, IhxParseException {
	return (readHexDigit(in) << 4) | readHexDigit(in);
    }
 
// ******* IhxFile *************************************************************
/**
  * Constructs an instance from a given file name.
  * This method can also read system resources, e.g. files from the current jar archive.
  * @param in Input stream from which the ihx file is read.
  * @param name Name of the input.
  * @throws IOException If an read error occurred.
  * @throws IhxFileDamagedException If the ihx file is damaged.
  */
    public IhxFile ( InputStream in, String name ) throws IOException, IhxFileDamagedException {
	int b, len, cs, addr;
	byte buf[] = new byte[255];
	boolean eof = false;
	int line = 0;
 
	for ( int i=0; i<ihxData.length; i++ )
	    ihxData[i] = -1;
 
	try {
	    while ( ! eof ) {
		do	{
		    b = in.read();
		    if ( b<0 )
			throw new IhxParseException( "Inexpected end of file" );
		} while ( b != (byte) ':' );
 
		line ++;
 
		len = readHexByte(in);		// length field 
		cs = len;
 
		b = readHexByte(in);		// address field 
		cs += b;
		addr = b << 8;
		b = readHexByte(in);
		cs += b;
		addr |= b;
 
		b = readHexByte(in);		// record type field
		cs += b;
 
		for ( int i=0; i<len; i++ ) {	// data
		    buf[i] = (byte) readHexByte(in);
		    cs+=buf[i];
		}
 
		cs += readHexByte(in);		// checksum
		if ( (cs & 0xff) != 0 ) {
		    throw new IhxParseException( "Checksum error" );
		}
 
		if ( b == 0 ) {			// data record
		    for (int i=0; i<len; i++ ) {
			if ( ihxData[addr+i]>=0 ) System.err.println ( "Warning: Memory at position " + Integer.toHexString(i) + " overwritten" );
			ihxData[addr+i] = (short) (buf[i] & 255);
		    }
		}
		else if (b == 1 ) {		// eof record
		    eof = true;
		}
		else {
		    throw new IhxParseException( "Invalid record type: " + b );
		}
	    }
	}
	catch ( IhxParseException e ) {
	    throw new IhxFileDamagedException ( name, line, e.getLocalizedMessage() );
	}
 
	try {
	    in.close();
	}
	catch ( Exception e ) {
	    System.err.println( "Warning: Error closing file " + name + ": " + e.getLocalizedMessage() );
	}
    }
 
/**
  * Constructs an instance from a given file name.
  * This method can also read system resources, e.g. files from the current jar archive.
  * @param fileName The file name.
  * @throws IOException If an read error occurred.
  * @throws IhxFileDamagedException If the ihx file is damaged.
  */
    public IhxFile ( String fileName ) throws IOException, IhxFileDamagedException {
	this( JInputStream.getInputStream( fileName ), fileName );
    }
 
// ******* dataInfo ************************************************************
 /**
  * Print out some information about the memory usage.
  * @param out Where the data is printed out.
  */
   public void dataInfo( PrintStream out ) {
	int addr=-1;
	for ( int i=0; i<=65536; i++ ) {	// data
	    if ( (i==65536 || ihxData[i]<0) && addr>=0 ) {
		System.out.println( i-addr + " Bytes from " + Integer.toHexString(addr) + " to " + Integer.toHexString(i-1) );
		addr = -1;
	    }
	    if ( i<65536 && ihxData[i]>=0 && addr<0 ) 
		addr = i;
	}
    }
 
}