Intel-HEX-Kodierer

Intel HEX ist das Textformat, das die meisten Mikrocontroller-Toolchains weiterhin erzeugen, wenn Sie ein flashbares Abbild anfordern: Jede Zeile beginnt mit einem Doppelpunkt, gefolgt von einer Byteanzahl, einer sechzehn Bit breiten Adresse, einem Datensatztyp, optionalen Datenbytes und einer Zweierkomplement-Prüfsumme, die Einfügefehler erkennt, bevor ein Programmer fehlerhafte Daten schreibt. Dieser Intel-HEX-Kodierer baut aus Adresse, Typ und hexadezimaler Nutzlast einen korrekten Datensatz oder analysiert eine oder mehrere Zeilen, die Sie bereits haben, prüft die Länge gegen die angegebene Byteanzahl und lehnt jede Zeile ab, deren Prüfsumme nicht stimmt.

Firmware-Datensatz mit Adresse, Typ und Prüfsumme kodieren

Setzen Sie mode auf encode oder belassen Sie den Standardwert. Legen Sie die Nutzlast in data als hexadezimale Ziffern ab; optionale Leerzeichen, Doppelpunkte, Bindestriche und zero-x-Präfixe werden entfernt, eine ungerade Ziffernanzahl nach der Bereinigung wird abgelehnt, und mehr als zweihundertfünfundfünfzig Bytes werden abgelehnt, weil das Längenfeld ein einziges Byte ist. Die Engine setzt dann Doppelpunkt, Byteanzahl, Adresse, Typ, Daten und die Zweierkomplement-Prüfsumme aller vorherigen Bytes zusammen und liefert ein records-Array mit einem Objekt, das die vollständige Zeile, numerische und hexadezimale Adresse, Typnamen, Daten-Hex und Prüfsumme enthält.

Eine leere data-Zeichenkette ist für Dateiende und reine Typ-Experimente gültig.

Zeilen dekodieren, jede Prüfsumme prüfen und Felder lesen

Setzen Sie mode auf decode und legen Sie eine oder mehrere Intel-HEX-Zeilen in text ab, jeweils beginnend mit einem Doppelpunkt. Mehrzeilige Einfügungen werden an Zeilenumbrüchen geteilt; leere Zeilen werden ignoriert. Für jede nicht leere Zeile prüft der Parser, dass der Rumpf gerade Hex-Länge hat, dass das Byteanzahl-Feld zur Anzahl der Datenziffern passt, dass der Datensatztyp zwischen null und fünf liegt und dass das abschließende Prüfsummenbyte dem Zweierkomplement der Summe aller vorherigen Bytes des Datensatzes entspricht.

Bevorzugen Sie decode, wenn Sie erklären müssen, was ein Hersteller-Dump enthält, wenn Studierende zeigen sollen, dass eine handberechnete Prüfsumme zur Datei passt, oder wenn ein Testharness beweisen muss, dass ein Artefakt nach einer Transformation noch dem veröffentlichten Datensatz entspricht.

Abläufe, Preise, Grenzen und wann Sie dieses Werkzeug nutzen

Ein anderer Ablauf fügt ein mehrzeiliges Fragment mit erweitertem Linearadress-Datensatz und Dateiende-Markierung ein und bestätigt jede Prüfsumme, bevor ein Mensch eine Feldaktualisierung freigibt. Diese Fähigkeit expandiert erweiterte Adressdatensätze nicht zu einer zweiunddreißig Bit flachen Speicherkarte und spricht nicht mit einem Hardware-Programmer; kombinieren Sie sie mit Ihrem eigenen Flasher oder Kartenbauer, wenn Sie die vollständige Abbild-Zusammenstellung brauchen. Quelltext folgt denselben Aufbewahrungsregeln wie andere KIT-Parse-Elemente, und Ergebnisse sind sicher zu pinnen, weil der Algorithmus vollständig deterministisch ist.

Halten Sie Nutzlasten für interaktive Nutzung kurz genug — Datensatzdaten sind durch das Format selbst auf zweihundertfünfundfünfzig Bytes begrenzt — und nutzen Sie dedizierte Binär-Upload-Werkzeuge für Produktionsbilder mit mehreren Megabytes.