Problem

Workaround

On common Linux distributions, the serial UART ports (usually /dev/ttySx or /dev/ttyUSBx devices) belongs to the root user and to the dialout group. Standard users are not allowed to access these devices.

An easy way to allow the current user access to the Linux machine's serial ports is by adding the user to the dialout group. This can be done using the following command:

$sudo usermod -a -G dialout $USER

Note:

Note: For this command to take effect, you must log out and then log back in.

On macOS, the CAPSENSE™ Tuner can't be launched from the Launchpad.

Launch the Tuner from within the Device Configurator or use the command line option.

On common Linux distributions, the Tuner forbids communication interface selection after re-plugging KitProg during communication.

Refer to the “Installation Procedure on Ubuntu Linux (x64)” section in the Cypress Programmer 2.1 CLI User Guide.

KitProg3 UART is accessible but not able to read data on Linux kernel 4.15 and above or Mac OS X 10.13 and above.

Use third-party UART to USB bridge.

Update the KitProg3 firmware to version 1.11.243 or above.

Cannot establish communication with a device that operates in Low power mode.

Refer to the

Communication and Low power mode

section.

Unable to connect to the device via the RTT communication protocol. The OpenOCD log displays an error “Could not find symbol '_SEGGER_RTT' in executable”.

RTT support is not enabled in the application. Refer to the

Setting up RTT communication in the application

section.

Note:

The Tuner provides information about the root cause of connection to KitProg issue in an operation log. The operation log location can be found in the About CAPSENSE™ Tuner box.