Page 1
posPacker
User Guide
Page 2
Page 3
posPacker
User Guide
72E-86035-01
Revision A
July 2006
Page 4
© 2006 by Symbol Technologies, Inc. All rights reserved.
No part of this publication may be reproduced or used in any form, or by any electrical or mechanical means, without
permission in writing from Symbol. This includes electronic or mechanical means, such as photocopying, recording, or
information storage and retrieval systems. The material in this manual is subject to change without notice.
The software is provided strictly on an “as is” basis. All software, including firmware, furnished to the user is on a
licensed basis. Symbol grants to the user a non-transferable and non-exclusive license to use each software or
firmware program delivered hereunder (licensed program). Except as noted below, such lice nse may not be assigned,
sublicensed, or otherwise transferred by the user without prior written consent of Symbol. No right to copy a licensed
program in whole or in part is granted, except as permitted under copyright law. The user shall not modify, merge, or
incorporate any form or portion of a licensed program with other program material, create a derivative work from a
licensed program, or use a licensed program in a network without written permission from Symbol. The user agrees to
maintain Symbol’s copyright notice on the li censed programs delivered hereunder, and to include the same on any
authorized copies it makes, in whole or in part. The user agrees not to decompile, disassemble, decode, or reverse
engineer any licensed program delivered to the user or any portion thereof.
Symbol reserves the right to make changes to any software or product to improve reliability, function, or design.
Symbol does not assume any product liability arising out of, or in connection with, the application or use of any product,
circuit, or application described herein.
No license is granted, either expressly or by implication, estoppel, or otherwise under any Symbol Technologies, Inc.,
intellectual property rights. An implied license only exists for equipment, circuits, and subsystems contained in Symbol
products.
Symbol, Spectrum One, and Spectrum24 are registered trademarks of Symbol Technologies, Inc. Bluetooth is a
registered trademark of Bluetooth SIG. Microsoft, Windows and ActiveSync are either registered trademarks or
trademarks of Microsoft Corporation. Other product names mentioned in this manual may be trademarks or registered
trademarks of their respective companies and ar e here b y ackno wle dg ed .
Symbol Technologies, Inc.
One Symbol Plaza
Holtsville, New York 11742-1300
http://www.symbol.com
Patents
This product is covered by one or more of the patents listed on the website: www.symbol.com/patents
Page 5
Table of Contents
About This Guide
Introduction.................................................................................................................... v
Chapter Descriptions ..................................................................................................... v
Notational Conventions.................................................................................................. v
Related Documents and Software................................................................................. vi
Chapter 1: Getting Started
Introduction ................................................................................................................... 1-1
Using posPacker ........................................................................................................... 1-1
Source Explorer ...................................................................................................... 1-2
Destination Explorer ................................................................................................ 1-3
IFB Functions .......................................................................................................... 1-3
IFB Files .................................................................................................................. 1-4
IFB Header Variables .............................................................................................. 1-5
Chapter 2: Multi-IFBs
Introduction ................................................................................................................... 2-1
PD8500 Multi-IFB Support ............................................................................................ 2-1
Creating Multi-IFBs Using posPacker ........................................................................... 2-2
Installing NK.BIN ........................................................................................................... 2-3
Installing Flash.bin ........................................................................................................ 2-3
Chapter 3: posUnpacker
Introduction ................................................................................................................... 3-1
Source Explorer Section ............................................................................................... 3-2
Destination Explorer Section ......................................................................................... 3-2
IFB File Contents Section ............................................................................................. 3-2
IFB Header Properties Section ..................................................................................... 3-2
Index
Page 6
iv posPacker User Guide
Page 7
About This Guide
Introduction
This guide provides instructions for using the posPacker software package.
Chapter Descriptions
Topics covered in this guide are as follows:
•
Chapter 1, Getting Started explains how to use the posPacker tool.
•
Chapter 2, Multi-IFBs describes Multi-IFBs and how to create them with posPacker.
•
Chapter 3, posUnpacker explains how to use the posUnpacker tool to unpack (expand) or examine the
contents of an existing IFB.
About This Guide
Notational Conventions
The following conventions are used in this document:
•
“Device” refers to the Symbol PD8500 POS device.
•
Bold text is used to highlight the following:
- Dialog box, window, and screen names
- Drop-down list and list box names
- Check box and radio button names
- Icons on a screen
- Button names on a screen.
•
Italics are used to highlight specific items in the general text, and to identify chap ters and sectio ns in this
and related documents.
•
Bullets (•) indicate:
- action items
- lists of alternatives
- lists of required steps that are not necessarily sequential
•
Sequential lists (e.g., those that describe step-by-step procedures) appear as numbered lists.
Page 8
vi posPacker User Guide
Related Documents and Software
The following documents provide more information about PD8500 devices.
•
posBuilder Software Development Toolkit, p/n 72E-63755-xx
•
posPortal CE Integrator Guide, p/n 72E-64639-xx
•
PD8500 Product Reference Guide, p/n 72E-65797-xx
For the latest version of this guide go to:http://www.symbol.com/manuals.
Page 9
Chapter 1
Chapter 1
Chapter 1
Getting Started
Introduction
The posPacker software package includes the following components:
•
posPacker - a tool that creates IFBs
•
posUnpacker - a tool that extracts IFBs
•
Microsoft Visual Basic 6.0 source code - for customizing applications
These tools support the latest IFB features such as the ability to create multi-IFBs.
Using posPacker
Getting Started
Use the posPacker tool to create standard IFBs, as well as newer Multi-IFBs. The application main window
consists of five sections which provide specific functionality:
•
Source Explorer
•
Destination Explorer
•
IFB Functions
•
IFB Files
•
IFB Header Variables
Page 10
1 - 2 posPacker User Guide
Figure 1-1
posPacker Main Window
Source Explorer
Use the Source Explorer section of the posPacker tool to add files to a new IFB.
Figure 1-2
1. In the drive browser, select a drive from which to select files.
2. In the folder browser, select a folder on the drive. The file list displays all the files in that folder.
3. Add files to the new IFB. These appear in the IFB Files section:
- Select the Add Folder button to add all the files in the selected folder to the new IFB, excluding the
- Select the Add Tree button to ad d all the files i n the sele cted folder to the new IFB, including all files in
- Select the Add File button to add only the selected file to the new IFB. Alternatively, double-click each
Source Explorer Section
files in subfolders.
subfolders.
file to add it to the new IFB.
Page 11
Getting Started 1 - 3
4. In the File Type Filter text box, enter a file filter that affects which files types appear in the Source Explorer.
By default this is set to "*.*", which includes all file types.
Destination Explorer
Use the Destination Explorer section of the posPacker tool to select the destination of the new IFB file.
Figure 1-3
1. In the drive browser, select a destina tion drive.
2. In the folder browser, select a destination folder.
3. Enter the name of the IFB file in the text box.
4. Select the Package button to save the new IFB.
Destination Explorer Section
IFB Functions
Use the IFB Functions section of the posPacker tool to specify advanced IFB command functions, which you
use primarily for creating Multi-IFBs.
Figure 1-4
1. To remove files and command functions from the new IFB:
- Select the Remove button to remove the selected IFB file or IFB command function from the IFB Files
- Select the Remove All button to remove all files and IFB command functions from the IFB Files section,
IFB Functions Section
section.
clearing all contents from the new IFB.
2. The four IFB command function buttons perform disk operating system style functions on the target system
while the new IFB is expanding on the target platform.
- Select the Del Folder button to create a Delete Folder IFB command function call in the new IFB. In the
text box to the right of this button, enter the name of the folder to delete on the target system, or
double-click a folder to enter its name. The folder can either reside in the new IFB, or it can exist on
Page 12
1 - 4 posPacker User Guide
the target system. Note that the Delete Folder IFB command function call is recursive (it deletes all
files and subfolders in the specified folder).
- Select the Make Folder button to create a Make Folder IFB command function call in the new IFB. In
the text box to the right of this button, enter the name of the folder to create on the target system, or
double-click a folder to enter its name. The folder is only created on the target system if it does not
already exist.
- The Run File button creates a Run File IFB command function call in the new IFB. In the text box to
the right of this button, enter the name of the file to run on the target system, or double-click a file to
enter its name. The file can reside in the new IFB, or it can exist on the target system. During IFB
expansion, the Run File IFB command function call do es not return until the running file completes, so
further IFB expansion halts until then. Use this command primarily for creating Multi-IFBs, where you
enter the name of the IFB file to run (expand) in the text box. Note that using the Run File IFB
command function with non-IFB files only works for SYSTEM signed IFBs (IFBs signed by Symbol).
Using this command with IFBs that are CUSTOMER, VAR, or PUBLIC signed for a non-IFB file
generates an access level error.
- The Del File button creates a Delete File IFB command function call in the new IFB. In the text box to
the right of this button, enter the name of the file to delete from the t arget system, o r double-click a file
to enter its name. The file can reside in the new IFB, or it can exist on the target system.
3. Select the Delete Previous Folder Contents check box to cause the new IFB to create empty folders on the
target system. This ensures that the new IFB inst alls on the t arget system without leaving older files on the
target system. Use this check box with caution. Once you delete a folder on the target system, you
cannot recover it.
IFB Files
The IFB Files section of the posPacker tool displays all the IFB command functions in the new IFB. The name
of the new IFB file appears at the root. Note that the commands execute on the t arg et system in the order the y
appear in the IFB Files section.
Figure 1-5
Table 1-1
Icon Description
IFB Files Section
IFB Files Section Icons
New IFB File Name
Make Folder IFB Command Function
Delete Folder IFB Command Function
Page 13
Getting Started 1 - 5
Table 1-1
IFB Files Section Icons (Continued)
Icon Description
Make File IFB Command Function
Delete File IFB Command Function
Run File IFB Command Function
IFB Header Variables
Use the IFB Header Variables section of the posPacker tool to specify the information in the header used when
creating an IFB.
Figure 1-6
1. In the IFB Root Folder drop-down list, select the target root folder for the new IFB. Changing this r eset s the
IFB Header Variables Section
contents of the new IFB. When updating a customer script, always use the \customer\script root folder. Use
\temp to create temporary files on the target system for use with Multi-IFBs. This guide does not address
other folders, which are for advanced users.
2. In the IFB Target Platform drop-down list, select the target platform for which the IFB is generated. Select
PD8500 to create IFBs for the PD8500.
3. In the Comment text box, optionally enter a description pertaining to the IFB for documentation purposes
only .
4. In the Name text box, enter a meaningful name for the IFB. This is NOT the file name of the IFB. This name
is stored in the header of the IFB.
5. In the Version text box, enter the version number for the IFB. Use the numbering scheme VersionMajor,
VersionMinor, BuildMajor, BuildMinor
. Use only comma-separated numbers. Do not enter letters or
symbols.
Page 14
1 - 6 posPacker User Guide
Page 15
Chapter 2
Multi-IFBs
Introduction
A Multi-IFB is an IFB package that contains one or more pre-packaged IFB files that execute and delete when
extracted to the target device. Executing an IFB file on the target device extracts that IFB file.
Multi-IFBs need not be digitally signed, unless they contain files (other th an IFB files) that require access to
restricted areas on the target device (such as customer script files). Each IFB is treated as a separately signed
IFB. For example, if you have a system update IFB (digitally signed by Symbol) and a customer script IFB
(digitally signed by the customer) p ackaged together in one unsig ned Multi-IFB, the system update IFB and the
script IFB expand properly even though they were con tained in an unsigned Multi- IFB. Likewise, if you create a
customer signed Multi-IFB that contains an unsigned customer script, the script cannot install on the target
device even though it was contained in a customer signed Multi-IFB.
Chapter 2
Chapter 2
Multi-IFBs
PD8500 Multi-IFB Support
PD8500 devices with system version 3.20 offer complete support for Multi-IFBs. PD8500 devices with system
version 3.16 do not support the Multi-IFB \temp root folder. PD8500 devices with system versions older than
3.16 do not support Multi-IFB.
Page 16
2 - 2 posPacker User Guide
Creating Multi-IFBs Using posPacker
Figure 2-7
Creating Multi-IFBs
To create a Multi-IFB using posPacker on a PD8500 that fully supports Multi-IFBs (system version 3.20 and
above):
1. In the IFB Header Variables section, select \temp as the IFB Root Folder.
2. In the Source Explorer section, double-click the file name for an existing IFB, or click on the file and select
the
Add File button, to add the IFB file to the new Multi-IFB.
3. In the IFB Files section, double-click the added IFB file.
4. Click Run File to enable the Multi-IFB to extract the file on the target device.
5. Click Del File to delete the IFB file from the target device.
6. In the Destination Explorer section, select a destination folder. Enter the name of the new Multi-IFB next to
the
Package button, then click the Package button to save the Multi-IFB.
To create a Multi-IFB using posPacker on a PD8500 that partially supports Multi-IFBs (system version 3.16
only):
1. In the IFB Header Variables section, select \public as the IFB Root Folder.
2. In the Source Explorer section, double-click the file name for an existing IFB, or click on the file and select
the
Add File button, to add the IFB file to the new Multi-IFB.
3. In the IFB Files section, double-click the added IFB file.
4. Click Run File to enable the Multi-IFB to extract the file on the target device.
5. Click Del File to delete the IFB file from the target device.
Page 17
6. In the Destination Explorer section, select a destination folder. Enter the name of the new Multi-IFB next to
the
Package button, then click the Package button to save the Multi-IFB.
Installing NK.BIN
Files expand on the target platform in the order they are listed in posPacker. In the special case that NK.BIN, or
an IFB containing NK.BIN, is installed, any previously loaded extension packs and patches are deleted from
the target system immediately after NK.BIN is installed. If an extension pack or patch is required, add this to
posPacker after adding NK.BIN so that the pack or patch re-installs after NK.BIN.
Installing Flash.bin
Installing Flash.bin clears everything, so you cannot install anything else. After installing Flash.bin, the target
system terminates further IFB expansion and reboots.
Multi-IFBs 2 - 3
Page 18
2 - 4 posPacker User Guide
Page 19
Chapter 3
posUnpacker
Introduction
Use the posUnpacker tool to unpack (expand) or examine the contents of an existing IFB. The main window
consists of four sections which provide specific functionality:
•
Source Explorer
•
Destination Explorer
•
IFB File Contents
•
IFB Header Properties
Chapter 3
Chapter 3
posUnpacker
Figure 3-8
posUnpacker
Page 20
3 - 2 posPacker User Guide
Source Explorer Section
Use the Source Explorer section of the posUnpacker tool to select an IFB file to unpack (expand) or examine.
1. In the drive browser, select a drive from which to select files.
2. In the folder browser, select a folder on the drive. The file list displays all the IFB files in that folder.
3. Click a file in the file list, or enter the name of an IFB file in the text box to the right of the Unpack button.
4. Select the Unpack button to unpack (expand) the selected IFB file to the location specified in the
Destination Explorer section.
Destination Explorer Section
Use the Destination Explorer section of the posUnpacker tool to select a destination folder for the unpacked
IFBs.
1. In the drive browser, select a drive from which to select files.
2. In the folder browser, select a folder on the drive. Alternatively, enter a destination drive and folder in the
text box at the bottom.
The IFB unpacks at this location.
IFB File Contents Section
Use the IFB File Contents section of the posUnpacker tool to view the contents of the selected IFB.
IFB Header Properties Section
Use the IFB Header Properties section of the posUnpacker tool to view the file header information in the
selected IFB.
Page 21
Index
A
adding files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
adding folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
adding Multi-IFB files . . . . . . . . . . . . . . . . . . . . . . . . 2-2
B
bullets . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
C
chapter descriptions . . . . . . . . . . . . . . . . . . . . . . . . . . . v
conventions
notational . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . v
creating folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
creating Multi-IFB . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
D
deleting folders . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
deleting Multi-IFB files . . . . . . . . . . . . . . . . . . . . . . . . 2-2
destination explorer . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
posUnpacker . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
F
files
adding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
adding Multi-IFB . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
deleting Multi-IFB . . . . . . . . . . . . . . . . . . . . . . . . 2-2
filtering . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
removing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
running . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
running Multi-IFB . . . . . . . . . . . . . . . . . . . . . . . . 2-2
selecting destination . . . . . . . . . . . . . . . . . . . 1-3, 3-2
unpacking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
filtering files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
Flash.bin . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
folders
adding . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
creating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
deleting . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
root . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
I
icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
IFB
adding files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
adding folders . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
creating folders . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
deleting folders . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
filtering files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
icons . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
removing files . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
root folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
running files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
selecting destination . . . . . . . . . . . . . . . . . . 1-3, 3-2
target platform . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
unpacking . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
IFB file contents
posUnpacker . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
IFB files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
IFB functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
IFB header properties
posUnpacker . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
IFB header variables . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
M
main window . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
destination explorer . . . . . . . . . . . . . . . . . . . . . . . 1-3
IFB files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
IFB functions . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
IFB header variables . . . . . . . . . . . . . . . . . . . . . . 1-5
source explorer . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
Multi-IFB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
adding files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
creating . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
deleting files . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
Page 22
Index - 2 posPacker User Guide
PD8500 support . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
root folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
running files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
N
NK.BIN . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-3
notational conventions . . . . . . . . . . . . . . . . . . . . . . . . . . v
P
PD8500
Multi-IFB support . . . . . . . . . . . . . . . . . . . . . . . . . 2-1
posPacker main window . . . . . . . . . . . . . . . . . . . . . . 1-2
posUnpacker . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-1
destination explorer . . . . . . . . . . . . . . . . . . . . . . . 3-2
IFB file contents . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
IFB header properties . . . . . . . . . . . . . . . . . . . . . 3-2
source explorer . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
R
related documents and software . . . . . . . . . . . . . . . . . .vi
removing files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-3
root folder . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Multi-IFB . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2-2
running files . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-4
running Multi-IFB files . . . . . . . . . . . . . . . . . . . . . . . . 2-2
S
source explorer . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-2
posUnpacker . . . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
T
target platform . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
U
unpacking IFB files . . . . . . . . . . . . . . . . . . . . . . . . . . 3-2
using posPacker . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-1
V
version . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1-5
Page 23
Tell Us What You Think...
We’d like to know what you think about this Manual. Please take a moment to fill out this questionnaire and fax this form
to: (631) 738-3318, or mail to:
Symbol Technologies, Inc.
One Symbol Plaza M/S B-4
Holtsville, NY 11742-1300
Attention: Technical Publications Manager
IMPORTANT: If you need product support, please call the appropriate customer support number provided. Unfortunately,
we cannot provide customer support at the fax number above.
Manual Title:___________________________________________
(please include revision level)
How familiar were you with this product before using this manual?
Very familiar Slightly familiar Not at all familiar
Did this manual meet your needs? If not, please explain.
______________________________________________________________________________________
______________________________________________________________________________________
______________________________________________________________________________________
______________________________________________________________________________________
What topics need to be added to the index, if applicable?
______________________________________________________________________________________
______________________________________________________________________________________
______________________________________________________________________________________
______________________________________________________________________________________
What topics do you feel need to be better discussed? Please be specific.
______________________________________________________________________________________
______________________________________________________________________________________
______________________________________________________________________________________
______________________________________________________________________________________
What can we do to further improve our manuals?
______________________________________________________________________________________
______________________________________________________________________________________
______________________________________________________________________________________
______________________________________________________________________________________
Thank you for your input—We value your comments.
Page 24
Page 25
Page 26
Symbol Technologies, Inc.
One Symbol Plaza
Holtsville, New York 11742-1300
http://www.symbol.com
72E-86035-01
Revision A - July 2006
Loading...