Vous êtes sur la page 1sur 17

Using the Printer Driver Delivery Package

72-70973-01
Rev. A – December 2004

Page 1 of 17
Description ...................................................................................................................................... 3

Printer Driver CAB File .............................................................................................................. 4

Deployment Registry File ........................................................................................................... 6

Terminal Default Settings Registry File ..................................................................................... 6

Preparing A Terminal Default Registry File ............................................................................... 6

User Default Settings Registry File............................................................................................. 6

Preparing A User Default Registry File ...................................................................................... 7

Modifying the User Default Registry File .................................................................................. 8

Printer Driver CAB File Installation ............................................................................................... 9

Installing a New Printer Cab File on a Mobile Computer with Built-In Printer Support ........... 9

Installing the Printer Driver Temporarily ................................................................................. 12

Installing The New Printer Driver Cab On a Mobile Computer Without Printer Support........ 13

Printer Driver Removal ................................................................................................................. 15

Printer Driver Upgrades ............................................................................................................ 16

Checking for Proper Installation of the Cab File ...................................................................... 17

Page 2 of 17
Description
The Symbol Printer Driver Delivery Package is available in a zip file for installation from
a host computer or as a CAB file for installation on a mobile computer from AirBEAM or
MSP. Both files are similar except that the CAB file does not contain documentation. The
Symbol Printer Driver Delivery Package contains the following:

1. Printer Driver CAB file


2. Deployment Registry file
3. Terminal Default Settings Registry file
4. User Default Settings Registry file
5. Printer Driver Copy file, printerdriver.cpy
6. Load Command file, Wceldcmd.exe file
7. User Documentation (zip file only)
8. Demos.

CAB Demos
Default Registry files
Setup.DLL Win32PrintSamp.exe
PrintAPI32.dll BasicPrint.exe
PrintMDD.dll Coffee.bmp
PrintPDDxxxx.DLL (7)
PrintTLDxxx.DLL(4)

MC3000 Config Documentation


MC50 Config Using Symbol Printer API
Using the Symbol printer Driver Cab file
Config
User settings registry file
Terminal settings registry file
Deployment Registry file
Printer Driver Copy file, printerdriver.cpy
Load Command file, Wceldcmd.exe file

Page 3 of 17
Printer Driver CAB File
The Printer Driver CAB file contains the following:

• Registry files:
• Default Registry file
• Cameo_series.reg
• Comtec_RP3.reg
• Encore_Series.reg
• Oneil_MF2T.reg
• Oneil_MF2TBluetooth.reg
• Oneil_MF4T.reg
• QL320.reg
• QL320BT.reg
• Zebra_series.reg
• PrintPad.reg
• PrinterDriver.reg
• DLL files:
• Setup.DLL
• PrintAPI32.dll
• PrintMDD.dll
• PrintPDDComtec.dll
• PrintPDDLinePrintMode.dll
• PrintPDDMonarch9450.dll
• PrintPDDMonarch9490.dll
• PrintPDDOneil.dll
• PrintPDDPGP1000.dll
• PrintPDDZebra.dll
• PrintTLDBluetooth.dll
• PrintTLDSerial.dll
• PrintTLDSock.dll

Page 4 of 17
The Printer Driver Delivery Package zip file is installed on a host computer and then files
are copied to the mobile computer using ActiveSync.

The Printer Driver Delivery Package CAB file is copied onto a mobile computer using
ActiveSync, AirBEAM or MSP and then it installs onto a mobile computer.

The printer driver is installed on a mobile computer as illustrated below:

MC3000 Deployment Package MC3000 Web Package

MC50 Deployment Package MC50 Web Package

CAB Package ZIP Package

CAB Demos CAB Demos

Config Config Documentation

Folder Structure on Device Folder Structure on PC

\Application \Application
MCxxUser.reg MCxxUser.reg
PrinterDriver.cpy PrinterDriver.cpy
PrinterInstall.reg PrinterInstall.reg
Prt_PPC2003_2004_11_18.cab Prt_PPC2003_2004_11_18.cab
Wceldcmd.exe Wceldcmd.exe

\Application\Demos \Application\Demos
Coffee.bmp Coffee.bmp
Win32PrintSamp.exe Win32PrintSamp.exe
BasicPrint.exe BasicPrint.exe
PrintMgr.exe PrintMgr.exe

\Platform \Platform
MCxxPrinterTerm.reg MCxxPrinterTerm.reg

Using Symbol Printer Driver API.doc


Using Symbol Printer CAB File.doc

Page 5 of 17
Deployment Registry File
The Deployment Registry file (printerinstall.reg) provides the registry settings necessary
to install the Printer Driver CAB file upon a cold boot. A pre-reserved Startup registry
key is used to install the Printer Driver CAB file upon cold boot.

Terminal Default Settings Registry File


The Terminal Default Settings Registry file contains the registry settings that define the
printing defaults for the mobile computer (if the user settings are not defined). The
filename is in the format <name>PrinterTerm.reg, where <name> is the product name.

After installation, the Terminal Default Settings Registry settings are located in:
[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SymPrint1\TermDefaults]

Preparing A Terminal Default Registry File


Only printers supported by a specific mobile computer are included in the
mobile computer’s Terminal Default Registry file. The registry file does not
need to have comments. All the different keys for Serial, Bluetooth,
Spectrum24 and IrDA are available and enabled with logical values for this
mobile computer. For example, if a mobile computer is serial only, the
PrintTLDSerial.ddl file is selected.

Terminal Default Registry example:


[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SymPrint1]
"DeviceName"="Oneil_Series"

[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SymPrint\Oneil_Series]
"PddDll"="PrintPDDOneil.dll"
"DlgDLL"=""
"TldDLL"="PrintTLDSerial.dll"
"PrintPort"="COM1: 9600"
"DeviceAddress"="157.235.188.250"
"NumReConnect"=dword:00000005
"DevicePort"=dword:000017d5
"PrintMode"=dword:00000001
"BTCommTimeout"=dword:35
"ShowBTDialog"=dword:001
…….. Font entries

User Default Settings Registry File


The User Default Settings Registry file contains the registry settings that defined the user
printer settings. The user can edit this file if they do not want to use the defaults in the
Use Default Settings Registry file. The filename is in the format
<name>PrinterUser.reg, where <name> is the product name.

Page 6 of 17
After installation, the User Default Settings Registry settings are located in:
[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SymPrint1\UserDefaults]

Preparing A User Default Registry File


The difference between the Terminal Default Registry file and the User
Default Registry file is the included comments in the User Default Registry
file. The comments help the user modify the different entries. The User
Default Registry file overrides the Terminal Default Registry file settings.
User Default Registry example:
[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SymPrint1]
; Select the "default" printer to use
; if PRINT_CreateDC is called without a printer name
"DeviceName"="Oneil_Series"
[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SymPrint\Oneil_Series]
"PddDll"="PrintPDDOneil.dll"
"DlgDLL"=""

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;;; Printer Connectivity Selection ;;;;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;;; Uncomment exactly one of the following sections ;;;;;
;;;;; and/or edit the values as appropriate ;;;;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;; For Serial Connections
;;
"TldDLL"="PrintTLDSerial.dll"
"PrintPort"="COM1: 19200"
; "PrintPort"="COM1: 9600"
;; For S24 Socket Connections
;;
; "TldDLL"="PrintTLDSock.dll"
; "DeviceAddress"="157.235.188.250"
; "NumReConnect"=dword:00000005
; "DevicePort"=dword:000017d5
;; Set print mode to 1 for serial 0 for IRDA
; "PrintMode"=dword:00000001
; "PrintMode"=dword:00000000
;; For Bluetooth Connections
;;
; "TldDLL"="PrintTLDBluetooth.dll"
; "PrintPort"="COM8: 19200"
; "PrintPort"="COM8: 9600"
; "BTCommTimeout"=dword:35
; 0 == Don't show Bluetooth printer select dialog, 1 == show
Bluetooth printer select dialog
; "ShowBTDialog"=dword:001

Page 7 of 17
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
…….. Font Entries

Modifying the User Default Registry File


The user can modify the User Default Registry file to set specific settings for a printer.
To modify the default file:

1. On a host computer, open the User Default Registry file using a text editor (i.e.,
Notepad).
2. Modify the registry file and than save the file.
3. ActiveSync the mobile computer with a host computer.
4. Open Explorer to view the directories of the mobile computer.
5. Copy updates User Default Registry file to the Application directory on the
mobile computer.
6. Cold boot the mobile computer.
7. Verify that the settings have taken effect.

Page 8 of 17
Printer Driver Delivery Package Zip File Installation
The Printer Driver Delivery Package zip file can be installed on:

• Mobile computer with built-in printer support


• Mobile computer without printer support.

Installing a New Printer Delivery Package on a Mobile Computer with


Built-In Printer Support
1. Remove the following files from the mobile computer’s Platform directory (if
applicable):
Note: If the following files are not removed from the Platform directory, error messages
might appear indicating that the file already exists.

• PrintAPI32.dll
• PrintMDD.dll
• PrintPDDComtec.dll
• PrintPDDLinePrintMode.dll
• PrintPDDMonarch9450.dll
• PrintPDDMonarch9490.dll
• PrintPDDOneil.dll
• PrintPDDPGP1000.dll
• PrintPDDZebra.dll
• PrintTLDBluetooth.dll
• PrintTLDSerial.dll
• PrintTLDSock.dll
• Cameo_series.reg
• Comtec_RP3.reg
• Encore_Series.reg
• Oneil_MF2T.reg
• Oneil_MF2TBluetooth.reg
• Oneil_MF4T.reg
• QL320.reg
• QL320BT.reg

Page 9 of 17
• Zebra_series.reg
• PrintPad.reg
• PrinterDriver.reg
2. Expand the Printer Driver Delivery Package zip file into a temporary directory on
a host computer.
3. ActiveSync the mobile computer with a host computer.
4. Open Explorer to view the directories of the mobile computer.
5. Copy all files from the Application directory to the Application directory on the
mobile computer.
6. Copy all file from Platform directory to the Platform directory on the mobile
computer.
7. Cold boot the mobile computer.
Upon cold boot, the Printer Driver CAB file in the Application directory is copied to the
Windows directory via the copy file. Once copied, the Printer Driver CAB file expands
and runs the setup.dll file in RAM, self-consuming the copy in the Windows directory
upon completion.

Note: Subsequent warm boots will not find the Printer Driver CAB file in the Windows
directory and will not run it. Upon a cold boot the Printer driver CAB file is copied from
Application directory to the Windows directory and re-run.

The setup.dll file checks the registry for the presence of the TermDefaults registry
key under the Symprint1 registry key. The settings in the TermDefaults registry
key are copied and written to the Symprint registry key. If the TermDefaults
registry key is present only the specified Physical Device Driver (PDD) and Transport
Layer Document (TLD) files are installed.

The setup.dll file then checks the registry for the presence of the UserDefaults
registry key under the Symprint1 registry key. The settings in the UserDefaults
registry key are copied and written to the Symprint registry key. The UserDefaults
settings are used only to modify already specified settings in the TermDefaults
registry key. If the TermDefaults registry key does not exist, the UserDefaults
registry key settings determine which PDD or TLD files to install.

Example:
[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SymPrint1]
[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SymPrint\QL320]
[HKEY_LOCAL_MACHINE\Drivers\BuiltIn\SymPrint\Oneil_MF4T]
This above example indicates that the QL320 and MF4T printers are supported by the
mobile computer.

If TermDefault and UserDefault registry keys are not present, the setup.dll file
copies the common registry settings contained in the Printer Driver CAB file to the

Page 10 of 17
Symprint registry key. The common settings registry file indicates that all PDD and
TLD files are installed.

If the TermDefaults registry key contains Cameo Series, MF2T and QL320 settings
and the UserDefault registry key contains Comtec_RP3, MF4T and MF2T settings,
only the MF2T printer settings in the UserDefault registry file can modify the
TermDefaults settings. All others are ignored.

After installation is complete, the sample printer application (win32print) is located in the
Programs File directory on the mobile computer.

Page 11 of 17
Installing the Printer Driver Delivery Package Temporarily
To load the printer driver temporarily on the mobile computer:

Note: Upon a cold boot, the printer driver files are not retained in memory.

1. Expand the Printer Driver Delivery Package zip file into a temporary directory on
a host computer.
2. ActiveSync the mobile computer with a host computer.
3. Open the Explorer to view the directories of the mobile computer.
4. Copy the Printer Driver CAB file (example, PRT_PPC2003_2004_20_21.cab) in
the Temp directory on the mobile computer.
5. In File Explorer on the mobile computer, locate and double-tap the Printer Driver
CAB file. The file expands into the specific directories.
6. Warm boot the mobile computer.
Ensure that the connectivity is setup correctly in the registry.

The Printer Driver CAB file has selective install, based on options in User Default
Registry file and the Terminal Default Registry file. The steps for installation and testing
are:

1. Unzip the Printer Driver Delivery Package zip file.


2. Copy the files on mobile computer as shown in \application and \platform folder
on extracting zip.
3. Cold boot the mobile computer.
4. You can check whether User or Terminal settings have taken effect, by looking
into \Windows folder - what PDDs are installed.
5. If you remove Terminal Default Registry File and the User Default Registry File,
and cold boot, all printer drivers ( PDDs and TLDs) install.

Page 12 of 17
Installing the Printer Driver Delivery Package On a Mobile Computer
Without Printer Support
To install the Printer Driver file on a mobile computer that does not have printer support:

1. Expand the Printer Driver Delivery Package zip file into a temporary directory on
a host computer.
2. ActiveSync the mobile computer and the host computer.
3. Open Explorer to view the directories of the mobile computer.
4. Copy the files from the zip file to their respective directories on the mobile
computer.
5. Cold boot the mobile computer.
6. Verify that the User Default and/or Terminal Default settings have taken effect.
7. Make changes in Terminal and User .reg files (on the host computer desktop, in
notepad) and copy it back on the mobile computer.
8. Cold boot the mobile computer.
Note: If the Terminal and User .reg files are removed, and cold boot is performed, all
printer drivers (PDD and TLD files) are installed.

If installing the printer driver on a non-Symbol mobile computer:

• Reg merg utility does not exist


• Copy file utility does not exist
• Manual installation is required
• Upon cold boot, printer driver installation is lost.
• Default printer selections can be changed by application modified registry key
in “symprint” registry key.
If installing the printer driver on a Symbol mobile computer with Reg-merge and copy
files but does no have built-in printer support:

• Copy the printTerm.reg file into the Platform directory


• Copy the cab, cpy, userreg, startup.reg, wceldcmd files into the Application
directory.
If installing the printer driver on a Symbol mobile computer with Regmerge and copy file
and cab printer support:

• Copy the cab, cpy, startup.reg, wceldcmd files into the Application directory.
If installing the printer driver on a Symbol mobile computer with Regmerge and copy file
with built-in printer support with printer setting not in NK:

Page 13 of 17
• Delete all printer reg files
• Delete all PPD, TLD and MDD files
• Copy the printTerm.reg file into the Platform directory
• Copy the cab, cpy, userreg, startup.reg, wceldcmd files into the Application
directory.
• Warm boot the mobile computer.

Page 14 of 17
Printer Driver Removal
To remove the printer driver from the mobile computer:

1. ActiveSync the mobile computer and the host computer.


2. Open Explorer to view the directories of the mobile computer.
3. Remove Printer Driver CAB file from Application directory.
4. Remove the <name>PrintUser.reg file from the Application directory.
5. Remove the <name>Print.cpy file from the Application directory.
6. Remove the PrintInstall.reg file from the Application directory.
7. Remove the <name>PrintTerm.reg file from the Platform directory.
8. Cold boot the mobile computer.
All the printer MMD, API, TLD and PPD files are removed from the Windows directory.
The TermDefault and UserDefault registry keys are removed.

Page 15 of 17
Printer Driver Upgrades
To install printer driver upgrades:

1. ActiveSync the mobile computer and the host computer.


2. Backup any information.
3. ActiveSync the mobile computer and the host computer.
4. Open Explorer to view the directories of the mobile computer.
5. Remove the printer driver cab file from the Application directory.
6. Copy the new printer driver cab file into the Application directory.
7. If applicable, copy the User Default Registry file into the Application directory.
8. If applicable, copy the Terminal Default Registry file into the Platform directory.
9. Cold boot the mobile computer.

Page 16 of 17
Checking for Proper Installation of the Cab File
Using Microsoft remote registry editor, a terminal base registry editor or a viewer, ensure
that the following registry keys exist:

HKEY_LOCAL_MACHINE\DRIVERS\BUILTIN\SYMPRINT
Under this registry key you will find supported printers and their setting as
defined by the terminal default and override by the user defaults

HKEY_LOCAL_MACHINE\DRIVERS\BUILTIN\SYMPRINT1\

Under this registry key are two sub-keys:

o TermDefaults registry key

This registry key contains the settings from the Terminal Default Registry
file and defines the supported printers.

o UserDefaults registry key

This registry key contains the settings from the User Default Registry file.

Page 17 of 17