Added slime glove draft

src/SUMMARY.md

@@ -45,6 +45,10 @@
     - [SmolSlimeConfigurator](smol-slimes/firmware/SmolSlimeConfigurator.md)
   - [Smol LED Codes](smol-slimes/smol-LED-codes.md)
 
+# SlimeVR Gloves
+
+- [SlimeVR Gloves](glove-for-slime/index.md)
+
 # Advanced User Guides
 
 - [Detailed Setup](server/README.md)

src/glove-for-slime/index.md

@@ -0,0 +1,287 @@
+# SlimeVR Gloves
+
+```admonish warning
+**Disclaimer:** This project is highly experimental. These devices may be incompatible with newer versions of the SlimeVR Server and may require frequent firmware updates. Hardware, firmware, and communication protocols are subject to change.
+```
+
+```admonish info
+Are you interested, have questions, or running into issues? Chat with us in ***#finger-tracking*** on the <a href="https://discord.gg/SlimeVR" target="_blank">SlimeVR Discord</a>!
+```
+
+Looking for a way to add finger tracking to your VR setup? SlimeVR Gloves are a community-driven project designed to make finger tracking accessible and easy to implement.
+
+The gloves utilize flex sensors and microcontrollers to capture finger movements accurately.
+
+They are fully compatible with the SlimeVR server.
+
+## Table Of Contents
+
+- TOC
+{:toc}
+
+## 🧤 Guizmo12 Glove
+Currently, the Guizmo12 Glove is the primary project for SlimeVR Gloves.
+
+<div class="embeddedVideo">
+    <img src="assets/index/img/Guizmo12-glove.webp" alt="Slime Gloves Example" loading="lazy">
+  Guizmo12 glove in development values reading
+</div>
+
+## Glove Hardware
+
+### Required tools
+
+<table>
+  <thead>
+    <tr>
+      <th>Component</th>
+      <th>Example/Notes</th>
+      <th>Price</th>
+      <th>Store Link</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Soldering supplies</td>
+      <td>Solder, iron, etc.</td>
+      <td>Varies</td>
+      <td>
+        <ul>
+          <li><a href="https://www.amazon.com/s?k=soldering+kit">Amazon</a></li>
+          <li><a href="https://aliexpress.com/w/wholesale-soldering-kit.html?g=y&SearchText=soldering+kit&sortType=total_tranpro_desc">AliExpress</a></li>
+        </ul>
+      </td>
+    </tr>
+  </tbody>
+</table>
+
+### Required Components
+
+<div class="table-wrapper">
+  <table class="community-builds-table">
+  <thead>
+    <tr>
+      <th>Component</th>
+      <th>Example/Notes</th>
+      <th>Price</th>
+      <th>Store Link</th>
+    </tr>
+  </thead>
+  <tbody>
+    <tr>
+      <td>Microcontroller</td>
+      <td>Adafruit ESP32 Feather V2</td>
+      <td>$19.95</td>
+      <td><a href="https://www.adafruit.com/product/5400">Adafruit</a></td>
+    </tr>
+    <tr>
+      <td>Flex sensors (5x)</td>
+      <td>For each finger</td>
+      <td>~$5-8 each</td>
+      <td><a href="https://www.adafruit.com/product/1070">Adafruit</a></td>
+    </tr>
+    <tr>
+      <td>Glove base</td>
+      <td>Any fabric glove</td>
+      <td>~$5-10</td>
+      <td><a href="https://www.amazon.ca/-/fr/dp/B07FPN6WF4">Amazon</a></td>
+    </tr>
+    <tr>
+      <td>10k Resistors</td>
+      <td>For voltage divider</td>
+      <td>&lt;$1</td>
+      <td><a href="https://pl.aliexpress.com/w/wholesale-10k-resistor.html?spm=a2g0o.home.search.0">AliExpress</a></td>
+    </tr>
+    <tr>
+      <td>Wires</td>
+      <td>Thin, flexible</td>
+      <td>~$5</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td>Battery</td>
+      <td>LiPo, e.g. 150-300mAh</td>
+      <td>~$5-10</td>
+      <td><a href="https://www.adafruit.com/product/1317">Adafruit</a></td>
+    </tr>
+    <tr>
+      <td>Connectors (optional)</td>
+      <td>JST or similar for battery/sensors</td>
+      <td>~$2-5</td>
+      <td></td>
+    </tr>
+    <tr>
+      <td>3d Printed Case</td>
+      <td>
+        <a href="https://github.com/Guizmo12/gizmoglovesmocap/tree/main/STL">Guizmo12 Glove case files for printing</a>
+      </td>
+      <td></td>
+      <td></td>
+    </tr>
+  </tbody>
+</table>
+</div>
+
+### Building Guide
+
+Carefully cut small slits in the glove to insert each flex sensor.
+
+Ensure that the base of each sensor is secured while allowing the tip to move freely in both forward and backward directions.
+
+<div style="display: flex">
+  <img src="assets/index/img/Glove-Building/Glove-FlexSensor-insertion.jpg" loading="lazy" class="small-size-image">
+  <img src="assets/index/img/Glove-Building/Glove-FlexSensor-inserted.jpg" loading="lazy" class="small-size-image">
+</div>
+
+Next, connect the opposite side of each sensor to the corresponding Feather V2 pins:
+- A9: Thumb
+- A7: Index
+- A2: Middle
+- A3: Ring
+- A4: Little
+
+<div class="embeddedVideo">
+  <img src="assets/index/img/Glove-Building/soldered-board.webp" loading="lazy" class="big-size-image">
+  Guizmo12 Glove schematic 
+</div>
+
+Solder the wires on the same side of each flex sensor and connect them to the Feather V2’s GND pin.
+
+<div class="embeddedVideo">
+  <img src="assets/index/img/Guizmo12-glove-schematic.webp" loading="lazy" class="big-size-image">
+  Guizmo12 Glove schematic 
+</div>
+
+Place the resistors on one side of the Feather V2 and solder them together to form a voltage divider.
+
+Afterward, connect a wire from the 3V pin to the junction of the resistors.
+
+<img src="assets/index/img/Glove-Building/board-soldering.webp" loading="lazy" class="big-size-image">
+
+<img src="assets/index/img/Glove-Building/putting-glove-with-board-on-glove-with-flex-sensors.gif" loading="lazy" class="small-size-image">
+
+In this setup, the Feather V2 is powered via USB from the wrist tracker.
+
+<img src="assets/index/img/Glove-Building/glove-powered-by-waist-tracker.webp" loading="lazy" class="big-size-image">
+
+## Compiling and Flashing Firmware
+
+Below is a step-by-step guide to compiling and flashing SlimeVR Server compatible glove firmware.
+
+### Firmware Variants
+
+| Firmware Name                                                                             | Usage Description                                                            |
+| ----------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------- |
+| [ConnectToSlime](https://github.com/Guizmo12/gizmoglovesmocap/tree/main/ConnectToSlime)   | For use with the [SlimeVR Server](https://github.com/SlimeVR/SlimeVR-Server) |
+| [FullGloveWIFI](https://github.com/Guizmo12/gizmoglovesmocap/tree/main/FullGloveWiFi)     | For use with `server_tester.py`                                              |
+| [FullGloveNoWiFi](https://github.com/Guizmo12/gizmoglovesmocap/tree/main/FullGolveNoWiFi) | For use with a serial console                                                |
+
+### Setting up environment
+
+#### 1. Download and Install Arduino IDE
+
+- Download the [Arduino IDE](https://www.arduino.cc/en/software) and install it on your computer.
+
+#### 2. Install ESP32 Board Support
+
+- Open Arduino IDE.
+- Go to **File > Preferences**.
+- In the "Additional Boards Manager URLs" field, add:
+  ```
+  https://raw.githubusercontent.com/espressif/arduino-esp32/gh-pages/package_esp32_index.json
+  ```
+- Go to **Tools > Board > Boards Manager**.
+- Search for "esp32" and install the latest version by "esp32 by Espressif Systems".
+
+#### 3. Install Required Libraries
+
+- In Arduino IDE, go to **Sketch > Include Library > Manage Libraries...**
+- Search for and install:
+  - `WiFi by Arduino`
+
+#### 4. Install USB drivers (Windows only)
+
+- `Feather ESP32 V2` use [CP210x USB to UART](https://www.silabs.com/software-and-tools/usb-to-uart-bridge-vcp-drivers?tab=downloads) –  install the appropriate driver. 
+- `ESP32-S3` boards generally use **native USB (CDC)** – no driver needed on macOS/Linux.
+
+#### 5. Board Selection
+
+- Go to **Tools > Board** and select board settings based on board.
+
+| Board              | Arduino IDE Board Setting     |
+| ------------------ | ----------------------------- |
+| Feather ESP32 V2   | **Adafruit Feather ESP32 V2** |
+| ESP32-S3 SuperMini | **ESP32S3 Dev Module**        |
+
+- Go to **Tools > Port** and select the port corresponding to your device.
+
+Recommended settings:
+- **Upload Speed:** 921 600  
+- **Port:** your detected COM port  
+- For S3 boards: enable **USB CDC On Boot** and **PSRAM** if available.
+
+### Compiling And Flashing
+
+#### 1. Download the Firmware
+
+- Clone or download the firmware repository from [GizmoGlovesMocap GitHub](https://github.com/Guizmo12/gizmoglovesmocap).
+- Open `ConnectToSlime/GizmoSlimeFirmware.ino` in Arduino IDE.
+
+#### 2. Configure WiFi Credentials
+
+- In the code, find these lines:
+  ```cpp
+  const char* ssid = "your_ssid";
+  const char* password = "your_password";
+  ```
+- Replace `"your_ssid"` and `"your_password"` with your WiFi network's SSID and password.
+
+#### 3. Configure Hand Selection
+
+Next, find the hand-selection section:
+
+```cpp
+// Choose which set of bone positions to use
+const int* BONE_POSITIONS = BONE_POSITIONS_RIGHT; // Change to _LEFT for left hand
+```
+
+Change the value depending on which glove you are uploading:
+
+| Glove      | Code line                                           |
+| ---------- | --------------------------------------------------- |
+| Right hand | `const int* BONE_POSITIONS = BONE_POSITIONS_RIGHT;` |
+| Left hand  | `const int* BONE_POSITIONS = BONE_POSITIONS_LEFT;`  |
+
+*Tip: label each physical board before flashing to avoid confusion when pairing with the SlimeVR server.*
+
+#### 4. Compile and Upload
+
+1. Click **Verify (✓)** to compile the code.
+2. Click the **Upload (→)** button (right arrow) in Arduino IDE.
+3. Wait for the upload to complete. The glove will reboot and attempt to connect to your WiFi.
+
+  When you see Hard resetting via RTS pin… in the console, the upload has completed.
+
+**If using ESP32-S3 SuperMini:**
+If upload fails, hold **BOOT**, press **RESET**, release **RESET**, then release **BOOT**, and try uploading again.
+
+#### 5. Verify Operation
+
+- Open the Serial Monitor (**Tools > Serial Monitor**) at 9600 baud to view debug output.
+- The glove should connect to WiFi and begin sending data to the SlimeVR server.
+
+## Troubleshooting
+
+| Issue                   | Solution                                                                                                   |
+| ----------------------- | ---------------------------------------------------------------------------------------------------------- |
+| **No COM port appears** | Use a data-capable USB cable; install CP210x drivers (Feather). For S3, enter bootloader mode if required. |
+| **Upload timeout**      | Lower upload speed (921 600 → 460 800 → 115 200).                                                          |
+| **Compilation errors**  | Verify correct board is selected (Feather V2 or ESP32S3 Dev Module).                                       |
+
+## References
+
+- 🔗 [GizmoQC Mocap Glove GitHub repository](https://github.com/Guizmo12/gizmoglovesmocap/tree/main)
+
+<hr/>
+
+*Created by Shine Bright ✨, [Depact](https://github.com/Depact) and [GizmoQC](https://github.com/Guizmo12)*