1*83d290c5STom Rini /* SPDX-License-Identifier: GPL-2.0+ */ 24a5b6a35Swdenk /* 34a5b6a35Swdenk * (C) Copyright 2000 44a5b6a35Swdenk * Wolfgang Denk, DENX Software Engineering, wd@denx.de. 54a5b6a35Swdenk */ 64a5b6a35Swdenk 74a5b6a35Swdenk /*-------------------------------------------------------------------------- 84a5b6a35Swdenk * 94a5b6a35Swdenk * Motorola S-Record Format: 104a5b6a35Swdenk * 114a5b6a35Swdenk * Motorola S-Records are an industry-standard format for 124a5b6a35Swdenk * transmitting binary files to target systems and PROM 134a5b6a35Swdenk * programmers. LSI Logic have extended this standard to include 144a5b6a35Swdenk * an S4-record containing an address and a symbol. 154a5b6a35Swdenk * 164a5b6a35Swdenk * The extended S-record standard is as follows: 174a5b6a35Swdenk * 184a5b6a35Swdenk * S<type><length><address><data....><checksum> 194a5b6a35Swdenk * S4<length><address><name>,<checksum> 204a5b6a35Swdenk * 214a5b6a35Swdenk * Where: 224a5b6a35Swdenk * 234a5b6a35Swdenk * type 244a5b6a35Swdenk * is the record type. Where: 254a5b6a35Swdenk * 264a5b6a35Swdenk * 0 starting record (optional) 274a5b6a35Swdenk * 1 data record with 16-bit address 284a5b6a35Swdenk * 2 data record with 24-bit address 294a5b6a35Swdenk * 3 data record with 32-bit address 304a5b6a35Swdenk * 4 symbol record (LSI extension) 31fc0b5948SRobert P. J. Day * 5 number of data records in preceding block 324a5b6a35Swdenk * 6 unused 334a5b6a35Swdenk * 7 ending record for S3 records 344a5b6a35Swdenk * 8 ending record for S2 records 354a5b6a35Swdenk * 9 ending record for S1 records 364a5b6a35Swdenk * 374a5b6a35Swdenk * length 384a5b6a35Swdenk * is two hex characters. This defines the length of the 394a5b6a35Swdenk * record in bytes (not characters). It includes the address 404a5b6a35Swdenk * field, the data field, and the checksum field. 414a5b6a35Swdenk * 424a5b6a35Swdenk * address 434a5b6a35Swdenk * is 4, 6, or 8 characters. Corresponding to a 16-, 24-, or 444a5b6a35Swdenk * 32-bit address. The address field for S4 records is 454a5b6a35Swdenk * always 32 bits. 464a5b6a35Swdenk * 474a5b6a35Swdenk * data 484a5b6a35Swdenk * 494a5b6a35Swdenk * Are the data bytes. Each pair of hex characters represent 504a5b6a35Swdenk * one byte in memory. 514a5b6a35Swdenk * 524a5b6a35Swdenk * name 534a5b6a35Swdenk * Is the symbol name. The symbol is terminated by a ','. 544a5b6a35Swdenk * 554a5b6a35Swdenk * checksum 564a5b6a35Swdenk * Is the one's complement of the 8-bit checksum. 574a5b6a35Swdenk * 584a5b6a35Swdenk * Example 594a5b6a35Swdenk * 604a5b6a35Swdenk * S0030000FC 614a5b6a35Swdenk * . 624a5b6a35Swdenk * . 634a5b6a35Swdenk * S325000004403C0880018D08DD900000000011000026000000003C0880012508DC50C50000B401 644a5b6a35Swdenk * S32500000460C50100B8C50200BCC50300C0C50400C4C50500C8C50600CCC50700D0C50800D4FA 654a5b6a35Swdenk * S32500000480C50900D8C50A00DCC50B00E0C50C00E4C50D00E8C50E00ECC50F00F0C51000F49A 664a5b6a35Swdenk * S325000004A0C51100F8C51200FCC5130100C5140104C5150108C516010CC5170110C518011434 674a5b6a35Swdenk * . 684a5b6a35Swdenk * . 694a5b6a35Swdenk * S70500000000FA 704a5b6a35Swdenk * 714a5b6a35Swdenk * The S0 record starts the file. The S3 records contain the 724a5b6a35Swdenk * data. The S7 record contains the entry address and terminates 734a5b6a35Swdenk * the download. 744a5b6a35Swdenk * 754a5b6a35Swdenk *-------------------------------------------------------------------------- 764a5b6a35Swdenk */ 774a5b6a35Swdenk 784a5b6a35Swdenk #define SREC_START 0 /* Start Record (module name) */ 794a5b6a35Swdenk #define SREC_DATA2 1 /* Data Record with 2 byte address */ 804a5b6a35Swdenk #define SREC_DATA3 2 /* Data Record with 3 byte address */ 814a5b6a35Swdenk #define SREC_DATA4 3 /* Data Record with 4 byte address */ 824a5b6a35Swdenk #define SREC_COUNT 5 /* Count Record (previously transmitted) */ 834a5b6a35Swdenk #define SREC_END4 7 /* End Record with 4 byte start address */ 844a5b6a35Swdenk #define SREC_END3 8 /* End Record with 3 byte start address */ 854a5b6a35Swdenk #define SREC_END2 9 /* End Record with 2 byte start address */ 864a5b6a35Swdenk #define SREC_EMPTY 10 /* Empty Record without any data */ 874a5b6a35Swdenk 884a5b6a35Swdenk #define SREC_REC_OK SREC_EMPTY /* last code without error condition */ 894a5b6a35Swdenk 904a5b6a35Swdenk #define SREC_E_BADTYPE -1 /* no valid S-Record */ 914a5b6a35Swdenk #define SREC_E_NOSREC -2 /* line format differs from s-record */ 924a5b6a35Swdenk #define SREC_E_BADCHKS -3 /* checksum error in an s-record line */ 934a5b6a35Swdenk 944a5b6a35Swdenk #define SREC_MAXRECLEN (512 + 4) /* max ASCII record length */ 954a5b6a35Swdenk #define SREC_MAXBINLEN 255 /* resulting binary length */ 964a5b6a35Swdenk 974a5b6a35Swdenk int srec_decode (char *input, int *count, ulong *addr, char *data); 98