devc-serusb

QNX SDP8.0Utilities ReferenceUtilities

Driver for USB-to-serial adaptors and USB CDC ACM devices

Note:
You must be root or have the right abilities to start this driver.

Syntax:

  devc-serusb [options] [-d args] [-t]

Runs on:

QNX OS

Options:

In addition to the devc-ser* options, this driver supports the following options:

-d args[,args ...]
Device-specific options; refer to Device-specific options, below.
-t
Test the connection by completing the initialization but don't begin processing data and just exit afterwards. Use this option if you want to confirm that the device is connected properly, without running any data through the driver.

Device-specific options

The device-specific options that you can specify with the -d option are:

busno=bus
The bus number of the USB controller.
debug=[rx|tx|intr|all|none]
Write raw URB data to slogger2.
devno=dev
The USB address of the device.
did=did
The device ID of the device.
drt=num
Data ready timeout (device-specific).
drtx=[hi|lo]
(For MOSCHIP 7840 devices) DTR TX line mode when mode=RS485. The default is hi.
ifaces=idx[:idx...]
A list of USB interfaces to use. You must specify at least one interface, and use a colon (:) to separate multiple interfaces.
ign_remove
Specify to prevent the removal callback from being attached.
mode=name
Set the serial communication mode to RS232 (the default) or RS485.
module=name
Set the hardware module to use for an unknown vendor ID or device ID.
name=name
The basename for the pathname entry. The default is /dev/serusb.
path=name
Connect to the specified USB stack. Default is /dev/usb/io-usb-otg.
pindex=idx
Set the port that the index options are to be applied to.
priority=prio
Set the priority of the event-processing thread. Default is 21.
query_modules
Display the currently supported hardware modules.
retry=num
The number of retries if a status of USBD_STATUS_DEV_NOANSWER is given.
rx_urbs=num
The number of URBs for BulkIn. Default is 4.
tx_urbs=num
The number of URBs for BulkOut. Default is 4.
unit=num
The unit number: 1 = /dev/serusb1, 2 = /dev/serusb2, etc. Default is the first available number, starting from 1.
vid=vid
The vendor ID of the device.
wait=num
Wait num seconds for the USB stack. Default is 60 seconds.

Description:

The devc-serusb is a driver for USB-to-serial adaptors and Communications Device Class Abstract Control Model (CDC ACM) devices. The driver automatically detects ACM devices, based on the USB Class code.

If you provide the vid, did, busno and devno arguments for device-specific options, devc-serusb doesn't attach an insertion callback to detect newly inserted devices. The driver will work only with the already-inserted device that corresponds to the arguments specified on the command line. If you don't also specify the ign_remove option, the driver is terminated when the device is removed.

The unit option has meaning only when the driver is started for a specific device by using the vid, did, busno and devno arguments. If the driver is managing device insertions, the default behavior always applies.

Note:
Because devc-serusb is a USB class driver, the USB stack (io-usb-otg) must be running before you start this driver.

This driver supports a DCMD_CHR_RESET devctl() command that resets the device. Not all drivers use this command.

Page updated: