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