-
Notifications
You must be signed in to change notification settings - Fork 1
Home
Dylan Marcus edited this page Aug 20, 2025
·
2 revisions
Welcome to the M1 Orientation Manager Wiki! This documentation provides comprehensive setup and configuration instructions for all supported IMU devices.
The M1 Orientation Manager is an external orientation device manager and utility designed to aggregate different head tracking methods. It supports various IMU devices through different connection types including Serial, BLE, OSC, and Camera interfaces.
| Device | Connection Type | Status | Wiki Page |
|---|---|---|---|
| Custom Input OSC | OSC | ✅ Stable | Setup Guide |
| Supperware IMU | MIDI/USB | ✅ Stable | Setup Guide |
| MetaWear/mBientLab IMUs | BLE | ✅ Stable | Setup Guide |
| Waves Nx Tracker IMU | BLE | ✅ Stable | Setup Guide |
- Build the Application: Follow the build instructions in the main README
- Choose Your Device: Select your IMU device from the supported list above
- Follow Device Setup: Click on the setup guide for your specific device
- Test Connection: Use the OSC client tool to verify your device is working
- macOS: 10.15+ (Catalina and later)
- Windows: Windows 10/11
- Linux: Ubuntu 18.04+ (limited support)
- BLE (Bluetooth Low Energy): For MetaWear and Waves Nx devices
- Serial/USB: For M1 IMU and WitMotion devices
- MIDI/USB: For Supperware devices
- OSC (Network): For custom OSC input devices
The M1 Orientation Manager uses a modular architecture:
- Hardware Abstraction Layer: Common interface for all device types
- Device Implementations: Specific drivers for each supported device
- Data Transmission Types: Serial, BLE, OSC, Camera interfaces
- OSC Client Tool: Example application for testing and integration
- Issues: Report bugs or request new device support on GitHub Issues
- Documentation: Additional technical details in the Source directory
- OSC Tool: See the OSC Client documentation for integration examples
We welcome contributions for new device support! Please feel free to open an issue with device details if you'd like support for a specific IMU device not currently listed.
This documentation is for the M1 Orientation Manager project by Mach1