FAQ

Why I can't get Gigabit speed on the USB3.0 ethernet

1000mbps is just theoretical speed. Due to losses such as system conversion, the actual speed of Gigabit Ethernet is generally between 900mbps to 1000mbps. If you cannot achieve speeds above 900mbps make sure you are using the USB3.0 Type-C cables, some Type-C cables only feature the USB2.0 standard which can result in the speed being limited to below 480mbps.

Why is the USB Simulation not working

There could be three reasons for such problems.
1. The insertion and removal function wasn't set correctly.
Check the insertion and removal option of the DIP switch on the bottom of the Pi-Cast PCB. If the option was set as on, the insertion and removal feature was active and the system must be configured.
The Pi-Cast uses GPIO5 to control status of the removal and insertion simulation. When the logic level of GPIO5 is High the USB is insertion otherwise the USB is removal.

The pre-build images and images made for PiKVM Hat V3 support this function out of the box. But most PiKVM images for diy platform are not setting GPIO5 to High by default. You can add the below code to the gpio section of the file /etc/kvmd/override.yaml.

__v3_usb_breaker__:
            pin: 5
            mode: output
            initial: true
            pulse:
                delay: 0

After adding the code, the file would look like below.

kvmd:
gpio:
    scheme:
        __v3_usb_breaker__:
            pin: 5
            mode: output
            initial: true
            pulse:
                delay: 0

If you do not require the insertion and removal function, you can turn off the insertion and removal option of the DIP switch to set the USB to always be in an inserted state.

2. The USB signal was not routed correctly.
The USB signal of CM4 could be routed between the type-c port(on the same site as the HDMI ports) and the Hat fpc connector. Make sure the port you are using matches the CM4_USB on the DIP switch. When the CM4_USB on the DIP switch is set to off the USB signal is routed to the type-c port. Otherwise, the USB signal is routed to the Hat fpc connector.

3. The USB cable doesn't support data transfer.
Some USB-C cables only support charging. Try using another cable that definitely supports data transfer.