Return Value

A successful call to mclAddHexLine will return ERR_OK. If the line is not a valid INHX8M or INHX32 hex line, the function returns ERR_BAD_HEXFILE.

Remarks

A successful call to mclAddHexLine will add a single line of hex data to 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 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.

Before making multiple calls to mclAddHexLine, it is essential that a call to mclClear is made prior to calling mclAddHexLine. This is to ensure that the loader write buffer is cleared and correctly configured for use.

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

See Also