micropc OCTAGON SYSTEMS PC SmartLINK IV User Manual

Hide thumbs

page of 48

/ 48
Bookmarks

Quick Links

Download this manual

PC SmartLINK IV User's Manual

served. However, any part of this document may be reproduced,

provided that Octagon Systems Corporation is cited as the source.

The contents of this manual and the specifications herein may

change without notice.

TRADEMARKS

Micro PC™, PC SmartLink™, CAMBASIC™, STD BASIC™,

Octagon Systems Corporation®, the Octagon logo and the Micro PC

logo are trademarks of Octagon Systems Corporation.

Intel® is a registered trademark of Intel Corporation.

THE

COMPANY

6510 W. 91st Ave.

Doc. Order #03449 Rev 0993

Westminster, CO 80030

Tech. Support: 303–426–4521

Need help?

Do you have a question about the OCTAGON SYSTEMS PC SmartLINK IV and is the answer not in the manual?

Questions and answers

Summary of Contents for micropc OCTAGON SYSTEMS PC SmartLINK IV

Page 1 PC SmartLINK IV User's Manual COPYRIGHT Copyright 1993—Octagon Systems Corporation. All rights re- served. However, any part of this document may be reproduced, provided that Octagon Systems Corporation is cited as the source. The contents of this manual and the specifications herein may change without notice.
Page 3 TABLE OF CONTENTS CHAPTER 1: OVERVIEW ..........1 Using SmartLINK Windows .............. 1 Selecting Menus .................. 3 Using the Keyboard ..............3 Using the Mouse ................3 CHAPTER 2: GETTING STARTED ......... 5 System Requirements ................. 5 Creating a Backup Copy ..............5 Installing PC SmartLINK IV .............
Page 4 APPENDIX A: SPECIAL CODES ......... 27 Introduction ..................27 Sounding the Bell ................27 Clearing the Screen ................28 Positioning Cursor ................28 Changing Screen Attributes ............. 31 DOS File Handling ................32 Close a DOS file ................33 Read/Write from File to Buffer ............34 Read/Write from Buffer to Port ............
Page 5 CHAPTER 1 OVERVIEW USING SMARTLINK WINDOWS This section describes the elements of a window. Most windows have certain elements in common, such as a title bar and menus. Not all windows have every element. Figure 1–1 illustrates the various elements of a window: Menu Bar Close Box Title Bar...
Page 6 Close box Closes the window. Double–clicking this box closes the active window. Scroll bars Move the contents of a window into view. Click- ing the arrow at either end scrolls one line or one column at a time. Keeping the mouse button pressed scrolls continuously.
Page 7 SELECTING MENUS Using the Keyboard • Hold down the <Alt> key + the highlighted letter of the menu item on the menu bar. Throughout this manual, these key- strokes are designated as Alt + key. • Press F10, use the left or right arrow to highlight the menu item and then press <Enter>.
Page 8 This page intentionally left blank. Overview – 4...
Page 9 CHAPTER 2 GETTING STARTED SYSTEM REQUIREMENTS PC SmartLINK IV runs on the IBM PC compatible family of computers with at least 512K RAM, DOS 2.1 or higher, a floppy drive, and one serial port on the PC (uses COM1, 2, 3 or 4). SmartLINK IV runs on any 80–column monitor.
Page 10 Modify your AUTOEXEC.BAT file to add the path variable for PC SmartLINK IV: PATH=C:\smartlk Connect an available COM port on your PC to COM1 on the target system. Refer to your Microcontroller or PC Control Card user’s manual for more information. To start SmartLINK, type the following: SL <ENTER>...
Page 11 To change the serial parameters, select Options | Serial Parameters. Make the appropriate changes and select Save. NOTE: This new configuration is saved in a configuration file in your current directory. For information on saving all the configuration parameters, refer the Chapter 3. 10.
Page 12 To activate the screen editor: Move the cursor with the keyboard arrow keys or click the mouse and make any changes. EDIT MODE displays on the menu bar. Press <Enter> to save all the changes made to the current line. Press <Enter>...
Page 13 SMARTLINK COMMAND LINE OPTIONS The following switches allow you configure PC SmartLINK IV from DOS command when SmartLINK is started. The syntax for starting SmartLINK IV is as follows: SL [/M] [/L] [/Cn] [/Bx] [Dx] [Sx] [Px] Specifies the target system as a Micro PC–DOS system. Bypasses the SmartLINK sign–on screen.
Page 14 This page intentionally left blank. Getting Started – 10...
Page 15 CHAPTER 3 TERMINAL EMULATION DESCRIPTION The Terminal Emulation screen is used to communicate with the target system. In this mode any keyboard entry is sent to the target system. Any character sent from the target system is displayed on your PC monitor. File Edit Search...
Page 16 Save Saves the active document using its current name. Save As Saves the active document after giving you an opportunity to change the file name and the directory for storage. Change Allows you to change the default directory or Directory revert back to the previous directory.
Page 17 Copy Copies the selection onto the Clipboard. To copy: Highlight the contents you want to copy. Select Edit | Copy Paste Copies the contents of the Clipboard to the document at the insertion point. To paste: Position the cursor where you want to insert the Clipboard contents.
Page 18 In the Text To Find box, type the text you want to find. If you want to limit the search to Case Sensitive and/or Whole Word Only, tab to the appropriate option and press the space bar to select or deselect. Select OK.
Page 19 and then waits for you to select Yes, No, or Cancel with a dialog box. If you decide not to confirm each occurrence, SmartLINK finds the first occurrence of the text and automati- cally makes the change. Select Search | Search Again to repeat the process.
Page 20 Transfer Mode BUFFER TARGET Disk Target ASCII Target Disk Buffer Target INTEL HEX Target Buffer DISK Buffer Disk Disk Buffer From Disk to Target File Format ASCII % transferred Size: INTEL HEX ROM HEX ChDir START Filename: C:\smartlk Cancel TEST.BAS Figure 3–1—File Transfer to BASIC Target System RANSFER Disk Target...
Page 21 When you select the type of transfer mode, the diagram in the dialog box changes to reflect your selection. It also reflects the file format you have chosen. ORMAT ASCII SmartLINK send an ASCII file on a line by line basis.
Page 22 Micro PC–DOS Systems The following diagram illustrates a typical dialog box display when transferring a file from your PC to a DOS target system: TARGET Direction XMODEM Disk Target PRG SSD1 Target Disk DISK From Disk to Target Transfer Protocol XMODEM Program SSD1 % transferred...
Page 23 execute the DISKSAVE.EXE program on the target system and that the DISKSEND.EXE program is in the PATH on your PC. NOTE: Not all Octagon Micro PC–DOS systems support this option, refer to your hardware manual for more information. HANGE IRECTORY Allows you to change the current directory.
Page 24 The progress of the transfer is displayed in the dialog box. If you wish to halt the transfer press <Esc> or <Ctrl>+C. NOTE: You can use the hotkeys Alt+U or click this option on the status line to bypass steps 1 and 2. Dump Buffer Allows you to examine the contents of the Smart- LINK buffer.
Page 25 Tile Arranges all open windows in smaller sizes to fit on the screen. To tile the window: Select Window | Tile Cascade Arranges all open windows so that each title bar is visible. To cascade the windows: Select Window | Cascade Next Switches the active window.
Page 26 OPTIONS Serial Parameters Ports The port on your PC used to communicate with the target system. SmartLINK supports COM1, COM2, COM3 or COM4. The system will auto- matically determine the number of ports on your PC and display the options accordingly. Data Bits The number of data bits can be either 7 or 8.
Page 27 Miscellaneous Environment Allows you to change the target system communi- cation environment between BASIC and Micro PC–DOS without having to exit SmartLINK and select a new target system. Auto Linefeed Automatically inserts a linefeed character everytime a carriage return is received from the target system.
Page 28 To save the configuration: Select Options | Save Configuration If you need to revert back to the default parameters, delete SL.CFG from the directory. Load Configuration Loads the configuration file previously saved with the Save Configuration option. To load the configuration: Select Options | Load Configuration Colors Allows you to select the colors for the desktop, menus and dialog...
Page 29 CHAPTER 4 TROUBLESHOOTING Cannot communicate With Target System • SmartLINK and the target system must have the same serial parameters. • Verify that the target system is functional. • Check the serial cable for short or open circuit conditions. • Verify that you are using the correct cable and connectors for that target system.
Page 30 This page intentionally left blank. Troubleshooting – 26...
Page 31 APPENDIX A SPECIAL CODES INTRODUCTION This section lists the various control codes that PC SmartLINK uses to control screen and disk functions. The control sequences are listed in the following form: General Description Control Sequence Examples: The first example assumes you are using either an STD BASIC or CAMBASIC programming language and syntax.
Page 32 CLEARING THE SCREEN Clear screen, re–set attributes and home cursor This sequence has the same effect as CLS in BASIC. The screen is cleared to a black and white default. Control Sequence: 27 59 Example: 1) PR$ 27,59 PRINT CHR$(27);";"; ANSII clear screen for MS–DOS redirection This sequence has the same effect as <ESC>J but is ANSII compatible...
Page 33 Line feed Causes cursor to advance to next line. Screen will scroll if necessary. To return to beginning of line, a carriage return must be executed. Line is not erased after a line feed. Control Sequence: 10 Example: 1) PR$ 10 PRINT CHR$(10);...
Page 34 Cursor down Moves cursor down one line. Similar to line feed except there is no screen scroll. Code is ignored if it is at the bottom of the screen. Control Sequence: 22 Example: 1) PR$ 22 PRINT CHR$(22); Home cursor Positions cursor in the upper left of the screen.
Page 35 Turn cursor on or off To turn the cursor off, set x equal to 32. To turn on the cursor, set x to 33. Control Sequence: <ESC> C x Example: 1) PR$ ESC,67,32 PRINT CHR$(27);'"C "; CHANGING SCREEN ATTRIBUTES Set foreground (character) attributes Sets the color of the character.
Page 36 Change all background attributes Changes the entire screen to the same background attribute. x is a 1 byte character. Attribute codes are IBM compatible. Add 32 to x variable. Control Sequence: <ESC> A x Example: 1) PR$ ESC,65,33 PRINT CHR$(27);CHR$(65);CHR$(33); Changes the entire screen to a blue background.
Page 37 Control Sequence: <ESC> DOS h name$ Example: 1) none 100 B$="TEST.DAT$" 100 PRINT CHR$(27);"DOS";CHR$(2);B$; Opens file with handle #2 using the file name specified in Open an existing file, placing pointer at the end (append) Opens an existing file placing the pointer at the end. File handle h ranges from 9 to 7.
Page 38 Example: 1) none PRINT CHR$(27);"DC";CHR$(4); Closes a file with handle #4. READ/WRITE FROM FILE TO BUFFER Read from file to buffer Transfers data from disk to SmartLINK buffer. File handle h ranges from 0 to 7. n is a byte number indicating the number of bytes to transfer to the buffer (up to 128).
Page 39 READ/WRITE FROM BUFFER TO PORT Read from buffer to serial port Transfers data from the SmartLINK buffer to the serial port. n is a byte number indicating the number of bytes to send out the serial port. The maximum number of bytes the can be sent is 128.
Page 40 SET FILE POINTER Set file pointer position Read or write data from a specified point. File handle h ranges from 0 to 7. pos$ is starting position number which is terminated by a $. The maximum number is limited by DSO (approximately 32 million).
Page 41 Draw a vertical line Draws a vertical line n number of lines down starting at coordinate position y and x. y and x coordinates are not offset by 32. This line will not connect to any other lines. Control Sequence: <ESC> V y x n Example: 1) PR$ ESC,86,35,2,10 PRINT CHR$(27);CHR$(86);...
Page 42 Fill a block Fills a block defined by coordinates y1 x1 y2 x2 with the character specified by c. A character value of 219 will produce a solid block. Other patterns may be created using other characters. The attribute of the fill character can be specified by the <ESC>...
Page 43 Save window to SmartLINK RAM Characters and attributes currently in window n are saved to SmartLINK RAM. Window n ranges from 0 to 15. The window information may be saved to disk or called again for redisplay. The windows have been previously defined by the <ESC>...
Page 44 Load window from disk to SmartLINK RAM Loads a window previously saved to disk. Window n ranges from 0 to 15. name$ is any valid DOS file name including drive and path. This string must be terminated with a $. The $ is not part of the file name.
Page 45 Transfers a window from SmartLINK RAM to the display Transfers data for a window from SmartLINK RAM to the display. The placement of the window must have been previously defined by the <ESC> W command. The window may be placed into SmartLINK RAM in one of two ways: (1) Load from disk using the <ESC>...
Page 46 PRINTER COMMANDS Set print ON or OFF All characters sent to the screen will be echoed to the printer when it is turned ON. To turn ON the printer, set s = 33 (21H). When s = 32 (20H), the printer is OFF. Some Toshiba laptop computers lock up when using this command.
Page 47 Control Sequence: <ESC> Q Example: 1) none 100 PRINT CHR$(27);CHR$(81); 110 INPUT A$ Line 100 requests the status and line 100 is the reply. Special Function Codes – 43...
Page 48 Special Function Codes – 44...