Subversion Repositories usb_fpga_1_11

/*!

   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;

        }

    }

}