Here is what I've been able to figure out on how to use the command options. Just for the record.



-- typical invocation


mac $ ./BitHoist -id Sunbird.bin
File 'Sunbird.bin'
Address: 0xc000,0xffff
CRC: 0xf3680b8f
Mask ID: 58
ID byte: 0x58
Sum word: 0xd1ee
Sequence: Dec 3, 1990 #1420 (0D2A058C)
Scan ID: 3411
BCC: AUWR3607 (stock)




-- Print Tektronix format of hex to terminal


mac $ ./BitHoist -t -stdout Sunbird.bin
%2A6EE4C0000D530D2A058CD1EE58800A9715F100E8
%2A6CE4C0105FD03AF8A002000D00FF00EB001000AB
... clipped ...




-- Note BitHoist sends "normal" output to stderr.
-- To redirect all to stdout, do:


mac $ ./BitHoist -id Sunbird.bin 2>&1
File 'Sunbird.bin'
Address: 0xc000,0xffff
CRC: 0xf3680b8f
Mask ID: 58
ID byte: 0x58
Sum word: 0xd1ee
Sequence: Dec 3, 1990 #1420 (0D2A058C)
Scan ID: 3411
BCC: AUWR3607 (stock)




-- all to a file


mac $ ./BitHoist -id Sunbird.bin >myout 2>&1
mac $ cat myout
File 'Sunbird.bin'
Address: 0xc000,0xffff
CRC: 0xf3680b8f
Mask ID: 58
ID byte: 0x58
Sum word: 0xd1ee
Sequence: Dec 3, 1990 #1420 (0D2A058C)
Scan ID: 3411
BCC: AUWR3607 (stock)




-- When you run with the -id parameter, you will get the range of
-- addresses of the binary data in the bin file. Use 0x before a
-- number to indicate hex.


mac $ ./BitHoist -t -stdout -r 0xc000,0xc04f Sunbird.bin
%2A6EE4C0000D530D2A058CD1EE58800A9715F100E8
%2A6CE4C0105FD03AF8A002000D00FF00EB001000AB
%2A6864C0200017005B2A30000AE0080C0906000000
%2A6054C0304493CAB862FFFDFD320A14647800C804
%2A6F44C040B00BB8A0404F7C101EA703E9043C90BF
%0781010




-- Run with mask option


mac $ ./BitHoist -mask Sunbird.bin
---- cut here ----
0xc000, 0x10000, 0xc000, 0xc002, 0xc006, 0xc008, 0x80290058, 0xb4bb275c,
#ifndef rez
1, 1,
#endif
begin
0xc000, 0x10000
end,
begin
sumlo, sumhi
end,
---- cut here ----