gds-udev(7)

NAME
gds-udev - udev rules for creating reproducible USB device names for GW Instek GDS oscilloscopes

DESCRIPTION
gds2000tools comes with a set of udev(7) rules for GW Instek GDS series oscilloscopes with USB interfaces. These rules create reproducible device names in addition to the device names assigned by the operating system.

Typically, the operating system assigns generic devices names, like /dev/ttyACM0 to an oscilloscope's USB interface. These device names can change, for example, when the oscilloscope is unplugged and plugged in again.

The gds2000tools udev rules create an additional device name for an oscilloscope in /dev, that is reproducible. I.e. it is always the same for a particular oscilloscope, independent of the order in which the oscilloscope was plugged in to USB.

Such a device name simplifies the specification of the desired oscilloscope for gdsh(1)'s gds-open command, and in the GDSH_DEV environment variable when GDSH_CONNECT_AT_START is used. See gdsh(1) for details.

The device name is of the form

    /dev/model-serialnumber

Where

model
    The oscilloscope model as returned by the oscilloscope in the USB iProduct field (see lsusb(8)). Typical values are, for example, GDS-2064 or GDS-2102. This name is also the same as returned in the model field by the IDN? query.

serialnumber
    The oscilloscope serial number as returned by the oscilloscope in the USB iSerial field. Typical values are, for example, EG150000 or P930116. This serial number is also the same as returned in the serial number field by the *IDN? query.

Installation of the udev rules is optional. They are installed when HAS_UDEV in gds2000tools-x.y/config.mk is set to 1 during the build and installation of gds2000tools.

FILES

80-instek-gds.rules
    The udev rules.

EXAMPLES
For a GDS-2064 with the serial number EG150000 the following device name would be created when the oscilloscope is plugged in to USB.

    /dev/GDS-2064-EG150000

The device name will be removed when the oscilloscope is unplugged.

SEE ALSO
gdsh(1), lsusb(8), udev(7).

COPYRIGHT
Copyright © 2010 Thomas Weidenfeller

gds2000tools is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3 as published by the Free Software Foundation.

gds2000tools is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with gds2000tools. If not, see <http://www.gnu.org/licenses/>.