/*
 * Проверка Intel HEX и подготовка адресованного образа прошивки. Контрольные суммы записей,
 * расширенные адреса и пересечения проверяются до использования результата; рабочая память
 * C-парсера принадлежит вызывающему.
 */

#ifndef SET_FIRMWARE_IMAGE_H
#define SET_FIRMWARE_IMAGE_H
#include "pcan_abi.h"
#ifdef __cplusplus
extern "C" {
#endif
/* Caller-owned workspace; the parser never allocates memory or accesses files. */
typedef struct { uint32_t address; uint8_t value; } firmware_hex_cell_t;
enum { FW_HEX_OK, FW_HEX_FORMAT, FW_HEX_CHECKSUM, FW_HEX_RECORD,
       FW_HEX_EOF, FW_HEX_OVERLAP, FW_HEX_RANGE, FW_HEX_CAPACITY,
       FW_HEX_PREFIX, FW_HEX_DIGITS, FW_HEX_LENGTH };
/* Strict HEX: reject any overlap and any non-whitespace after EOF. On failure
 * count is zero. Cells are sorted by address only on successful completion. */
PCAN_ABI_API int firmware_hex_parse(const char *text, size_t length,
    firmware_hex_cell_t *cells, size_t capacity, size_t max_records,
    size_t *count, size_t *error_line);
/* Return one contiguous segment starting at offset in a successfully parsed
 * workspace; the caller uses its address and copies its values into its model. */
PCAN_ABI_API size_t firmware_hex_segment_size(const firmware_hex_cell_t *cells,
    size_t count, size_t offset);
#ifdef __cplusplus
}
#endif
#endif