This tutorial guides you to enable USB communication in WSL 2 for Cahute and fxlink.

Demonstration setup

Windows 10/11 with latest updates

WSL 2.5.9

Ubuntu 24.04 LTS (WSL distro)

usbipd-win 5.1.0

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


Restart your PC, then install the latest release of WSL by wsl --update --web-download.

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

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. If you set up the policy correctly, it should indicate "Allowed" in STATE column.

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
(Update 2025-6-25: removed vhci_hcd and SDL segfault/error workarounds as they were fixed by the latest update of usbipd-win, WSL and sdl2-compat)

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. 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.