Initialization, O File Functions | Lucent Technologies USS-720

Preliminary User Guide, Rev. 2	USS-720
February 1999	USB Device Driver

2 Initialization

■The driver entry routine is called and initializes callbacks for the following functions when the operating system loads the driver:

— Create:	Open a handle to a device instance.
— Read:	Read a block of data from the Bulk In pipe.
— Write:	Write a block of data to the Bulk Out pipe.
— DeviceIoControl:	Process I/O requests documented in Section 4 of this document.
— Close:	Close the handle of the device instance.

■A symbolic link will be created associating this device driver with a special device instance that can be used to call IOCTL_GET_DEVICE_INSTANCES (i.e., LPTUSB). (See Section 4.13 of this document.)

■The Add_Device routine is called by the conﬁguration manager. The conﬁguration manager interacts with the USB bus enumerator to identify newly attached devices in the system. Through the layered driver architecture with the host controller driver, this USS-720 routine will be called when a USS-720 device is identiﬁed. After the device object has been successfully created, symbolic links will be created associating this device driver with the speciﬁc device instances (i.e., LPTUSB1, LPTUSB2, LPTUSBx).

3 I/O File Functions

This section provides instructions on how to use the I/O ﬁle functions to interface with the USS-720. Only parame- ters relative to the USS-720 Device Driver are explained in this document. Please refer to the Win32 SDK docu- mentation for the complete deﬁnitions of the following functions and all referenced data types:

Function	Description

CreateFile	Open an instance of a particular device.

ReadFile	Reads data from the Bulk In pipe.

WriteFile	Write data to the Bulk Out pipe.

DeviceIoControl	Send a control code to a device instance.

CloseHandle	Close an instance of a device.

Lucent Technologies Inc.

7-3

Image 61

Lucent Technologies Initialization, O File Functions, Preliminary User Guide, Rev USS-720 February, USB Device Driver

Contents

Information Manual, Rev September Introduction Table of Contents September USB-to-IEEE Bridge Information Manual, Rev Evaluation Kit for USS-720 IOCTL1284 Terminate USS-720 USB Device Driver Preliminary User GuideIOCTLSET1284REGISTER USS-720 USB Port Monitor Application Note Evaluation Kit Contents \SAMPLES Hardware Requirements Getting Started Instructions OSR2.1 Cable Installation Instructions Windows 98 Cable Installation Instructions Software Updates Plug and Play USB Driver and Port MonitorPort Creation Eeprom Lucent Technologies Inc In-System Design, Inc Lucent Technologies Microelectronics Group USB Applications Support September USS-720 Driver Software Object Code License Agreement Evaluation Kit SoftwareFebruary Introduction Licensed Software USS-720 Software Use Agreement FebruaryFurnishing of Licensed Software Ownership February Software Use Agreement USS-720 Agreement Prevails Warranty and IndemnityNothing Construed 04 Conﬁdentiality Nonassignability PublicityAddresses Integration Disputes Applicable Law USS720.INF USS720.SYSDocumentation USS-720 Software Use Agreement February Application Note, Rev February Software Components Plug and Play Operation PnP Customer-Deﬁned DataPrinter Enumeration Installation Process Power ManagementOperating Systems Supported USB Hardware Types Supported Print Types Supported Printer Types Supported Preliminary Data Sheet, Rev September FeaturesDescription Table of Contents Pin Information Preliminary Data Sheet, Rev USS-720USB-to-IEEE Parallel Port nSelectIn Signal Active-Low Parallel Port nAutoFd Signal Active-LowParallel Port nInit Signal Active-Low Parallel Port nAck Signal Active-Low USB Port OverviewDevice Descriptor, Conﬁgurations, and Inter- faces Descriptor Locations Onboard Device Descriptor USB-to- Ieee 1284 Bridge SeptemberDevice Descriptor Offset Field Size Value Description Conﬁguration Descriptor USB-to- Ieee Bulk Out Endpoint Descriptor, I0A0E1 Interface Descriptors Bulk 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-Speciﬁc Requests GET1284REGISTER Vendor-Speciﬁc RequestsSET1284REGISTER Register-Based Operation Ieee 1284 Port GET1284REGISTER Data Byte Register Data RegistersInterrupt Pipe Read Data Byte Register Data Default Bit Symbol Bit Description Status Register Address Bit SymbolParallel Port nFault Signal Reserved Access Default Bit Symbol Bit Description Control Register Address Bit SymbolParallel Port nInit Signal USB-to-IEEE1284 Bridge USS-720Instant USB ECP Command Register Address Bit Symbol Access Mode20 Description Extended Control Register Address Bit Symbol USS-720 Control Register Address Bit Symbol USS-720 Setup Register Address Bit Symbol Interrupts External Crystal Connection External Circuitry Requirements High Drive Mode Filter Bypass ModeSelf-Powered Mode Absolute Maximum Ratings Parameter Symbol Min Unit Parameter Symbol Test Conditions Min Typ Max Unit Electrical CharacteristicsCapacitance Values Parameter Unit Clklo Clkhi Setup and Hold Input Timing Parameter Timing CharacteristicsOutput Delay Timing Parameter Min Max Unit Ordering Information Outline DiagramPin Mqfp Device Code Package Comcode Application Note February Description Port ParallelBridging USB to Typical Circuit Showing USS Lucent Technologies Inc Preliminary User Guide, Rev February Signal Directions IOCTL1284 Setmode O File Functions InitializationPreliminary User Guide, Rev USS-720 February USB Device Driver CreateFile ReadFile Error Codes WriteFile DeviceIoControl CloseHandle Control Code Description O Control Codes Parameters IOCTL1284 Ecpfwdtorev IOCTL1284ECPREVTOFWD IOCTL1284 Ecpsetchannel IOCTL1284 Setmode Register Mode Description IOCTL1284 Terminate Value Description IoctlabortpipeBulkoutpipe Bulkinpipe Ioctlcancelpiperequest IOCTLGET1284REGISTER ALTINTERFACE0 IoctlgetaltsettingALTINTERFACE1 ALTINTERFACE2 Ioctlgetcapabilities Ioctlgetconfigurationdescriptor Ioctlgetdevicedescriptor Ioctlgetdeviceinstances Ioctlgetinterface Bit Meaning Ioctlgetportstatus Command Description IOCTLISSUEUSS720COMMAND Byte Description Ioctlreadinterruptpipe Ioctlresetpipe IOCTLSET1284REGISTER Ioctlsetaltsetting Ioctlsoftreset Deviceinstanceheader O Control Data StructuresDeviceinstance Data Structure REGISTER1284, *PREGISTER1284 REGISTER1284 ADVREGISTER1284, *PADVREGISTER1284 ADVREGISTER1284 Lucent Technologies Inc USS-720 USB Port Monitor Printer Cable with Instant USB USS-720 Application Note USB Port Monitor February W98USS720EvalKit2402.zip to download the installation ﬁles Software Installation InstructionsApplication Note June Click on Enter Library September MN99-052CMPR-1 Replaces MN97-061CMPR-04