Device button names

Table of Contents

• How to document button names
• Devices
  • Space Pilot
  • Space Navigator
  • Magellan SpaceMouse

This is an effort to document the mapping between physical device buttons and their button numbers, across all known 6dof devices. If you have a device not listed in this page, please consider adding to the growing list of devices in this page. If you have a listed device and you discover an error in this page, please consider fixing it. If you don't want to make a github account, which is needed in order to edit this page, feel free to send the information over email at spacenav-users@lists.sourceforge.net

How to document button names

If you have a device not listed here, and you wish help us grow this list, the first step is to figure out the mapping the actual physical buttons and their button numbers. The easiest way to do that is to run the "simple" example program which comes with libspnav, press all the buttons and note the numbers printed for each one of them.

• Download the latest libspnav release from https://github.com/FreeSpacenav/libspnav/releases extract it somewhere, and change into that directory.
• run ./configure and then make in the libspnav directory to build libspnav
• change into the examples/simple directory, and run make to build the example program.
• finally run ./simple_af_unix

Simple example output:

got button press event b(3)
got button release event b(3)
got button press event b(5)
got button release event b(5)

If you have remapped your device buttons in /etc/spnavrc or through spnavcfg, this will affect what the simple example prints. So please move /etc/spnavrc out of the way (rename it or move it to somewhere else temporarily), and restart spacenavd before doing this.

Alternatively you can use spnavcfg to discover the mapping between buttons and their numbers. The advantage of spnavcfg is that it uses raw button events, which makes it unaffected by button remapping. Go into the "Buttons" tab, and when you press any buttons, their numbers will be listed at the top of the button mapping interface, and the number in the corresponding button row will turn red.

Devices

Space Pilot

number	button label
0 - 5	1 - 6
6	T
7	L
8	R
9	F
10	Esc
11	Alt
12	Shift
13	Ctrl
14	Fit
15	Panel
16	+ (increase)
17	- (decrease)
18	Dom
19	3D (lock icon)
20	Config

Space Navigator

number	device button
0	left side
1	right side

Magellan SpaceMouse

number	button label
0 - 7	1 - 8
8	* (asterisk)