This tutorial guides you to enable USB communication in WSL 2 for Cahute and fxlink (updated 2025-6-15).

Requirements

Latest update of Windows 10/11

WSL 2.5.7+ (minimum stable version that comes with Linux kernel 6.6)

usbipd-win 4.0.0+ (5.0.0+ for Windows on ARM64 devices)

The guide will be using WSL 2.5.7, usbipd-win 5.1.0 and Ubuntu WSL 24.04 LTS for demonstration.

Setting up WSL 2
If you are new to WSL, open PowerShell as administrator and execute the following commands to enable it:


Restart your PC to apply these changes, then install the latest stable build of WSL by clicking this link.

Set the default install version for new distros to WSL 2:


You can type wsl --list --online and select your preferred distro from the list by wsl --install <distro> --web-download, or install other third-party WSL distros like ArchWSL.

Installing Cahute and fxlink
Make sure to sudo apt update && sudo apt upgrade to have the latest libraries before going through all these instructions.

Go to the README of GiteaPC and install it. Since we will be using the full version of fxlink, install the following dependencies:


Then continue with the remaining instructions as usual.

Lastly, follow these instructions to install Cahute.

Instructions for using usbipd-win
The following instructions are for CLI users. If you prefer GUI, you can take a look at Alelec's or Nickbeth's WSL USB manager.

On the Windows host, go to the release page for the usbipd-win project and download the latest .msi installer.

After installing usbipd-win, open Windows Terminal with elevated privileges. Execute the following commands to add all Casio calculator protocols to the policy:


Connect your calculator to PC and run usbipd list. Look for the USB device with a VID of 07cf and record its bus ID. While your WSL instance is active, attach your calculator by usbipd attach -w -b <bus-id>.

To let your calculator always connect to WSL instance instead of the host, add -a flag after usbipd attach. This will start an endless attach loop until you press Ctrl+C to terminate it.

The -u flag allows you to start the attach loop, even if your calculator is not connected to that port. Note that it requires -a and -b flags to be present in your command input.

For calculators that use CESG502, type p7 info in WSL terminal to confirm that Cahute can detect the calculator connection and list the calculator info. If your calculator is in USB Flash mode, enter lsblk to see if its storage appears under sdx directory.

Possible issues and workarounds
1. If you have installed USBPcap in Windows (which is used for debugging with Cahute), usbipd will prompt you:


If you prefer not to force bind your calculator to WSL instance, do not use both components simultaneously.

2. If usbipd-win cannot automatically load vhci_hcd module, edit the module config file:


Add vhci_hcd module at a new line, save the config file and restart your WSL session.

3. Since fxlink is installed in your home directory, fxsdk build-cg -s may not work properly as it requires sudo privileges. In this case, execute the following workaround in WSL terminal:


Copy its path and enter the following command at your fxSDK project directory as sudo:


Another way (but not recommended) is to start as root and install fxSDK there instead.

4. If p7screen prompts you:


You probably have encountered the bug that has been upstreamed to libsdl's bug tracker (thanks Cakeisalie5 for the report). For now to work around it, create a WSLg config file:


Save the config file with the following content and restart your WSL session: