Page 2
However, PSC reserves the right to change any specification at any time without prior notice. PSC is a registered trademark of PSC Inc. The PSC logo is a trademark of PSC. All other trademarks and trade names referred to herein are property of their respective owners.
Page 5
View Menu ... 38 Show Calling Function ... 38 Show Frame/Subroutine Nodes... 38 Toolbar ... 39 PPG ... 39 Program Nodes ... 39 PPG Explorer... 40 Status Bar ... 40 Create Menu ... 40 Function Nodes ... 42 Frame (Ctrl+Alt+F) ... 42 Subroutine (Ctrl+Alt+S)...
Page 6
Specifying a Register Field ... 80 Register Example: Parsing Data ... 81 Files ... 81 Using a File as a Source... 82 Data Location... 82 Using a File as a Destination... 83 Write Type... 84 Templates... 84 PT Program Generator (PPG) v5.0...
Page 7
Template Uses ... 84 Creating a Template ... 85 Modifying an existing template ... 86 Template Example: Modifying Inventory ... 86 Fields ... 87 Using Fields in Templates ... 88 PT40 Communication... 89 Overview ... 89 Downloading the Application to the PDT ... 89 What Happens During a Download?...
Page 8
Verifying that a Number is an Integer ... 139 Verifying Input Size ... 142 Downloading a File to a PSC Portable ... 145 Finding the Number of Records in a File ... 147 Searching for a Partial Match ... 148 Searching for Data in a File ...
Page 9
Agreement. If you use the Software, you will be deemed to have accepted the terms and conditions of this Agreement. If you do not intend to be bound by the terms of this Agreement, PSC is not willing to license the Software to you, you may not use or copy the Software, and you must contact the party from whom you acquired the Software promptly for instructions.
All notices of a claim should be sent to PSC Inc., Legal Department, 111 SW Fifth Ave. Suite 4100, Portland, OR 97204-3644. 5.2 In the defense or settlement of any such claim, PSC may, at its option, 1) procure for End User the right to continue using the Software, 2)
10.2 Notice. All notices required or authorized under this Agreement shall be given in writing, and shall be effective when received, with evidence of receipt. Notices shall be sent to End User at such address as End User shall provide to PSC in writing, and shall be sent to PSC Attn: Contract Administration, PSC Inc., 959 Terry Street, Eugene, OR 97402.
Page 12
(PPG) Software End User License Agreement NOTES PT Program Generator (PPG) v5.0...
Document Overview This document is divided into seven chapters and eight appendices: • Introduction on page 1 ventions used in this manual, and tells how to access PSC Technical Support. • Getting Started on page 5 gives you an overview of PPG concepts and usage.
, contains bar codes that can be used to , provides troubleshooting information and , is a glossary of the specific PPG programming are in . When keyboard keys are Linked ENTER Bold , or SHIFT+ENTER Ctrl+C PT Program Generator (PPG) v5.0 ), hold down the first...
Windows Controls Words in Bold names, subroutine names, node names, file, field, template, and register names, menu options, buttons, dialog boxes, field names, and radio-buttons. Words in Bold order provided. For example, select Cautions indicate an action where there is a possibility of damage to data integrity or data failure.
Page 16
Introduction NOTES PT Program Generator (PPG) v5.0...
Overview Refer to this section as you prepare to install and use the PT Program Genera- tor (PPG). The following general topics are covered: • Before You Start on page 6 • • • • PPG Installation on page 6 •...
Registering Your Copy of PPG PSC values your feedback. Please take a few moments and complete the Prod- uct Registration form located on PSC's website or on the PSC Manuals CD.
Windows Supported Portables PPG v 5.0 only supports the PSC Falcon PT40. A compatible docking station or communications cable is required for the PDT to work with PPG. Contact a portable data collection supplier to purchase the required equipment and accessories.
Add/Remove Programs along the left side of the window. to initiate the program removal process. Change/Remove Start Menu > PT Program Generator PT Program Generator (PPG) v5.0 Installing PPG Settings > Control Panel > Add/ Change or Remove Pro-...
Select Overview of PPG Use PPG to construct and design an application for your PSC portable. You can create custom applications to collect, verify, and store data. Designing and creating the program is the first part of the process; there are several steps involved.
PPG is the PT Program Generator application. This is the application you use to create programs for a PSC portable. PPGXFER is used to transfer the program you created in PPG to the porta- ble.
This example is useful as a model for designing complex applications. . You can download additional PPG library files, discussed in , from PSC’s website. . The second toolbar is the PPG toolbar...
(Refer to Math Create a new node. (Refer to Call Create a new . (Refer to Links on page Link PT Program Generator (PPG) v5.0 26.) button: Create 50.) Subroutines on page 51.) Menu Nodes on page 55.) Display Nodes on page 56.)
Navigation If your flow chart is larger than the PPG window, use the scroll bars and cursor keys to scroll different areas into view. (refer to mouse to expand the window size by clicking and dragging on the beveled lower right corner of the PPG window. Working with PPG Windows To expand the PPG window to fill the screen, or the PPG Application to fill the PPG window, select the...
PPG to create provides details on each program node type. command to load the program into Download Program compiles the program automatically, translating PPGComp PT40 Communication on page 89 PT Program Generator (PPG) v5.0 to transfer the col- XFER32...
PPG Application Design Overview This chapter provides an overview of the process of designing and building an application using PPG. The following topics are covered: • Designing the Application on page 15 • • • Node Types and the Parent-Child Relationship on page 17 •...
Is there an obvious direction to the program? For example, a user would normally collect data and then upload it. This order should be reflected in the main menu and in the program flow. PT Program Generator (PPG) v5.0...
• • Node Types and the Parent-Child Relationship Build your application in a modular fashion, taking advantage of the Parent- Child relationship. There can be multiple levels in each program flow chart. Any type of Operation node can exist at any level. The top level is the parent and lower levels are children.
Function Nodes represents a program step or work performed by the for each step in the Frame to chose from, as shown in Operation Nodes PT Program Generator (PPG) v5.0 Opera- Function Nodes , but Frames Operation , list the .
Actual vs. Virtual Display The Falcon PT40's actual display screen is a window to a larger display area called the virtual display (refer to fit into the actual display. However, applications can sometimes contain data longer than the default 6 line by16 character view of the actual display. Figure 4.
Figure 5 on page 21 file transfer process used when you create custom files with PPG and down- load them to your PSC Falcon PT40 from a PC. node if an error occurs or, if the copy opera- Display node.
Figure 5. Application Generation, Data Flow & Transfer Process Additional Resources Before or after you complete the application design, to understand better how to work with PPG to design and to create custom applications for your PSC Falcon PT40, complete the Refer to Sample Program Files on page 10 files included with the PPG software.
Overview This section discusses the PPG menubar, located at the top left of the user interface. The following menu items are reviewed: • File Menu on page 23 • Edit Menu on page 34 • View Menu on page 38 •...
. Or use the appropriate keyboard Figure 6 simultaneously. Ctrl + S menu to create a new file, open an existing file, save a File (Ctrl+N) File > New PT Program Generator (PPG) v5.0 Ctrl + P from the menubar. If no applica-...
Opening an Existing File To open an existing program source file, select use the keyboard shortcut: shown in Figure 7 Figure 7. The Open Dialog By default, the directory. If the file you want is located elsewhere, choose the drive and direc- tory from those lists, or type them in the input box.
File> Save As dialog box, shown in Figure 8 field. The pull-down list dis- File Name dialog, shown in Figure 9 Print PT Program Generator (PPG) v5.0 to replace the from the menubar. This File Name from the File > Print...
Figure 9. The Print Dialog Press to send the displayed frame to the printer. Only one view of a flow chart can be printed at a time. Page Setup Select File > Page Setup page 28 User’s Guide to change the printing options. (Refer to File Menu Figure 10 on...
PPG Compiler for complete instructions on download- (Ctrl+Z) Customize Application File > Customize Application PT Program Generator (PPG) v5.0 options. Page Setup File > dialog box: from the menubar.
Page 41
User’s Guide Click on the arrow to access the fields’ pull-down lists. File Menu Determines the PSC por- table defaults. Select from one of two PSC portable types. Determines the language and font size in which prompts appear on the PDT.
Page 42
Default width / height for nodes and grids are displayed in pixels Width indicate the number of pixels between points. Height to save your settings. This opens the dialog shown in PT Program Generator (PPG) v5.0 button to open the dialog box shown Font Height...
Figure 13. Customize Options dialog 4. Select • • Customize Display File > Customize Display log box, as shown in Figure 14. The Display Options Window User’s Guide to apply the setting changes to all new applications. Press to apply your changes only to the current application. Press to cancel your changes.
Page 44
If this feature is not enabled, nodes are free-floating. You can change the shape and color for each type of node in the flow chart. PT Program Generator (PPG) v5.0 Default width/height = 10 pixels between points.
Fill color Outline color More Colors... Startup Show PPG Toolbar Show Program Nodes toolbar Show PPG Explorer Recent Files Select File > Recent Files PPG files. Figure 15. Recent Files Menu You can select a file to open from this list. User’s Guide Click on to open a standard Windows dialog box...
Copy (Ctrl+C) on page 35 Paste (Ctrl + V) on page 35 Delete (Del) on page 36 Properties on page 36 menu items, select and then the specific menu item you Edit > PT Program Generator (PPG) v5.0 Figure 16 on page 34...
box is the desired size and shape, release the mouse button. All objects within the box are selected. You may then cut or copy all the selected objects and place them somewhere else, or drag all the selected objects with the mouse to a new location. Moving Objects To move an object from one frame or program to another, select it and choose .
This field is optional, but you may wish to complete it to provide yourself additional information when using similarly named items. to close the dialog without keeping your modifications. Cancel PT Program Generator (PPG) v5.0 from the menubar Edit > Delete command instead of the...
Operation Nodes Operation Node lowing methods: • Point to the node and double click with the left mouse button. • Point to the node and click the right mouse button to activate a popup menu; select Operation Node’s Properties name and other node information. dialog box.
PPG Explorer on page 40 Status Bar on page 40 to show the parent frame of an open Node Types and the Parent-Child Relationship on page 17 PT Program Generator (PPG) v5.0 from the menubar. You can node. Frame Subroutine...
Toolbar The PPG Toolbars can be turned on and off by toggling the appropriate menu items. Use these features to customize the way your copy of PPG looks and behaves. Select Figure 21. View Toolbars menu Select View > Toolbar > PPG on and off.
Create > Frame (Ctrl+Alt+F) on page 42 Subroutine (Ctrl+Alt+S) on page 42 Menu (Ctrl+Alt+U) on page 42 Display (Ctrl+Alt+D) on page 42 PT Program Generator (PPG) v5.0 on or off. You can also Explorer window to close it. . Hold...
Page 53
• • • • • • • • • Data on page 43 • • • • Refer to Creating & Using Nodes on page 49 using nodes. Figure 22. Create Menu User’s Guide Input (Ctrl+Alt+I) on page 42 Output (Ctrl+Alt+O) on page 42 Verify (Ctrl+Alt+F) on page 42 Copy (Ctrl+Alt+C) on page 42 Modify (Ctrl+Alt+Y) on page 43...
Subroutines , refer to Menu Nodes on page 55 (Ctrl+Alt+D) (Ctrl+Alt+O) Verify Nodes on page 63 PT Program Generator (PPG) v5.0 Frames on page 50 , refer to Subroutines on page 51 Display Nodes on Input Nodes on page 57...
Modify nodes change the contents of a given register or file. Refer to Modify Nodes on page 67 Math (Ctrl+Alt+M) nodes perform basic mathematical functions on the contents of a register Math or file. Refer to Call (Ctrl+Alt+L) nodes branch to a subroutine. Upon completion, the subroutine returns Call to the calling node.
Window > Cascade Windows on page 45 Tile Windows on page 45 Filename [Frame] on page 46 at the bottom of the PT Program Generator (PPG) v5.0 and the desired menu item: menu to view a list of Window...
Cascade Windows Select Windows > Cascade overlapping tiles. Refer to Figure 25. Windows Arranged by Cascading Tile Windows Select Windows > Tile overlapping tiles. Refer to User’s Guide from the menubar to arrange open windows as , to view cascading windows. Figure 25 on page 45 from the menubar to arrange open windows as non- , to view tiled windows.
The PPG Menubar Figure 26. Windows Arranged by Tiling Filename [Frame] Select Windows > Filename [Frame] den behind other windows to the top or to expand a minimized from the menubar to bring a window hid- Frame PT Program Generator (PPG) v5.0...
Help Menu To access Help want to use from the menubar: • • Figure 27. Help Menu PPG Help (F1) Select Help > PPG Help or the Help within the PPG application. About PPG... About copyright and version information. Figure 28. About PPG... User’s Guide menu items, select Help >...
Page 60
The PPG Menubar NOTES PT Program Generator (PPG) v5.0...
View > Show Frame/Subroutine Nodes nodes or choose View > Show Calling Function Main Menu shows the start frame of the sample2.scr application PT Program Generator (PPG) v5.0 command, start in the File New from the frame and a frame for each...
1. Select lower right corner of the frame window. The new frame is assigned a default name. 2. To position the frame, point to it, hold down the left mouse button, and drag the frame with the mouse. When the frame is positioned where you want it, release the mouse button.
Page 64
The new subroutine is assigned a default name. shows the Frames level of a program that contains three nodes within the program frames Call from the menubar. A new subroutine Create > Subroutine PT Program Generator (PPG) v5.0...
2. To position the subroutine, move the pointer to it, hold down the left mouse button, and drag the subroutine with the mouse. When the subroutine is positioned where you want it, release the mouse button. Since subroutines aren’t Linked to other objects, their locations are optional.
Page 66
For each selected node, specify a frame or node to branch to. Enter text as you wish it to appear on the display of the PDT. PT Program Generator (PPG) v5.0 from the menubar. (refer to Figure 33 on page 57 , above.
Each node type also contains properties unique to its type. For more details on each node type, all operation nodes are described in this section in the order that they appear on the PPG toolbar and the PPG menubar. Menu Nodes node presents a group of options on the portable’s screen and allows Menu the user to choose one of those options by pressing a function key.
(refer to Input ) contains a text-entry area the exact size of Figure 33 on page 57 for more information node (refer to Menu PT Program Generator (PPG) v5.0 node instead of a Display Dis- Input Nodes on page 57). Display Menu Nodes on page 55).
Figure 33. The Dialog Box for a Display node Input Nodes nodes specify how the portable will receive data. You can use the dialog Input box for an etc.) you want to accept. Figure 34. Input Node Property Dialog User’s Guide node to indicate which sources of input (scanner, data keys, Input Creating New Nodes...
The node that makes sure it's a valid number and at the same Verify tab option specifies whether to save the number of characters PT Program Generator (PPG) v5.0 key. key once to put the unit <Shift>...
Figure 35. Input Node: Track Size Tab Input Size Display Tab Echo to Display on the portable’s screen. Figure 36. Input Node: Display Tab When this option is selected, you are prompted to specify how and where data is displayed. You can select either the current cursor location or a specific posi- tion.
), select Register in the Data Destination pull-down list. You can choose to insert the File Files on page 81 PT Program Generator (PPG) v5.0 Using a Register as a Desti- pull-down list. To Write Type Creat- pull-down...
Figure 38. The Output Node Properties Dialog You can send a constant value or the contents of a register or file. When send- ing data to the system, you can use special commands that sound a beep, set the system date or time, or reconfigure the portable. You can also send com- mands to the display to reposition the cursor or erase the display.
Figure 39 Select the location for the beginning of the command to appear on the porta- ble’s display from the Select Operation for more information. PT Program Generator (PPG) v5.0 Files on page button. An Add Output Operation pull-down list.
Erase screen, return cursor to home position Move up one or more rows Move down one or more rows Move right one or more columns Move left one or more columns Display text on screen [ NO OPERATION ] Depending upon which operation you select, one or more parameters may be required.
Verify Options Tab Figure 41. Verify Node Verify Options Tab Data Type ASCII values Numeric values Numeric values (hex values Alphabetic values Comparison Type User’s Guide allows you Data type to select the type the data should match ASCII values (hex values acters and symbols (such as brackets, commas, dollar sign, and slash).
Figure 43. The Copy Node Properties Dialog Copy From Tab Data Source of a register or file. If you choose text string. If you choose tion. For more information, refer to Copy To Tab Data Destination either a register or a file. Select the destination from the available options. For more information, refer to File as a Destination on page 83 Next Nodes...
Search/ feature on the Replace node. To use a Modify partial match, refer to Searching for a Partial Match on page 148 using the node. Verify PT Program Generator (PPG) v5.0 Register name Template Field...
Reverse Delete Clear 8th Bit Next Nodes Next node ceeds or fails. Math Nodes nodes perform basic mathematical operations on the contents of a file or Math register. Figure 45. Math Node Properties Dialog User’s Guide Reverses the order of data in the specified register. For example, if the 123456 register value were 654321...
Math tab lets you specify a constant value or a file or register con- is displayed near the bottom of the dialog. PT Program Generator (PPG) v5.0 shows the dia- Figure 45 on page 69 Registers on page 78...
Creating New Nodes Operand 2 Tab tab lets you specify a constant value or a file or register con- Operand 2 taining the second operand for the mathematical operation. The location of is displayed near the bottom of the dialog. Operand 2 Figure 47.
Divides operand 1 by operand 2. Returns the remainder. nodes optimizes a PPG program, saving both time and Call shows a Figure 51 Call Node Properties PT Program Generator (PPG) v5.0 dialog (refer to Figure 45 on page . Select from mathemati- Figure 50 Call...
Figure 51. Call Node Properties Dialog Call Subroutine Click on the down-arrow of all subroutines within the program. Select the subroutine you want to and then select to a subroutine executes the specified subroutine and then returns to the Call node following the Links Creating Links...
Press the or the (a Link with one or more bends), point to the source jointed Link keys while grasping the node with the mouse Shift Ctrl button. PT Program Generator (PPG) v5.0 button Delete...
Automatically Generated Nodes Start Nodes Start nodes point to the first node in each frame. The are created automatically by PPG when a frame or a subroutine is created. Exit Nodes Exit nodes indicate where the frame ends and returns to its parent frame. Exit nodes are created automatically by PPG when you create a Link from one frame to another.
Page 88
Creating & Using Nodes NOTES PT Program Generator (PPG) v5.0...
Overview This section discusses methods for controlling data flow, data handling, and data organization. The following topics are covered: • Controlling Data Flow on page 78 • Registers on page 78 • • • • • • Files on page 81 •...
Fields are a breakdown of data in a single register. Data is arranged as fields in records in a template. Fields can be set to either a fixed length or a variable length with a separator. as the source, you are given options as shown in Register PT Program Generator (PPG) v5.0...
Figure 52. The Source Register Options To view a list of existing registers, click on the arrow to the right of the register list. To select one of these registers, click on it. To create a new register, click on the New Register Register Fields To select a specific field in the register, select the...
Specifying a Register Field on page checkbox for the Field Register Source in a , the template and field pull-down lists Register Destination Figure 54 New Template PT Program Generator (PPG) v5.0 80). or select Field as pull-down list, Template button (refer to...
Register Example: Parsing Data You own a catalog business. When you ship packages out, you scan a label that includes the destination region. The first character of each label identifies this destination region as North, West, South, or East. Customize the appli- cation so it divides data into four separate files by region.
First indicates the first record in the file. Last indicates the last record in the file. Number selects a specific record. You are prompted for the record number. PT Program Generator (PPG) v5.0 button to create a new New File...
Index Using a File as a Destination When you choose Figure 56 Figure 56. Destination File Options Select from the file. User’s Guide Index lets you indicate a register where the number of the record you want to use is stored. You are prompted for the name of the register containing the record value (refer to Using a Register as a Source on page...
or with delimiters separating variable-length fields in the record, as in the fol- lowing: 2348,493848 48,393948 8,293832 9,832928 185,392038 28,282930 Once downloaded to the PC, this data file can be easily translated by a data- base or spreadsheet program. The first value in each record goes into a field, the second value goes into an tion pairs the values appropriately.
Once you've PPG Explorer Properties window is displayed as shown in Create Template PT Program Generator (PPG) v5.0 Available list Template Fields list and press Remove , and right-click on it to open...
1. Create an portable file. 2. Use second named Part Number. 3. Copy the Part Number register to a Lookup register. 4. Append ,* to the lookup key (wild card lookup). 5. Lookup Lookup register against the inventory file. This assumes that the inventory file is comma delimited, and contains Part Number and Quantity fields.
(formatted into columns in the data file), or they are allowed a variable length with a separator (such as a comma) separating them. You can also use a template to divide a register’s data into separate fields. dialog is shown in Figure 59 Edit Field PT Program Generator (PPG) v5.0...
PT40 Communication Overview This chapter describes how to communicate with the PSC PT40 portable data terminal (PDT). The following topics are covered: • Downloading the Application to the PDT on page 89 • • • Using XFER32 on page 92 •...
Page 102
Figure 61. PPGXFER Window 6. Double-click on the > Exit The PSC Portable Compiler window appears momentarily as PPG compiles the program, translating it into a language understood by the portable. The original *.scr file remains intact, and the compiled file is given the same name, but with a *.hex extension.
What Happens During a Download? During the application download process, a number of steps take place. First, the downloader checks the version number of the PT40’s operating system. 1. The downloader allows you to choose from three different options. Figure 62. Updating the Operating System’s Download software. Download the new operating system Proceed without...
• General Tab on page 93 • Transfer Tab on page 94 • Logging Tab on page 96 The settings in these dialogs can be modified or customized to meet your com- munications requirements. General Tab General this section to modify the PDT’s (ACK/NAK is the only protocol used by the PT40), and Window Size Figure 65.
This feature is only available with ZModem Protocol is NOT supported by the Falcon PT40. ZModem This feature is only available with tab to establish file transfer settings. PT Program Generator (PPG) v5.0 as the protocol unless you ZModem Protocol. permitted before a file transfer...
Page 107
Figure 66. Transfer Tab of the File Transfer Utility Sender Timeout (Seconds) Receiver Timeout Path/Filename Transmission Overwrite Source Longer or Newer CRCs Don’t Match Append Always Source Newer Date/Length Don’t Match Never File Transfer Default User’s Guide Enter the maximum number of seconds to wait for a connection when sending files.
Default File Transfer Use the button to locate a new log file. Browse , below for specifics on sending files. Refer to for specifics on receiving files. PT Program Generator (PPG) v5.0 . When Log to File folder.
Transmit (Send) Files 1. Select the Figure 68. Send File to Portable Window 2. Select the file to send. 3. Click • Press User’s Guide button. Transmit Files to send the file to the data collection terminal Open to not send any files Cancel Using XFER32...
3. Click Press Cancel If you are using a DOS Host PC and wish to use DOS to transfer files, you can download PDTFER, an unsupported DOS file transfer application, from PSC’s website www.pscnet.com button. Receive Files to begin receiving the file.
Overview This tutorial reviews common PPG procedures. Instructions for the following tasks are available: • Studying a Sample Program on page 100 • Building a Custom Portable Program on page 106 • • • • • • Loading and Using the Program on page 126 •...
Figure 70. A Sample Program File 4. Click on the bar to expand the frame window to its full size. Programs > PT Program Generator > PT Program Gener- to load PPG. button at the top right of the title bar to Maximize and select sample.scr from the displayed list...
Page 113
• • • The current frame is always indicated by a shape filled with color. To select a frame, click on it with the left mouse button. 5. Move the mouse pointer to the mouse button (or select the frame and choose the menu).
Page 114
8. Double-click the Figure 73. The Display: Options Properties 9. To close the frame, each shape represents an Display: Options Figure 73 properties dialog, press Display: Options PT Program Generator (PPG) v5.0 frame to Main Menu node. Operation Operation node. Operation...
Page 115
10. Select the X (close button) on the top right of the to return to the higher level of the program. • You can also use levels. 11. Double-click the Figure 74. The Contents of the Collect frame • • 12.
Page 116
(refer to Erase frame node to return to the Program level. Erase subroutine ( Pad Zeros Program Subroutine PT Program Generator (PPG) v5.0 level. Program Figure 76 level) is called from the Collect node to open it.
Page 117
Studying a Sample Program Figure 77. The Contents of the Pad Zeros subroutine 18. Close the subroutine window and to return to the Pad Zeros Program level. By looking at all the pieces of this program file, you can get a general idea of how the program is put together.
Collect Data Create the frames shown in steps: 1. If you took a break and exited PPG, select Generator > PT Program Generator load PPG. 1. Click on the fill the screen. 2. If you are continuing from the last section, select new flow chart.
Figure 78. Main Application Level of the Program 4. Click the right mouse button and select frame and choose Frame Properties select 5. Now create the FRAME mouse button and select log. Enter Collect Data in the 6. Select of the workspace, click the right mouse button, and select to open the Creating Links You now have the three frames of your program.
Create > Link Main Menu Main Menu frame. Main Menu Figure 79 on page 109 PT Program Generator (PPG) v5.0 frame and click the left mouse frame and click the mouse frame to the Main Menu frame, Main Menu...
Figure 79. Flow Chart showing Jointed Links Creating the Main Menu Nodes After defining program’s frames, you must specify the nodes for each frame. To view the a frames’ nodes, double-click on it. Or highlight the frame and select > Show Frames/Subroutines Operation divided into nine node types, with a different dialog box associated with each node.
Page 122
Create > Menu node and select Menu Menu > Properties Options from the menubar or press the Create > Link PT Program Generator (PPG) v5.0 Figure 80 on page 110 opens in the Menu node from the pop-up Properties Figure 71 on button.
Page 123
Figure 81. The completed Main Menu nodes 8. Right-click the the node’s Display Figure 82. The Menu: Options Dialog Box 9. On the first line of the User’s Guide Building a Custom Portable Program node and select Menu: Options . The dialog includes a text-entry area, called Properties , that represents the portable’s screen (refer to area, type Main Menu.
Page 124
A pull-down list appears, listing possible destination nodes. so that when the user presses Exit Collect Data checkbox. Click on the down-arrow button next to <F4> <F4> PT Program Generator (PPG) v5.0 Figure 83 , the pro- <F3> from the Exit Upload Data...
15. Select Program Saving Your Program Even though the program's not complete, it's a good idea to save it periodi- cally while you are creating it. Select Enter tutorial in the . PPG will add the extension *.scr automatically. select You have completed the on the portable’s screen and allow the user to press checks to see which function key was pressed and passes control to either the...
Page 126
PPG Tutorial Create nodes for the 1. If you're returning from a break after exiting PPG, double-click on the PPG icon in the PT Program Generator. Then choose and select tutorial.scr from the file list. Select the PPG window. 2. At the Program level, double-click the contents.
3. Create all the nodes shown in on the cated by the first line of text in the node. Rename each node accord- ing to the second line of text. Link the nodes together as shown. If you click twice on the window.
Page 128
Columns and rows are numbered starting with 0 instead of 1; so enter 1 in the field to indicate the second row and 0 in the field to indicate the first column. PT Program Generator (PPG) v5.0 checkboxes let you indicate checkboxes. This allows the user to Link to the...
Page 129
Figure 87. The Input Properties: Display Tab 5. Create a special register for the input data to keep it separate from other data. Figure 88. The Input: Item Properties Dialog: Store Info Tab Register program stores input data in a register named 6.
Copy: To File ) and the Output: Error Beep pull-down list. Scroll through the list Register to save your settings and exit the dialog box. PT Program Generator (PPG) v5.0 window. Create Register field to create a new dialog box. Input Item...
The Output: Error Beep Node Now you need to set the ing steps: 1. Double-click the Figure 91. The Output: Error Beep Dialog Box 2. On the setting and Constant as the • • 3. Press The Display: Error Text Node You can have a special message appear when the error beep is sounded.
File > Save nodes you created prompt the user to enter data, and they Main Menu PT Program Generator (PPG) v5.0 node to copy data from the Inven- register is replaced. Inventory field set to Register.
Creating and Setting Up the Upload Data Nodes The last frame, portable’s file to a file on the PC. You will set up nodes that do the following: • Display a menu asking if the user wants to upload data. •...
(refer to Output: to PC tab, select the Information to Output . This will send the output to the serial port of the portable, PT Program Generator (PPG) v5.0 node, create the Link to the Output: option. Next Node/On Error...
Figure 96. The Output To: PC Dialog Box 3. From the pull-down list select Monthly Inventory. 4. On the Next Node field. 5. Press The Output: Error Beep Node Complete the following steps to set up this node: 1. Select the 2.
<F4> to save your settings and exit the dialog. node to open its dialog box. Input: Timeout Display checkbox. Select Modify Erase File Function Key Function Key. PT Program Generator (PPG) v5.0 Main . The node that follows this Input...
3. Enable the list that appears next to to the pass with no input. 4. Press The Modify: Erase File Node After you have uploaded data from the portable file, you will want to erase its contents. Otherwise, further data you collect is appended to the data you just uploaded, and your data file will quickly grow out of control.
File > Download Program The PSC window appears while PPG compiles Portable Compiler the program. When compiling is complete, the PSC window displays the message Initiating Download connection is successful, the program is loaded into the portable. When downloading is complete, the message...
Page 139
1. Double-click on the File > Exit choose 2. Double-click on the close it. 3. Disconnect the portable from the cable, and press the begin collecting data. 4. Scan the following bar codes at least once. Each time a code is scanned correctly, you should hear a single beep.
Input Collect Data The database program can be set up to treat the first field field. TUTORIAL TUTORIAL PT Program Generator (PPG) v5.0 frame of your program and each item on the record, program to collect and program:...
Output node to use a template. Input Programs > PT Program Generator > PT Program Gener- to load PPG. from the menubar to load the tutorial.scr File > Open Creating and Using Templates...
Page 142
Verify node to the Copy node to the node so that they are no longer jointed. Input Exit PT Program Generator (PPG) v5.0 frame, and reposition the node. Copy node and from Display , and rename the Figure 81...
7. Select the new • • 8. Skip over the two node ( • • 9. On the • • Creating the Fields Create the template fields by completing the following steps: 1. On the ter as the is the same register used to store the Inventory from being overwritten by the other, you can create a template to divide the register into two fields: one for the...
Page 144
(,) in the field. This separates the two values Delimiter with a comma. Press Done field should appear on the Item list of available fields. PT Program Generator (PPG) v5.0 dialog. Create Template dialog. Create Field . Enter Item Quantity...
Page 145
4. Select • • 5. Define the order of the fields in the template. • • You may need to scroll through the list to find the fields you want. 6. Press 7. On the • • 8. Specify storing the input item number in the (The program will work correctly whether or not you perform this step.) •...
Page 146
After you enter the item and quantity values, both entries are displayed together on the third line, separated by a comma. Managing Data on page 77 PT Program Generator (PPG) v5.0 , instead of Column register at the cursor position...
Sample Verification Methods on page 138 • • • • Downloading a File to a PSC Portable on page 145 • Finding the Number of Records in a File on page 147 • Searching for a Partial Match on page 148 •...
Example Frames Setting the Date and Time All PSC portables include a clock that keeps track of the current date and time. To allow users to adjust the date and time settings, complete the follow- ing steps: 1. Create a new 2.
Displaying the Contents of a Register Tip04.scr, illustrated in the portable, using two Figure 104. Tip04.scr Flow Chart 1. Creates a new information to the existing display and position the cursor within the display screen. • • • User’s Guide , displays the contents of a register on Figure 104 nodes as follows:...
Chooses Default Register from the list. node prevents the register contents from being written on the to the display. Default Register node. Verify PT Program Generator (PPG) v5.0 . This node writes the Scan Output pull-down list. Data Source pull-down...
Figure 106. Verify Information Tab: Register Data Source 3. On the Figure 107. Verify Options Tab: Numeric Data Type Verifying that a Number is an Integer Another type check that may be needed is to confirm that data is an integer, rather than a fractional numeric value.
Page 152
2. Enter the value to check. Figure 110. Display Input Value 3. Verify that the value is numeric (checks for any valid floating point format). Figure 108 on page 139 Verify Integer PT Program Generator (PPG) v5.0 , confirms that data is an...
Page 153
Figure 111. Verify Numeric 4. Verify that there is no e in the value (floating point allows for expo- nents. i.e. 1.25e-6 is a valid floating point value). Figure 112. Verify No e 5. Check for a . (decimal point) (values with fractions are not integers). Figure 113.
This example is illustrated in Tip05.scr, which is shown in page 143 Output Fail option in the Size to Register Verify PT Program Generator (PPG) v5.0 node collect- Input node. Figure 115 on...
Page 155
Figure 115. Tip05.scr Verifies Input Size Display: SCAN Input: STORE In the example, the into a register using the size to register option. Be sure to use different registers to store the size and the input. Verify characters long. If the size is incorrect, the display named user to try again.
Page 156
Input PT Program Generator (PPG) v5.0 . If so, it exits the frame. register. The options in its 117.
For example, you might have an inventory file that you need to check scanned codes against. Tip06.scr, shown in downloads a file from the host computer to a connected portable. Figure 118. Tip06.scr Downloads a File to a PSC Portable Display: READY Instructs the user to press Input: FKEY Verify: EXIT User’s Guide...
Page 158
Choose to replace existing data or place new data at the beginning or end of the file or at a given record number. Enabled so that the user can see the file going into the portable unit. PT Program Generator (PPG) v5.0 Dis- on the portable’s screen.
Finding the Number of Records in a File The easiest way to determine the number of records in a file is to use a node with Register value). Since it won’t find a match, the program will return the file size, storing it in the index register.
Loc3 Price ,1000* node as the Comparison type against the Default Verify Default Register ” into the Default Register Default Register PT Program Generator (PPG) v5.0 ” on the front and Loca- 1000, insert “ ” in Part # overwriting.
Figure 121. Tip08 4. In the Type 5. In the Register as the Searching for Data in a File A search of a multiple field file for data in one field of the file may be accom- plished using the “ files are not necessary.
Page 162
File as the File = Default File node, Verify Verify Options type, and Lookup as the Comparison PT Program Generator (PPG) v5.0 must be looked up in Asset # field Default Register ” on the front of the field...
Splitting Records into Two Files This method is still valid, but no longer recommended since you can use Searching for a Partial Match on page When verifying only a part of a record, you can accelerate the process by split- ting the record into two different files and referencing each file’s index posi- tion.
Page 164
Copy: 1ST FIL Modify: DEL TEMP Instructs the user to wait while the PSC portable completes this process. Places the constant “end” at the end of the file to mark the last record. Copies the first record in the file into the default register.
Referencing Two Different Files Tip10.scr, illustrated in contains item numbers and one that contains item descriptions. Records in both are sorted identically. By referencing data in both files, this example dis- plays the description of an item whose number is entered by the user. Figure 123.
Page 166
Copy To Tab Positions the cursor on the portable screen. The program returns to Display: SCAN an item number again. PT Program Generator (PPG) v5.0 instructs the user to enter Input: ITEM Figure 125 on page , prompting the user to enter...
Reviewing a File Tip11.scr, illustrated in tents of a file, one record at a time. Figure 126. Tip11.scr Reviews a File Copy: END Copy: INDEX=1 Verify: END Output: INDEXED Displays the contents of the record at the position specified in the User’s Guide Figure 126 on page 155 Copies the constant “end”...
Page 168
Keeps the record contents displayed until the user presses a key. The program then loops back to Verify: END displayed. ). Next, output the first record and give the option to PT Program Generator (PPG) v5.0 so that the next record can be Finding the Number of...
Sounding a Beep To sound a beep on a portable, use an to Constant and Figure 128. Output Beep Node In the constant field, enter the human readable text of one of the following codes: Sounds a high beep Sounds a low beep You can enter more than one code, for multiple tones.
Page 170
Quantity field of the default register. Any zeros beyond the sixth digit are dropped. Reverses the six characters in the default register, returning the original input to the correct order with leading zeros. PT Program Generator (PPG) v5.0 node. Copy...
Overview PSC offers a library of several sample PPG program source files which include examples of file manipulation, templates, and nodes. Several working pro- grams are included, although many of them are only examples and do not pro- vide any functional value. You can download these files from the area of PSC’s website at...
Page 172
A program that keeps a running total on an item. A pick list file is down- loaded into the portable, and as the items are matched, the user has the option to add or subtract a quantity from the total PT Program Generator (PPG) v5.0...
Page 173
MULTIPLE.SCR MULTPLE2.SCR A large program (342 nodes, with 8 separate programs) that has the PICKLIST.SCR RANGE.SCR TRACKER.SCR TRACKER2.SCR A sample of a different approach to tracking time. As each function is UPLOAD.SCR UPPRPLUS.SCR A sample data-collection program that transmits data to a host via a User’s Guide A multiple-option program that includes a option;...
Page 174
The PPG Library NOTES PT Program Generator (PPG) v5.0...
PPG System Commands Overview To use PPG to reset the default settings on the PDT, enter the human readable portion of these bar codes at the system command prompt. This is useful to automatically change modes for the user. The following bar codes are provided in this section: •...
PPG System Commands Using Predefined Defaults The PSC Falcon PT40 use the following four sets of parameter defaults. Reset the portable to a predefined default set by scanning one of the bar codes in Table 3 on page 164 Table 3. Predefined Defaults for the PT40...
Alternate Parameters Enter these commands by scanning the bar codes with the PT40’s laser or through the PC’s serial port. You can also embed these codes in a PPG applica- tion. The Falcon PT40 recognizes the bar code commands in Table 4.
Page 178
PPG System Commands Reset Mode Clears all memory and resets the portable. CAUTION PT Program Generator (PPG) v5.0...
File Dump Program Mode Set Date Set Time <CR> Only Protocol ACK/NAK Protocol Xmodem Protocol User’s Guide Appendix F Useful Bar Codes * $ + $ * $ + $ * $ + $ * $ $ * * % . * % - - C A 0 0 E E * - C A 0 1 E E *...
Page 182
Useful Bar Codes Reset Factory Defaults * $ + S - D 2 C 8 E E * PT Program Generator (PPG) v5.0...
Overview Use this section to solve common problems you might have while using PPG. Following is a list of troubleshooting topics: • Fixing Corrupted Files on page 171 • Error Messages on page 173 • Technical Support on page 178 Fixing Corrupted Files Occasionally a file becomes corrupt and won't open.
Place the cursor at the end of the file. Delete any extraneous characters after the final ‘)’ character. File > Program the Portable <CLR>+<ENT> PT Program Generator (PPG) v5.0 . Then Options > Settings to try again. while reloading the...
If you continue to have trouble with your program, you can call PSC for technical assistance (refer to Technical Support on page 178 PPG Error Messages Table 6.
Page 186
Troubleshooting Invalid file access code. 1 – 3 valid. Contact PSC Technical Support Invalid grid value. Enter any non- zero numeric value in both grid size fields and select OK. Invalid function node size. Enter any non-zero numeric value in both size fields and select OK.
The file containing bitmaps for the selected language cannot be found. Reinstall PPG to restore all files. If the message persists, you may be running an outdated version of PPG- Comp. Contact PSC Technical Support for assistance. Error <source file name> is empty Error Messages .scr...
Open the file with PPG and verify that it appears as expected. If the message per- sists, contact PSC Technical Support for assistance. Your program may have too many nodes in a frame or have too many fields defined in a template.
Page 189
Error Messages Portable successfully programmed BEL received - Aborting. No response - Aborting. Too many NAKs - Aborting Unknown response - Aborting. COM port error Open COM error Set COM state error TimeOut exceeded WriteComm error - Aborting. PDT does not support application file.
PSC Website TekForum Search for information on the TekForum by clicking on the the top of PSC’s home page. Browse the TekForum at PSC’s website to find answers to your questions about common technical issues. Register with Tek- Forum to submit a question to the PSC Technical Support Staff and receive a solution to your question posted on TekForum within 48 hours.
Appendix H node executes a branch to a subroutine. Call The display screen of your PSC portable is divided vertically into six- teen columns, numbered 0 through 15. node is used to transfer information from one file or register to Copy another file or register.
Page 192
A program source file must be compiled (using PPGComp) before it can be loaded into a portable. A record is a set of related data fields stored as a single line in a file. PT Program Generator (PPG) v5.0 , and Copy...
Page 193
The contents of the register are overwritten each time you scan a code. The display screen of the PSC Falcon PT40 is divided horizontally into rows, numbered 0 through 5. Refer to for more information on the number of rows allowed, depending upon the selected language.
Page 194
Glossary NOTES PT Program Generator (PPG) v5.0...
adjusting frames jointed links links arrows see links axes, grid settings for bar codes for programming beeper bar codes for beeps setting tone of bits eighth, clearing from data box size for frames and nodes breakpoints buttons radio User’s Guide Call nodes characters number of (in registers)
Page 196
Download Program command downloading programs D0, D1, D2 (predefined defaults) echoing data input Edit menu Copy Paste Rename PT Program Generator (PPG) v5.0...
Page 197
eighth bit, clearing from data enlarging the PPG window erasing contents of registers, fields, or files error messages displaying on portable screen Exit command fields creating for templates creating from data in a register defining erasing contents of storing data in file dump, bar code for File menu Download Program...
Page 198
PPG window version minimize button, location of minimizing the PPG window Modify nodes Modify Erase File modifying input mouse selecting two or more objects with mouse actions click, definition double click right click PT Program Generator (PPG) v5.0...
Page 199
moving frames links objects naming files frames New command nodes 53–64 Call changing fonts in Copy Copy To File copying creating for templates cutting deleting Display Display Enter Item Display Error Text Display Successful Input Input Item Input Timeout Display linking to other nodes or frames Math linking to other nodes or frames...
Page 200
PPG window to an icon registers breaking into fields creating erasing erasing contents of number of characters in setting destination for input storing data in Rename command renaming PT Program Generator (PPG) v5.0...
Page 201
frames replacing data resetting default communications settings bar code for resetting the portable bar code for reversing order of data right click sample applications Save As command Save command saving program source files scanned data, translating scanner, allowing input from screen clearing displaying menus on...
Page 202
XFER32 general tab logging tab transfer tab zeros, padding values with zoom in command zoom out command PT Program Generator (PPG) v5.0...
Page 204
Asia Pacific PSC Hong Kong Hong Kong Telephone: [852]-2-584-6210 Fax: [852]-2-521-0291 Australia PSC Asia Pacific Pty Ltd. North Ryde, Australia Telephone: [61] 0 (2) 9878 8999 Fax: [61] 0 (2) 9878 8688 France PSC S.A.R.L. LES ULIS Cedex, France Telephone: [33].01.64.86.71.00 Fax: [33].01.64 46.72.44...
Need help?
Do you have a question about the PT Program Generator and is the answer not in the manual?
Questions and answers