From 2b1067af3c67044fd8d04a4cd29a141a9ca0e758 Mon Sep 17 00:00:00 2001
From: galister <3123227-galister@users.noreply.gitlab.com>
Date: Wed, 20 Dec 2023 13:58:57 +0000
Subject: [PATCH] add dongles-over-ip guide

---
 content/docs/other/_index.md                 | 10 ++++
 content/docs/other/dongles-over-ip/_index.md | 60 ++++++++++++++++++++
 2 files changed, 70 insertions(+)
 create mode 100644 content/docs/other/_index.md
 create mode 100644 content/docs/other/dongles-over-ip/_index.md

diff --git a/content/docs/other/_index.md b/content/docs/other/_index.md
new file mode 100644
index 0000000..2941924
--- /dev/null
+++ b/content/docs/other/_index.md
@@ -0,0 +1,10 @@
+---
+weight: 300
+title: Other
+---
+
+# Other
+
+This category houses guides that are not specific to any other cagegory.
+
+- [Dongles over IP](/docs/other/dongles-over-ip/) plug your Watchman dongles into another host on the same network
\ No newline at end of file
diff --git a/content/docs/other/dongles-over-ip/_index.md b/content/docs/other/dongles-over-ip/_index.md
new file mode 100644
index 0000000..b7cbc74
--- /dev/null
+++ b/content/docs/other/dongles-over-ip/_index.md
@@ -0,0 +1,60 @@
+---
+weight: 300
+title: Dongles over IP
+---
+
+# Dongles over IP
+
+This setup uses USB-over-IP to let you plug your Watchman dongles (the ones that comes with Tundra / Vive Trackers) into a different computer (like a Raspberry Pi). These dongles can then be used with trackers as well as index/vive/pimax/etc controllers.
+
+#### The benefits of this setup
+
+- Trackers can be far away from your computer
+- Trackers can be far away from radio interference
+- You can conveniently hide the ugly cabling under/behind a piece of furniture
+
+#### Requirements
+
+- Main PC connected to the same wired network as the dongle host. While you can technically use WiFi, it's not recommended as it has a high chance to interfere with the Bluetooth connection of dongles.
+
+### Dongle host setup
+
+1. Install `usbip` and Python3 on dongle host. On debian/raspbian it's `apt install usbip python3`.
+2. Put the `usbip-bind` script (from below) on the dongle host, (e.g. into `/root`)
+`sudo wget https://gist.github.com/galister/2fbd23cfaff8ba4839efa13184e4e197/raw/13b0b2fd6dee609169b6a98b302f6a6ac5c2d307/usbip-bind -O /root/usbip-bind; sudo chmod +x /root/usbip-bind`
+3. Set up `usbip-bind bind` to run on startup
+On Raspbian: `echo '/root/usbip-bind bind' | sudo tee -a /etc/rc.local`
+4. With your dongles plugged in, run `sudo /root/usbip-bind bind`, to bind them for the first time
+
+### VR PC setup:
+
+1. Download `usbdongle` and put it somewhere safe:
+`wget https://gist.github.com/galister/2fbd23cfaff8ba4839efa13184e4e197/raw/13b0b2fd6dee609169b6a98b302f6a6ac5c2d307/usbdongle; chmod +x usbdongle`
+2. Edit `usbdongle` and set the `DONGLE_HOST` variable to the IP or hostname of your dongle host. (run `ip addr` on dongle host to find out)
+3. Optional: If you don't want to enter your sudo password for `usbdongle` every time, run this as a single multi-line command:
+
+```bash
+echo "$USER ALL=(root) NOPASSWD: /usr/sbin/usbip detach *
+$USER ALL=(root) NOPASSWD: /usr/sbin/usbip attach *
+$USER ALL=(root) NOPASSWD: /usr/sbin/usbip list *
+$USER ALL=(root) NOPASSWD: /sbin/modprobe vhci-hcd" | sudo tee -a /etc/sudoers
+```
+
+4. Run `usbdongle` before starting SteamVR/Monado (or on startup/login)
+
+### Things to watch out for
+
+- **Whenever a new dongle was plugged in** or an existing re-plugged, run `sudo /root/usbip-bind rebind` on the dongle host
+- **If the dongle host is rebooted**, stop steamvr/monado, run `usbdongle` and then re-start SteamVR/Monado.
+- In case there's a network issue and `usbdongle` can't rebind even after running `usbip-bind rebind` on dongle host, try rebooting both hosts.
+- By default, the Linux kernel supports up to 8 virtual USB devices.
+    - If you need more than 8, you can change the `CONFIG_USBIP_VHCI_HC_PORTS` kernel config option and re-compile your kernel.
+- A Pi 3.0 Model A is known to handle 2x Tundra SW4 dongles or 8 Vive dongles without requiring a powered hub
+
+## Scripts
+
+You can find the original ones [here](https://gist.github.com/galister/2fbd23cfaff8ba4839efa13184e4e197).
+
+## Support
+
+Reach out to @galister on Discord/Matrix
\ No newline at end of file