Skip to content

biscuitvixen/smol-biscuits

🍪 Smol Biscuits SlimeVR Trackers

Build Status License License Platform

Tiny, lightweight, and long-lasting SlimeVR trackers for full-body tracking

These are a derivative of SlimeVR trackers, designed to be smaller, lighter, and longer lasting! Perfect for comfortable all-day body tracking.

✨ Features

  • 🔧 Custom PCB - Minimal footprint carrier board
  • 🏠 Custom 3D printed case - Flexible two-piece design
  • 💾 Custom firmware - Optimized derivative of SlimeVR firmware
  • 🔋 Extended battery life - Efficient power management
  • 📡 Wireless connectivity - nRF52840-based communication

📋 Table of Contents

🔧 Hardware

PCB Design

The PCB is designed in KiCad and the files can be found in the pcb folder. The PCB is designed to be as small as possible, acting as a carrier board for a Seeed Studio XIAO nRF52840 on the opposite side of the sensors.

📊 Sensors

Component Model Function
IMU ICM-45686 6-axis motion sensing
Magnetometer QMC-6309 Magnetic field detection

🎯 IMU: ICM-45686

High-performance 6-axis motion sensor providing accurate accelerometer and gyroscope data.

🧭 Magnetometer: QMC-6309

Precision 3-axis magnetic sensor for improved orientation tracking.

🔋 Battery

The board requires a LiPo battery. Size based on your needs, but the included case is designed to fit a 150mAh battery for optimal balance between size and runtime.

🏠 3D Printed Case

The case features an innovative two-piece design with a flexible interlink. The battery compartment and PCB housing are separate, connected by a flexible joint that allows the tracker to bend naturally around your body.

🔗 Design Features

  • Flexible interlink - Allows bending around body contours
  • Strain relief - Protects battery cable from damage
  • Modular design - Separate battery and PCB compartments

🎨 Print Materials

Component Recommended Material Reason
Flexi-link TPU Flexibility and durability
Base plates PETG Strength under strain
Top cover PLA or PETG Aesthetic preference
Switch PLA or PETG Aesthetic preference

⚠️ Important: The strap piece is under significant strain - avoid PLA for base plates as it may break!

💾 Firmware

🚀 Pre-Compiled Firmware

The firmware is included as a git submodule in the firmware folder. It's a fork of the SlimeVR firmware with specific support for the Smol Biscuits PCB.

📦 Quick Start: Use the pre-compiled firmware files from the releases section to program your trackers and receiver.

🛠️ Compiling Firmware Yourself

Want to customize or build from source? Follow these steps:

  1. Clone with submodules:

    git clone --recurse-submodules https://github.com/biscuitvixen/smol-biscuits.git
  2. Follow SlimeVR dev documentation: 📖 SlimeVR Compilation Guide

  3. Build with correct board target:

    west build -p auto -b xiao_ble -d build . -- -DNCS_TOOLCHAIN_VERSION=NONE -DBOARD_ROOT=.

🔨 Assembly

🔧 Soldering the PCB

⚠️ Safety First: Use proper ventilation and ESD protection when soldering

Step-by-step Process:

  1. Solder sensor components 📊

    • Solder the sensor components onto the PCB
    • ⚠️ Leave the XIAO nRF52840 for later
  2. Prepare battery terminals 🔋

    • Pre-tin the battery terminals on the XIAO
    • Pre-tin the corresponding footprint on the PCB
  3. Position the XIAO 📱

    • Use the solder jig to place the XIAO nRF52840
    • Battery terminals facing up ⬆️
  4. Apply flux and align

    • Apply flux to all connections
    • Place sensor PCB on top, aligning battery terminals
  5. Heat and bond 🔥

    • Use square heat pass-through pads to melt solder
    • Apply gentle pressure to flatten boards together
    • Allow to cool completely ❄️
  6. Inspect and test 🔍

    • Visual inspection of all joints
    • Use multimeter to check for shorts
  7. Complete connections 🔗

    • Solder all castellated pins around PCB edge
    • Solder battery to back of sensor board

💾 Programming the PCB

Tracker Programming:

  1. Connect 🔌 - USB-C cable to computer
  2. Bootloader mode 🔄 - Double-tap reset button
  3. Flash bootloader 📥 - Copy update-slimenrf_xiao_sense_bootloader-0.9.2-SlimeVR.7_nosd.uf2
  4. Verify ✅ - Should show as SLIMENRF_XIAO_SENSE drive
  5. Flash firmware 🎯 - Copy firmware_tracker.uf2 to drive
  6. Reboot 🔄 - Device will restart with new firmware

📡 Programming the Receiver

For Holyiot receiver:

🏠 Assembling the Case

Step-by-step Assembly:

  1. Strap preparation 📏

    • Slide bases onto 30mm strap
    • Ensure notches face each other 🔄
  2. Flex link installation 🔗

    • Place flex link between bases in designated slot
  3. Battery compartment 🔋

    • Insert battery spacer between strap and battery
    • Position battery on top of spacer
  4. Secure battery 🔒

    • Hold battery in place by wires
    • Snap battery base into place
  5. PCB installation 📱

    • Place PCB into PCB base
    • Align switch with cutout ⚙️
  6. Switch mechanism 🎛️

    • Slide switch slider over PCB switch
  7. Final assembly

    • Ensure case slides correctly over switch
    • Snap top cover into place
  8. Strap adjustment 📐

    • Adjust strap to fit comfortably
    • Secure in place

📡 Setup & Calibration

For complete setup and calibration instructions, refer to the official SlimeVR documentation:

🔗 SlimeVR Pairing & Calibration Guide


🎊 Congratulations!

Your Smol Biscuits SlimeVR trackers are ready to use!

Enjoy your new lightweight, comfortable full-body tracking experience! �✨


📄 License

🔧 Hardware Designs

PCB files, 3D models, schematics, and case designs are licensed under:

Personal and educational use: ✅ Free to use, modify, and share
Commercial use: ❌ Requires separate license - contact [onlybiscuit7@gmail.com]

💾 Firmware

Firmware retains the original SlimeVR license terms:

  • Original SlimeVR licenses: MIT | Apache 2.0
  • See firmware submodule for complete licensing information

🤝 What This Means

  • Hobbyists & Makers: Build away! Just credit me and share improvements
  • Companies: Want to sell these? Let's talk revenue sharing or licensing
  • Everyone: Improvements must be shared under the same terms

🤝 Third-Party Components

  • SlimeVR Firmware: Check firmware submodule for licensing terms
  • Dependencies: Various open source licenses (see individual components)

🤝 Contributing

I welcome contributions! Please feel free to submit pull requests or open issues.

📞 Support

For support and questions:

  • 📖 Check the SlimeVR Documentation
  • 💬 Join the SlimeVR Discord community
  • 🐛 Report issues on GitHub

About

Custom smol-slime SlimeVR derivative – biscuit’s tiny VR trackers (PCB, firmware, 3D printed case) for Seed Studio XIAO nRF52840

Topics

Resources

License

Apache-2.0 and 2 other licenses found

Licenses found

Apache-2.0
LICENSE-APACHE
Unknown
LICENSE-CC-BY-NC-SA
MIT
LICENSE-MIT

Stars

Watchers

Forks

Packages

 
 
 

Languages