hex_map_append_block

This function appends a new Hex block to a Hex Map object.

Syntax

hex_block_t hex_map_append_block(
        hex_map_t         map,
        unsigned int      addr,
        unsigned int      len,
        void*             data
);

Parameters

map - a reference to the Hex Map object

addr - address of the Hex block. Note that this address refers to the HEX file address, not to the address in program memory.

For PIC12, PIC16, PIC24, dsPIC30, and dsPIC33 the HEX addresses are doubled. For example memory address 0x200 will be represented as 0x400 in the HEX file and in the Hex Block structure.

len - length of the block.

data - the pointer to data to be copied into the block, or NULL if you want to leave the block uninitialized.

Return

The function returns the pointer to the newly appended block, or NULL if the operation fails.

Minimum library version - 163