hex_map_write

This function writes a HEX file using data from the Hex Map object.

Syntax

int hex_map_write(
        hex_map_t         map,
        char*             file_name
);

Parameters

map - a reference to the Hex Map object

file_name - the name of the HEX file to write

Return

The function returns non-zero if the write succeeds, or zero if the operation fails.

Notes

If the Hex Map object contains a device name, the function will append the device name to the end of the HEX file, for example:

:00000001FF
;dsPIC33CK1024MP708

On Windows, there are two versions of this function - hex_map_write_a (for ASCII) and hex_map_write_w (for UNICODE). The "nsdspif.h" file maps hex_map_write to one of these functions depending on whether UNICODE is defined or not.

 

Minimum library version - 163