Caution: This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

devc-serusb

Driver for USB-to-serial adaptors


Note: You must be root to start this driver.

Syntax:

devc-serusb [options]

Runs on:

Neutrino

Targets:

ARMLE, PPCBE, SHLE, x86

Options:

-b number
The initial baud rate (default 57600).
-C size
The size of the canonical buffer in bytes (default 256).
-d args[,args ...]
Device-specific options. See below.
-E
Set options to "raw" (default).
-e
Start in edited mode (default raw). Software flow control is enabled by default.
-F
Disable hardware flow control (default to hardware flow control enabled). Hardware flow control is not supported in edited mode.
-f
Enable hardware flow control (default). Hardware flow control is not supported in edited mode.
-I number
The size of the raw input buffer in bytes (default 2048).
-O number
("Oh") The size of the interrupt output buffer in bytes (default 2048).
-S|s
Disable / enable software flow control. The default depends on the mode: in raw mode (-E, the default), it's disabled; in edited mode (-e), it's enabled.

The order in which you specify the -E or -e, and -S or -s options matters:

Options Mode Software flow control
-e Edited Enabled
-S -e Edited Enabled
-e -S Edited Disabled
-E Raw Disabled
-s -E Raw Disabled
-E -s Raw Enabled

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

busno=bus
The bus number of the USB controller.
devno=dev
The USB address of the device.
did=did
The device ID of the device.
ign_remove
Specify to prevent the removal callback from being attached.
module=name
Set the hardware module to use for an unknown vendor ID or device ID.
path=name
Connect to the specified USB stack. Default is /dev/io-usb/io-usb.
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.
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.

If you provide the vid, did, busno and devno arguments for device-specific options, devc-serusb does not 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 do not 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) must be running before you start this driver.

See also:

devc-serpci, io-usb