Lucent Technologies USS-720 manual Software Components, Application Note, Rev February

Page 23

Application Note, Rev. 1

February 1999

Incorporating Customer Data into USS-720 Evaluation Kit Software Using the Build Me One Utility

Introduction

Using the Build Me One utility found on In-System Design’s web site, the USS-720 Evaluation Kit soft- ware can be modified to include data specific to a customer’s USB peripheral. This document describes the components, customization data, and other general topics related to the free software provided by Lucent Technologies and In-System Design in support of the USS-720 Instant USB™ device. See the instructions under Customer-Defined Data below for information on obtaining the free software.

Software Components

The files obtained by using the Build Me One utility are the software necessary for standard PnP installa- tion and operation of the USS-720-based USB Smart Cable. This software consists of:

1.

Class Installer,

xxxxxxCI.DLL;

2.

WDM device driver,

xxxxxxSB.SYS;

3.

Port monitor installer,

xxxxxxIN.DLL;

4.

Port monitor,

xxxxxxMN.DLL;

5.

Install file,

xxxxxxSB.INF;

The six-character “xxxxxx” strings are defined by the customer. (Refer to ‘Driver Name’ information in the Customer-Defined Data section below.)

Example: If “XYZPRT” is the ‘Driver Name’ defined by the customer, then the Class Installer software file would be named XYZPRTCI.DLL.

Installer checks that all required components are installed for OSR2.1 systems (Windows 95 with the USB supplement and QFE).

If the Class Installer finds the operating system is correct, the device driver and port monitor are installed. If the Class Installer finds the operating system either does not correspond to the software or the operating system does not have all required components, an error message is displayed.

WDM Device Driver

The device driver for the USB Smart Cable follows the Windows Driver Model specification. Note there are different binaries for Windows 95 and Windows 98 as different libraries are linked. Note that the supplied software will work only with printer drivers that use the Windows spooling system to interface with the USS-720 USB port monitor.

Port Monitor

The port monitor, developed by In-System Design, is responsible for the communication between the Windows spooler and a printer. This port monitor enables printing from Windows applications using the USB Smart Cable. The port monitor controls the I/O port to which the physical printer is connected and is responsible for the communication channel between the spooler and the printer.

Class Installer

The Class Installer checks that the operating system version is compatible with the USB Smart Cable soft- ware being loaded. This is necessary as there are two different binary versions of this software, one for Microsoft Windows* 95/OSR2.1 and one for Microsoft Windows 98. Furthermore, the Class

Install File

The install file is modified to match the information provided by the customer. The information in the external EEPROM is used during the Plug and Play process to load the correct device driver.

*Microsoft and Windows are registered trademarks of Microsoft Corporation.

Lucent Technologies Inc.

4-1

Image 23
Contents Information Manual, Rev September IntroductionTable of Contents September USB-to-IEEE Bridge Information Manual, Rev Evaluation Kit for USS-720IOCTLSET1284REGISTER USS-720 USB Device Driver Preliminary User GuideIOCTL1284 Terminate 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 UpdatesPort Creation USB Driver and Port MonitorPlug and Play 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 LawDocumentation USS720.SYSUSS720.INF USS-720 Software Use Agreement February Application Note, Rev February Software ComponentsPrinter Enumeration Customer-Defined DataPlug and Play Operation PnP USB Hardware Types Supported Power ManagementInstallation Process Operating Systems SupportedPrint Types Supported Printer Types SupportedDescription FeaturesPreliminary Data Sheet, Rev September Table of Contents USB-to-IEEE Preliminary Data Sheet, Rev USS-720Pin Information 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- facesDevice Descriptor Offset Field Size Value Description USB-to- Ieee 1284 Bridge SeptemberOnboard Device Descriptor Configuration Descriptor USB-to- IeeeBulk Out Endpoint Descriptor, I0A0E1 Interface DescriptorsBulk In Endpoint Descriptor, I0A1E2 September USB-to-IEEE1284 BridgeBulk Out Endpoint Descriptor, I0A1E1 Interrupt Endpoint Descriptor, I0A2E3 Bulk Out Endpoint Descriptor, I0A2E1Bulk In Endpoint Descriptor, I0A2E2 Standard Requests PipesRequests Get Port Status Data Bit Description Printer Class-Specific RequestsSET1284REGISTER Vendor-Specific RequestsGET1284REGISTER Register-Based Operation Ieee 1284 PortByte Register Data RegistersGET1284REGISTER Data Byte Register Data Interrupt Pipe Read DataParallel Port nFault Signal Reserved Status Register Address Bit SymbolDefault Bit Symbol Bit Description 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 UnitOutput Delay Timing Parameter Min Max Unit Timing CharacteristicsSetup and Hold Input Timing Parameter 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