Smol Slime

Smol Slimes (also known as nRF Trackers) uses a protocol called Enhanced ShockBurst (ESB) on Nordic Semiconductor nRF52x and nRF52840 System-on-Chip (SoC). These are very power-efficient trackers, requiring a much smaller battery that can last for days to weeks compared to traditional ESP (WiFi) SlimeVR Trackers. A Receiver (also known as a dongle) is required to bridge the communications between the trackers and SlimeVR Server. This method doesn't work with Quest Standalone without using a computer for OSC.

Warning

Disclaimer: This project is highly experimental. These devices may be incompatible with newer versions of SlimeVR Server and will require a firmware update. Nothing is final yet; this includes hardware, firmware, protocols used, and etc.

Interested, have questions, or issues with this project? Chat with us in #smol-slimes on SlimeVR Discord!

Hardware

Receiver

  • eByte Dongle (E104-BT5040U) - Cheapest Receiver, free shipping from AliExpress, and has PCB Trace Antenna.
  • Nordic Semiconductor nRF52840 Dongle (PCA10059) - More expensive, not free shipping from Digikey/Mouser, and has PCB Trace Antenna.
  • SuperMini nRF52840 - Cheapest option, but having a ceramic antenna and your trackers also having a ceramic antenna will reduce signal strength and range.
  • Seeed Studio XIAO nRF52840 - Expensive option, but having a ceramic antenna and your trackers also having a ceramic antenna will reduce signal strength and range.

Tracker

  • SuperMini nRF52840 (Cheapest) or Seeed Studio XIAO nRF52840 (Smaller, but very expensive)
  • Compatible IMU/IMU Breakout Board
    • BMI270
    • ICM-42688-P
    • ICM-42688-V
    • ICM-45686
    • LSM6DSR
    • ISM330DHCX
    • LSM6DSO
    • LSM6DSV
    • LSM6DSV16B
    • ISM330BX
  • Compatible Mags (Optional)
    • BMM150 (not tested)
    • BMM350 (not tested)
    • IIS2MDC
    • LIS2MDL
    • LIS3MDL (not tested)
    • MMC5983MA
  • Push Button/Momentary Switch (One is recommended for Resetting, Pairing, Calibration, Sleep, putting the tracker in DFU mode for firmware. A second can be used to separate the original Reset functions from the other features.) A tweezer can be used to short the pins for the initial tracker setup instead.
  • Slide Switch - Recommended, but optional. Allowing you to turn on/off your tracker. Deep sleep by holding down the push button puts the tracker in a very low power state (not completely off).
  • 3.7V LiPo Battery - Battery must be 50ma or larger with XIAO nRF52840 and 100ma or larger with SuperMini nRF52840.

Schematic

Smol Slime Schematic

Software

  • Git Client
  • nRF Connect for Desktop
    • Programmer (Inside nRF Connect; needed for Nordic and eByte Dongles only)
    • Serial Terminal (Inside nRF Connect; recommended to send commands to your Receiver/Trackers)
    • Toolchain Manager (Inside nRF Connect; needed for building firmware for receiver and tracker)
      • 2.6.2 (Inside Toolchain Manager) Don't use a newer version!
  • Visual Studio Code
    • nRF Connect for VS (Install within VS Code Extension tab)
  • SlimeVR Server
    • 0.13.2 or later version

Firmware

Cloning Repositories

  1. Open Command Prompt (Type cmd in Start Menu).
  2. Change to a directory you want the repositories to clone to. (Use "cd" followed by space and then a full path to a folder or drive.)
  3. Cloning SlimeNRF Receiver Repository.
git clone --single-branch --recurse-submodules -b master https://github.com/SlimeVR/SlimeVR-Tracker-nRF-Receiver.git
  1. Cloning SlimeNRF Tracker Repository.
git clone --single-branch --recurse-submodules -b master https://github.com/SlimeVR/SlimeVR-Tracker-nRF.git

Note: It is recommended to clone to a filepath without whitespaces and/or unicode characters. You may encounters errors when building the firmware.

Building firmware

  1. Launch VS Code using nRF Connect's Toolchain Manager.
  2. Open the folder to one of the repositories.
  3. Make any pin changes or necessary adjustments to board\arm followed by board_name*board_name*.dts.
  4. Click on the nRF Connect tab on the left side of your screen (about half way down).
  5. Under "Applications" , click on "+ Add build configuration."
  6. For Receiver, under "CMake Preset", select the board and then scroll to the bottom and "Build Configuration". For Tracker, under "Board Target", select the "Custom" Radio button first, then select the board, and scroll to the bottom to "Build Configuration."

Note: For trackers, settings are found in "nRF Kconfig GUI" under "Actions" and expand the "SlimeNRF" section.

Changing board defines

  • To be added in the future.

Adjusting settings in the Kconfig

  • To be added in the future.

Pre-Compiled firmware for default pins

Updating Adafruit Bootloader (Make sure this step is completed before flashing firmware or you may brick your device)

  1. You can download them here. https://github.com/adafruit/Adafruit_nRF52_Bootloader/releases
  2. For SuperMini, download update-nice_nano_bootloader-x.x.x_nosd.uf2. For XIAO, download update-xiao_nrf52840_ble_sense_bootloader-x.x.x_nosd.uf2 . (The proper non-Sense version doesn't update the bootloader.)
  3. Plug the device into your computer via data USB cable.
  4. The device should start off in DFU mode when new without a bootloader. The LED should be fading on and off.
  5. If device's LED is not fading on and off, press the reset button twice (or short RST/GND pins) twice within 0.5s. If device with existing SlimeNRF firmware, reset 4 times.
  6. Navigate to your Downloads folder and copy the uf2 file.
  7. Navigate to the Mass Storage Drive (ex. NICENANO/XIAO-SENSE) from ThisPC.
  8. Paste the file into there, and the window should close and the device will reboot.

Flashing firmware to device

Dongles (Nordic/eByte)

  1. Open "Programmer" in nRF Connect.
  2. Press the reset button, and the LED should start fading on and off, putting the device in DFU Mode. For eByte, it is the right button. For Nordic, it is a side button (not the round white button).
  3. On the top left corner, select your Device.
  4. Click on "Add File".
  5. Navigate to your local Receiver repository, then select file in build\zephyr\zephyr.hex.
  6. Click the "Write button".

SuperMini and other Devices with Adafruit Bootloader as Receiver/Tracker (Make sure Bootloader is updated first!):

  1. Plug the device into your computer via data USB cable.
  2. The device should start off in DFU mode when new without a bootloader. The LED should be fading on and off.
  3. If device's LED is not fading on and off, press the reset button twice (or short RST/GND pins) twice within 0.5s. If device with existing SlimeNRF firmware, reset 4 times.
  4. Navigate to your local Receiver or Tracker repository, then go to build\zephyr\.
  5. Copy zephyr.uf2 file.
  6. Navigate to the Mass Storage Drive (ex. NICENANO) from ThisPC.
  7. Paste the file into there and the window should close and device will reboot.

Pairing Mode

Tracker

Method 1: Console
  1. Open nRF Connect for Desktop.
  2. Open Serial Terminal from nRF Connect.
  3. Ensure your tracker is connected to your computer via cable.
  4. On the top left corner, select your tracker under Devices.
  5. Click the "Connect to Port" button.
  6. Type pair into the console.
Method 2: Button
  1. Press the Reset (or short RST/GND pins) or Function button (if you have SW0 defined) 3 times.

Device's LED should blink once every sec.

Receiver

Method 1: Console
  1. Open nRF Connect for Desktop.
  2. Open Serial Terminal from nRF Connect.
  3. Ensure your tracker is connected to your computer via cable.
  4. On the top left corner, select your dongle under Devices.
  5. Click the "Connect to Port" button.
  6. Type pair into the console.
Method 2: Button
  1. On the eByte dongle, press the left button 3 times. On the Nordic dongle, press the round white button 3 times.

Device's LED should blink once every sec.

Once trackers are paired, the LED should stop blinking once per sec. To exit pairing mode on Receiver, type reboot in the console or press the left button once on eByte Dongle or the white button once on Nordic Dongle.

Calibration

Basic

Method 1: Console
  1. Open nRF Connect for Desktop.
  2. Open Serial Terminal from nRF Connect.
  3. Ensure your tracker is connected to your computer via cable.
  4. On the top left corner, select your tracker under Devices.
  5. Click the "Connect to Port" button.
  6. Type calibrate into the console while tracker is on a flat surface.
  7. Wait for the logs to reboot and print out again.
Method 2: Button
  1. Press your Reset or SW0 (Functional) button twice and leave the tracker still on a flat surface for a few seconds.

6-Sided

  1. Make sure the power switch is on. (So the tracker can run on battery when unplugged.)
  2. 6-Sided Calibration will start the first time the tracker loads up after flashing new firmware. It can be redone by using the 6-side command in console. (At the moment, there is no button press combination to start this calibration.)
  3. Follow the console log on rotating sides on a flat surface. Leave the cable side for last.
  4. When prompted for the last side, unplug your USB cable and place the side with the USB port onto the flat surface.
  5. Wait a bit until calibration is complete.

Updating firmware

  1. If your Receiver needs firmware updated, do this first.
  2. Open nRF Connect's Serial Terminal.
  3. Select your Receiver from the Device list.
  4. Click the "Connect to Port" button.
  5. Enter clear to unpair all of your trackers from the Receiver.
  6. Enter pair to enter pairing mode on your Receiver.
  7. Connect a tracker to your computer via USB cable and make sure the power switch is on. (So the tracker can run on battery when unplugged for 6-sided calibration.)
  8. Select your tracker from the Device List.
  9. Click the "Connect to Port" button.
  10. Enter dfu to go into DFU Mode.
  11. Copy the UF2 file onto your tracker.
  12. 6-sided calibration will start right away (this can be redone with 6-side command if needed.)
  13. After 6-sided calibration, enter calibrate to calibrate the ZRO.
  14. Enter pair to enter pairing mode.
  15. Wait for the tracker to pair to the Receiver, and then disconnect.
  16. Repeat process for all trackers.
  17. Select your Receiver from the Device list.
  18. Click the "Connect to Port" button.
  19. Enter reboot to exit pairing mode.

Console Commands

Receiver

  • info - Get device information
  • list - Get paired devices
  • reboot - Soft reset the device
  • pair - Enter pairing mode
  • clear - Clear stored devices
  • meow - Meow!

Tracker

  • info - Get device information
  • reboot - Soft reset the device
  • calibrate - Calibrate sensor ZRO
  • 6-side - Calibrate 6-side accelerometer
  • pair - Enter pairing mode
  • dfu - Enter DFU bootloader
  • meow - Meow!

Troubleshooting

Check Console Logs

  1. Open nRF Connect for Desktop.
  2. Open Serial Terminal from nRF Connect.
  3. Ensure your tracker is connected to your computer via cable.
  4. On the top left corner, select your tracker under Devices.
  5. Click the "Connect to Port" button.

Error LED Codes

SWD Debugging

  • Instructions for the Raspberry Pi, Raspberry Pi Pico, ST-Link V2, J-Link, nRF52/nRF52840 DevKit, OB-ARM, and other debuggers to be added in the future.
Debugging
Fixing bricked bootloader/device

Resource: https://github.com/joric/nrfmicro/wiki/Bootloader

SlimeVR nRF Receiver Firmware: https://github.com/SlimeVR/SlimeVR-Tracker-nRF-Receiver

SlimeVR nRF Tracker Firmware: https://github.com/SlimeVR/SlimeVR-Tracker-nRF

Scawanf's PCB R3 on Github: https://github.com/SlimeVR/SlimeVR-Tracker-nRF-PCB

Scawanf's PCB R3 on OSHWLab: https://oshwlab.com/sctanf/slimenrf3

SlimeVR Discord: https://discord.gg/SlimeVR

Created by Shine Bright