Troubleshooting

This guide provides solutions to common issues encountered while installing or using TLKCore. If you cannot find a solution here, please check the official documentation or contact support.

Q1: Issues during TLKCore installation or usage

If you encounter any problems during tlkcore installation or usage, please check the following:

  1. Dependencies: Ensure you have the required dependencies installed. Refer to the prerequisites section for hardware and software requirements.

  2. Python Version: Check the compatibility of your Python version. TLKCore supports Python 3.8+.

  3. Configuration: Review the documentation for any specific configuration steps. Ensure your environment matches the prerequisites (e.g., USB drivers, network settings).

  4. Logs: Check console output or logs for error messages and search for them online or in the documentation.

Q2: CERTIFICATE_VERIFY_FAILED error

If you encounter a CERTIFICATE_VERIFY_FAILED error, it is often due to SSL certificate issues. Try the following steps:

  1. Update pip: Update your pip to the latest version:

    pip install --upgrade pip

  2. Proxy Settings: If you are behind a corporate firewall, configure your proxy settings. For example, in Windows Command Prompt:

  3. Disable SSL Verification (not recommended for production): Install with trusted hosts:

    pip install tlkcore --trusted-host pypi.org --trusted-host files.pythonhosted.org

  4. Custom CA Certificates: Download cacert.pem from https://curl.se/ca/cacert.pem and set the environment variable.

    On Windows:

    set SSL_CERT_FILE={$your_path}\cacert.pem

    On Linux/macOS:

    export SSL_CERT_FILE={$your_path}/cacert.pem

Q3: USB device not recognized

If your USB device (e.g., for scanning or connection) is not recognized:

  1. Drivers: Ensure USB drivers are installed. Follow the installation guides in the prerequisites.

  2. Permissions: On Linux, check udev rules as described in prerequisites. Reload rules with:

    sudo udevadm control --reload-rules
sudo udevadm trigger

  3. Reconnect: Unplug and replug the USB device.

  4. Device Manager: On Windows, check Device Manager for unrecognized devices and update drivers.

Q4: Network connection issues (Ethernet/RJ-45)

If you cannot connect via Ethernet:

  1. DHCP/Static IP: Ensure the device and host PC are on the same network. For static IP, configure as per prerequisites (192.168.100.xxx with subnet mask 255.255.255.0).

  2. Firewall: Disable firewalls temporarily to test.

  3. Ping Test: Ping the device’s IP address to verify connectivity.

Q5: ComPort issues

If ComPort is not working:

  1. Device Manager: On Windows, check Device Manager for the port.

  2. Udev Rules: On Linux, ensure udev rules are set as in prerequisites, including ModemManager blacklist.

  3. Reload Rules: Reload udev rules and replug the device.

  4. Permissions: Ensure your user has access to the port (e.g., in plugdev group).