Introduction

This document describes how to configure the Logitech TrackMan Marble Mouse (USB), shown in the following figure:

Logitech Marble Mouse USB

The image numbers the buttons as 1, 2, 3, and 4, but the trackball represents them as 1, 8, 9, and 3, respectively. That is, the large buttons are coded as left (1) and right (3), with no middle button; the small buttons are coded as back (8) and forward (9). This knowledge will help you create your own mappings, if desired.

Ubuntu 12.04 middle click issue

As of May 2012, the default setting for middle-button-enabled in Gnome is false. Since Gnome settings are applied after xorg settings, this results in middle button emulation disabled. To fix this, run the following in a terminal:

gsettings set org.gnome.settings-daemon.peripherals.mouse middle-button-enabled true

This needs to be done only once for each user - Gnome remembers this setting between logins. For a GUI alternative to gsettings, install the dconf-tools package and run dconf-editor. The setting can be found at org::gnome::settings-daemon::peripherals::mouse.

Ubuntu 10.04 and newer

This section guides the reader on how to establish a working trackball using Ubuntu 10.04 through 12.04 (note the middle click caveat above). In 10.04, hal is gone, and udev does not appear to be reliably supported by Xorg. However, Xorg supports  InputClass  sections in its configuration files, which are described here.

Configuration

To get your Marble Mouse working in Ubuntu 10.04, complete the following steps:

  1. Locate the existing xorg.conf.d directory:  locate xorg.conf.d | grep d$ 

  2. Edit 50-marblemouse.conf in that directory. (Note: Do not create your own xorg.conf.d directory as it can disable your keyboard and freeze X.)

  3. Update the InputClass section of 50-marblemouse.conf using one of the example configurations below.

  4. Logout and restart X, or reboot.
  5. If editing 50-marblemouse.conf does not work, edit /etc/X11/xorg.conf instead. The remainder of this section refers to this as the X Configuration File.

For an explanation of the evdev options used below, see man (4) evdev, also available online here (for X.org 7.5 as used in Ubuntu 10.04, 10.10 and 11.04).

Example Configuration #1

This configuration yields:

  • Button 1 - Normal left mouse button.

  • Button 2 - Single click is back; press and hold to scroll freely horizontally and vertically.

  • Button 3 - Single click is next.

  • Button 4 - Normal right mouse button.

  • Button 1 and Button 4 - Middle click.

Add the following text to the X Configuration File:

Section "InputClass"
        Identifier  "Marble Mouse"
        MatchProduct "Logitech USB Trackball"
        MatchIsPointer "on"
        MatchDevicePath "/dev/input/event*"
        Driver "evdev"
        Option "ButtonMapping" "1 2 3 4 5 6 7 8 9"
        Option "EmulateWheel" "true"
        Option "EmulateWheelButton" "8"
        Option "ZAxisMapping" "4 5"
        Option "XAxisMapping" "6 7"
        Option "Emulate3Buttons" "true"
EndSection

Note that this configuration enables the middle mouse emulation feature. Clicking the left and right buttons simultaneously is a middle mouse click.

To disable middle click, change the last option to:

        Option  "Emulate3Buttons" "false"

Disabling this feature causes Button 3 to no longer function as a next button, acting instead like a middle click.

Example Configuration #2

This example yields:

  • Button 1 - Normal left mouse button.

  • Button 2 - Normal middle mouse button.

  • Button 3 - Scroll freely with the trackball, both horizontally and vertically.

  • Button 4 - Normal right mouse button.

Add the following text to the X Configuration File:

Section "InputClass"
    Identifier      "Marble Mouse"
    MatchProduct    "Logitech USB Trackball"
    MatchIsPointer  "on"
    MatchDevicePath "/dev/input/event*"
    Driver          "evdev"
    Option          "SendCoreEvents" "true"

    #  Physical buttons come from the mouse as:
    #     Big:   1 3
    #     Small: 8 9
    #
    # This makes left small button (8) into the middle, and puts
    #  scrolling on the right small button (9).
    #
    Option "Buttons"            "9"
    Option "ButtonMapping"      "1 8 3 4 5 6 7 2 9"
    Option "EmulateWheel"       "true"
    Option "EmulateWheelButton" "9"
    Option "YAxisMapping"       "4 5"
    Option "XAxisMapping"       "6 7"

EndSection

Example Configuration #3

This example yields:

  • Button 1 - Normal left mouse button.

  • Button 2 - Normal middle mouse button.

  • Button 3 - Scroll freely with the trackball, only vertically.

  • Button 4 - Normal right mouse button.

Add the following text to the X Configuration File:

Section "InputClass"
    Identifier      "Marble Mouse"
    MatchProduct    "Logitech USB Trackball"
    MatchIsPointer  "on"
    MatchDevicePath "/dev/input/event*"
    Driver          "evdev"
    Option          "SendCoreEvents" "true"

    Option "Buttons"            "9"
    Option "ButtonMapping"      "1 8 3 4 5 6 7 2 9"
    Option "EmulateWheel"       "true"
    Option "EmulateWheelButton" "9"
    Option "ZAxisMapping"       "4 5"
EndSection

Trouble Shooting

Once you have logged back in, if it is not immediately working you can run

tail -f /var/log/Xorg.0.log

from a terminal, unplug and re-plug your mouse, and see what the X server is doing. You should see (among other things) two successive lines something like this:

(**) Logitech USB Trackball: Applying InputClass "evdev pointer catchall"
(**) Logitech USB Trackball: Applying InputClass "Marble Mouse"

If you only see the first and not the second, your InputClass section is being ignored. Either it is failing one of the Match lines (see the following paragraphs) or the configuration file it is in is being ignored entirely. If the Match lines appear correct, try moving the configuration from xorg.conf to xorg.conf.d/ as per above, or vice-versa.

In the above examples, the device name given in the MatchProduct option is "Logitech USB Trackball". Older models of the Marble Mouse may have a different name. Take a look at the output of the following command to determine the name of your device and change that line if necessary:

dmesg | grep Logitech

Edit the MatchProduct line in the above configuration to use your device name. For instance, older trackballs may use the following:

        MatchProduct "ImExPS/2 Logitech Explorer Mouse"

These older models may also use a different button mapping:

        Option "ButtonMapping" "1 8 3 4 5 6 7 2 9"

Ubuntu 9.10 and older

Introduction

Input devices are now configured using Hal, which means most settings in xorg.conf will be ignored when X starts. Hal's configuration files are stored in /etc/hal/fdi/policy with a file name extension of .fdi. After making configuration changes, restart X (or reboot the computer).

Ubuntu 9.10 - 24-Mar-2010

Avoid using Hal for this release as it has known issues. Try the following:

  1. Edit $HOME/bin/trackball.sh:

    dev="Logitech USB Trackball"
    we="Evdev Wheel Emulation"
    xinput set-int-prop "$dev" "$we Button" 8 8
    xinput set-int-prop "$dev" "$we" 8 1
    
    # xinput set-int-prop "$dev" "$we" 8 1
    # xinput set-int-prop "$dev" "$we Button" 8 9
    # xinput set-int-prop "$dev" "$we X Axis" 8 6 7
    # xinput set-int-prop "$dev" "$we Y Axis" 8 4 5
    # xinput set-int-prop "$dev" "Drag Lock Buttons" 8 8 
  2. Make sure trackball.sh begins with #!/bin/bash.

  3. Make the script executable:

    chmod +x $HOME/bin/trackball.sh
  4. Add the following lines to $HOME/.bashrc:

    xmodmap $HOME/.Xmodmap > /dev/null 2>&1
    $HOME/bin/trackball.sh
  5. Edit $HOME/.Xmodmap:

    pointer = 1 8 3 4 5 6 7 9 2

Logout and log back in. This setup provides:

  • Button 1 - Left click

  • Button 2 - Hold to scroll; click for back

  • Button 3 - Paste highlighted text (simulates middle-click)

  • Button 4 - Right click

Horizontal and Vertical Scrolling Example

To enable vertical and horizontal scrolling while holding down the small, left mouse button (button #2 in the image) change /etc/hal/fdi/policy/mouse-wheel.fdi to:

<?xml version="1.0" encoding="ISO-8859-1"?>
<deviceinfo version="0.2">
  <device>
    <match key="info.product" string="Logitech USB Trackball">
      <merge key="input.x11_options.ButtonMapping" type="string">1 2 3 4 5 6 7 8 9</merge>
      <merge key="input.x11_options.EmulateWheel" type="string">true</merge>
      <merge key="input.x11_options.EmulateWheelButton" type="string">8</merge>
      <merge key="input.x11_options.ZAxisMapping" type="string">4 5</merge>
      <merge key="input.x11_options.XAxisMapping" type="string">6 7</merge>
      <merge key="input.x11_options.Emulate3Buttons" type="string">true</merge>
    </match>
  </device>
</deviceinfo>

Vertical Scrolling Example

To enable vertical scrolling while holding down the small, left mouse button (button #2 in the image), change /etc/hal/fdi/policy/mouse-wheel.fdi to:

<?xml version="1.0" encoding="ISO-8859-1"?>
<deviceinfo version="0.2">
  <device>
    <match key="info.product" string="Logitech USB Trackball">
      <merge key="input.x11_options.ButtonMapping" type="string">1 8 3 9 2</merge>
      <merge key="input.x11_options.EmulateWheel" type="string">true</merge>
      <merge key="input.x11_options.EmulateWheelButton" type="string">8</merge>
      <merge key="input.x11_options.ZAxisMapping" type="string">4 5</merge>
      <merge key="input.x11_options.Emulate3Buttons" type="string">false</merge>
    </match>
  </device>
</deviceinfo>

Here's the /etc/hal/fdi/policy/mouse-wheel.fdi for left-handed operation (with right-handed in comments):

<?xml version="1.0" encoding="ISO-8859-1"?>
<deviceinfo version="0.2">
  <device>
    <match key="info.product" string="Logitech USB Trackball">
      <merge key="input.x11_options.Buttons" type="string">9</merge>
      <merge key="input.x11_options.EmulateWheel" type="string">true</merge>
      <merge key="input.x11_options.EmulateWheelTimeout" type="string">300</merge>
      <!-- Left hand -->
      <merge key="input.x11_options.ButtonMapping" type="string">3 9 1 4 5 6 7 8 2</merge>
      <merge key="input.x11_options.EmulateWheelButton" type="string">9</merge>
      <!-- Right hand -->
      <!-- <merge key="input.x11_options.ButtonMapping" type="string">1 8 3 4 5 6 7 2 9</merge> -->
      <!-- <merge key="input.x11_options.EmulateWheelButton" type="string">8</merge> -->
      <merge key="input.x11_options.XAxisMapping" type="string">6 7</merge>
      <merge key="input.x11_options.YAxisMapping" type="string">4 5</merge>
      <merge key="input.x11_options.ZAxisMapping" type="string">4 5</merge>
      <merge key="input.x11_options.Emulate3Buttons" type="string">true</merge>
    </match>
  </device>
</deviceinfo>

Firefox

If vertical scrolling does not work in Firefox, ensure the following about:config values are set (using Firefox):

mousewheel.horizscroll.withnokey.action         user set        integer 0
mousewheel.horizscroll.withnokey.sysnumlines    user set        boolean true

Middle Click

Currently the button mapping described above is being ignored by Hal. (As of 9.04 it appears that the button mapping is now applied correctly. Only use one method or the other.) This is particularly problematic if you want one of the small buttons to serve as middle click. A simple workaround is to remap what you need via xmodmap. As an example, let's map the small left button as middle click. Save this in your .Xmodmap file:

pointer = 1 8 3 4 5 6 7 2 9

Note that all we did was to swap the numbers 2 and 8. If you'd like to use the small right button as middle click, swap 2 and 9 instead. The .Xmodmap file will be loaded next time you log in. To run it manually, run:

$ xmodmap .Xmodmap

Using xmodmap affects all mice you have plugged in, an alternative is to use xinput to remap the buttons just for the device you specify.

$ xinput set-button-map "Logitech USB Trackball" 1 8 3 4 5 6 7 2 9

xinput may report the trackball as having 32 buttons and some window managers such as fluxbox require you to map all buttons reported for the device even though the buttons do not exist when using xinput. For fluxbox and similar window mangers the command below would map the trackball for left handed use. The large button on the right would be left click, the large button on the left would be right click, the small button on the right would function as a middle button, and the small button on the left would function as the scroll.

$ xinput set-button-map "Logitech USB Trackball" 3 9 1 4 5 6 7 8 2 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32

If you have a different device and don't know its identifier, you can find it via:

$ xinput list

Setting options via HAL may not work in Ubuntu 9.10 by default

Ubuntu 9.10 (Karmic Koala) contains gnome-settings-daemon 2.28.1 which does not honour settings made in /etc/hal/fdi/policy/. This is filed as http://bugs.debian.org/cgi-bin/bugreport.cgi?bug=552279. A workaround by disabling the mouse plugin of gnome-settings-daemon is described at http://bbs.archlinux.org/viewtopic.php?pid=644304. In my case (MacBook Pro 5,4 using the bcm5974 touchpad module) I had to reboot once after applying the workaround to make it stick. After this, I could change the settings as expected by editing the HAL fdi file and restarting HAL (some settings may need a module reload, too). Note that you can use

$ lshal | less

or similar to check whether the fdi settings were correctly merged into the configuration.

Alternative: apply settings via xinput

If you do not want to use HAL (or apply the workaround from the above section in Ubuntu 9.10), using xinput provides an alternative way to make the Logitech Marble work.

Horizontal & vertical scrolling with small left key & drag lock with small right key example:

xinput set-button-map "Logitech USB Trackball" 1 2 3 4 5 6 7 8 9
xinput set-int-prop "Logitech USB Trackball" "Evdev Wheel Emulation Button" 8 8
xinput set-int-prop "Logitech USB Trackball" "Evdev Wheel Emulation" 8 1
xinput set-int-prop "Logitech USB Trackball" "Evdev Wheel Emulation Axes" 8 6 7 4 5
xinput set-int-prop "Logitech USB Trackball" "Evdev Wheel Emulation X Axis" 8 6
xinput set-int-prop "Logitech USB Trackball" "Evdev Drag Lock Buttons" 8 9

You can add the lines above in a bash script (say marbleScroll.sh):

Now run the script

$ sh marbleScroll.sh

You can check what you have made via:

$ xinput list-props "Logitech USB Trackball"


CategoryHardware CategoryX

Logitech_Marblemouse_USB (last edited 2012-05-13 04:03:36 by subscriptions-drevicko)