Loader options can be set by calling mclSetOption or read by calling mclGetOption.

Program Code

Set OPTION_PROGRAM_CODE to TRUE to enable programming of user code when calling mclProgram. Set to FALSE to prevent user code from being programmed during a call to mclProgram. The default is TRUE.

Program Data

Set OPTION_PROGRAM_DATA to TRUE to enable programming of user EEPROM data when calling mclProgram. Set to FALSE to prevent user EEPROM data from being programmed during a call to mclProgram. The default is TRUE.

Verify Code When Programming

Set OPTION_PROGRAM_VERIFY_CODE to TRUE to enable verify of user code when calling mclProgram. Set to FALSE to prevent user code from being verified during a call to mclProgram. The default is TRUE.

Verify Data When Programming

Set OPTION_PROGRAM_VERIFY_DATA to TRUE to enable verify of user code when calling mclProgram. Set to FALSE to prevent user code from being verified during a call to mclProgram. The default is TRUE.

Verify Code

Set OPTION_VERIFY_CODE to TRUE to enable verification of user code when calling mclVerify. Set to FALSE to prevent user code from being verified during a call to mclVerify. The default is TRUE.

Verify Data

Set OPTION_VERIFY_DATA to TRUE to enable verification of user EEPROM data when calling mclVerify. Set to FALSE to prevent user EEPROM data from being verified during a call to mclVerify. The default is TRUE.

Verify After Programming

Set OPTION_VERIFY_AFTER_PROGRAMMING to TRUE to automatically invoke mclVerify after a call to mclProgram. Set to FALSE to prevent full verification after calling mclProgram. The default is FALSE.

Run After Programming

Set OPTION_RUN_AFTER_PROGRAMMING to TRUE to immediately exit the bootloader process after a call to mclProgram and then start running the target user code. The default is TRUE.

Load Hex File Before Programming

Set OPTION_LOAD_HEX_BEFORE_PROGRAMMING to TRUE to automatically load a *.hex file before executing a call to mclProgram. The *.hex file is given with a call to mclLoadHexFile. Set to FALSE to prevent the *.hex file from being automatically loaded before executing mclProgram. The default is FALSE.

Baud Auto Detect

Setting OPTION_BAUD_AUTO_DETECT enables the DLL to identify the correct communications baudrate of the loader installed on the target MCU. Setting to FALSE will disable this feature and require an explicit call to mclSetBaud. It is strongly recommended that this option is left in its default state of TRUE.

See Also

mclSetOption
mclGetOption