Lucent Technologies USS-720 manual O Control Codes, Control Code Description

Page 67

Preliminary User Guide, Rev. 2

USS-720

February 1999

USB Device Driver

 

 

4 I/O Control Codes

This section provides information for the I/O control codes used in the DeviceIoControl file function (see

Section 3.4). These control codes are used in the DeviceIoControl function to perform any of the following device- specific operations.

Note: Refer to the header file <USS720io.h> included on the USS-720 Evaluation Kit diskette for details regarding these control codes definitions. Please note that this file may be subject to periodic modifications. To obtain more information about these control codes, contact In-System Design.

Control Code

Description

 

 

IOCTL_1284_ ECP_FWDTOREV

Negotiates the peripheral from forward idle to reverse while in

 

ECP register mode.

 

 

IOCTL_1284_ECP_REVTOFWD

Negotiates the peripheral from reverse to forward idle while in

 

ECP register mode.

 

 

IOCTL_1284_ ECP_SET_CHANNEL

Sets the ECP channel on the peripheral for reads and writes.

 

 

IOCTL_1284_ SET_MODE

Negotiates the peripheral into one of the valid register modes.

 

 

IOCTL_1284_ TERMINATE

Performs a standard 1284 termination sequence.

 

 

IOCTL_ABORT_PIPE

Cancels any pending transfers for the specified pipe. The pipe

 

state and endpoint state are unaffected.

 

 

IOCTL_CANCEL_PIPE_REQUEST

Cancels the current request on the specified pipe by flushing

 

the pipe and canceling any outstanding requests on that pipe.

 

 

IOCTL_GET_ALTSETTING

Retrieves the current alternate interface setting from the USS-

 

720 device.

 

 

IOCTL _GET_CAPABILITIES

Returns a variable buffer length containing the device capabil-

 

ities string. This is a IEEE 1284 compatible string.

 

 

IOCTL_GET_CONFIGURATION_DESCRIPTOR

Retrieves the current configuration descriptor.

 

 

IOCTL_GET_DEVICE_DESCRIPTOR

Receives the current device descriptor.

 

 

IOCTL_GET_DEVICE_INSTANCES

Returns a list of current devices based on the symbolic links

 

created during each device enumeration.

 

 

IOCTL_GET_INTERFACE

Gets the information about the current interface and pipes.

 

 

IOCTL _GET_PORT_STATUS

Returns a status byte.

 

 

IOCTL_ISSUE_USS720_COMMAND

Issues a specific command for the USS-720 device.

 

 

IOCTL _GET_1284_REGISTER

Returns all 1284 registers.

 

 

IOCTL_READ_INTERRUPT_PIPE

Reports changes in the parallel port and buffer status when

 

they occur.

 

 

IOCTL_RESET_PIPE

Clears the halted state of the specified pipe within the USB

 

stack and resets the stalled state of the endpoint on the

 

device.

 

 

IOCTL _SET_1284_REGISTER

Sets one of the 1284 registers.

 

 

IOCTL _SET_ALTSETTING

Sets the alternate interface setting.

 

 

IOCTL _SOFT_RESET

Resets the device, flushes the Bulk Out and Bulk In pipes to

 

the default states.

 

 

Lucent Technologies Inc.

7-9

Image 67
Contents Information Manual, Rev September IntroductionTable of Contents September USB-to-IEEE Bridge Information Manual, Rev Evaluation Kit for USS-720IOCTL1284 Terminate USS-720 USB Device Driver Preliminary User GuideIOCTLSET1284REGISTER USS-720 USB Port Monitor Application Note Evaluation Kit Contents \SAMPLES Hardware RequirementsGetting Started Instructions OSR2.1 Cable Installation InstructionsWindows 98 Cable Installation Instructions Software UpdatesPlug and Play USB Driver and Port MonitorPort Creation Eeprom Lucent Technologies Inc In-System Design, Inc Lucent Technologies Microelectronics GroupUSB Applications Support September Introduction Evaluation Kit SoftwareUSS-720 Driver Software Object Code License Agreement FebruaryOwnership USS-720 Software Use Agreement FebruaryLicensed Software Furnishing of Licensed SoftwareFebruary Software Use Agreement USS-72004 Confidentiality Warranty and IndemnityAgreement Prevails Nothing ConstruedIntegration PublicityNonassignability AddressesDisputes Applicable LawUSS720.INF USS720.SYSDocumentation USS-720 Software Use Agreement February Application Note, Rev February Software ComponentsPlug and Play Operation PnP Customer-Defined DataPrinter Enumeration USB Hardware Types Supported Power ManagementInstallation Process Operating Systems SupportedPrint Types Supported Printer Types SupportedPreliminary Data Sheet, Rev September FeaturesDescription Table of Contents Pin Information Preliminary Data Sheet, Rev USS-720USB-to-IEEE Parallel Port nAck Signal Active-Low Parallel Port nAutoFd Signal Active-LowParallel Port nSelectIn Signal Active-Low Parallel Port nInit Signal Active-LowDescriptor Locations OverviewUSB Port Device Descriptor, Configurations, and Inter- facesOnboard Device Descriptor USB-to- Ieee 1284 Bridge SeptemberDevice Descriptor Offset Field Size Value Description Configuration Descriptor USB-to- IeeeBulk Out Endpoint Descriptor, I0A0E1 Interface DescriptorsBulk Out Endpoint Descriptor, I0A1E1 September USB-to-IEEE1284 BridgeBulk In Endpoint Descriptor, I0A1E2 Bulk In Endpoint Descriptor, I0A2E2 Bulk Out Endpoint Descriptor, I0A2E1Interrupt Endpoint Descriptor, I0A2E3 Requests PipesStandard Requests Get Port Status Data Bit Description Printer Class-Specific RequestsGET1284REGISTER Vendor-Specific RequestsSET1284REGISTER Register-Based Operation Ieee 1284 PortByte Register Data RegistersGET1284REGISTER Data Byte Register Data Interrupt Pipe Read DataDefault Bit Symbol Bit Description Status Register Address Bit SymbolParallel Port nFault Signal Reserved USB-to-IEEE1284 Bridge Control Register Address Bit SymbolAccess Default Bit Symbol Bit Description Parallel Port nInit SignalUSS-720Instant USB ECP Command Register Address Bit Symbol Access Mode20 Description Extended Control Register Address Bit SymbolUSS-720 Control Register Address Bit Symbol USS-720 Setup Register Address Bit Symbol Interrupts External Crystal Connection External Circuitry RequirementsAbsolute Maximum Ratings Parameter Symbol Min Unit Filter Bypass ModeHigh Drive Mode Self-Powered ModeClklo Clkhi Electrical CharacteristicsParameter Symbol Test Conditions Min Typ Max Unit Capacitance Values Parameter UnitSetup and Hold Input Timing Parameter Timing CharacteristicsOutput Delay Timing Parameter Min Max Unit Device Code Package Comcode Outline DiagramOrdering Information Pin MqfpApplication Note February Description USS ParallelPort Bridging USB to Typical Circuit ShowingLucent Technologies Inc Preliminary User Guide, Rev February Signal DirectionsIOCTL1284 Setmode USB Device Driver InitializationO File Functions Preliminary User Guide, Rev USS-720 FebruaryCreateFile ReadFile Error CodesWriteFile DeviceIoControl CloseHandle Control Code Description O Control CodesParameters IOCTL1284 EcpfwdtorevIOCTL1284ECPREVTOFWD IOCTL1284 Ecpsetchannel IOCTL1284 Setmode Register Mode DescriptionIOCTL1284 Terminate Bulkinpipe IoctlabortpipeValue Description BulkoutpipeIoctlcancelpiperequest IOCTLGET1284REGISTER ALTINTERFACE2 IoctlgetaltsettingALTINTERFACE0 ALTINTERFACE1Ioctlgetcapabilities Ioctlgetconfigurationdescriptor Ioctlgetdevicedescriptor Ioctlgetdeviceinstances Ioctlgetinterface Bit Meaning IoctlgetportstatusCommand Description IOCTLISSUEUSS720COMMANDByte Description IoctlreadinterruptpipeIoctlresetpipe IOCTLSET1284REGISTER Ioctlsetaltsetting Ioctlsoftreset Data Structure O Control Data StructuresDeviceinstanceheader DeviceinstanceREGISTER1284, *PREGISTER1284 REGISTER1284ADVREGISTER1284, *PADVREGISTER1284 ADVREGISTER1284Lucent Technologies Inc USS-720 USB Port Monitor Printer Cable with Instant USB USS-720 Application Note USB Port Monitor FebruaryClick on Enter Library Software Installation InstructionsW98USS720EvalKit2402.zip to download the installation files Application Note JuneSeptember MN99-052CMPR-1 Replaces MN97-061CMPR-04