Last active
July 17, 2024 01:38
-
-
Save mplewis/a8226348de276a9622df to your computer and use it in GitHub Desktop.
PTD's Intel Hex helper. This converts Intel Hex into NSData suitable for programming to a Bean. License: The MIT License
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
#import <Foundation/Foundation.h> | |
@interface PTDIntelHex : NSObject | |
@property (nonatomic, strong) NSString* name; | |
+ (PTDIntelHex*)intelHexFromHexString:(NSString*)hexString; | |
+ (PTDIntelHex*)intelHexFromFileURL:(NSURL*)file; | |
- (id)initWithHexString:(NSString*)hexString; | |
- (id)initWithFileURL:(NSURL*)file; | |
- (NSData*)bytes; | |
@end |
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
#import "PTDIntelHex.h" | |
typedef enum { | |
IntelHexLineRecordType_Data = 00, | |
IntelHexLineRecordType_EndOfFile = 01, | |
IntelHexLineRecordType_ExtendedSegmentAddress = 02, | |
IntelHexLineRecordType_StartSegmentAddress = 03, | |
IntelHexLineRecordType_ExtendedLinearAddress = 04, | |
IntelHexLineRecordType_StartLinearAddress = 05, | |
} IntelHexLineRecordType; | |
@interface IntelHexLine : NSObject | |
@property (nonatomic) UInt8 byteCount; | |
@property (nonatomic) UInt16 address; | |
@property (nonatomic) IntelHexLineRecordType recordType; | |
@property (nonatomic, strong) NSData* data; | |
@property (nonatomic) UInt8 checksum; | |
@end | |
@implementation IntelHexLine | |
@end | |
@interface PTDIntelHex () | |
@property NSURL* url; | |
@end | |
@implementation PTDIntelHex { | |
NSMutableArray* lines; | |
} | |
+ (PTDIntelHex*)intelHexFromHexString:(NSString*)hexString | |
{ | |
PTDIntelHex* h = [PTDIntelHex alloc]; | |
return [h initWithHexString:hexString]; | |
} | |
+ (PTDIntelHex*)intelHexFromFileURL:(NSURL*)file | |
{ | |
PTDIntelHex* h = [PTDIntelHex alloc]; | |
return [h initWithFileURL:file]; | |
} | |
- (id)initWithHexString:(NSString*)hexString | |
{ | |
self = [super init]; | |
lines = [[NSMutableArray alloc] init]; | |
if (self) { | |
if (![self parseHexString:hexString]) { | |
return nil; | |
} | |
} | |
return self; | |
} | |
- (id)initWithFileURL:(NSURL*)file | |
{ | |
self = [super init]; | |
if (self) { | |
NSString* tempName = [file lastPathComponent]; | |
NSRange range = [tempName rangeOfString:@"."]; | |
tempName = [tempName substringToIndex:range.location]; | |
_name = tempName; | |
lines = [[NSMutableArray alloc] init]; | |
NSError* err; | |
NSString* fileContents = [NSString stringWithContentsOfFile:file.path encoding:NSUTF8StringEncoding error:&err]; | |
if (![self parseHexString:fileContents]) { | |
return nil; | |
} | |
} | |
return self; | |
} | |
- (NSData*)bytes | |
{ | |
NSMutableData* imageData = [[NSMutableData alloc] init]; | |
for (IntelHexLine* line in lines) { | |
if (line.recordType == IntelHexLineRecordType_Data) { | |
[imageData appendData:line.data]; | |
} | |
} | |
return [imageData copy]; | |
} | |
- (BOOL)parseHexString:(NSString*)hexString | |
{ | |
NSArray* rawlines = [hexString componentsSeparatedByString:@"\n"]; | |
for (NSString* rawline in rawlines) { | |
if (rawline.length >= 11) { | |
if (![[rawline substringWithRange:NSMakeRange(0, 1)] isEqual:@":"]) { | |
return FALSE; | |
} | |
IntelHexLine* line = [[IntelHexLine alloc] init]; | |
line.byteCount = (UInt8)[self numberFromHexString : [rawline substringWithRange:NSMakeRange(1, 2)]]; | |
line.address = (UInt16)[self numberFromHexString : [rawline substringWithRange:NSMakeRange(3, 4)]]; | |
line.recordType = | |
(IntelHexLineRecordType)[self numberFromHexString : [rawline substringWithRange:NSMakeRange(7, 2)]]; | |
line.data = [self bytesFromHexString:[rawline substringWithRange:NSMakeRange(9, line.byteCount * 2)]]; | |
line.checksum = (UInt8)[self numberFromHexString : | |
[rawline substringWithRange:NSMakeRange(9 + (line.byteCount * 2), 2)]]; | |
[lines addObject:line]; | |
if (!line.data) { | |
return FALSE; | |
} | |
if ([line.data length] != line.byteCount) { | |
return FALSE; | |
} | |
} | |
} | |
return TRUE; | |
} | |
- (unsigned)numberFromHexString:(NSString*)hexString | |
{ | |
unsigned result = 0; | |
NSScanner* scanner = [NSScanner scannerWithString:hexString]; | |
[scanner scanHexInt:&result]; | |
return result; | |
} | |
- (NSData*)bytesFromHexString:(NSString*)hexString | |
{ | |
NSMutableData* data = [NSMutableData data]; | |
for (int i = 0; i + 2 <= hexString.length; i += 2) { | |
NSString* hexByteStr = [hexString substringWithRange:NSMakeRange(i, 2)]; | |
NSScanner* scanner = [NSScanner scannerWithString:hexByteStr]; | |
unsigned int intValue; | |
if ([scanner scanHexInt:&intValue]) | |
[data appendBytes:&intValue length:1]; | |
} | |
return [data copy]; | |
} | |
@end |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment