intel_hex 1.2.1 intel_hex: ^1.2.1 copied to clipboard
A Dart library that can read and write Intel HEX files. The Intel HEX format is a file format that contains binary information as ASCII text.
Intel HEX library #
A dart library that reads and writes Intel HEX files. Intel HEX is a file format that is used to store binary data as ASCII text. It is often used to program microcontrollers. The file format comprises of record blocks. Each record block is represented as a line in the text file. A record starts with a ":" character and ends at the end of the line. The last byte of a record block is the checksum of all other bytes in this block.
A record has six fields:
- Start code. Usually ":".
- Byte count
- Record type
- Data. May be empty.
This library supports both reading and writing Intel HEX files. Any comments in the files (or leading characters, empty lines) are ignored. Line lengths from 1 to 255 bytes are supported.
The following record types can be parsed:
|Data||00||A data field with the contents of the file.|
|End Of File||01||The parser stops once an End Of File record is found.|
|Extended Segment Address||02||A data field with an extended address that is added to the address all following data records. Allows addressing up to 1 MB.|
|Start Segment Address||03||A data field that holds the initial intruction pointer for 80x86 CPUs.|
|Extended Linear Address||04||A data field that contains the upper 16 bits of the addresses for all subsequent data fields. Allows using up to 4 GB.|
|Start Linear Address||05||Starting execution address for CPUs that support it.|
Getting started #
To use the package, simply add it to your pupspec.yaml:
dependencies: intel_hex: ^1.1.0
And you are good to go!
Here is a simple example showing how to read a file:
import 'package:intel_hex/intel_hex.dart'; // example reading a file ... final file = File(path).readAsStringSync(); var hex = IntelHexFile.fromString(file);
Converting binary data to an Intel HEX string can be done with the following code:
import 'package:intel_hex/intel_hex.dart'; Uint8List data = /* get binary data */; var hex = IntelHexFile.fromData(data); var hexString = hex.toFileContents();
Additional information #
If there are any bugs or you need an additional feature, please report them in the issue tracker.