PSC PT Program Generator manual

PT Program Generator User’s Manual 2342.book Page 0 Thursday , July 22, 2004 8:35 AM[...]

PSC Inc 959 T erry Street Eugene, Oregon 97402 T elephone: (541) 683-5700 F ax: (541) 345-7140 An Unpublished W ork - All r ights reser ved. No part of the contents of this documentation or the procedures described therein may be reproduced or transmitted in an y form or by an y means without pr ior written per mission of PSC Inc. or its wholly own[...]

User’s Guide i C ONTENTS Software End User License Agreemen t ........................... ....................... vii Introduction ................ ....................................................... .................... 1 Document Overview .......................................................................................................[...]

ii PT Program Generator (PPG) v5.0 User Interface ......................................................................................................... 11 Menus and Toolbars ........................................................................................... 11 PPG Toolbar Buttons .........................................................[...]

User’s Guide iii View Menu .................................................................................................................... 3 8 Show Calling Function .............................................................................................. 38 Show Frame/Subroutine Nodes.....................................................[...]

iv PT Program Generator (PPG) v5.0 Information to Output Tab .................................................................................. 61 Special Commands ............................................................................................ 62 Next Node ................................................................................[...]

User’s Guide v Template Uses ........................................................................................................ 84 Creating a Template ................................................................................................ 85 Modifying an existing template ............................................................[...]

vi PT Program Generator (PPG) v5.0 Example Frames ................................. .............................. .................. 135 Setting the Date and Time ............................................................................................ 136 Changing the Auto-Off Timeout ...........................................................[...]

User’s Guide vii PSC Inc. PT Program Generator (PPG) Software End User License Agreement NOTICE TO END USER: P SC is providing y ou with a license for the Software you have acqu ired, subject to the terms and conditions of this Agreement. If you use the Software, y ou will be deemed to have accepted th e terms and conditions of this Agreement. If[...]

(PPG) Software End User License Agreement viii PT Program Generator (PPG) v5.0 2. Intellectual Property. End User acknowledges that the So ftw are constitu tes valuable trade secrets of PSC and that the Software is protected b y intelle ctual proper ty laws and treaties. The license set f or th in this Agreement does not transfer to End User an y o[...]

PT Program Generator User’s Guide ix 5.3 PSC shall hav e no liability to End User for claims of infrin gement based upon 1) the use of the Software in combination wit h any product which PSC has not either furnished or author ized f or use with such Software, 2) the use of any Softw are designed, manufactured, or modified to the specifications of[...]

(PPG) Software End User License Agreement x PT Program Generator (PPG) v5.0 NOTES 2342.book Page x Thursday , July 22, 2004 8:35 AM[...]

User’s Guide 1 Chapter 1 Introduction Document Overview This document is divided into se ven chapters and eight appendices: • Introduction on page 1 , pro vides an overview of PPG, describes the con- ventions used in this manual, and tells how to access PSC T echnical Su pp o r t. • Getting Star ted on page 5 , tells you how to install and ru[...]

Introduction 2 PT Program Generator (PPG) v5.0 • Example F rames on page 135 , contains sample code for commonly used functions. • The PPG Library on page 159 , describes the applications that come with PPG. • PPG System Commands on page 163 , identifies the system commands that can be used with PPG. • ASCII/Hex Conversion T ab le on page 1[...]

Style Conventions User’s Guide 3 Windows Controls Wo r d s i n Bold are selections that appear in the PPG program, such as frame names, subroutine names, node names, file, field, template, and register names, menu options, buttons, dialog boxes, field names, and radio-buttons. Wo r d s i n Bold separated by an arro w ( > ) are menu actions you[...]

Introduction 4 PT Program Generator (PPG) v5.0 NOTES 2342.book Page 4 Thursday , July 22, 2004 8:35 AM[...]

User’s Guide 5 Chapter 2 Getting Started Overview Refer to this section as you pr epare to install and use the PT P rogram Genera- tor (PPG). The following general topics ar e covered: • Before Y ou Star t on page 6 • What’ s New in PPG v5.0? on page 6 . • PPG License Agreement on page 6 . • Registering Y our Cop y of PPG on page 6 . ?[...]

Getting Started 6 PT Program Generator (PPG) v5.0 Before You Start What’s New in PPG v5.0? The following features ar e new to this version of PPG: • PPG v5.0 works with PSC’ s F alcon PT40. • Impro ved user interface provides buttons to access program nodes and controls. • Double-byte language support for Chinese Simplified and Chinese T [...]

PPG Installation User’s Guide 7 •V i d e o - V G A •A C D - R O M d r i v e • A serial port (for loading your program into a portable) Operating Systems PPG works with the following M icrosoft ® Wind ows ® operating systems: •W i n d o w s ® 98 (SP5) •W i n d o w s ® 2000 (full double-byte functionality) •W i n d o w s ® Me ( S P[...]

Getting Started 8 PT Program Generator (PPG) v5.0 7. F inally , a message that PPG has b een successfully installed is dis- played. 8. P ress Finish to exit the installation. Upgrading to PPG v5.0 If you want to upgrade to PPG v5.0, complete the instructions in Installing PPG on page 7 . By default, PPG v5.0 is installed in a differ ent default loc[...]

Overview of PPG User’s Guide 9 2. The PPG window opens as illustrated in Figure 1 with a new , blank PPG application. Figure 1. The PPG Window Exiting PPG T o exit PPG, select File > Exit from the menubar or double-click on the Con- trol-men u box. A dialog appears, asking if yo u want to save any changes to the current file. S elect Ye s to s[...]

Getting Started 10 PT Program Generator (PPG) v5.0 PPG Tutorial T o become familiar with PPG, complete the PPG T utor ial on page 99 , or access the PPG T utorial via the on-line help. Program Files Executable Programs F ollowing is a list of executable pr ograms that are installed on your PC during the installation of PPG: Sample Program Files PPG[...]

Overview of PPG User’s Guide 11 PPG also comes with some example frames and files, discussed in Example F rames on page 135 . Y ou can download additional PPG library files, discussed in The PPG Library on page 159 , from PSC’ s website. User Interface Menus and Toolbars The PPG menubar is discussed in detail in The PPG Menubar on page 23 . In [...]

Getting Started 12 PT Program Generator (PPG) v5.0 Program Nodes Toolbar T o create new PPG Program Nodes , click on the node ’ s Create button: F or a complete description of each node type, refer to Creating & Using Nodes on page 49 . Copy Cop y the selected node to the clipboard. Refer to Copy (Ctrl+C) on page 35 . Paste P aste the cut or [...]

Overview of PPG User’s Guide 13 Navigation If your flow chart is larger than the PPG window , use the scroll bars and cursor keys to scroll different ar eas into view . (refer to Figure 3 on page 13 ). Or use your mouse to expand the window size by clicking and dragging on the beveled lower right corner of the PPG windo w . Working with PPG Windo[...]

Getting Started 14 PT Program Generator (PPG) v5.0 Generating the Program Refe r t o PPG Application Design on page 15 for an overview of using PPG to create a PDT application, starting with a flow chart of your data-collection process. Creating & Using Nodes on page 49 pro vides details on each program node type. Downloading the Program Once y[...]

User’s Guide 15 Chapter 3 PPG Application Design Overview This chapter pro vides an overview of the process of designing and building an application using PPG. The following topics are co vered: • Designing the Application on page 15 . • Application Output on page 15 . • Application Structure on page 16 • Node T ypes and the P arent-Child[...]

PPG Application Design 16 PT Program Generator (PPG) v5.0 Application Structure N ext you must decide what you want the program to do . Draft a program flow chart with pencil and paper , while keeping in mind the following ideas and concepts. F ollow them as steps if you like: 1. List the major actions the user may take. These may include reading d[...]

Node Types and the Parent-Child Relationship User’s Guide 17 • F or example, an application with collect and store functions would be broken up into a collection function and a storage function. • F or example, a storage function may contain steps to verify the data meets certain criteria, store the data in a file and track the amount of data[...]

PPG Application Design 18 PT Program Generator (PPG) v5.0 Creating Function Nodes Once you ’ ve designed the basic program st ructure, the next step in generating a portable program is to define each Function Node. Function Nodes are frames or subroutines and are used to organiz e the steps and work of Opera- tion Nodes . Most developers start by[...]

Node Types and the Parent-Child Relationship User’s Guide 19 Actual vs. Virtual Display The F alcon PT40's actual display screen is a window to a larger display area called the virtual display (refer to Figure 4 ). Most applications y ou will use will fit into the actual display . Ho wever , applications can sometimes contain data longer tha[...]

PPG Application Design 20 PT Program Generator (PPG) v5.0 The virtual display maintains the latest lines of data once all lines of the virtual display are full. The oldest lines of data are “ pushed off the top ” as new data is added at the bottom. Defining Program Flow After you create all the nodes, connect the program pieces together using L[...]

Additional Resources User’s Guide 21 Figure 5. Application Generation, Data Flow & T ransfer Process Additional Resources Before or after you complete the application design, to understand better ho w to work with PPG to design and to create custom applications for your PSC F alcon PT40, complete the PPG T utorial on page 99 . Refe r t o Samp[...]

PPG Application Design 22 PT Program Generator (PPG) v5.0 NOTES 2342.book Page 22 Thursd ay, July 22, 2004 8:35 AM[...]

User’s Guide 23 Chapter 4 The PPG Menubar Overview This section discusses the PPG menubar , located at the top left of the user interface. The following menu items are r eviewed: • File Menu on page 23 . • Edit Menu on page 34 . • View Menu on page 38 . • Create Menu on page 40 . • Window Menu on page 44 . • Help Menu on page 47 . Ref[...]

The PPG Menubar 24 PT Program Generator (PPG) v5.0 To a c c e s s File menu items, click on File > and then the menu item you want to use from the menubar as shown in Figure 6 . Or use the appropriate keyboar d short cut, indicated on the same line as the menu item. Many standard W in- dows keyboar d shortcuts can be us ed. For example, to print[...]

File Menu User’s Guide 25 Opening an Existing File (Ctrl+O) T o open an existing program source file, select Open from the File menu, or use the keyboard shortcut: Ctrl+O .This action opens the Open dialog, as shown in Figure 7 . Figure 7. The Open Dialog By default, the File list sho ws all program source ( .scr ) files in the PPG directory . If[...]

The PPG Menubar 26 PT Program Generator (PPG) v5.0 If a file of that name already exists in the specified dir ector y , a dialog box appears, asking if you want to replace the existing file. S elect Ye s to replace the file or No to return to the Save As dialog box, where you can give the file another name or place it in another location. Save As T[...]

File Menu User’s Guide 27 Figure 9. The Print Dialog Pre s s OK to send the displayed frame to the printer . Only one view of a flow chart can be printed at a time. Page Setup Sele ct File > Page Setup to change the printing options. (R efer to Figure 10 on page 28 .) 2342.book Page 27 Thursd ay, July 22, 2004 8:35 AM[...]

The PPG Menubar 28 PT Program Generator (PPG) v5.0 Figure 10. The Pa ge Setup Dialog Pre s s OK when you are finished modifying the Pag e S et u p options. Download (Ctrl+D) U se this feature after you have finished creating your flo w chart. Select File > Download from the menubar to compile the program and do wnload it onto the portable. The P[...]

File Menu User’s Guide 29 Figure 11. The Customize Application Dialog 2. Change the desired settings as explained belo w: PDT Options Click on the arro w to access the fields’ pull-down lists. Default PDT type Determines the PSC por- table def aults. Select from one of two PSC por table types. Default Language Determines the language and font s[...]

The PPG Menubar 30 PT Program Generator (PPG) v5.0 3. Select OK to save your settings. This opens the dialog sho wn in Figure 13 on page 31 . Appearance Y ou can change the appearance of nodes with these fields. Font Press the Font Select button to open the Font dialog box shown in Figure 12 to change the f ont and size displa yed in the flow chart[...]

File Menu User’s Guide 31 Figure 13. Customize Options dialog 4. Select OK to apply the setting changes to all new applications. •P r e s s No to apply your changes only to the current application. •P r e s s Cancel to cancel your changes. Customize Display (Ctrl+Y) File > Customize Display from the menubar to open the Displa y Options dia[...]

The PPG Menubar 32 PT Program Generator (PPG) v5.0 Grid Each flow chart has a gr id background, which is useful in organiz- ing the nodes. Y ou can customize the grid to meet your needs . Snap to grid Enable Snap to grid to organize the flo w char t so that nodes automatically snap to the nearest grid point when they are mov ed. If this feature is [...]

File Menu User’s Guide 33 Recent Files Sele ct File > Recent Files from the menubar to show a list of recently opened PPG files. Figure 15. Recent Files Menu Y ou can select a file to open from this list. Fill color Select a fill color for the node from the pull-down list. Default = White . Outline color Select a outline color for the node fro[...]

The PPG Menubar 34 PT Program Generator (PPG) v5.0 Exit (Alt+F4) Sele ct File > Exit from the menubar to exit PPG. If you have made changes since the last time you saved the file, PPG will prompt you to sav e the file. Edit Menu The following topics are co vered in this section: • Selecting Objects on page 34 . • Moving Objects on page 35 . [...]

Edit Menu User’s Guide 35 box is the desired size and shape, r elease the mouse button. All objects within the box are selected. Y ou may then cut or copy all the selected objects and place them some where else, or drag all the selected objects with the mouse to a new location. Moving Objects T o move an object from one frame or program to anothe[...]

The PPG Menubar 36 PT Program Generator (PPG) v5.0 Delete (Del) T o delete a node or frame, select it and choose Edit > Delete from the menubar or press the Delete key . The object is removed along with any associated Links. Properties Sele ct Edit > Properties from the menubar to view the Properties dialog for both Function and Operation Nod[...]

Edit Menu User’s Guide 37 Operation Nodes Fo r Operation Node s you can also access the Pr oper ties dialog using the fol- lowing methods: • P oint to the node and double click with the left mouse button. • P oint to the node and click the right mouse button to activate a popup menu; select Properties . The Operation Node’ s Proper ties dia[...]

The PPG Menubar 38 PT Program Generator (PPG) v5.0 View Menu To a c c e s s View menu items, select Vie w > and then the specific menu item below you want to use from the menubar: • Show Calling Function on page 38 . • Show F rame/Subroutine Nodes on page 38 . • T oolbar on page 39 . • PPG Explorer on page 40 . • Status Bar on page 40 [...]

View Menu User’s Guide 39 Toolbar The PPG T oolbars can be turned on and off by toggling the appropriate menu items. U se these features to customiz e the way your copy of PPG looks and behaves. Select Vie w > T oolbar from the menubar . Figure 21. View T oolbars menu PPG Sele ct View > T oolbar > PPG . Selecting this menu item toggles t[...]

The PPG Menubar 40 PT Program Generator (PPG) v5.0 PPG Explorer Sele ct View > PPG Explorer to toggle the PPG Explorer on or off . Y ou can also click on the small X at the top right of the Explorer window to close it. The Explorer wind ow i s do cka ble , wh ic h me ans you can repo sit io n it to o the r locations. T o move it, click on the do[...]

Create Menu User’s Guide 41 • Input (Ctrl+Alt+I) on page 42 . • Output (Ctrl+Alt+O) on page 42 . • V erify (Ctr l+Alt+F) on page 42 . • Copy (Ctrl+Alt+C) on page 42 . • Modify (Ctrl+Alt+Y) on page 43 . • Math (Ctrl+Alt+M) on page 43 . • Call (Ctrl+Alt+L) on page 43 . • Link (Ctrl+Alt+N) on page 43 . • Data on page 43 . • Regis[...]

The PPG Menubar 42 PT Program Generator (PPG) v5.0 Function Nodes Frame (Ctrl+Alt+F) F or a thorough discussion of Frames , refer to F rames on page 50 . Subroutine (Ctrl+Alt+S) F or complete information on Subroutines , r efer to Subroutines on page 51 . Operation Nodes Menu (Ctrl+Alt+U) Menu nodes present a group of options on the portable ’ s [...]

Create Menu User’s Guide 43 Modify (Ctrl+Alt+Y) Modify nodes change the contents of a given register or file. R efer to Modify Nodes on page 67 . Math (Ctrl+Alt+M) Math nodes perform basic mathematical func tions on the contents of a register or file. Refer to Math Nodes on page 69 . Call (Ctrl+Alt+L) Call nodes branch to a subroutine. U pon comp[...]

The PPG Menubar 44 PT Program Generator (PPG) v5.0 Window Menu To a c c e s s Window menu items, select Windo w > and the desired menu item: • Cascade Windows on page 45 . • Tile Windows on page 45 . • Filename [F rame] on page 46 . Figure 23. Window Menu Sele ct More Windows... at the bottom of the Window menu to view a list of open frame[...]

Window Menu User’s Guide 45 Cascade Windows Sele ct Windows > Cascade from the menubar to arrange open windows as overlapping tiles. R efer to Figure 25 on page 45 , to view cascading windows. Figure 25. Windows Arranged by Cascading Tile Windows Sele ct Windows > Tile from the menubar to arrange open windows as non- overlapping tiles. R ef[...]

The PPG Menubar 46 PT Program Generator (PPG) v5.0 Figure 26. Windows Arranged by Tiling Filename [Frame] Sele ct Windows > Filename [Frame] from the menubar to bring a windo w hid- den behind other windows to the top or to expand a minimized Frame . 2342.book Page 46 Thursd ay, July 22, 2004 8:35 AM[...]

Help Menu User’s Guide 47 Help Menu To a c c e s s Help menu items, select Help > and then the specific menu item you want to use from the menubar: • PPG Help (F1) . • About PPG... . Figure 27. Help Menu PPG Help (F1) Sele ct Help > PPG Help to access the main Help menu. Y ou can also press <F1> or the Help button on many Dialogs [...]

The PPG Menubar 48 PT Program Generator (PPG) v5.0 NOTES 2342.book Page 48 Thursd ay, July 22, 2004 8:35 AM[...]

User’s Guide 49 Chapter 5 Creating & Using Nodes Overview This section contains the following topics: • Flow Chart Levels on page 50 . • F rames on page 50 . • Subroutines on page 51 . • Creating New Nodes on page 53 . • Menu Nodes on page 55 . • Display Nodes on page 56 . • Input Nodes on page 57 . • Output Nodes on page 60 .[...]

Creating & Using Nodes 50 PT Program Generator (PPG) v5.0 Flow Chart Levels After creating an empty application with the File New command, start in the main frame level. N odes at this level should include frames and subroutines defining major steps in the application. T ake advantage of the parent-child relationship to organize the application[...]

Flow Chart Levels User’s Guide 51 1. Select Create > Frame from the menubar . A new frame appears in the lower right corner of the frame wi ndow . The ne w frame is assigned a default name. 2. T o 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[...]

Creating & Using Nodes 52 PT Program Generator (PPG) v5.0 Figure 31 on page 52 shows the F rames level of a program that contains three subroutines: one for counting the data co llected in a file, one for verifying that data, and one for displaying the data. Call nodes within the program frames jump to the subroutines as needed. S ubroutine nod[...]

Creating New Nodes User’s Guide 53 2. T o 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 y ou want it, release the mouse button. Since subroutines ar en ’ t Linked to other objects, their locations are optional. N ormally , they ar[...]

Creating & Using Nodes 54 PT Program Generator (PPG) v5.0 2. T o position the node, move the pointer to it, hold down the left mouse button, and drag the node with the mouse. When the node is positioned where you want it, r elease the mouse button. 3. T o give the node a more useful name, double-click on it with the left mouse button , select E[...]

Creating New Nodes User’s Guide 55 Each node type also contains properties unique to its type. F or more details on each node type, all operation nodes are described in this section in the or der that they appear on the PPG toolbar and the PPG menubar . Menu Nodes A Menu node presents a gr oup of options on the por table ’ s screen and allows t[...]

Creating & Using Nodes 56 PT Program Generator (PPG) v5.0 • Or you can get a combination of Chinese characters and one of the system fonts. Enter menu text here, including titles or prompts y ou want to display . In gen- eral, each line of the screen is associated with one portable function key , although it is possible to have more th an one[...]

Creating New Nodes User’s Guide 57 Figure 33. The Dialog Box f or a Display node Input Nodes Input nodes specify how the portable will receive data. Y ou can use the dialog box for an Input node to indicate which sources of input (scanner , data keys, etc.) you want to accept. Figure 34. Input Node Property Dialog 2342.book Page 57 Thursd ay, Jul[...]

Creating & Using Nodes 58 PT Program Generator (PPG) v5.0 Input From Tab (Next Nodes) F or each selected input source , specify the frame or node to branch to. The pull-down list for this option lists each node in the frame or subroutine. S elect the next node to be completed for each input type. Y ou can specify a different Link for each type [...]

Creating New Nodes User’s Guide 59 Figure 35. Input Node: T rack Size T ab Display Tab The Echo to Displa y option determines whether th e received data is displayed on the portable ’ s screen. Figure 36. Input Node: Display T ab When this option is selected, you are prompted to specify ho w and where data is displayed. Y ou can select either t[...]

Creating & Using Nodes 60 PT Program Generator (PPG) v5.0 Store Info Tab Data Destination specifies where to store the input data. Figure 37. Input Node: Store Info T ab T o specify placement of the data in a register (refer to Using a Register as a Desti- nation on page 79 ), select Register in the Data Destination pull-down list. T o store th[...]

Creating New Nodes User’s Guide 61 Figure 38. The Output Node Properties Dialog Y ou can send a constant value or the cont ents 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. Y ou can also send com- mands to the display to repositi[...]

Creating & Using Nodes 62 PT Program Generator (PPG) v5.0 Special Commands Y ou can use an Output node to send special commands to the portable's dis- play or operating system. Creating Special Display Commands T o create a command to send to the display , complete the following steps: 1. Select Display as the Output to Device . 2. Select [...]

Creating New Nodes User’s Guide 63 4. F ill in the appropriate values and select OK . Y ou may combine multiple Output commands in a single command string. Creating Special System Commands Refer to the F alcon PT40 P roduct Refer ence Guide for a table of system com- mands. Next Node Next node specifies the next operation to perform depending upo[...]

Creating & Using Nodes 64 PT Program Generator (PPG) v5.0 Figure 40 on page 64 shows the V erify Information tab of the Ve r i f y node proper- ties dialog. Verify Information Tab Figure 40. The V erify Node Properties Dialog Data V erify Source specifies the location of the data to be verified—either a register or a file. The Sorted setting [...]

Creating New Nodes User’s Guide 65 Verify Options Tab Figure 41. V erify Node V erify Options T ab Data T ype Data type allows you to select the type the data should match ASCII values ASCII values (he x values 20 to 7F ) include alpha-numeric char- acters and symbols (such as brack ets, commas, dollar sign, and slash). Refer to ASCII/Hex Conv er[...]

Creating & Using Nodes 66 PT Program Generator (PPG) v5.0 Store Index Tab Figure 42. Store Index T ab The Store Index In Register option stor es in a register the number of the first record in the file that passes the verifica tion. If there is no match, it stores the position of the last recor d. Select a regi ster name from the list. This opt[...]

Creating New Nodes User’s Guide 67 Figure 43. The Copy Node Properties Dialog Copy From Tab Data Source indicates the data to be copied—either a constant or the contents of a register or file. If you choose Constant , y ou are prompted for a number or text string. If you choose Register or File , you are prompted to specify a loca- tion. F or m[...]

Creating & Using Nodes 68 PT Program Generator (PPG) v5.0 Figure 44. The Modify Node Properties Dialog Data to Modify Data source specifies the location of the data to modify . If you choose Register , select a register from the displayed R egist er list box. T o modify only one field of the register , select the Field type and select the Te m [...]

Creating New Nodes User’s Guide 69 Next Nodes Next node specifies the next operation to go to when the modify function suc- ceeds or fails. Math Nodes Math nodes perform basic mathematical operations on the contents of a file or regi ste r . Figure 45. Math Node Properties Dialog Reverse Rev erses the order of data in the specified register . F o[...]

Creating & Using Nodes 70 PT Program Generator (PPG) v5.0 F or example, you could multiply the cont ents of the default register by 3 and store the results in a r egister called Tr i p l e . Rather than supplying a constant (such as 3), you could specify another register that contains the number you want to multiply , add, subtract, or divide b[...]

Creating New Nodes User’s Guide 71 Operand 2 Tab The Operand 2 tab lets you specify a constant value or a file or register con- taining the second operand for the math ematical operation. The location of Operand 2 is displayed near the bottom of the dialog. Figure 47. Math Node: Operand 2 T ab F or more information on files and registers, r efer [...]

Creating & Using Nodes 72 PT Program Generator (PPG) v5.0 Next Nodes Tab Next specifies the node to branch to if the math operation passes and where to branch to if it fails. A math operation wi ll fail only if you attempt to divide a value by zero or operate on a nonnumeric value. Figure 49. Math Node: Next Nodes T ab Operation (Mathematical F[...]

Creating New Nodes User’s Guide 73 Figure 51. Call Node Properties Dialog Call Subroutine Click on the down-arro w button to the right of the input box to display a list of all subroutines within the program. S elect the subroutine you want to Call , and then select OK . A Call to a subroutine executes the specifie d subr outine and then returns [...]

Creating & Using Nodes 74 PT Program Generator (PPG) v5.0 T o draw a jointed Link (a Link with one or more bends), point to the source node, move the pointer to wher e you want the first joint to be, click the mouse again, and draw the next leg of the Link . Click inside a frame or node to com- plete the Link. Adjusting Links T o adjust an exis[...]

Automatically Generated Nodes User’s Guide 75 Automatically Generated Nodes Start Nodes S tart nodes point to the first node in each frame. The are created automatically by PPG when a frame or a subroutine is cr eated. Exit Nodes Exit nodes indicate where the frame ends and returns to its par ent frame. Exit nodes are created automatically b y PP[...]

Creating & Using Nodes 76 PT Program Generator (PPG) v5.0 NOTES 2342.book Page 76 Thursd ay, July 22, 2004 8:35 AM[...]

User’s Guide 77 Chapter 6 Managing Data Overview This section discusses methods for controlling data flow , data handling, and data organization. The following topics ar e covered: • Controlling Data Flow on page 78 . • Registers on page 78 . • Using a Register as a Source on page 78 . • Register Fields on page 79 . • Using a Register a[...]

Managing Data 78 PT Program Generator (PPG) v5.0 Controlling Data Flow There are four tools y ou can use to control the flow of data: Table 2. Data Flow Tools The following sections describe ho w to sele ct a register to store or access data, how to select a source or destination file, and ho w to create a template for breaking down or combining da[...]

Registers User’s Guide 79 Figure 52. The Source Register Options T o vie w a list of existing registers, click on the arro w to the right of the register list. T o select one of these registers, cl ick on it. T o create a new register , click on the New Register button. Register Fields T o select a specific field in the register , select the Fiel[...]

Managing Data 80 PT Program Generator (PPG) v5.0 Write Type T o select how the data is stored in the register , select the write type from one of these options: Specifying a Register Field If you enable the Field checkbox for the Register Sour ce or select Field as the Write T ype in a Register Destination , the template and field pull-down lists b[...]

Files User’s Guide 81 Register Example: Parsing Data Y ou 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 . C ustomize the appli- cation so it divides data into four separate files by re[...]

Managing Data 82 PT Program Generator (PPG) v5.0 Using a File as a Source Fr o m t h e Data Destination pull-down list, select File to make additional options available, as shown in Figure 55 ). Figure 55. Source File Options Sele ct fro m th e File pull-down list, or press the Ne w File button to create a new file. Enable the Record checkbox to se[...]

Files User’s Guide 83 Using a File as a Destination When you choose File as the destination, you ar e given options as shown in Figure 56 . Figure 56. Destination File Options Sele ct fro m th e File pull-down list, or press the Ne w File button to create a new file. Index Inde x lets you indicate a register where the number of the record you w a[...]

Managing Data 84 PT Program Generator (PPG) v5.0 Write Type T o indicate where the new information is stored in the selected file, select one of the following options: . Templates A template is a structure that you can define and use to alter the way in which collected data is stored. T emplates can be used only in registers, not in file reco rds .[...]

Templates User’s Guide 85 or with delimiters separating variable-len gth fields in the recor d, as in the fol- lowing: 2348,493848 48,393948 8,293832 9,832928 185,392038 28,282930 Once downloaded to the PC, this data fi le can be easily translated by a data- base or spreadsheet program. The first v alue in each record goes into a Loca- tion field[...]

Managing Data 86 PT Program Generator (PPG) v5.0 2. In the Create T emplate Name field, enter the name of the template you want to create. 3. On the left, you will see a list of al l currently defined fields. The list of fields currently contained in the template appears in the A vailable Fields list on the left. • T o add an existing field to th[...]

Fields User’s Guide 87 1. Create an Input node to do wnload a inventor y file from the PC to a portable file. 2. U se second Input node to store a scanned part number in a register named Part Number . 3. Copy the Part Number register to a Lookup regi st er . 4. Append ,* to the lookup key (wild car d lookup). 5. Lookup Lookup register against the[...]

Managing Data 88 PT Program Generator (PPG) v5.0 3. The Edit Field dialog is shown in Figure 59 . Figure 59. Edit Field Dialog Using Fields in Templates The most common use of templates is to parse data in a register . A template defines the structure used to access data. The fields are either set to a fix ed length (formatted into columns in the d[...]

User’s Guide 89 Chapter 7 PT40 Communication Overview This chapter describes how to communicate with the PSC PT40 portable data terminal (PDT). The following topics are co vered: • Downloading the Application to the PDT on page 89 . • What Happens During a Download? on page 91 . • Specialized Download Situations on page 92 . • Using XFER3[...]

PT40 Communication 90 PT Program Generator (PPG) v5.0 • The PSC P ort able Compiler window appears momentarily as PPG compiles the program, translating it into a language understood by the portable. Figure 60. PSC P or table Compiler Window •T h e o r i g i n a l *.scr file remains intact, and the compiled file is given the same name, but with [...]

Downloading the Application to the PDT User’s Guide 91 What Happens During a Download? During the application download pr ocess, a number of steps take place. F irst, the downloader checks the version numb er of the PT40’ s operating system. 1. The downloader allo ws you to ch oose from three different options. Figure 62. Updating the Operating[...]

PT40 Communication 92 PT Program Generator (PPG) v5.0 3. The F alcon PT40 can hold up to four applications. Choose the location where you want to load your new application. • Once you select a location, your application is do wnloaded. • If there was pr eviously an application in the location you select, that application will be remo ved and re[...]

Using XFER32 User’s Guide 93 • General T ab on page 93 . • T ransf er T ab on page 94 . • Logging T ab on page 96 . The settings in these dialogs can be modified or customized to meet your com- munications requirements. General Tab The General tab is the first tab displayed on the XFER32 Setup d i a l o g b o x . Us e this section to modify[...]

PT40 Communication 94 PT Program Generator (PPG) v5.0 Transfer Tab Sele ct the T ransfer tab to establish file transfer settings. Protocol Select either XModem or ACK/NAK as the file transf er Protocol f or sending and receiv- ing files. NO TE: The PT40 defaults to the ACK/NAK protocol unless y ou select XModem . XFER32 defaults to the ZModem Proto[...]

Using XFER32 User’s Guide 95 Figure 66. T ransfer T ab of the File T ransfer Utility Sender Timeout (Seconds) Enter the maximum number of seconds to w ait for a connection when sending files. A v alue of 0 waits indefinitely . Receiver Timeout Enter the maximum number of seconds to wait f or a connection when receiving files. A v alue of 0 waits [...]

PT40 Communication 96 PT Program Generator (PPG) v5.0 Logging Tab Sele ct the Logging tab to establish settings for the communications log. The communications log can be helpful as a trouble-shooting aid. Figure 67. Logging T ab of the File T ransfer Utility Sele ct OK to save the settings and close the setup functions. Sending and Receiving Data V[...]

Using XFER32 User’s Guide 97 Transmit (Send) Files 1. Select the T ransmit Files button. Figure 68. Send File to P or table Window 2. Select the file to send. 3. Click Open to send the file to the data collection terminal •P r e s s Cancel to not send any files 2342.book Page 97 Thursd ay, July 22, 2004 8:35 AM[...]

PT40 Communication 98 PT Program Generator (PPG) v5.0 Receive Files When receiving files from a data collection terminal, a prompt appears. Enter the name of the incoming file. 1. Select the Receive Files button. Figure 69. Receive File from P ortable Window 2. Select (or enter) a filename for the file. 3. Click Open to begin receiving the file. Pr[...]

User’s Guide 99 Appendix A PPG Tutorial Overview This tutorial reviews common PPG proced ures. I nstructions for the following tasks are available: • Studying a Sample Program on page 100 . • Building a Custom P or table Program on page 106 . • Creating F rames and Links on page 106 . • Creating the Main Menu Nodes on page 109 . • Creat[...]

PPG Tutorial 100 PT Program Generator (PPG) v5.0 Studying a Sample Program The easiest way to find out how a portab le program works is to study an exist- ing one. PPG comes with four sample prog ram files. This tutorial looks at the simplest of the four . Later , you will load it into your por table and collect and upload data with it. Complete th[...]

Studying a Sample Program User’s Guide 101 • The program is initially shown at what is called the P rogram level. This level contains a flow chart of the program's main functions. Each shape in the flowchart is either a function node or an operation node. Most of the nodes ar e Linked together with arrows, indicating the flo w of the progr[...]

PPG Tutorial 102 PT Program Generator (PPG) v5.0 7. Each program frame has sublevel flow charts, which break a pr ogram down into component parts. Double-click the Main Men u frame to view its flow chart. Figure 72. The Contents of the Main Menu frame 8. Double-click the Display: Options node to view its Propert ies (refer to Figure 73 ). Figure 73[...]

Studying a Sample Program User’s Guide 103 10. Select the X (close button) on the top right of the Main Menu title bar to return to the higher level of the program. • Or choose the View > Sho w Calling Function to go back to the Sample Frame level. 11. Double-click the Collect frame to view its contents (refer to Figure 74 ). Figure 74. The [...]

PPG Tutorial 104 PT Program Generator (PPG) v5.0 13. Double-click the Upload frame to view the upload nodes (refer to Figure 75 ). Figure 75. The Contents of the Upload frame 14. Close the Upload frame window to go back to the Program level. 15. Double-click the Erase frame to view its nodes (refer to Figure 76 ). Figure 76. The Contents of the Era[...]

Studying a Sample Program User’s Guide 105 Figure 77. The Contents of the Pad Zer os subroutine 18. Close the Pad Zer os subroutine window and to return to the Pr ogram level. By looking at all the pieces of this pr ogram file, you can get a general idea of how the program is put together . The Pr ogram flow chart defines the major tasks of the p[...]

PPG Tutorial 106 PT Program Generator (PPG) v5.0 Building a Custom Portable Program At this point, you should understand the general concepts behind cr eating and loading a portable program, although many of the details have yet to be explained. In this section, you'll create a simple portable program from scratch. I t will allow you to collec[...]

Building a Custom Portable Program User’s Guide 107 Figure 78. Main Application Level of the Program 4. Click the right mouse button and select Properties (or select the frame and choose Edit > Properties from the menu) to display the Frame Properties dialog. T ype Main Menu in the Name field and select OK . The frame now appears with the name[...]

PPG Tutorial 108 PT Program Generator (PPG) v5.0 2. M ove the Link cursor to the Main Menu frame and click the left mouse button. 3. M ove the Link box to the Collect Data frame and click the mouse again. An arrow appears, pointing from the Main Menu frame to the Collect Data frame. 4. Select Create > Link f r o m t h e m e n u b a r, c l i c k [...]

Building a Custom Portable Program User’s Guide 109 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. Operation nodes involve more detailed information than frames and ar e divided into nine node types, with a di fferent dialog box associated wi[...]

PPG Tutorial 110 PT Program Generator (PPG) v5.0 2. Reposition the existing nodes as shown in Figure 80 on page 110 . Figure 80. Repositioned nodes 3. Select Create > Menu from the menubar . A Menu node opens in the lower left of this second windo w . 4. Right-click the Menu node and select Properties from the pop-up menu. Or select Menu > Pr[...]

Building a Custom Portable Program User’s Guide 111 Figure 81. The completed Main Menu nodes 8. Right-click the Menu: Options node and select Pr opert ies to display the node ’ s Properties . The dialog includes a text-entr y area, called Display , that represents the portable ’ s screen (refer to Figure 82 ). Figure 82. The Menu: Options Dia[...]

PPG Tutorial 112 PT Program Generator (PPG) v5.0 10. Use the keyboar d navigation keys to skip the next line and go to the third line. Enter Collect Data in the Display area. 11. Go to the 4th line and enter Upload Data , as shown in Figure 83 . • T o the left of the text-entr y area are checkbox es for function keys used to select options presen[...]

Building a Custom Portable Program User’s Guide 113 15. Select OK to exit the dialog box. Then close this frame to return to the Program lev el of the application. Saving Your Program E ven though the program's not complete, it's a good idea to save it periodi- cally while you are cr eating it. Select File > Save to save the program [...]

PPG Tutorial 114 PT Program Generator (PPG) v5.0 Create nodes for the Collect Data frame by completing the follo wing steps: 1. If you're returning fr om a break after exiting PPG, double-click on the PPG icon in the PT P rogram Generator . Then choose File > Open and select tutorial.scr from the file list. Select OK to load the file into t[...]

Building a Custom Portable Program User’s Guide 115 3. Create all the nodes shown in Figure 84 on page 114 , using commands on the Create menu or icons on the T oolbar . Each node's type is indi- cated by the first line of text in the node. Rename each node accor d- ing to the second line of text. Link the nodes together as shown. The Displa[...]

PPG Tutorial 116 PT Program Generator (PPG) v5.0 2. On the Input Fr om tab, the Input From checkbo xes let you indicate which sources of input you want the portable to accept. Select the Scanner , Data Ke y , and Function Key checkboxes. This allo ws the user to input data by scanning or pressing keys. Figure 86. The Input: Item Properties Dialog: [...]

Building a Custom Portable Program User’s Guide 117 Figure 87. The Input Properties: Display T ab 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 T ab 6. Click on the Store Info tab . Select Register from the Data Desti- nation pull-down list, as sho wn [...]

PPG Tutorial 118 PT Program Generator (PPG) v5.0 7. P ress the New Register button to open a Create Register windo w . Enter Inventory in the Create Register field to create a new Reg- ister named In ventory . P ress OK . 8. In the Write type pull-down list, select Overwrite to clear existing data from the register before storing newly input data. [...]

Building a Custom Portable Program User’s Guide 119 The Output: Error Beep Node N ow you need to set the Output node to sound a beep . Complete the follow- ing steps: 1. Double-click the Output: Error Beep node to display its dialog box. Figure 91. The Output: Error Beep Dialog Bo x 2. On the Inf ormation to Output tab, select System as the Outpu[...]

PPG Tutorial 120 PT Program Generator (PPG) v5.0 The Copy: To File Node F inally , you need to set up the Copy: T o File node to copy data from the Inven- tory register to a portable file for transmittal back to the PC. Each time ne w data is scanned or entered, existing data in the In ventory reg ist er is re pla ced . Therefore, the data must be [...]

Building a Custom Portable Program User’s Guide 121 Creating and Setting Up the Upload Data Nodes The last frame, Upload Data , allows the user to copy collected data from the portable’ s file to a file on the PC. Y ou will set up nodes that do the following: • Display a menu asking if the user wants to upload data. •I f t h e r e s p o n s[...]

PPG Tutorial 122 PT Program Generator (PPG) v5.0 The Menu: Confirmation Node Complete the following steps to set up this node: 1. Double-click on the Menu: Confirmation node to ope n i ts di al og, an d enter the text shown in Figure 95 . Leave the second line blank. Figure 95. The Menu: Confirmation Dialog 2. Enable the <F3> checkbox. Select[...]

Building a Custom Portable Program User’s Guide 123 Figure 96. The Output T o: PC Dialog Box 3. F rom the Data Source pull-do wn list, select File . F rom the File pull-down list select Monthly Inventory . 4. On the Next Nodes tab, select Display Successful from the Next Node field and Output Error Beep from the On Error field. 5. P ress OK to sa[...]

PPG Tutorial 124 PT Program Generator (PPG) v5.0 Enable <F4> and choose Exit Main Menu to return to the Main Menu if the user presses <F4> . Figure 97. New text f or the Menu: Err or T ext node 3. P ress OK to save your settings and exit the dialog box. The Display: Successful Node Complete the following steps to set up this node: 1. Se[...]

Building a Custom Portable Program User’s Guide 125 3. Enable the TimeOut checkbox. Enter 45 in the Seconds pull-down list that appears next to TimeOut . This instructs the program to return to the Main Menu if the user presses a function key or if 45 seconds pass with no input. 4. P ress OK to save your settings and exit the dialog. The Modify: [...]

PPG Tutorial 126 PT Program Generator (PPG) v5.0 Want a Break? If you are r eady for a break, you can easily stop here. Y ou have not made any changes that need saving, so you won ’ t lo se any work if you exit PPG or turn off your computer . Loading and Using the Program N ow that your program is tested and complete, it's time to load it in[...]

Loading and Using the Program User’s Guide 127 1. Double-click on the PPGXFER window's Contr ol-menu box or select File > Exit to close the window . (If downloading was unsuccessful, choose Abort from the menubar first.) 2. Double-click on the Contr ol-menu box in the Compiler window to close it. 3. Disconnect the portable from the cable,[...]

PPG Tutorial 128 PT Program Generator (PPG) v5.0 Creating and Using Templates The programs you've worked with so far handle singular information: Y ou scan or enter one code at a time, and the data is stored one entry per line. But suppose you wanted to collect sets of different types of data. I f you were taking inventory , for example, rathe[...]

Creating and Using Templates User’s Guide 129 •A n e w Display node that will prompt the user to enter a quantity value after an item number is entered •A n e w Input node that will use a template to store the quantity value in a register field •T w o Output nodes that will display the last-entered item and quantity values as a pair Y ou wi[...]

PPG Tutorial 130 PT Program Generator (PPG) v5.0 3. At the Pr ogram level, select the Collect Data frame, and reposition the nodes as shown in Figure 100 . 4. Delete the Link from the Ve r i f y node to the Copy node. 5. Adjust the Links from the Copy node to the Display node and from the Input node to the Exit node so that they are no longer joint[...]

Creating and Using Templates User’s Guide 131 7. Select the new Displa y node ( Display: How Man y? ).’ •E n t e r How Many? on the 1st line and Menu on the 4th line. •P r e s s OK . 8. Skip o ver the two Output nodes for now , and select the new Input node ( Input: Quantity ). •O n t h e Input From tab, enable the Data Key and Function K[...]

PPG Tutorial 132 PT Program Generator (PPG) v5.0 Figure 102. The Create T emplate Dialog •P r e s s t h e New T emplate button to open a Create T emplate dialog. •E n t e r Combine for the name of the new template. 3. Create the field names and define their lengths. •C l i c k o n t h e Create Field button to display a Create Field dialog. Fi[...]

Creating and Using Templates User’s Guide 133 4. Select Create Field , and enter Quantity in the Field Name box. • Select Va r i a b l e , enter a space in the Delimiter field and press OK . •T h e Quantity field should appear on the Create T emplate dialog in the list of available fields. 5. Define the order of the fields in the template. ?[...]

PPG Tutorial 134 PT Program Generator (PPG) v5.0 •P r e s s OK . 10. T o display the contents of the In ventory register at the cursor position on the portable’ s screen, select the Output: Register node, select Inventory from the Register pull-down list, and press OK . 11. Select File > Save to store the changes you hav e made. 12. Connect [...]

User’s Guide 135 Appendix B Example Frames This section provides examples of several commonly used Frames you can u se in your custom PPG application. The program source files ( *.scr file) for the example frames are installed during PPG installation; they are installed b y default in c:Program FilesPSCPPG50TIPSRC . T opics covered include: ?[...]

Example Frames 136 PT Program Generator (PPG) v5.0 Setting the Date and Time All PSC portables include a clock that keeps track of the current date and time. T o allow users to adjust the date and time settings, complete the follow- ing steps: 1. Create a new Output node. 2. Set the Output Destination to System . 3. Select Constant as the Data Sour[...]

Displaying the Contents of a Register User’s Guide 137 Displaying the Contents of a Register Tip04.scr , illustrated in Figure 104 , displays the contents of a register on the portable, using two Output nodes as follows: Figure 104. Tip04.scr Flow Chart 1. Creates a new Output node, called Po s i t i o n .This Output node sends information to the[...]

Example Frames 138 PT Program Generator (PPG) v5.0 2. Creates a new Output node, called Scan . This Output node writes the register contents starting at the cursor position. • Selects Output to Display . • Chooses Register from the Data Source pull-do wn list. • Chooses Default Register from the Register pull-down list. The first Output node [...]

Sample Verification Methods User’s Guide 139 Figure 106. V erify Information T ab: Register Data Source 3. On the V erify Options tab, select Numeric as the Data T ype . Figure 107. V erify Options T ab: Numeric Data T ype Verifying that a Number is an Integer Another type check that may be needed is to confirm that data is an integer , rather th[...]

Example Frames 140 PT Program Generator (PPG) v5.0 Tip15.scr , illustrated in Figure 108 on page 139 , confirms that data is an integer and performs the following steps: 1. Display V erify Intege r . Figure 109. Display Integer T est 2. Enter the value to check. Figure 110. Display Input V alue 3. V erify that the value is numeric (checks for any v[...]

Sample Verification Methods User’s Guide 141 Figure 111. V erify Numeric 4. V erify 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. V erify No e 5. Check for a . (decimal point) (values with fractions are not integers). Figure 113. V erify Decimal 2342.book Page 14[...]

Example Frames 142 PT Program Generator (PPG) v5.0 6. Displays the result ( pass/fail ). Figure 114. Displays P ass or Fail Verifying Input Size T o verify that a scanned or entered code is a given number of characters or within a given range, use the Size to Register option in the Input node collect- ing the data. This option stores the numb er of[...]

Sample Verification Methods User’s Guide 143 Figure 115. Tip05.scr V erifies Input Size In the example, the Input node named Store puts the number of characters into a register using the size to register option. B e sure to use different registers to store the size and the input. The Ve r i f y node named Size then verifies that the input is betw[...]

Example Frames 144 PT Program Generator (PPG) v5.0 Figure 116. The Input: ST ORE Dialog Figure 117. The V erify: SIZE Dialog Ve r i f y : E X I T Checks to see if the user pressed <F4> . If so , it exits the frame. Ve r i f y : S I Z E Checks the v alue stored in the Input Size register. The options in its dialog bo x are set as shown in Figu[...]

Downloading a File to a PSC Portable User’s Guide 145 Downloading a File to a PSC Portable U sually , users will need to upload file s containing scanned or input codes to a host computer . How ever , it is sometime s necessar y to download a file from a host to a portable. F or example, you might have an inventory file that you need to check sca[...]

Example Frames 146 PT Program Generator (PPG) v5.0 Figure 119. The Input: T O FILE Dialog T o download a file to a portable, set options for the Input node as follows: Ve r i f y : D N L D Checks to see if <F3> w as pressed and, if it was, continues to the Dis- play node . If <F3> was not pressed, the program loops bac k to the Input no[...]

Finding the Number of Records in a File User’s Guide 147 Finding the Number of Records in a File The easiest way to determine the number of recor ds in a file is to use a Ve r i f y node with Match set to a value you know is not in the file and the Store Index in Register checkbox selected (with a register specified for storing the index value). [...]

Example Frames 148 PT Program Generator (PPG) v5.0 Searching for a Partial Match A partial match for data in a file may be searched for using the wild card char- acters “ ~ ” and “ * ” and a Ve r i f y node. By inserting “ ~, ” on the front and appending a * to the end of a register containing the desired partial match data and searchin[...]

Searching for Data in a File User’s Guide 149 Figure 121. Tip08 4. In the Ve r i f y node V erify Information tab , select File as the Data Ty p e . and Default File as the File type. 5. In the Ve r i f y node, V erify Options tab, select ASCII as the Data T ype , Register as the Comparison type, and Default Register as the Register type. Searchi[...]

Example Frames 150 PT Program Generator (PPG) v5.0 Location Asset # Date Time Example data: Room 1,12345,2/24/2003,13:39:53 Room 1,12346,2/24/2003,13:39:58 Room 2,12347,2/24/2003,13:45:33 Room 2,12348,2/24/2003,13:39:43 If duplicate Asset #'s are to be disallo wed, the Asset # must be looked up in the second field and, if found, display a mess[...]

Splitting Records into Two Files User’s Guide 151 Splitting Records into Two Files = When verifying only a part of a recor d, you can accelerate the process by split- ting the recor d into two different files and referencing each file ’ s index posi- tion. F or example, if you had a file wi th the following recor ds showing item numbers and des[...]

Example Frames 152 PT Program Generator (PPG) v5.0 Figure 122. Splitting Records into T wo Files Display: W AIT Instructs the user to wait while the PSC portable completes this process. Copy: END Places the constant “end” at the end of the file to mark the last record. Copy: 1ST REC Copies the first record in the file into the def ault register[...]

Referencing Two Different Files User’s Guide 153 Referencing Two Different Files Tip10.scr , illustrated in Figure 123 on page 153 , uses two data files: one that contains item numbers and one that co ntains item descriptions. Recor ds in both are sorted identically . By refer encing data in both files, this example dis- plays the description of [...]

Example Frames 154 PT Program Generator (PPG) v5.0 Figure 124. The V erify: IN FILE Dialog Figure 125. The Copy: INDEX Dialogs Display: NO MA TCH If there is no match, Display: NO MA TCH instr ucts the user to enter the item number again and loops back to Input: ITEM . Copy: INDEX If there is a match, the index ed position is put into a second regi[...]

Reviewing a File User’s Guide 155 Reviewing a File Tip11.scr , illustrated in Figure 126 on page 155 , lets the user review the con- tents of a file, one record at a time. Figure 126. Tip11.scr Reviews a File Copy: END Copies the constant “end” to the end of the default file to mark the last record. Copy: INDEX=1 Copies the number 1 into a re[...]

Example Frames 156 PT Program Generator (PPG) v5.0 Figure 127. The Output: INDEXED Dialog The loop continues until the “ end” record is r eached, at which point the pro- gram deletes the “ end” record and exits the frame. The file is displayed one recor d at a ti me on the screen. Each time the user presses a key , the next record is displa[...]

Sounding a Beep User’s Guide 157 Sounding a Beep T o sound a beep on a por table, use an Output node with the Source option set to Constant and Destination set to System . Figure 128. Output Beep Node In the constant field, enter the human readable text of one of the follo wing codes: Y ou can enter more than one code, for multiple tones. F or ex[...]

Example Frames 158 PT Program Generator (PPG) v5.0 Figure 129. Tip14.scr Pads a Number with Leading Zer os This technique can be used with any fixe d length by simply changing the fix ed length of the second template and pro viding enough zeros in the Copy node. Copy: QTY Copies the quantity value in the def ault register into the INPUT SIZE regist[...]

User’s Guide 159 Appendix C The PPG Library 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 pr o- vide any functional value. Y ou can download these files from the [...]

The PPG Library 160 PT Program Generator (PPG) v5.0 COMPILE.SCR A collect-only program that counts the number of duplicate entries in a file. Output f or mat: item,repeats. CONFIG.SCR A program that allo ws the user to scroll through and change system parameters from a list that is loaded into the portable. FIELDS.SCR A shor t program that demonstr[...]

PPG Program Source Files User’s Guide 161 MUL TIPLE.SCR A multiple-option program that includes a Collect node with a compile option; an item/quantity option; a pick list; a calculator; and a clock option. MUL TPLE2.SCR A large program (342 nodes, with 8 separate programs) that has the same options as MULTIPLE.SCR plus a modem communications prog[...]

The PPG Library 162 PT Program Generator (PPG) v5.0 NOTES 2342.book Page 162 Thursd ay, July 22, 2004 8:35 AM[...]

User’s Guide 163 Appendix D PPG System Commands Overview T o 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 pro vided in this section: • Using Predefined Defaults on page 1[...]

PPG System Commands 164 PT Program Generator (PPG) v5.0 Using Predefined Defaults The PSC F alcon 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 T able 3 on page 164 . Table 3. Prede fined Defaults for the PT40 Predefined Defaults Default Name Bar Code Descr[...]

Alternate Parameters User’s Guide 165 Alternate Parameters Enter these commands by scanning the bar codes with the PT40’ s laser or through the PC’ s serial port. Y ou can al so embed these codes in a PPG applica- tion. The F alcon PT40 recognizes the bar code commands in T able 4 on page 165 . Table 4. Scannable Bar Codes of Alternate Settin[...]

PPG System Commands 166 PT Program Generator (PPG) v5.0 CA UTION Reset Mode Clears all memory and resets the portable. *+ . * 2342.book Page 166 Thursd ay, July 22, 2004 8:35 AM[...]

User’s Guide 167 Appendix E: ASCII/Hex Conversion Table ASCII Hex ASCII He x ASCII He x ASCII He x NUL 00 SP 20 @ 40 60 SOH 01 ! 21 A 41 a 61 STX 02 “ 22 B 42 b 62 ETX 03 # 23 C 43 c 63 EO T 04 $ 24 D 44 d 64 ENQ 05 % 25 E 45 e 65 ACK 06 & 26 F 46 f 66 BEL 07 & 26 G 47 g 67 BS 08 ( 28 H 48 h 68 HT 09 ) 29 I 49 i 69 LF 0A * 2A J 4A j 6A [...]

ASCII/Hex Conversion Table 168 PT Program Generator (PPG) v5.0 NOTES 2342.book Page 168 Thursd ay, July 22, 2004 8:35 AM[...]

User’s Guide 169 Appendix F Useful Bar Codes File Dump Program Mode Set Date Set Time <CR> Only Protocol A CK/NAK Protocol Xmodem Protocol *$ $* */ .* *% . * *% - * *$ + $ - C A 0 0 E E * *$ + $ - C A 0 1 E E * *$ + $ - C A 0 2 E E * 2342.book Page 169 Thursd ay, July 22, 2004 8:35 AM[...]

Useful Bar Codes 170 PT Program Generator (PPG) v5.0 Reset Factory Defaults *$ + S- D 2 C 8 E E * 2342.book Page 170 Thursd ay, July 22, 2004 8:35 AM[...]

User’s Guide 171 Appendix G Troubleshooting Overview U se this section to solve common problems you might have while using PPG. F ollowing is a list of troubleshooting topics: • Fixing Corrupted Files on page 171 . • Error Messages on page 173 . • T echnical Suppor t on page 178 . Fixing Corrupted Files Occasionally a file becomes corrupt a[...]

Troubleshooting 172 PT Program Generator (PPG) v5.0 Downloading the Program to the Portable If a few seconds pass with no messages, PPG was unable to make a connection with the portable • Select a different serial port by selecting Options > Settings . Then select the File > Program the P ortable to tr y again. • Make sure that the cable [...]

Error Messages User’s Guide 173 Error Messages This section lists error messages that you might come across in the PT P ro- gram Generator . F ollowing each error message is a possible solution and, where applicable, a refer ence to the sect ion of this manual in which you can find more information about solving the problem. If y ou continue to h[...]

Troubleshooting 174 PT Program Generator (PPG) v5.0 In valid file access code. 1 – 3 valid. Contact PSC T echnical Suppor t In valid grid value. Enter any non- zero numeric v alue in both grid size fields and select OK. Y ou have entered a z ero or no value f or one or both grid size fields. Set both grid size fields to non-zero v alues and press[...]

Error Messages User’s Guide 175 PPGComp Error Messages T able 7. PPGComp Error Messages Unrecognized node type found An unrecognized node type has been read. This usually indicates that the .scr file has been corrupted. Contact T echnical Suppor t for assis- tance. Error Messa g e Description Can't access PPGXFER tool to download application[...]

Troubleshooting 176 PT Program Generator (PPG) v5.0 PPGXfer Error Messages T able 8. PPGXFER Error Messages Error with <sour ce file name> An error occurred while reading the source file. Mak e sure you selected the correct source file . Open the file with PPG and verify that it appears as e xpected. If the message per- sists, contact PSC T e[...]

Error Messages User’s Guide 177 P or table successfully programmed The application w as successfully downloaded to the PDT . BEL received - Aborting. These errors indicate that PPGXfer receiv ed an une xpected response from the PDT . Reset the PDT and tr y the download again. No response - Aborting. T oo many NAKs - Aborting Unknown response - Ab[...]

Troubleshooting 178 PT Program Generator (PPG) v5.0 Technical Support PSC Website Support PSC’ s website ( www .pscnet.com) is the complete source for technical support and information for PSC products. The site offers PSC’ s new T ekF orum, product support, product registration, warranty information, product F AQs (frequently asked questions),[...]

User’s Guide 179 Appendix H Glossary This section contains definitions for terms used in this manual. Review and familiarize yourself with these terms before using PT Program G enerator (PPG) to create custom programs. Call node A Call node ex ecutes a branch to a subroutine. columns The display screen of y our PSC por table is divided v er tical[...]

Glossary 180 PT Program Generator (PPG) v5.0 input Input is the information gathered during data collection or the action of gathering the information. Input node An Input node designates what type of por table input is acceptab le and where the input is stored. jointed Link A jointed Link is a Link that has two or more segments intersecting at an [...]

User’s Guide 181 register A register is a temporary holding place for up to 128 characters of data. When you scan a bar code with a portable, the code is stored in a register until it is verified and copied into a file f or safek eeping. The contents of the register are ov erwritten each time you scan a code. rows The display screen of the PSC F [...]

Glossary 182 PT Program Generator (PPG) v5.0 NOTES 2342.book Page 182 Thursd ay, July 22, 2004 8:35 AM[...]

User’s Guide 183 I NDEX A adjusting frames 51 , 53 , 54 , 73 jointed links 108 links 74 , 108 , 109 , 110 , 130 arrows see links axes, grid settings for 30 , 32 B bar codes for programming 165 beeper bar codes for 165 beeps 119 setting tone of 157 bits eighth, clearing from data 69 box size for frames and nodes 30 , 32 breakpoints 179 buttons rad[...]

184 PT Program Generator (PPG) v5.0 objects 35 Create menu Frame 51 , 52 Link 73 creating frames 50 , 106 jointed links 74 , 108 links 107 from Output nodes 122 nodes 53 , 114 program source files 24 registers 117 subroutines 52 Cut command 35 , 36 compared with Delete 36 Cut vs. Delete, using 36 cutting objects 35 D data breaking into fields in a [...]

User’s Guide 185 eighth bit, clearing from data 69 enlarging the PPG window 13 erasing contents of registers, fields, or files 69 error messages 173 displaying on portable screen 119 Exit command 90 F fields 43 , 78 , 80 , 87 , 128 , 179 creating for templates 131 creating from data in a register 81 defining 86 erasing contents of 69 storing data[...]

186 PT Program Generator (PPG) v5.0 controlling flow of 77 copying to a file 66 destination for 60 echoing 59 modifying 67 size, verifying 142 storing in fields 60 in files 60 in registers 60 verifying 63 Input nodes 57 , 180 Input Item 115 Input Timeout Display 124 linking to other nodes or frames 58 J jointed links 180 adjusting 108 creating 74 ,[...]

User’s Guide 187 moving frames 51 , 53 , 54 , 73 links 35 , 74 , 108 , 109 , 110 objects 35 N naming files 120 frames 51 , 53 , 54 , 107 New command 24 nodes 53–64 , 180 Call 53 , 72 , 179 changing fonts in 30 Copy 66 , 179 Copy To File 120 copying 35 creating 53 , 114 for templates 129 cutting 35 deleting 36 Display 56 , 179 Display Enter Item[...]

188 PT Program Generator (PPG) v5.0 erasing 69 moving data to and from 66 naming 120 portables allowing data input from 58 beeps 119 setting tone of 157 default communications settings bar code for 170 downloading files to 145 echoing input to screen 59 function keys allowing input from 58 assigning to menu items 56 keys 3 programming 14 screen cle[...]

User’s Guide 189 frames 51 , 53 , 54 , 107 replacing data 68 resetting default communications settings bar code for 170 resetting the portable bar code for 166 reversing order of data 69 right click 3 S sample applications 10 , 11 Save As command 26 Save command 25 saving program source files 26 scanned data, translating 14 scanner, allowing inpu[...]

190 PT Program Generator (PPG) v5.0 W wand, allowing input from 58 wildcards 63 windows enlarging 13 maximizing 13 minimizing 13 reducing 13 windows controls 3 X XFER32 general tab 93 logging tab 96 transfer tab 94 Z zeros, padding values with 157 zoom in command 13 zoom out command 13 2342.book Page 190 Thursd ay, July 22, 2004 8:35 AM[...]

2342.book Page 191 Thursd ay, July 22, 2004 8:35 AM[...]

Asia P acific PSC Hong K ong Hong K ong T elephone: [852]-2-584-6210 F ax: [852]-2-521-0291 Au s t r a l i a PSC Asia P acific Pty Ltd. Nor th Ryde, A ustralia T elephone: [61] 0 (2) 9878 8999 F ax: [61] 0 (2) 9878 8688 France PSC S.A.R.L. LES ULIS Cedex, F rance T elephone: [33] .01.64.86.71.00 F ax: [33].01.64 46.72.44 Germany PSC GmbH Darmstadt,[...]