F&Q
Exception Fixes
No ttyUSBx Serial Device After Opening Web Page on Linux
- This may be due to a missing serial driver. Please reinstall the CH34x driver using the following steps:
- Download the driver from the WCH official website (download link: https://www.wch.cn/download/CH341SER_LINUX_ZIP.html), extract it, and navigate to the
driver
directory. - Run
uname -r
to check your operating system's release version. Find the corresponding version in (this link)[https://elixir.bootlin.com/linux/v6.2/source/drivers/usb/serial/ch341.c] and copy the content intoch341.c
. - Execute the
make
command to compile the driver. - Run
sudo make load
to install the driver. - Replace the old driver:
cp ch341.ko /lib/modules/$(uname -r)/kernel/drivers/usb/serial/ch341.ko
.
- Some Linux distributions come with
brltty
, a Braille display tool that occupies the/dev/ttyUSB0
serial port, causing the webpage to be unable to detect it. If you are not usingbrltty
, it is recommended to uninstall it withsudo apt remove brltty
.
Unable to Open NanoKVM-USB Corresponding Serial Device After Opening Web Page
- This may be due to other programs occupying the serial port. Please ensure it is not in use before trying again.
- Linux may lack permissions to open the serial port. Execute
sudo chmod 777 /dev/ttyUSB*
in the terminal. - The Chrome browser may not have detected the serial port. Please refresh the webpage or restart Chrome.
- Chrome may lack sufficient permissions. Please grant the necessary permissions.
No HDMI Loop Out
- The beta version hardware only supports USB power from the HOST side. Please ensure proper power supply from the HOST side during use.
If the above methods do not resolve the issue, please describe your purchased model and the encountered problem on the forum, GitHub, or QQ group, and we will respond patiently.
Feedback Methods
- GitHub Issues
- MaixHub Forum
- QQ Group: 703230713