TermIt

TermIt V1.2a ------------ Date: 10 Oct 1996 Description ------------ TermIt is a communication program that supports the DEC VT52, VT100 and ANSI escape sequences. It works on the Series 3a only. TermIt provides an 80 column and 24 line full screen emulation of the DEC VT52 and VT100 terminal. TermIt support all of the DEC VT100 features, including: - highlighting - underline - inverse video - auto wrap mode - forward and reverse scrolling - full cursor movement - line and block erase - VT102 insert/remove character extension - VT102 insert/remove line extension - ANSI insert character - clear screen and reset terminal - normal and special graphics character set - ANSI/VT52 mode - tab settings - Delete and Enter key mapping - VT100 keypad emulation - full serial port and handshake configuration - full modem configuration - xmodem and ymodem file transfer protocols - saving current configuration on exit - 3 level screen zooming - "Bring in" text data from other application - external device driver loader for 3FAX modem - all input/output character translation - dialling directory with up to 6 phone numbers - device status report, device attribute, terminal parameters reports - simple script language TermIt support VT-52 commands sequences standalone, and as part of VT-100 features. *********************************************************************** * WARNING AND DISCLAIMER * *********************************************************************** * * * Use this software at your own risk. I will not be held responsible * * for any damage to you, your machine and/or your information as a * * result of using TermIt. * * * *********************************************************************** Installation ------------ TermIt is distributed as a single zip archive. You will need Unzip (under Unix, MSDOS, or VMS), PKUNZIP (under MSDOS), or WinZip (under Windows) to unpack the distribution file, Termtxxx.zip (xxx = version number). 1. Unpack Termtxxx.zip to an empty directory and check the contents... Termit.app TermIt application Termit.rsc TermIt help file (optional) Readme.txt This readme file 2. Copy Termit.app into the \APP\ directory on any of your Psion drives. 3. Create directory TERMIT under \APP\ directory on any drive (M:,A:,B:), but NOT USE Flash SSD for that! 4. Copy TermIt.rsc file to \APP\TERMIT\ directory. This is optional. 5. Install TermIt from the System screen with Psion-I or select Apps | Install from the menu (for English Psions). Menu description ---------------- File Transmit (Psion + T) Send a file using the selected protocol. The unregistered version can send file < 5 Kbytes only. Receive (Psion + R) Receive a file using the selected protocol. The unregistered version can receive file < 5 Kbytes only. Capture (Psion + C) Start capturing incoming data to a file selected from file selection dialogue. If you select existing file, it will be overwrite. When logging is on, on status line is word "Capt" and this menu is changes to "Capture off". Run/Stop Script (Psion + F) Start/Stop script file. While script is running, "Scrt" word is on status line. Edit Bring in (Psion + B) Brings onto TermIt screen text which has previously been highlighted in another application. For registered users only. This function can bring in up to 128 character only now. Connect Dial (Psion + D) You can choice dialling method from Menu Extras/Set preferences/Dial mode. Two mode available: - Direct you just enter phone number - Directory you select phone number from list. This list you can edit from Menu/Connect/Edit dial. Modem dial commands consist of: Dial prefix + Phone Number + Dial suffix Last entered phone number in Direct mode will be saved as first phone number in list. Edit dial (Psion + Shift + D) You can enter and save up to 6 phone numbers and use it for dialling in Directory dialling mode. You can choice this dialling method from Menu/Extras/Set preferences/Dial mode. HangUp (Psion + H) Hang Up modem using Settings/Modem/HangUp string. Initialize (Psion + I) Initialise modem using Settings/Modem/Initialize string. Settings Port (Psion + P) Sets the serial port options: Baud rate 50 ... 19200 Data bits 5 ... 8 Stop bits 1,2 Parity None,Event,Odd Ignore parity no / yes Channel TTY:A, TTY:B, TTY:C, TTY:D a550 driver Disable / Enable disable/enable to load device driver for using with 3Fax modem. For registered users only. The unregistered users can use channel "tty:A" only. Port settings will be display on status line. Modem (Psion + M) Sets the modem commands string: Init string determine string which will be send to modem for modem initialising. Hang Up determine string which will be send to modem for modem Hang Up. Dial prefix determine string which will be send to modem before dialling phone number. Dial suffix determine string which will be send to modem after dialling phone number. Handshake (Psion + K) Sets the serial port handshakes: Xon/Xoff RTS/CTS DTR/DSR Terminal (Psion + N) Sets the terminal emulation options: Term Type TTY / VT52 / VT100 sets terminal type. VT100 are ANSI compatible. Local echo off / on on/off local echo function. Word wrap off / on determine cursor action after reaching the right screen edge. Incoming CR <CR> / <CR>+<LF> / <LF> determine cursor action of incoming <CR> code Incoming LF <LF> / <LF>+<CR> / <CR> determine cursor action of incoming <LF> code Destruct BS off / on determine cursor action of incoming <BS> code: BackSpace or Delete. Comm buffer (bytes) 16...254 determine incoming buffer length. You can select buffer length for faster communication. Default value is 80. Translate (Psion + A) Sets the translating for transmitted character: Enter Key <CR> / <CR+LF> / <LF> determine which code is transmitted when the Enter key is pressed. BackSpace <DEL> / <BS> determine which code are transmitted when the Delete key is pressed. Translation table off / on If you use this option, you can translate any incoming and outgoing character, using translation table. Translation table is just a file, with 256+256 character code. This option is brilliant for user, who use national code table, i.e. Scandinavian and Russian KOI-8. Now available: - for Finland language - Finish.tbl - for Russian KOI-8 - Koi8rus.tbl - for Russian ALT code - Alt_rus.tbl Any other are welcome! Table name <file with translation table>.tbl Select file with translation table. This file extension is ".TBL". Protocol (Psion + O) Select the file transmit/receive protocol: ASCII XModem CRC XModem CRC (1k) XModem Checksum YModem YModem (1k) YModem-G YModem-G (1k) Selected protocol will be displayed on status line. Sets the default directory for file transmit: Tx dir Name Sets the default directory for file receive: Rx dir Name Screen (Psion + S) Sets screen and cursor attributes: Cursor flashing off / on Cursor style Line / Block Bold text Enable / Disable Status line On / Off Save Settings (Psion + Shift + S) Save current TermIt settings into selected .INI file. This file will be visible under TermIt application on System screen, and can be selected and loaded. Special Set preferences (Psion + Q) Sets TermIt preferences: Auto Dial off / on If set to on, TermIt will dialling first saved phone number after starting. Dial mode Direct / Directory Sets dialling method. If you select Manual, you can use (and edit directly) one phone number only. If you select Directory, you can use (not edit) up to 6 predefined phone numbers. Clock Off / Time / Timer Show system time or online time in the left corner of the status line. For registered users only. Reset vt100 (Psion + Shift + E) Sets the default parameters to vt100 terminal. Clear Screen (Psion + E) Clears the screen and set cursor to the left top corner. Zoom in (Psion + Z) Zoom out (Psion + Shift + Z) Increase/decrease font and window size. 6x6, 6x8 and 8x8 size available. When using big font, on status line you can see word "Zoom" You can move window corner-to-corner, using Control + Arrow key. Visible window position will be displayed on status line. Register (Psion + Shift + R) Available for unregistered users only. Registering TermIt. If you have register code just enter it and press Enter. Thank you for registering TermIt! You have file Termit.reg in your /APP/TERMIT directory now. About TermIt (Psion + Shift + A) Show "About TermIt" window. Exit (Psion + X) Leave TermIt. Current settings will be save in current .INI file in /APP/TERMIT/ directory. "secret" Hot keys ----------------- Next Settings Dialogs available, but not visible in menu (you must use HOT KEY) : Time settings (Psion+Shift+T) Allow sets delay (up to 5 sec with step 1/20 sec ) after End Of Line (EOL) and after each character (CHR). You must define EOL character code for your system. By default it is 13 (CR). Sounds settings (Psion+Shift+O) Allow enable/disable sounds system for TermIt. You can select any .WVE files for using with TermIt. Bell disable / enable On/off terminal bell (after incoming char 007) PostOp Sound disable / enable On/off sounds after long time operation (capture, transmit, receive...) File Name ... Start Sound disable / enable On/off sounds when TermIt started. File Name ... ***IMPORTANT *** You can use ROM sounds too. It have name: sys$al01.wve - Fanfare sys$al02.wve - Soft bells sys$al03.wve - Church bell To select this sounds: 1. Press Ctrl+Tab in File Name field. 2. Enter file name in "Filename pattern" filed (as sys$al01.wve). 3. Enter "ROM::" in "Full path field". 4. Press Ctrl+Enter VT100 keypad emulation ---------------------- As there is no numeric keypad on the 3a, TermIt can emulate it using main keyboard. The <DIAMOND> key turns on keypad mode for one character. TermIt allow you generate keypad key with two methods: 1. Using alpha and numeric keys Ex: for generate keypad <,> key code, press <DIAMOND>, than press <f> key. s3a keyboard VT100 keypad +-----+-----+-----+-----+ +-----+-----+-----+-----+ | | | | | | | | | | | 1 | 2 | 3 | 4 | | pf1 | pf2 | pf3 | pf4 | | | | | | | | | | | +-----+-----+-----+-----+ +-----+-----+-----+-----+ | | | | | | | | | | | q | w | e | r | | 7 | 8 | 9 | - | | | | | | | | | | | +-----+-----+-----+-----+ +-----+-----+-----+-----+ | | | | | | | | | | | a | s | d | f | | 4 | 5 | 6 | , | | | | | | | | | | | +-----+-----+-----+-----+ +-----+-----+-----+-----+ | | | | | | | | | | | z | x | c | E | | 1 | 2 | 3 | E | | | | | n | | | | | n | +-----+-----+-----+ t | +-----+-----+-----+ t | | | | e | | | | e | | Space | . | r | | 0 | . | r | | | | | | | | | +-----------+-----+-----+ +-----------+-----+-----+ 2. Using numeric and Shift+numeric keys Ex: for generate keypad <,> key code, press <DIAMOND>, than press <"> key (Shift+2). s3a keyboard VT100 keypad +-----+-----+-----+-----+ +-----+-----+-----+-----+ | | | | | | | | | | | 1 | 2 | 3 | 4 | | pf1 | pf2 | pf3 | pf4 | | | | | | | | | | | +-----+-----+-----+-----+ +-----+-----+-----+-----+ | | | | | | | | | | | 5 | 6 | 7 | 8 | | 7 | 8 | 9 | - | | | | | | | | | | | +-----+-----+-----+-----+ +-----+-----+-----+-----+ | | | S+1 | S+2 | | | | | | | 9 | 0 | or | or | | 4 | 5 | 6 | , | | | | <!> | <"> | | | | | | +-----+-----+-----+-----+ +-----+-----+-----+-----+ | S+3 | S+4 | S+5 | S | | | | | | | or | or | or | + | | 1 | 2 | 3 | E | | <> | <$> | <%> | 6 | | | | | n | +-----+-----+-----+ | +-----+-----+-----+ t | | | S+8 | or | | | | e | | S+7 or <&>| or | | | 0 | . | r | | | <?> | <^> | | | | | +-----------+-----+-----+ +-----------+-----+-----+ You can cancel keypad mode by <DIAMOND> again. Also, you can generate VERTICAL BAR symbol with <DIAMOND> and <b>. Script language ================ Script is ASCII text file, with commands for TermIt terminal emulator. You can make it, using OPL editor or Word application, but you *MUST* save file with script as TEXT! Script commands: WAITFOR "string" This command waiting for text "string" in incoming character sequence. When "string" will be find, next script command will be executed. SEND "string" This command send text "string" to port (modem, host...). EXIT Exit script. Any other string in script file will be skipped. * string parameters *MUST* start and finish by <"> character. Commands haven't timeout period now. If your script can't execute, because system answer is not, what TermIt want see, just stop script (Psion + f). While script is running (waiting), you can enter any commands manually. Script example: ! UNIX login script SEND "ATDT1234567" ! Send dialling command to modem WAITFOR "login:" ! Waiting UNIX login prompt SEND "My_name" ! Send user name WAITFOR "Password:" ! Waiting UNIX password prompt SEND "My_password" " ! Send user password EXIT ! Exit script ! END UNIX login script If after command SEND "ATDT1234567" ! Send dialling command to modem you have response BUSY (phone line is BUSY), script will be BLOCKED, because it waiting string "login:". In this case you can stop script and run it again, or directly enter command ATDT1234567 to modem from keyboard. After connecting to host, script will be continued. Bug Reports / Comments ---------------------- Send all bug reports and comments to the author (Serge Shestopalov) at the address shown in the Support section below. Registration ------------ TermIt is Shareware, which means you can try the program before deciding to purchase it, and you may give copies of the trial version to other Psion Series 3a/3c users to try. However, you cannot legally continue to use the program if you decide not to register it, nor may you give copies of the registered version or the registration code to others. You may use the trial version for 30 days, and I will provide assistance to get the program to work with your Psion 3a during that period, but further support is available only to registered users. The registration fee is UKP L15 or USD $25. Payment can be made by... * Cash only (no cheques please) to Serge Shestopalov Balvu 15-56 Riga, LV-1003 LATVIA EUROPE * GO SWREG on CompuServe and use ID number 9740 * Using the RegNet service on my World Wide Web page at http://ourworld.compuserve.com/homepages/Serge_S *Important note*: Please do not send cheques. The local banks all charge an excessive amount to cash them. The easiest way to register is by sending cash in a good strong envelope (between two pieces of paper so you cannot see through the envelope). Once registered, you will receive a personal code to free TermIt from the nag screen and limitations. There is no need to re-install. Please add your full name for the registration message. Support ------- This product is supported via e-mail only. Please send all messages to: Internet: dustman@stoat.riga.lv CompuServe: 100526,1317 The latest version will always be available from my Web page: http://ourworld.compuserve.com/homepages/Serge_S History ------- 20 Oct 1995 v1.0a beta release 20 Nov 1995 v1.0e first release 22 Dec 1995 v1.1a add VT52 and VT102 features add character translation table add special graphics character sets some cursor movement bugs fixed - tested using VT100 test by Per Lindberg, Stockholm University Computing Center 30 Dec 1995 v1.1b .INI file bug fixed add simple script language add default directory for Tx/Rx add forced Hang Up command with DTR set/reset. 23 Feb 1996 v1.1c add Time settings dialog (Psion+Shift+T) add Sound settings dialog (Psion+Shift+O) window moving to cursor visible position, when zoom changed fixed. 10 Oct 1996 v1.2a port settings bug fixed automatic 3Fax loader added status line On/Off added some minor bug fixed Thanks ------ - Graham P. Tappenden. - Klaus Lichtenwalder for beta testing and for many good ideas about TermIt. - Giancarlo Barbadoro for ideas and testing. - Pekka Mannerkorpi for "Translation table" idea support, and testing. - Phil Spencer (nicko@nildram.co.uk) for great beta testing. ----------------------- Serge Shestopalov 1996.