Notes When Installing on Linux

Notes when installing the TWELITE STAGE APP on Linux

Linux

The USB device ID of TWELITE R2 has changed from the conventional 0403:6001 to 0403:6015. You need to add udev settings.

A 32-bit version is not provided.

Linux environments differ in the types of packages provided depending on the distribution and version. You may need to install packages or configure settings individually.

Please refer to general information using error messages as clues.

Environment

Development and operation have been confirmed on the following environments.

Ubuntu 16.04, 18.04, 20.04
NNLinux Beta8 64bit
CentOS 7

Handling Serial Ports

To recognize MONOSTICK or TWELITE-R from TWELITE STAGE, you need to unload the ftdi_sio module and grant read/write permissions to the USB device.

The USB device IDs are shown below.

Vendor ID 0x0403
Product ID 0x6001 (MONOSTICK, TWELITE R) or 0x6015 (TWELITE R2)

We provide udev setting scripts (for Ubuntu, CentOS) to automate this configuration.

Copy the definitions to /etc/udev/rules.d and reload the settings. After setting, unplug and replug the USB device, then run TWELITE_Stage.run. If the USB device appears on the initial screen, the settings have been applied.

Ubuntu 16.04, 18.04, 20.04


cd ./MWSTAGE/TWELITE_Stage/INSTALL/ubuntu/
sudo ./set_udev_sudo.sh

Definition file (line breaks added for readability)

ACTION=="add",
   ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001",
   MODE="0666",
   RUN+="/bin/sh -c 'rmmod ftdi_sio && rmmod usbserial'"
ACTION=="add",
   ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6015",
   MODE="0666",
   RUN+="/bin/sh -c 'rmmod ftdi_sio && rmmod usbserial'"

CentOS 7


cd ./MWSTAGE/TWELITE_Stage/INSTALL/centos/
sudo ./set_udev_sudo.sh

Definition file (line breaks added for readability)

ACTION=="add",
   ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6001",
   MODE="0666",
   RUN+="/bin/sh -c '/usr/sbin/rmmod ftdi_sio'"
ACTION=="add",
   ATTRS{idVendor}=="0403", ATTRS{idProduct}=="6015",
   MODE="0666",
   RUN+="/bin/sh -c '/usr/sbin/rmmod ftdi_sio'"

Registering the Application

You may not be able to run TWELITE_Stage.run from a file icon on the desktop. This is because the system may not recognize TWELITE_Stage.run as an executable.

Ubuntu 16.04, 18.04, 20.04

We provide a script to generate definition files for Ubuntu.


cd ./MWSTAGE/TWELITE_Stage/INSTALL/ubuntu/
./make_launch_icon.sh

This script creates a .desktop file (application definition) in $HOME/.local/share/applications.

After running the script, the TWELITE STAGE icon will be added to the application list.