Return Value

A successful call to mclLoadHexFile will return ERR_OK. If the *.hex file cannot be found, the function returns ERR_NO_HEXFILE. If the file is not a valid INHX8M or INHX32 hex file, the function returns ERR_BAD_HEXFILE.

Remarks

A successful call to mclLoadHexFile will load the *.hex file into the loader write buffer. The write buffer can then be written to the target MCU with a call to mclProgram. The write buffer is automatically overwritten with either another call to mclLoadHexFile or by calling mclRead. The write buffer may also be initialised with a call to mclAddHexLine and cleared with a call to mclClear. A call to mclVerify can be used to verify the contents of the write buffer against the contents of the target MCU.

The loader write buffer is automatically cleared should a call to mclLoadeHexFile not return ERR_OK.

See Also