From 0a195a6d8cbe1d9c8f33cdfb63a2cde27786d344 Mon Sep 17 00:00:00 2001
From: gullradriel <3157857+gullradriel@users.noreply.github.com>
Date: Mon, 18 Nov 2024 10:55:46 +0100
Subject: [PATCH] added webusbserial troubleshoot page

---
 Web-USB-Serial.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)
 create mode 100644 Web-USB-Serial.md

diff --git a/Web-USB-Serial.md b/Web-USB-Serial.md
new file mode 100644
index 0000000..1a3a101
--- /dev/null
+++ b/Web-USB-Serial.md
@@ -0,0 +1,18 @@
+If WebUSB serial isn’t working on a Linux browser, here are several common issues to check:
+- Permissions: Linux restricts USB device access by default. Make sure your user is in the dialout and plugdev group, allowing serial port and USB storage access. You can add your user with:
+```
+sudo usermod -aG dialout $USER
+sudo usermod -aG plugdev $USER
+```
+- Udev Rules: Certain USB devices may need custom udev rules for proper permissions. Check the documentation for your USB device, and if necessary, add a rule in /etc/udev/rules.d/. In that directory, create a file named 53-hackrf.rules and add the following content in it:
+```
+ATTR{idVendor}=="1d50", ATTR{idProduct}=="604b", SYMLINK+="hackrf-jawbreaker-%k", MODE="660", GROUP="plugdev"
+ATTR{idVendor}=="1d50", ATTR{idProduct}=="6089", SYMLINK+="hackrf-one-%k", MODE="660", GROUP="plugdev"
+ATTR{idVendor}=="1d50", ATTR{idProduct}=="cc15", SYMLINK+="rad1o-%k", MODE="660", GROUP="plugdev"
+ATTR{idVendor}=="1fc9", ATTR{idProduct}=="000c", SYMLINK+="nxp-dfu-%k", MODE="660", GROUP="plugdev"
+```
+- Browser Compatibility: Not all Linux browsers support WebUSB fully. Chrome (or Chromium-based browsers) has the most stable WebUSB support. Verify you’re using an up-to-date version of Chrome or Edge.
+- Operating System Version: WebUSB support can vary depending on your Linux distribution and kernel version. Updating to the latest stable version of your distribution might solve compatibility issues.
+- Permissions in Chrome: Chrome may require explicit permission to access USB devices. You can check this by going to chrome://settings/content/usbDevices.
+- Browser Security Settings: Extensions or privacy settings in your browser might be blocking WebUSB. Disabling extensions or running in an incognito window might help isolate the issue.
+- Cables or Port Issues: Verify your USB cable and port are functional by testing with another device or using a different cable
\ No newline at end of file