Troubleshooting
Problem | Workaround |
---|---|
On common Linux distributions, the serial UART ports (usually /dev/ttySx or /dev/ttyUSBx devices) belong 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: For this command to take effect, you must log out and then log back in. |
On Linux, attempts to set up or start DFU Host tool communication causes the tool to close without any messages. | To enable DFU Host tool communication under Linux, install the udev rules for KitProg3: Disconnect the KitProg device. Execute in the terminal (root access required): sh $CYSDK/tools/fw-loader/udev_rules/install_rules.sh Reconnect the KitProg device. |
On common Linux distributions, the DFU Host tool forbids communication protocol 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 a third-party UART to USB bridge. Update the KitProg3 firmware to version 1.11.243 or above. |
After updating firmware and middleware for your application, SPI transfer speed is not as fast as expected. | You may be able to improve performance by modifying the src/backend/cychannelspi.cpp file. Remove the calls to
when building your bootloader host tool. |
Sending command 0x47 is not supported. | Command 0x37 can be used for transferring a large amount of data to a device due to better synchronizing with middleware. |