Allen-Bradley 1747-PBASE Programming Manual Download Page 125

Page: 125 / 144

Publication 1746-PM001A-US-P

BASIC Macro Library

A-3

Keyboard Functions

The following table describes the macro CALLs that you use to perform keyboard
functions.

background_black()

Prints text with the background black.

None

background_red()

Prints text with the background red.

None

background_green()

Prints text with the background green.

None

background_yellow()

Prints text with the background yellow.

None

background_blue()

Prints text with the background blue.

None

background_magenta()

Prints text with the background magenta.

None

background_cyan()

Prints text with the background cyan.

None

background_white()

Prints text with the background white.

None

blink_off()

Has no special attributes.

None

lines()

Shows the user how fancy screens can be drawn.

None

Table A.1 Operation Macros

Screen Macro CALLs

Macro

Inputs

Outputs

Table A.2 Keyboard Macros

Keyboard Macro CALLs Macro

Inputs

Outputs

hit_any_key()

Prints

Hit any key to continue

, then waits on a program

port key to be hit.

None

get_key(%1)

Gets the next key typed and places its ASCII decimal value in %1.

None

%1 = next key typed

get1_key(%1)

Gets the next character from PRT1.

None

%1 = next character

get2_key(%1)

Gets the next character from PRT2.

None

%1 = next character

Summary of Contents for 1747-PBASE

Page 1: ...BASIC Development Software Catalog Numbers 1747 PBASE Programming Manual ...

Page 2: ...ion SGI 1 1 Safety Guidelines for the Application Installation and Maintenance of Solid State Control available from your local Rockwell Automation office describes some important differences between solid state equipment and electromechanical devices that should be taken into consideration when applying products such as those described in this publication Reproduction of the contents of this copy...

Page 3: ...th the BASIC or BASIC T Module 1 2 Installation Procedure 1 3 Directory Structure 1 5 Backing up Your Software 1 6 Chapter 2 Getting Familiar with Your Development Software Starting Your Software 2 1 Toplevel Menu 2 2 Main Menu 2 2 Status Line 2 3 Message Line 2 4 Function Keys 2 4 Using Help Outside a Program 2 4 Using Help Within a Program 2 5 Typical Pull down Menu 2 5 Navigating Within Windows...

Page 4: ...12 Autosave 3 12 Search and Replace Defaults 3 13 Terminal Emulation Mode Selection 3 13 Save Configuration and Exit 3 14 Chapter 4 Editing a Program Using Simple Editing Techniques 4 1 Searching Operations 4 2 Using Block Operations 4 3 Text Formatting Undo and Redo 4 6 Advanced Editing Techniques 4 7 Drawing Lines 4 8 Using the Calculator 4 9 The ASCII Table 4 9 Using Windows 4 9 Using Keystroke...

Page 5: ... Macros 6 10 Merging a Program File 6 10 Creating a Second Program 6 11 Entering the Program 6 11 Translating 6 13 Downloading 6 15 Executing 6 15 Chapter 7 Printing Your Program Setting Up Your Printer 7 1 Printer Selection 7 2 Printer Setup 7 3 Printer Device File 7 3 Serial Printers 7 4 Using the Printer Controls 7 5 Copies to Print 7 5 Line Numbering 7 5 Print Margin 7 5 Eject Page 7 5 Printin...

Page 6: ...ations Setup 9 14 Autobaud 9 15 General Setup Parameters 9 16 Terminal 9 16 Com Port Settings 9 16 Colors 9 17 Save Setup 9 17 DH485 Communications Setup 9 18 Attach 9 18 General Setup Parameters 9 19 Terminal 9 19 Com Port Settings 9 20 Who Active 9 21 Who Listen 9 22 Colors 9 22 Save Setup 9 22 Appendix A BASIC Macro Library Library Overview A 1 Screen Functions A 2 Keyboard Functions A 3 SLC Ba...

Page 7: ...Publication 1746 PM001A US P Table of Contents v Appendix B The DOS Directory Shell Using the DOS Directory Shell B 1 DOS Directory Shell Operation B 2 File Operations from the DOS Directory Shell B 4 ...

Page 8: ...Publication 1746 PM001A US P Table of Contents vi ...

Page 9: ... Use this manual if you are responsible for designing installing programming or troubleshooting control systems that use Allen Bradley small logic controllers You should have a basic understanding of SLC 500 products PLC products and 1771 and 1746 I O products You should understand programmable controllers and be able to interpret the ladder logic instructions required to control your application ...

Page 10: ...oving blocks of text text formatting and advanced editing features 5 Manipulating Files Provides information on file management from simple loads saves and merges to creating your own User Menus 6 Writing Programs Using the BASIC Development Language Begins with an overview of the BASIC language macros and program organization A second sample program is written translated and downloaded 7 Printing...

Page 11: ...00 System Overview 1747 SO001A US P A description of how to install and use a Modular SLC 500 Processor Modular Hardware Style Installation and Operation Manual 1747 6 2 A reference manual that contains status file data and instruction set information for SLC 500 processors SLC 500 and MicroLogix 1000 Instruction Set Reference Manual 1747 6 15 A description of how to install and use a module that ...

Page 12: ...le a BASIC program file filename extension the characters to the right of the filename and period Hypertext help a context sensitive help system that allows access to help from practically any point in the BASIC Development Software keystroke macros a recorded series of keystrokes invoked by one keystroke to reduce the number of keystrokes needed to perform a function memory module BASIC or BASIC ...

Page 13: ...e progression to arrive at a screen through a QuickStroke is shown as follows QuickStroke SHIFT F5 Rockwell Automation Support Rockwell Automation offers support services worldwide with over 75 Sales Support Offices 512 authorized Distributors and 260 authorized Systems Integrators located throughout theUnited States alone plus Rockwell Automation representatives in every major country in the worl...

Page 14: ...ual please notify us of it on the enclosed Publication Problem Report If you have any suggestions for how this manual could be made more useful to you please contact us at the address below Rockwell Automation Control and Information Group Technical Communication Dept A602V P O Box 2086 Milwaukee WI 53201 2086 ...

Page 15: ...ent Software programs for downloading to the module windows that allow you to edit up to 100 files or different parts of the same files simultaneously adjacent window function for easy movement between split windows pull down menu system and QuickStroke shortcuts dynamic display function key labels with Shift Ctrl and Alt keys user definable keystroke macros that allow you to replace a series of c...

Page 16: ...place and multi file search functions multiple default directories based on file extensions bas files in one directory bdl files in another The BASIC Development Software requires an MS DOS compatible personal computer with at least 640K byte available RAM installed and at least 2M byte of available disk space on the hard drive Your personal computer must be operating with a DOS version between 3 ...

Page 17: ...t configurations refer to the SLC 500 BASIC and BASIC T User Manual publication number 1746 UM004A US P You should have two 3 5 inch disks or three 5 25 inch disks Installation Procedure Before installing your BASIC Development Software the autoexec bat file in your personal computer should be modified to include the ABBASIC BDS directory in its path command This allows the BASIC Development Softw...

Page 18: ...lled C This indicates that the installation procedure has been aborted If you still wish to use this drive you must free some space by deleting any unnecessary files you have on that disk and then try the installation again IMPORTANT When modifying your path command in the autoexec bat file do not remove any other directories from the existing path Add C ABBASIC BDS to the end of the current path ...

Page 19: ...t stores the help files Change to your working directory before invoking PBASE Additional working directories can be created anywhere on your hard disk You can change the sub directory names after the installation process if the default names are not acceptable The HELP sub directory must reside directly under the BDS sub directory or its equivalent Do not rename the HELP sub directory Rockwell Au...

Page 20: ...the original software installation two 3 5 inch or three 5 25 inch disks Your blank disks need not be formatted Refer to your DOS manual for more information ATTENTION This software is protected under the copyright laws of the United States Unauthorized reproduction of copyrighted software violates U S copyright laws Criminal penalties may include fines or imprisonment ...

Page 21: ...ng software installation refer to Chapter 1 the BAS subdirectory was created for use as a working directory To change to this directory type CD ABBASIC BAS at the DOS prompt and press the Enter or Return key indicated throughout this manual by Enter The moves to the end of the line CD ABBASIC BAS 4 4 4 4 Type PBASE at the DOS prompt and press Enter The software determines your monitor type and dis...

Page 22: ...ter 5 Edit mode allows you to enter Edit mode and open a new file window or enter the presently active window All main menu functions are available in this mode Translate compile allows you to immediately translate compile a selected file provided you have correctly set up the filename extension and compiler program Translate compile is also available from the Other menu and is described in Chapte...

Page 23: ... 3 indicates that your cursor is in the third line of the active window C 1 indicates that your cursor is in the first column of the active window 1747 PBASE indicates that you are working with the BASIC development software TEXT EDIT indicates that you are in Text Editing mode R does not appear in this example but would appear if you were creating a keystroke macro described in Chapter 4 to indic...

Page 24: ...gram 1 Press F1 or click the left mouse button when the cursor is on 1 Help at the bottom left corner of the screen Help is context sensitive meaning that a help screen appropriate for the current subject appears If you are not working on any specific subject at the time 1747 PBASE REFERENCE GUIDE TABLE OF CONTENTS appears 2 2 2 2 Move the cursor or arrow keys to B Editor Quick Reference and press...

Page 25: ...k the left mouse button to exit help on GOTO 4 4 4 4 Move the cursor up or down so that it is no longer on the same line as the GOTO statement 5 5 5 5 Press F8 or move the mouse cursor to 8 BasHlp and click the left mouse button If you are not on a word the BASIC Language Reference Manual TABLE OF CONTENTS appears From this table of contents you can access a broad range of help screens on the modu...

Page 26: ...dows simultaneously Each may contain a separate file or they can be linked together and contain different parts of the same large file You can open and close these windows independently of each other The following screen shows an example with 3 windows opened simultaneously Window A contains a file called BASE 1 while windows B and C both contain a file called BASE 2 In this case B and C are linke...

Page 27: ...ess the pull down menus Cursor to the right or left to highlight the Window menu and press Enter File Window Block Cursor Search Text Layout Print Macro Config Other Exit A D ABBASIC BAS BASE 1 B D ABBASIC BAS BASE 2 100 this is BASE 1 100 this is BASE 2 110 for x 1 to 100 110 for x 1 to 50 120 a x 2 120 a x 2 5 130 if a 60 then 180 130 if a 70 then 180 140 next x 140 next x 150 goto 200 150 goto ...

Page 28: ...inks to the left If you let go of left arrow and press up arrow the screen shrinks upwards 4 4 4 4 Let go of Shift and press right arrow You are now positioning the A window 5 5 5 5 Press ESC when you are finished adjusting the size and shape of the A window 6 6 6 6 Pull down the Window menu again Cursor down to select Zoom on the Window menu Zoom causes the A window to return to full size File Wi...

Page 29: ... to the pull down menus Cursor to the right or left to highlight File and press Enter 2 2 2 2 Cursor down or move your mouse to select save file As on the File menu When it is highlighted press Enter or click the left mouse button You also could have pressed A since it is the highlighted letter corresponding to this menu item The SAVE FILE AS dialog box appears on the screen On the first line it i...

Page 30: ...ent window QuickStroke F5 We recommend that you periodically save sizeable programs as you work on them to avoid losing large quantities of work in the event of a system error or power failure The BASIC development software has an autosave feature that offers two methods for automatically saving files as you work on them It also has a backup feature with several methods for making backup files The...

Page 31: ...ting a BDL file a new file is created using the same name but with the BAS extension The BAS file contains the BASIC language version of your program including line numbers In our case there is now a file named FIRST BDL and a file named FIRST BAS Physically Connecting to Your BASIC or BASIC T Module At this point you could download the FIRST BAS program to the module and execute it on the module ...

Page 32: ... RS 232 that follows the terminal selection indicates that the BASIC development software is currently configured for RS 232 communications Depending on your system you may have configured it for DH485 communications DH485 instead 3 3 3 3 Press Enter and the prompt symbol should appear indicating that you have established communications with the module If you do not see the prompt symbol you have ...

Page 33: ...ressing Enter causes the translated version FIRST BAS of the file you are actively working on FIRST BDL to be downloaded to the module Exiting a BASIC Program To exit a program 1 Press F3 to exit terminal mode This returns you to the main menu screen in Edit mode 2 2 2 2 If using a mouse move the mouse cursor over to Exit on the second line of the screen and click the left mouse button You can als...

Page 34: ...Publication 1746 PM001A US P 2 14 Getting Familiar with Your Development Software ...

Page 35: ...Terminal Emulation mode selection save configuration and exit Setup and Configuration Menu The Setup and Configuration menu can be selected from the Toplevel menu or the Main menu Path Toplevel Menu Configuration Menu Path Main Menu Config To access the Setup and Configuration menu from the Toplevel menu for example move the cursor using your mouse to the Configuration menu option and click the le...

Page 36: ...followed by the desired switch or switches A space between PBASE and the is optional however if using more than one switch each must be separated by a space File Window Block cUrsor Search Text Layout Print Macro Config Other Exit SETUP AND CONFIGURATION DOS 5 0 CPU 80386 No File Video Card VGA Color PBASE Path C ABBASIC BDS Expanded Memory N A Serial PBASE1 Edit settings Display setup Mouse Key r...

Page 37: ... Development Software ABBASIC BDS unless you renamed it during installation Then you must use this command line switch every time you run the BASIC Development Software EN Don t try to use enhanced keyboard Some personal computers and some special memory resident programs do not work when the BASIC Development Software tries to use the enhanced keyboard functions If you experience keyboard problem...

Page 38: ... and then opens a window for TEST BAS Configuring Your Edit Options Path Toplevel Menu Configuration menu Setup and Configuration menu Edit settings Path Main Menu Config Setup and Configuration menu Edit settings Selecting Edit settings from the Setup and Configuration menu causes the following dialog box to appear Yn Sets screen width to n V No snow suppression on CGA monitor Do not wait for ret...

Page 39: ...e characters chosen as word delimiters typically are those that follow the end of a word When you move the cursor one word to the left Ctrl left arrow or one word to the right Ctrl right arrow the cursor stops at the next character to the right of a word delimiter If two or more word delimiters appear together the cursor stops at the next character to the right of the furthest right delimiter L 3 ...

Page 40: ...red field and then click the left mouse button If you do not have a mouse press Tab to access this field use the up or down arrow keys to position the cursor and press Space bar to select the desired items Truncate spaces This option tells 1747 PBASE whether or not to truncate spaces that trail lines of text This truncation only occurs when loading a file Ctrl Z at EOF Some programs require a Ctrl...

Page 41: ...video mode at 25 lines or 43 50 lines Selecting 43 50 lines allows you to view more of your program on the screen but the text size is considerably smaller Refer to the help screens for details Configuring Mouse and Keyboard Options Path Toplevel Menu Configuration menu Setup and Configuration menu Mouse Key repeat setup Path Main Menu Config Setup and Configuration menu Mouse Key repeat setup Sel...

Page 42: ...og box for the BDL extension There you can see that the Edit mode for BDL files is text the Indent style is smart the Tab spacing is 2 the Right margin is 78 and Word wrap is off Effect on Programming If for example you select a program called FIRST BDL to be loaded into an edit window the software searches the filename extension list and finds BDL It refers to the parameters entered in the EXTENS...

Page 43: ...er Default directory is used to define DOS directory paths for loading and saving files You can enter a disk drive and or directory and sub directory path here Refer to the help screen on the Default directory for details Effect on Programming When you enter a filename to be loaded into a window you can enter a DOS path along with the filename If you do not the currently active directory will be s...

Page 44: ...g box appears You can define a number of compiler specific parameters here Refer to Chapter 8 for details on the parameters in this dialog box Effect on Programming Compiling is controlled by the settings in the COMPILER PROGRAM SETUP dialog box Parameters there determine among other things whether the file is saved first whether the screen is cleared whether compiler errors are processed and how ...

Page 45: ...ons of a file into expanded memory or onto a disk drive This memory swapping is done with no effect on you as a user You should find out how much expanded memory EMS your personal computer has before setting values to any of these parameters As you become more proficient in using this software and begin using shell to DOS or user defined program features you should determine the maximum program si...

Page 46: ...he BASIC Development Software you can select a specific directory where they are to be stored You can also use the Temporary file directory to send files to a RAM disk if you have that utility on your personal computer Autosave The autosave feature causes files to be saved automatically after a specified period of time or a specified period of keyboard inactivity This prevents you from losing too ...

Page 47: ...oke macros are described in Chapter 4 For details and descriptions of these parameters refer to the help screens Terminal Emulation Mode Selection Path Toplevel Menu Configuration menu Terminal Selection Menu Path Main Menu Config Terminal Selection Menu The Terminal Selection Menu option from the Setup and Configuration menu allows you to select the Terminal Emulation mode desired for communicati...

Page 48: ...it without saving configuration changes those that were changed immediately remain changed Only changes that are not saved until exiting are abandoned IMPORTANT A file called DEFAULTS BAT is included with the BASIC Development Software package to restore the default values It will restore all values as if you had just installed the software in your personal computer This file is executed by typing...

Page 49: ...iques The following keys perform as described while editing text IMPORTANT If using the keys on the numeric keypad of your personal computer make sure you have turned your NumLock off Table 4 1 Key Functions Keys Function right arrow Moves the cursor across the screen to the right left arrow Moves the cursor across the screen to the left up arrow Moves the cursor up the screen down arrow Moves the...

Page 50: ...lementing menu selections refer to the network of help screens Refer to Chapter 2 for details on using Help Path Toplevel menu Edit mode Search Quickstroke available for individual items within the Search menu Figure 4 1 Search Menu Delete Deletes the character directly under the cursor Backspace Deletes the character to the left of the cursor Insert Toggles between Insert mode new text is inserte...

Page 51: ...For a complete description and examples of this search option refer to the help screen search and Replace allows you to replace the searched item with a selected item This is the same as Search for text except that it allows for replacement of the searched characters during the search repeat Previous search repeats the last Search for text or search and Replace multiple File search searches any or...

Page 52: ...the File menu Move the cursor to the Information About Current File option and press Enter or the left mouse button Below the description of the current file are the unlock and lock options Press Tab and or the arrow keys to select either of these options and press Enter or the left mouse button File Window Block cUrsor Search Text Layout Print Macro Config Other Exit BLOCK A Copy block F9 No File...

Page 53: ...the left mouse button to define this cursor position in the file This option is similar to marking lines of text except that it allows you to take portions of a line End block F7 only appears while you are in the process of marking text Select it after you have marked all that you want of the block turn marking oFf Ctrl F9 only appears after you have marked text It allows you to remove all block m...

Page 54: ...tive window Table 4 3 Block Menu Actions Option QuickStroke Description IMPORTANT If you are unable to change any characters in a file that file has probably been locked Files can be locked made read only or unlocked through the File menu Move the cursor to the Information About Current File option and press Enter or the left mouse button Below the description of the current file are the unlock an...

Page 55: ...cal or numerical order You can control which column of characters is to be sorted and you can confine the sorting to a specific area you have defined with a block upper Case allows you to change a word line or block to all upper case letters Lower Case allows you to change a word line or block to all lower case letters cenTer line Centers the currently selected line between column 1 and the right ...

Page 56: ...saved with the file and translated into BASIC code if you are using the 1747 PBASE Translator Be aware that some printers may require special line characters to be defined in order to print the lines Hypertext help is available with more details on this feature Your BASIC Development Software comes with an example line drawing program that uses this feature with programming macros You can load thi...

Page 57: ...ur entries and a paste option that pastes the calculation result at the last cursor location in the active window Hypertext help is available with more details on this feature The ASCII Table Path Toplevel menu Edit mode Other ASCII table QuickStroke Toplevel menu Edit mode Alt A The ASCII table is a view only three page ASCII table with character decimal and hexadecimal columns Using Windows Path...

Page 58: ...ew file can be loaded in the process If not the existing file is duplicated in the split window and linked to the original List Alt F1 lists the open windows by window letter filename status and path Windows can be selected deleted hidden saved and previewed through this list Next Shift F1 alphabetically selects the next window unless it is hidden Previous Ctrl F1 alphabetically selects the previo...

Page 59: ...TER Modify size Scroll Lock On moves or resizes a window Zoom CTRL F3 increases a window to full size Zooming the same window a second time returns it to its original size mInimize reduces a window to a single line icon linK allows you to view and or edit different sections of the same file by placing those sections in different windows This is useful for large files and when doing block editing U...

Page 60: ...re being recorded until you press Alt F10 again 2 Press the keys that you would use to accomplish the file splicing F2 brings up the Main menu F selects the File menu M selects Merge file from disk type in the name of the file to load Enter 3 Press Alt F10 again to stop keystroke recording Once recording is terminated you asked if you want to save the keystroke macro Select the Yes option The EDIT...

Page 61: ...e a change to the recorded keystrokes For example you find that the company header is always left highlighted after the file merge operation you defined with the Alt B QuickStroke Since it is necessary to turn this block marking off before any other block editing can be done you can add the necessary keystrokes to the macro 1 From the keystroke MACRO MANAGER dialog box highlight the Company header...

Page 62: ...the options you may select Mode selection determines whether the keystroke macro can be invoked from Edit or Terminal modes 1 Edit Keystroke Press Tab to get to this field followed by the space bar or down arrow to display a list of the actual keystrokes programmed for the selected macro You can cursor up or down the list and then add INS delete DEL or change F3 the keys as needed 1 In some cases ...

Page 63: ...boards the F11 F12 and center keys can be assigned as QuickStroke keys Using Cursor Markers The Cursor menu provides several options for marking and retrieving the cursor position while writing programs If you are editing a very large file and need to frequently access a different section you can set a cursor position marker at a key location and then instantly move to that position marker at any ...

Page 64: ...ndow These are not the same cursor positions as those in the marker stack They are stored with a marker number from 0 through 9 and prompted when this menu option is selected Retrieve random access mark retrieves the selected stored cursor position and causes the cursor to move to that position You are prompted for marker number 0 through 9 when this menu option is selected goto Line number Alt F8...

Page 65: ...th Toplevel menu Edit mode File QuickStroke available for individual items within the File menu Figure 5 1 File Menu The following table provides a brief explanation of the options available from the File menu File Window Block cUrsor Search Text Layout Print Macro Config Other Exit FILE Edit new file No File Load file into current window ShftF5 Save file in current window save file As F5 Informat...

Page 66: ...le in current window save the files in the currently active window It saves the file under its original name and replaces any previously saved version save file As F5 saves the files in the currently active window under a different name You can type a new name with extension in the dialog box that appears or you can select an existing name from the directory list in the dialog box If you select th...

Page 67: ...al filename does not change For example you have two BASIC files called FURN1 BDL and FURN2 BDL used to control heat treating furnaces If you add them to the user menu you can load them quickly using the Select a project file option Also you can create a descriptive name so that others using the software will recognize them The FURN1 BDL file could be listed as FURNACE CONTROL PROGRAM MAIN FURNACE...

Page 68: ...on your personal computer User defined programs may be your word processing program a file or disk management program or a spreadsheet User defined programs appear on a User menu just like the project files discussed in the previous section However this is an entirely different User menu and the programs on it are generally independent programs executable at the DOS level of your personal computer...

Page 69: ... the file resides in the current working directory you have to provide a complete DOS path for the program To select the actual filename 1 Highlight the select a Filename option and press Enter or click the left mouse button A dialog box appears giving you the option to view a directory listing of you personal computer Use this directory listing to move through your directories and disk drives unt...

Page 70: ...r defined program no additional memory is freed up by swapping BASIC Development Software out to disk or EMS EMS refers to your computer s expanded memory if it has any To disk only when executing a user defined program additional memory is freed up by swapping BASIC Development Software out to disk To EMS only when executing a user defined program additional memory is freed up by swapping BASIC D...

Page 71: ... space bar to toggle your selection X Yes Y No After selecting Options move to Starting directory Starting Directory If you failed to define a complete directory path to the filename you entered above you may do so here For example you could enter C WORD if the word processing filename you selected resided in the C drive of your personal computer in the Word directory on that drive Refer to you DO...

Page 72: ...Publication 1746 PM001A US P 5 8 Manipulating Files ...

Page 73: ...e BASIC development language This core is then enhanced by the addition of translator directives and programming macros all structured to a simple open format that requires no line numbers Descriptive label references are used as destinations for transferring control instead of line numbers As an example a BASIC development language program for printing the date is shown below It uses a translator...

Page 74: ...es the BASIC language by offering translator directives and programming macros in an open format that does not require line numbering Translator Directives When you write a program using the BASIC development language it eventually must be translated to the BASIC language for downloading to the BASIC or BASIC T module Translation is performed by the 1747 PBASE Translator software This translation ...

Page 75: ...different programs without re entering any code or having to edit line numbers The included file can contain any combination of program statements and translator directives Syntax I filename ext Example Before translation After translation REM INCLUDE EXAMPLE 0 REM I FIRST BDL 10 REM INCLUDE EXAMPLE 20 FOR X 1 TO 100 30 A X 2 40 P A 50 NEXT X 60 END IMPORTANT If a dollar sign immediately follows t...

Page 76: ...or s command line then the translator searches the current working directory for the file FIRST BDL In either of these three cases if the file is not found then Error 25 File not found appears in the message line during translation Label Labels are used instead of line numbers to reference a target location in a program A symbolic label is used anywhere you would have used a program line number in...

Page 77: ...ated these commands are not given line numbers but they are included in the output file As the file is downloaded to the BASIC or BASIC T module these directives are executed as soon as they are encountered Syntax T command for module Example Before translation After translation REM TEXT COMMAND EXAMPLE 0 REM I INCLUDE BDL 10 REM TEXT COMMAND EXAMPLE FOREGROUND_BLACK 20 PRINT CHR 27 30m BACKGROUND...

Page 78: ...5 L GET_C_VALUE 800 C 107 N 800 C 107 Increment The Increment directive allows you to specify a numeric value to be used as an increment between line numbers The translator uses this increment when it assigns line numbers during translation The number must be between the values of 1 and 100 This directive can be used throughout the program as often as needed The line number immediately following t...

Page 79: ...points B during program translation D inserted anywhere in the program turns Debug on until D is encountered The default is for Debug to be turned off D Syntax D to turn debug on D to turn debug off Example Before translation After translation REM DEBUGGING 0 REM B 10 REM DEBUGGING D 20 IF A C THEN GOTO 50 IF A C THEN GOTO GET_C_VALUE 30 STOP B 40 A 55 A 55 50 STOP L GET_C_VALUE 60 C 107 B C 107 I...

Page 80: ... While the programming macros described above already exist in the BASIC Development Software these are created by you They are created using a MACRO translator directive described in the next section Creating Your Own Programming Macro The Macro directive is a translator directive that allows the user to define BASIC statements as a macro that can be used in the program A programming macro must b...

Page 81: ... For example if you made a programming macro file named mine bdl you could then begin all of your programs with the command I Mine bdl This would include that file during translation and allow you to use your programming macros throughout the program Bringing in Programs from Separate Files Depending on the circumstances you may want to access other programs from your program or you may wish to co...

Page 82: ...bed in this chapter Merging a Program File There are two ways to merge program files the Include translator directive and the Merge file from disk option available from the File menu Include can be used only with BASIC development language programs and is described in this chapter in the translator directives section Merge file from disk can be used with any program file It prompts you for a filen...

Page 83: ...lick the left mouse button The SAVE FILE AS dialog box disappears and the message C ABBASIC BAS SECOND BDL Saved appears in the message line 5 Type the first two lines of the Second program REM SECOND PROGRAM will print screen below then check operator number Note that they are comments because they are enclosed in Remember comments are not translated If you want these lines in the translated BASI...

Page 84: ...mode only so be sure that you have spaces and not text wherever you expect to draw a line 9 Type the print statements as shown except for the lines Leave spaces where you expect to draw a line P tab 10 P tab 10 WARNING P tab 10 Use of this machine is restricted P tab 10 10 When you are ready to draw the box pull down the Other menu and select Linedraw 11 Position the cursor to a corner of the box ...

Page 85: ...nother entry cls print Invalid Entry Operator number not recognized goto loop1 L op1setup get_time d1 m1 y1 setup for operator 1 goto acknowledge L op2setup get_time d2 m2 y2 setup for operator 2 L acknowledge cls cursor_down 11 print_time print Operator op 48 acknowledged end Translating Since this example is written using the BASIC development language it must be translated to the BASIC Language...

Page 86: ... 200 210 OP GET 220 IF OP 49 THEN GOTO 270 230 IF OP 50 THEN GOTO 320 240 P CHR 27 2J 250 P Invalid Entry Operator number not recognized 260 GOTO 190 270 CALL 46 280 POP D1 290 POP M1 300 POP Y1 310 GOTO 360 320 CALL 46 330 POP D2 340 POP M2 350 POP Y2 360 P CHR 27 2J 370 P CHR 27 11B 380 PUSH A 390 CALL 46 400 POP A 410 P A 420 POP A 430 P A 440 POP A 450 P A 460 POP A 470 P Operator OP 48 acknow...

Page 87: ...er 9 Assuming this is done and your configuration is correct use the following steps to download a file 1 Select Terminal mode from either the Other menu or from the Toplevel menu 2 Select the File menu while inTerminal mode 3 Select Download from host to module 4 If second bdl was the last file you translated its translated version second bas is the default file for the download and you need only...

Page 88: ...Publication 1746 PM001A US P 6 16 Writing Programs Using the BASIC Development Language ...

Page 89: ...e printer and to control the printing of a file Most of the discussion in this chapter involves features selected from this menu Path Toplevel Menu Edit mode Print QuickStroke none Figure 7 1 Print Menu File Window Block cUrsor Search Text Layout Print Macro Config Other Exit PRINT A print current File EOF print marked Block printer Setup printer Type IBM printer Device file LPT1 Copies to print 1...

Page 90: ... your printer is on the list provided and does not function properly or as you would like it to possibly from being an older model with slightly different control codes you can select Edit F3 to modify the control codes IMPORTANT Pressing Enter after making changes to the PRINTER DRIVER SETUP screen saves those changes If you have made changes that you do not want to save or if you just want to le...

Page 91: ...changing font styles or line spacing but is not restricted to that Printer Setup Path Main Menu Print printer Setup QuickStroke none When you select printer Setup a menu of printer specific control codes is displayed These codes originate in the PRINTER DRIVER SETUP screen described in the previous section Typically these printer codes determine things like letter quality font and line spacing Pri...

Page 92: ...nter output from the LPT1 port to one of your serial communication ports For example mode LPT1 COM2 If you do not want to redirect printer output you can add a serial printer device to the Print menu Path Toplevel Menu Edit mode Print QuickStroke none To specify a new printer device 1 Select printer Device file to access the PRINTER DEVICE dialog box 2 Select Create Ins to enter a new printer devi...

Page 93: ...rint multiple copies of a file or block The default value is one Line Numbering Path Main Menu Print Line numbering QuickStroke none This adds line numbers to the left hand side of your printout These are not BASIC line numbers but simply print line numbers beginning with the number one Print Margin Path Main Menu Print print Margin QuickStroke none This allows you to define a left margin for prin...

Page 94: ...y time press Esc print marked Block prints the currently marked block This allows you to print a portion of a file instead of the entire file Refer to the block operations discussion in Chapter 4 for information on the three block marking methods There are other print options available by using the DOS shell Refer to your DOS manual for details Printing In Background This requires that the DOS pri...

Page 95: ...dow is the currently active window Once this is accomplished translate compile your program by using one of the following paths Path Toplevel Menu Translate compile Path Toplevel Menu Edit mode Other Translate compile QuickStroke Toplevel Menu Edit mode CTRL F8 Table 8 1 Filename Extensions File Extension Description name BDL This is your source file you have written in the BASIC development langu...

Page 96: ...x errors For example the translator will accomplish these tasks in the following program Figure 8 1 Second Program Before Translation SECOND BDL REM SECOND PROGRAM will print screen below then check operator number I Include bdl screen setup background_Black High_Intensity foreground_Yellow cls print statements print P tab 10 P tab 10 WARNING P tab 10 Use of this machine is restricted P tab 10 hit...

Page 97: ...COND BAS 0 REM 10 REM SECOND PROGRAM 20 P CHR 27 40M 30 P CHR 27 1M 40 P CHR 27 33M 50 P CHR 27 2J 60 P 70 P TAB 10 80 P TAB 10 WARNING 90 P TAB 10 Use of this machine is restricted 100 P TAB 10 110 P 120 P Hit any key to continue 130 If EOF THEN GOTO 130 140 PUSH A 150 A GET 160 POP A 170 P 180 P CHR 27 2J 190 P Enter your Operator Number 200 IF EOF THEN GOTO 200 210 OP GET 220 IF OP 49 THEN GOTO...

Page 98: ...in an include file during translation another window is opened containing that include file The cursor is placed at the error location in that file Find Next Compiler Error This feature locates the next error in the source file window generated by the most recent compile If you are not currently on the source file window you are bumped to that window when the find neXt error option is selected Pat...

Page 99: ...ate Ins Delete Del Exp COMPILER PROGRAM SETUP Ser Description 1747 PBASE Translator Command line BTRAN FILE I ABBASIC BAS Edi Program type 1747 PBASE Dis Memory required in k bytes 0 all 0 Mou Fil Swap method Options Pri Use default Clear screen sWa No swap X Save all files Bak To disk only Reload file Sea To EMS only Do NOT process compiler errors Ter To EMS then to disk saV OK ENTER Cancel ESC H...

Page 100: ... take place when they are necessary They are affected by the amount entered under memory required Use default should normally be selected for this Options are Use default selecting this causes the swap method selected when configuring Swapping expanded memory to be used No swap no additional memory is freed before invoking the compiler program To disk only causes swapping the software out to disk ...

Page 101: ...nual publication number 1746 UM004A US P or BASIC Module Series B User Manual publication number 1771 6 5 113 The Communication mode for your personal computer is set by the BASIC Development Software through the configuration menu terminal selection in Chapter 3 of this manual Verify that communication modes match before enteringTerminal mode You may be unsuccessful in establishing communications...

Page 102: ...ASE Erase the program stored in ROM ERASE LIST LIST current program or indicated lines of program to the console device LIST LIST 10 50 LIST LIST current program or indicated lines of program to the device connected to port PRT1 LIST LIST 50 LIST LIST current program or indicated lines of program to the device connected to port PRT2 LIST LIST 50 MODE Set up port parameters MODE DH485 19200 NEW Era...

Page 103: ...232 into DH485 Refer to the SLC 500 BASIC and BASIC T User Manual publication number 1746 UM004A US P 1 Select Download from host to module using the path shown below Path Toplevel Menu teRminal File Download from host to module Path Main Menu Other teRminal File Download from host to module QuickStroke Toplevel Menu teRminal Page Down You are prompted for a filename to download as shown on the fo...

Page 104: ...been keyed in or selected from the directory screen begin the download operation by pressing Enter DOWNLOADING flashes on the status line of the BASIC Development Software and the lines of the file scroll across the screen as they are downloaded to the module Uploading File The BASIC Development Software provides an upload utility that allows programs to be copied from the module to your personal ...

Page 105: ...ct different directories or exit directories by selecting the Note that a sort option is also available that sorts the current directory When you select Sort you are prompted for a sort key Enter the letter s of the desired sort operation into the sort key window Type in the path filename and file extension for example abbasic bas myfile bas IMPORTANT When a file is uploaded without specifying a f...

Page 106: ...ged to Terminal mode and established communications with the module as described earlier in this chapter and then proceed as follows 1 Select Upload hex file from module to host using the path shown below Path Toplevel Menu teRminal File uPload hex file from module to host Path Main Menu Other teRminal File uPload hex file from module to host QuickStroke none You are prompted for a filename to upl...

Page 107: ...mmunications with the module as described earlier in this chapter Proceed as follows 1 Select Download hex file from host to module using the path shown below Path Toplevel Menu teRminal File dOwnload hex file from host to module Path Main Menu Other teRminal File dOwnload hex file from host to module QuickStroke none You are prompted for a filename to download just as you would be if downloading ...

Page 108: ... prompted for a filename to back up 2 Enter the path filename and file extension of the file to be backed up The default filename is MODULE IMG 3 Press Enter after typing in the filename and the module image backup begins The following information is uploaded from the module BASIC program residing in RAM and stored in an Intel HEX format named FILENAME RAM All programs and configuration informatio...

Page 109: ...configuration stored in RAM or User PROM will be restored if the corresponding menu choice is selected You can also restore all user defined battery backed variables If the user defined battery backed are not restored your program should re initialize these variables Debugging Your Program The BASIC Debugger is a source level debugger for the module This debugger is used exclusively to aid in debu...

Page 110: ...ariable in the watch window F4 Gotill Executes your program until the line that currently contains the cursor is reached F5 Screen Displays the current status of the terminal screen F6 Search Searches for string in the current file F7 Trace Executes the program being debugged one line at a time F8 Layout Creates windows allowing combinations of the BDL BAS and Watch windows to be displayed F9 Run ...

Page 111: ...observe the features available with the BASIC Debugger 1 After downloading type RUN to execute the program You are prompted to enter a number If not you may have a bug in the program using the debugger may help you find it 2 Enter an odd number less than 100 and press Enter A message appears indicating it is odd You are prompted to enter a number again 3 Enter an even number less than 100 and pres...

Page 112: ...the program Note that you can select a variable wherever it occurs in a program 11 Press F2 to examine the value of that variable Note that it is half the value you entered in step 3 which is consistent with the way this program sorts even numbers 12 Press Esc to return to the debugger screen without changing the variable s value 13 While the cursor is still marking the variable x press F3 Note th...

Page 113: ...each time the trace passes through the for next loop 19 Keep pressing F7 until you trace through the program to completion Note that the debugger is terminated and you are returned toTerminal mode 20 Repeat steps 4 and 5 to return to the debugger 21 Press F5 This temporarily returns you to the Terminal mode screen Press any key to bring the debugger back 22 Press F6 You see a search screen identic...

Page 114: ...ou do make minor changes to the program in the module always go back to the original BDL file duplicate those changes and translate compile the program Then download it to the module and verify that it works as intended This ensures that the versions all match and that you have some backup for the program in the module If you must do extensive editing to a program you should go back to the origina...

Page 115: ...that Autobaud searches for the baud rate but does not modify the data bits stop bits parity or port number These selections must be correctly configured to match those of the module before Autobaud can successfully find the baud rate File Setup Display deBug Exit to Edit SETUP Autobaud General file names etc Terminal com Port settings baud rate etc AltP Colors saVe setup Cancel ESC HELP F1 MENU F2...

Page 116: ...ersonal computer to sound a beep when the file upload or download operation is completed or terminated Word wrap in file viewer allows word wrap when viewing a file Right margin for file viewer is the right margin for the word wrap when viewing a file Terminal The Terminal selection brings up a TERMINAL SETUP dialog box that allows selection of ASCII or ANSI terminal emulation Com Port Settings Th...

Page 117: ... select the number of stop bits Valid choices are 1 or 2 Handshaking selects whether or not the software handshaking occurs between your personal computer and the device it is communicating with Always enable this menu item while downloading or uploading programs to or from the module Colors Use this menu selection to change the screen background and foreground colors The up and down cursor keys c...

Page 118: ...it becomes necessary to re establish lost communications with the module When selected your personal computer attempts to re establish communications with the module at the configured module address on the DH485 network NOTE General Purpose Communications is not intended for use with the module This is done through the Terminal Selection menu accessed through the Setup and Configuration menu Refer...

Page 119: ...wnloaded to the module will come from Log File is the name of the log file You are always given the opportunity to edit this filename just before opening a log file Beep on downloads and uploads causes your personal computer to sound a beep when the file upload or download operation is completed or terminated Word wrap in file viewer allows word wrap when viewing a file Right margin for file viewe...

Page 120: ...our personal computer for use in communicating with the module Choose between COM1 or COM2 Baud rate allows you to select a communications baud rate Choices are 1200 2400 9600 or 19200 Terminal Address allows you to select the terminal address on the DH485 network Module Address allows you to select the module s address on the DH485 network Maximum Node Address allows you to select the maximum nod...

Page 121: ...or the communications port parameter Terminal Address Figure 9 6 Who Active Screen File Setup Display deBug Exit Terminal Address 0 Basic Address 1 to Edit SETUP Attach General file names etc WHO ACTIVE Active Station Identification 0 BASIC SOFT 31 12 24 1 BASIC MOD 31 13 25 2 5 02 31 14 26 3 15 27 4 16 28 5 17 29 6 18 30 7 19 31 8 20 9 21 10 22 11 23 Port Settings F2 Cancel Esc Help F1 HELP F1 ME...

Page 122: ...colors The up and down cursor keys change the foreground colors the left and right cursor keys change the background colors Save Setup By selecting save Setup you save all the current setup parameters pertinent to DH485 Terminal Mode File Setup Display deBug Exit Terminal Address 0 Basic Address 1 to Edit SETUP Attach General file names etc WHO LISTEN Active Node Table 0 12 24 1 13 25 2 14 26 3 15...

Page 123: ...amming with the BASIC development language Included is a description of what the macro CALL does along with a list of inputs and outputs associated with the macro Programming macros are described in Chapter 6 of this manual The example program in that chapter SECOND BDL makes extensive use of these macros IMPORTANT The file INCLUDE BDL comes as part of the BASIC Development software package It con...

Page 124: ... cursor down 1 rows 1 the number of rows to move the cursor down None cursor_right 1 Moves the cursor right 1 columns 1 the number of columns to move the cursor right None cursor_left 1 Moves the cursor left 1 columns 1 the number of columns to move the cursor left None cursor_save Saves the current cursor position None None cursor_restore Restores the cursor to the saved position None None high_i...

Page 125: ...ackground magenta None None background_cyan Prints text with the background cyan None None background_white Prints text with the background white None None blink_off Has no special attributes None None lines Shows the user how fancy screens can be drawn None None Table A 1 Operation Macros Screen Macro CALLs Macro Inputs Outputs Table A 2 Keyboard Macros Keyboard Macro CALLs Macro Inputs Outputs h...

Page 126: ...o the M1 file The offset position 0 to 63 in the M1 file is defined by the first input variable 1 The offset position 0 to 63 in the M1 file 2 BASIC variable or constant to be converted None read_m0_image_signed 1 2 Reads a binary value 32768 to 32767 from the M0 image file The offset position 0 to 63 in the M0 file is defined by the first input variable The variable which receives the data is the...

Page 127: ...3 Sets the clock to the time indicated by 1 2 and 3 1 Hours 0 to 23 2 Minutes 0 to 59 3 seconds 0 to 59 None set_date 1 2 3 Sets the clock to the date indicated by 1 2 and 3 1 Days 1 to 31 2 Months 1 to 12 3 Years 0 to 99 None input_date Sets the Wall Clock date It asks the operator for the date and sets the clock None None set_day Asks the operator for the day of week and sets the Wall Clock day ...

Page 128: ...quired 1 is the number of variables to be stored If the MTOP is not 5FFFh then this function is skipped 1 Number variables None read_bat_var 1 2 Retrieves battery backed variables 2 storage number 1 variable to be retrieved write_bat_var 1 2 Writes battery backed variables 2 storage number 1 variable to be written Table A 6 Program Macros Program Control Macro CALLs Macro Inputs Outputs CALL_ram T...

Page 129: ..._num 1 2 3 Converts 1 from a string to a numeric value then stores the result in 3 2 is a validity code 1 String number to be converted 2 Validity of output value 0 Value not valid 1 Valid Value 255 3 Converted value find_str_in_str 1 2 3 Finds a string within a string It locates the first occurrence position of the string 1 String to be found 2 String to be searched 3 Result 0 String not found 0 ...

Page 130: ...c Disables the CTRL C function None None enable_c Enables the CTRL C function None None Table A 9 Port Control Macros Port Control Function Macro CALLs Macro Inputs Outputs clear_prt1_buffers Clears the PRT1 input and output buffers None None clear_prt2_buffers Clears the PRT2 input and output buffers None None Table A 10 DH485 Macros DH485 Function Macro CALLs Macro Inputs Outputs wait_common_inp...

Page 131: ..._3 1 2 Converts the number from BASIC Floating Point to PLC 3 3 Digit Signed Fixed Decimal BCD XXX XXX 1 Value to be converted 2 BTR word to store value None db_to_plc_bcd_4 1 2 Converts the number from BASIC Floating Point to PLC 4 Digit BCD XXXX 1 Value to be converted 2 BTR word to store value None db_to_plc_bcd_6 1 2 Converts the number from BASIC Floating Point to PLC 6 Digit Signed Fixed Dec...

Page 132: ...holds value to be converted 2 Converted value Table A 11 1771 DB B Backplane Macros Number Conversion CALLs Macro Inputs Outputs Table A 12 1771 DB B Backplane CALLs Backplane CALLs Macro Inputs Outputs btr Performs a block transfer read None None btw Performs a block transfer write None None btr_timed 1 Performs a block transfer read with a 2 second timeout None Status of block transfer btw_timed...

Page 133: ...ctory tree you can move through and select directories as the tree builds mark multiple files for copying deleting printing or loading or prompt for a DOS command to be repeated on all marked files For example you can mark several BDL files enter the compiler command at the command prompt press Enter and all marked files are compiled view or change file attributes view any file in a pop up Read On...

Page 134: ...y shell are two distinctly different features Shell to DOS temporarily drops out of the BASIC development software and takes you back to the DOS level where you can run programs or execute DOS commands File Window Block cUrsor Search Text Layout Print Macro Config Other Exit C ABBASIC BAS SECOND BAS loaded 1747 PBASE DOS Shell E Use cursor keys to move A B C D E F G H I TAB Toggle display mode E 4...

Page 135: ...able from the DOS directory shell File Window Block Cursor Search Text Layout Print Macro Config Other Exit 1747 PBASE DOS Shell D SCREEN Use cursor keys to move A B C D E F G H I TAB Toggle display mode D 4982K 6 files Space Mark Unmark file DIR 06 06 91 03 14p CtrlBackSpace Parent dir MCOM 000 2150 06 08 91 03 13p A F2 Change Directory YPNLV 000 2146 06 06 91 06 58p A F3 Delete File s MCOM 001 2...

Page 136: ...hell Some of these operations can be performed on several files at once if the files have been marked Files are marked by pressing the space bar when the filename is highlighted Marked files are indicated by the character In the previous figure with multiple directories notice that several of the files in the bottom directory are marked Exit the DOS directory shell by selecting Done ESC with your ...

Page 137: ...ment language creating a program 2 9 6 11 macros 6 8 overview 2 9 6 1 translator directives 6 2 BASIC development software language 6 1 outline 1 1 starting 2 1 BASIC module backing up module image 9 8 choosing files 9 16 commands 9 2 communicating with 9 1 connecting to 2 11 debugging programs 9 9 DH485 communications 9 18 downloading files 9 3 downloading hex files 9 7 PC interface 1 2 restoring...

Page 138: ... com port settings 9 20 communications setup 9 18 interface card 3 3 WHO ACTIVE 9 21 WHO LISTEN 9 22 dialog box definition P 4 directory structure 1 5 display black and white 3 3 length and width 3 3 options 3 7 snow suppression 3 4 DOS directory shell B 1 directory tree B 2 feature 1 1 downloading files 9 3 from Terminal mode 9 3 hex files 9 7 program 2 13 6 15 drawing lines 4 8 E Edit mode 2 2 4...

Page 139: ...4 14 overview 1 1 4 11 6 8 L Label directive 6 4 language type 3 9 Line Number directive 6 6 linedraw example 6 12 feature 1 2 uses 4 8 M Macro directive 6 8 macro manager dialog box 4 13 4 14 options 4 14 Macro menu 4 11 macros battery back up A 6 clock A 5 communication A 4 Ctrl C A 8 DH485 A 8 keyboard A 3 keystroke 1 1 4 11 6 8 library A 1 operation A 2 overview 6 8 port control A 8 program A ...

Page 140: ...ew 7 1 program 7 6 product support P 5 program downloading 2 13 editing 2 9 exiting 2 13 printing 7 6 saving 2 10 translating 2 11 programming BASIC development language 6 1 debugging 9 9 debugging example 9 11 macros 6 8 6 10 making corrections 1 1 9 14 saving 2 10 search operations 4 2 second program 6 11 subprogram CALL 70 and CALL 71 6 10 translation 2 11 8 1 writing programs 6 1 programming m...

Page 141: ... Tab expand 3 7 temporary files 3 12 Terminal mode changing to 2 12 9 1 downloading 9 3 selection 3 13 uploading 9 4 terminal type 9 16 9 19 terms and abbreviations P 4 text copying 4 5 cut and paste 4 5 deleting 4 5 moving 4 5 sorting 4 7 Text directive 6 5 Toplevel menu 2 2 Translate compile 2 2 translating configuration 8 4 errors 8 4 feature 8 1 programs 2 11 8 1 translator 8 1 configuration 8...

Page 142: ...Publication 1746 PM001A US P 6 Index W WHO ACTIVE 9 21 WHO LISTEN 9 22 window labels 2 7 window menu 2 6 4 10 windows 1 1 2 6 4 9 writing programs 6 1 ...

Page 143: ......

Page 144: ...Publication 1746 PM001A US P May 2000 7 40072 096 01 A Supercedes Publication 1746 6 2 November 1994 2000 Rockwell International Corporation Printed in the U S A Back Cover ...

Search results

Summary of Contents for 1747-PBASE

Reviews:

Related manuals for 1747-PBASE

Brands by name

Popular brands

Allen-Bradley 1747-PBASE, Programming Manual

Search results

Summary of Contents for 1747-PBASE

Reviews:

Related manuals for 1747-PBASE

Brands by name

Popular brands