Logitech Marblemouse USB for Ubuntu


 

Introduction

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

Logitech Marble Mouse USB

What Logitech calls left and right button are coded 1 and 3, with no middle button; the small buttons Logitech calls "Forward" and "Backward" are coded as back (8) and forward (9). This knowledge will help you create your own mappings, if desired.

 

Without any special configuration

Without any special configuration, the mouse would work the way expected:

  • Left – Normal left mouse button.

  • Back – Single click is back

  • Forward – Single click is next.

  • Right – Normal right mouse button.

However, the mouse misses scroll buttons and middle button. These has to be emulated. This article is about how to make that happen.

 

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. In Ubuntu 14.04, it is located in /usr/share/X11/
  3. 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.)

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

  5. Logout and restart X, or reboot.
  6. 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: add wheel emulation feature

This configuration yields:

  • Left – Normal left mouse button.

  • Back – Single click is back;

  • Forward – Single click is next; press and hold to scroll freely horizontally and vertically.

  • Right – 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 "EmulateWheel" "true"
        Option "EmulateWheelButton" "9"
EndSection

In this case, mouse wheel is emulated by pressing and holding the "Forward" button, the button 9. You can configure to use button 8, the "Back" button, instead, but, in that case, both "Left button" and "Back Button" would need to be pressed together in order to select text while scrolling, and since both buttons are under a thumb, it will be rather acrobatic to do it with just one thumb.

 

Example Configuration #2: add middle mouse button emulation

 

Section "InputClass"
        Identifier  "Marble Mouse"
        MatchProduct "Logitech USB Trackball"
        MatchIsPointer "on"
        MatchDevicePath "/dev/input/event*"
        Driver "evdev"
        Option "EmulateWheel" "true"
        Option "EmulateWheelButton" "9"
        Option "Emulate3Buttons" "true"
EndSection

With this configuration, clicking left and right mouse button at the same time results a middle-click, which function as pasting the selected text under cursor to the place under mouse pointer.

In Ubuntu 12.04 and later, one additional configuration needs to be done. 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.

 

Example Configuration #3, forgo "Back" button

This example yields:

  • Left Button – Normal left mouse button.

  • Back Button – Normal middle mouse button.

  • Forward Button – Single click results 'next'. Press and hold scrolls with the trackball vertically.

  • Right Button – 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"

EndSection

If you intend this:

  • Forward Button – Scroll freely with the trackball, both horizontally and vertically.

Add this:

    Option "YAxisMapping"       "4 5"
    Option "XAxisMapping"       "6 7"

 

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:

  • Left Button – Left click

  • Back Button – Hold to scroll; click for back

  • Forward Button – Paste highlighted text (simulates middle-click)

  • Right Button – Right click

 

Horizontal and Vertical Scrolling Example

To enable vertical and horizontal scrolling while holding down the small, left mouse button ("Back Button" 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 ("Back Button" 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"

 

Read more

How to migrate Raspberry Pi 5 OS from micro SD to NVME m.2 SSD

首先我買了Raspberry Pi CM5後來買了Raspberry Pi CM5 I/O board來當個人電腦使用,系統是安裝在256GB SD卡上運行的很好。用久了在開啟較肥的程式像Web Browser或LiberOffice會有慢半拍的反應,而有了升級NVME m.2 SSD念頭。 因為Raspberry Pi 5支援的最快PCIe gen3 x 4就不去考慮快的Gen4 or Gen5 m.2 SSD。找了ADATA出的 LEGEND 710入門級的產品,會利用HMB(Host Memory Buffer)來加速I/O速度,因為是Raspberry Pi OS kernel會認不得而無法正常使用 事先在SD卡的/boot/firmware/cmdline.txt 加入 kernel command line參數如下,然後重開機m.

By Phillips Hsieh

How to document Home Lab and Network

運維機房和跨域的網路,會遇到各式需求與問題,用對工具才能分析問題,個人覺得最重要的是使用能處理問題的工具。 推薦目前想學和正在使用的平台與軟體,協助將公司/家用機房文件化 佈告欄任務管理 Focalboard 白板可管理任務指派 網路架構文件編寫 netbox 精細管理網路設備與連接線路 IP 資源管理 phpipam 專注網路IP分配 邏輯塊文件編寫 draw.io 視覺化概念圖 機房設備管理 ITDB 管理設備生命週期與使用者

By Phillips Hsieh

如何在Raspberry Pi4上安裝Proxmox for ARM64

第一步 準備好Raspberry Pi 4 / CM4 4GB RAM,這裡要留意CM4如果是買有內建eMMC storage會限制不能使用SD卡開機而限制本地空間容量,如果沒有NAS外接空間或使用USB開機的話,建議買CM4 Lite插上大容量SD卡 第二步 去Armbian官網下載最小化Debian bookworm image https://www.armbian.com/rpi4b/ Armbian 25.2.2 Bookworm Minimal / IOT 然後寫入SD/USB開機碟,寫入方法參考官方文件 https://github.com/raspberrypi/usbboot/blob/master/Readme.md Note: 官方提供的預先設定系統方法,可以在Armbian初次啟動自動化完成系統設定。連結在此 https://docs.armbian.com/User-Guide_Autoconfig/

By Phillips Hsieh

世界越快心越慢

在晚飯後的休息時間,我特別享受在客廳瀏灠youtube上各樣各式創作者的影音作品。很大不同於傳統媒體,節目多是針對大多數族群喜好挑選的,在youtube上我會依心情看無腦的動畫、一些旅拍記錄、新聞時事談論。 尤其在看了大量的Youtube的分享後,我真的感受到會限制我的是我的無知,特別是那些我想都沒想過的實際應用,在學習後大大幫助到我的生活和工作層面。 休息在家時,我喜歡想一些沒做過的菜,動手去設計生活和工作上的解決方案,自己是真的很難閒著沒事做。 如創作文章,陪養新的習慣都能感覺到成長的喜悅,是不同於吃喝玩樂的快樂的。 創作不去限制固定的形式,文字是創作、影像聲音也是創作,記錄生活也是創作,我想留下的就是創造—》實現—》回憶,這樣子的循環過程,在留下的足跡面看到自己一路上的成長、失敗、絕望、重新再來。 雖然大部份的時候去做這些創作也不明白有什麼特別的意義,但不去做也不會留下什麼,所以呀不如反事都去試試看,也許能有不一樣的水花也許有意想不到的結果,投資自己永遠不會是失敗的決定,不是嗎?先問問自己再開始計畫下一步,未來沒人說得準。 像最近看youtube仍大一群人在為DOS開

By Phillips Hsieh