/Xyz_mouse

Alternate firmware for Orbion mouse CAD

Primary LanguageC++GNU General Public License v3.0GPL-3.0

LOGO Xyz Mouse

Xyz Mouse firmware for Orbion

First attempt to build an alternate firmware for Orbion. It is now compatible with 3Dconnexion drivers and mimic Spacemouse compact.

It gives to your Orbion 6Dof (see usage). The current firmware is designed for Arduino Leonardo. Ports for more modern mcus and different sensors is planned.

First done :

Todo/improve

  • Orbion_settings : a mixed library wich managed display and settings
  • Strings management to improve

Installation :

It can be tricky to get the firmware to be recognized by the system. Follow this steps to get it work.

  • Clone the current repo,
  • Open the folder with platformio in Vscode
  • Check platformio.ini and src\settings.h
  • Compile and upload the firmware
  • Unplug/plug the Orbion
  • Install the 3DConnexion drivers
  • Restart your computer.

The default display build is configured for sh110x, if you want change for SSD1306 open platformio.ini and change default_envs value to ssd1306

Usage :

At first run the firmware store a default config in EEPROM

Mode actuators function Notes
Normal B1/B2 Button Left / Button right
Joystick or rot knob Tilt / Orbit
B3 Enter settings
B_Knob + Joystick or rot Knob Pan / Zoom
Settings B_Knob Select
B3 Return/Cancel
rot_Knob scroll
Color settings rot_Knob change Hue 16M color settings
Joystick X change saturation
Joystick Y change brigthness Britthness of Color1 is used in Rainbow mode

Settings Menu

Press B3 button to enter menu

  • Settings
    • Knob Direction (L hand / R hand)
    • PAN / TILT (reverse behavior when knob button is pressed)
    • DZ width (change joystick deadzone setting)
    • Sensitivity (Joystick)
    • Color 1 (For led Effects)
    • Color 2
    • Color mode (Color 1 , gradient(color 1, color 2), Rainbow)
    • Motion mode (fixed, )
    • Screensave timeout

All other settings (by app, buttons functions )can be done in 3DxWare on your computer.

Troubleshooting

I cannot access the Settings menu pressing B3:

Check if settings.h follows your pinout.

Black screen at startup, Not recognize as SpaceMouse

Uninstall/reinstall 3Dconnexion drivers. Restart you computer.

Any questions

@fboc on Discord

Inspiration sources :