ENABLE_ACQUIRE​

Enables or disables the acquisition of the target device in test mode.

Possible values:

ENABLE_POWER_SUPPLY​

Controls the internal power supply of KitProg3/MiniProg4 adapters. If this command is specified, the KitProg3 driver enables the power supply, thus powering on the target during initialization.

Possible values:

  • 0 – Power supply disabled

  • Any other value defines target voltage in millivolts.

  • default – Sets the last used voltage before KitProg3/MiniProg4 was powered off.

ENABLE_CM0, ENABLE_CM4​

Allows specifying the CPU cores to be visible to OpenOCD. OpenOCD never affects disabled cores.

Possible values:

  • 1 – Corresponding core is enabled.

  • 0 – Core is disabled.

TARGET_AP​

Applicable for "secure" (PSOC™ 64) MCUs only. Enables the choice of DAP access port that will be used for programming.

Possible values:

  • sys_ap – SYS_AP (AP #0, default)

  • cm0_ap – CM0_AP (AP #1)

  • cm4_ap – CM4_AP (AP #2). Choosing this access port will enable external SMIF memory banks.

FLASH_RESTRICTION_SIZE​

Applicable for "secure" (PSOC™ 64) MCUs only. Use this variable to limit the size of accessible flash so OpenOCD will not affect flash locations where the "secure" CyBootloader is located. The default value of this variable varies across different PSOC™ 64 MCUs.

ENABLE_WFLASH, ENABLE_SFLASH, ENABLE_EFUSE​

Applicable for "secure" (PSOC 64) MCUs only. Enables the corresponding flash bank when set to a non-zero value. The WorkFlash is enabled by default on PSOC™ 64 CYS0644A, CYB0644A, CYB06447 and CYB06447-BL MCU devices. SFlash and eFuse banks are disabled by default on all PSOC™ 64 MCU targets.

SMIF_BANKS​

Defines QSPI memory banks. This variable is a two-dimensional associative Tcl array of the following format:

set SMIF_BANKS {
  1 {addr <XIPaddr1> size <BankSz1> psize <ProgramSz1> esize <EraseSz1>}
  2 {addr <XIPaddr2> size <BankSz2> psize <ProgramSz2> esize <EraseSz2>}
  ...
  N {addr <XIPaddrN> size <BankSzN> psize <ProgramSzN> esize <EraseSzN>}
}

Where:

  • XIPaddrN

    – XIP mapping address

  • BankSzN

    – Total size of this flash bank, in bytes

  • ProgramSzN

    – Minimal programming granularity (program block size), in bytes

  • EraseSzN

    – Minimal erase granularity (erase block size), in bytes