home *** CD-ROM | disk | FTP | other *** search
/ Boot Disc 8 / boot-disc-1997-04.iso / PDA_Soft / Psion / comms / termit11 / TERMIT.TXT < prev   
Text File  |  1996-01-09  |  17KB  |  548 lines
  1.         Psion 3a VT52/VT100 Terminal Emulator
  2.                 TermIt v1.1
  3.                  User Guide
  4.            Copyright Serge Shestopalov 1995
  5.  
  6. TermIt is a communication program that supports the DEC VT52 and VT100 escape
  7. sequences. It works on the Series 3a only.
  8.  
  9. This product is Shareware. If you find this product useful, please register it.
  10. Registration will remove the Nag screen and sound, remove limited file size
  11. for XYmodem transmit/receive (5k), add other extension, and provide the
  12. latest version.
  13.  
  14. Registration
  15. =============
  16.  
  17. To Register send a cash or check for UKP 15.00 (or USD 25.00) to
  18.                    ----
  19.  
  20.     Serge Shestopalov
  21.     Balvu 15-56
  22.     Riga, LV-1003
  23.     LATVIA
  24.     EUROPE
  25.  
  26. Or register on Compusrve under SWREG Number XXXX for $25
  27. (In future, please lets me know, if it is interesting for you)
  28.  
  29. After that, I will send to you your REGISTERATION CODE via e-mail
  30. (or post mail).
  31. Please send me e-mail message for faster reply.
  32.  
  33. For contact
  34. ===========
  35.  
  36. e-mail: dustman@stoat.riga.lv
  37.  
  38. compuserve: 100526,1317
  39.  
  40. mail: Serge Shestopalov
  41.       Balvu 15-56
  42.       Riga, LV-1003
  43.       LATVIA, EUROPE
  44.  
  45. To Install
  46. ==========
  47.  
  48. 0. If you have prvious TermIt version, remove old files, exclude "Termit.reg".
  49. 1. Create directory TERMIT under APP directory on any drive (M:,A:,B:)
  50. 2. Copy file TERMIT.APP  into the \APP\TERMIT directory
  51. 4. From the system screen menu, select Apps/Install (Psion + I), press Tab key,
  52.    change directory to \APP\TERMIT and select TERMIT.APP file.
  53.  
  54. Files included with this release
  55. ===============================
  56.  
  57. TERMIT.APP    The main module
  58. TERMIT.TXT    This file
  59.  
  60. Character translation tables for any languages available by request.
  61.  
  62. Extension for registered users
  63. ===============================
  64.  
  65. Registered version have next extensions:
  66.  
  67.     - unlimited file size X- and Y-Modem file transfer
  68.     - "Bring in" function
  69.     - 4-channel communication port support
  70.     - external driver support (for 3Fax modem)
  71.     - clock or online timer on status line
  72.     - translation table option
  73.     - vt100 keypad emulation
  74.     - simple script language
  75.  
  76. Technical details
  77. =================
  78.  
  79. TermIt provides an 80 column and 24 line full screen emulation
  80. of the DEC VT52 and VT100 terminal.
  81.  
  82. TermIt support all of the DEC VT100 futures, including:
  83.  
  84. - highlighting
  85. - underline
  86. - inverse video
  87. - autowrap mode
  88. - forward and reverse scrolling
  89. - full cursor movement
  90. - line and block erase
  91. - VT102 insert/remove character extension
  92. - VT102 insert/remove line extension
  93. - ANSI insert character
  94. - clear screen and reset terminal
  95. - normal and special graphics character set
  96. - ANSI/VT52 mode
  97. - tab settings
  98. - Delete and Enter key mapping
  99. - VT100 keypad emulation
  100. - full serial port and handshake configuration
  101. - full modem configuration
  102. - xmodem and ymodem file transfer protocols
  103. - saving current configuration on exit
  104. - 3 level screen zooming
  105. - "Bring in" text data from other application
  106. - support external device driver for 3FAX modem
  107. - all input/output character translation
  108. - dialing directory with up to 6 phone numbers
  109. - device status report, device attribute, terminal parameters reports
  110. - simple script language
  111.  
  112. TermIt support VT-52 commands sequences standalone, and as part
  113. of VT-100 futures.
  114.  
  115. Menu description
  116. =================
  117.  
  118. File
  119.     Transmit (Psion + T)
  120.         Send a file using the selected protocol.
  121.         The unregistered version can send file < 5 Kbytes only.
  122.  
  123.     Receive (Psion + R)
  124.         Receive a file using the selected protocol.
  125.         The unregistered version can receive file < 5 Kbytes only.
  126.  
  127.     Capture (Psion + C)
  128.         Start capturing incoming data to a file selected
  129.         from file selection dialogue. If you select existing
  130.         file, it will be overwrite. When logging is on, 
  131.         on status line is word "Capt" and this menu 
  132.         is changes to "Capture off".
  133.  
  134.     Run/Stop  Script (Psion + F)
  135.         Start/Stop  script file. While script is running,
  136.         "Scrt" word is on status line.
  137.  
  138. Edit
  139.     Bring in  (Psion + B)
  140.         Brings onto TermIt screen text which has previously been
  141.         highlighted in another application. For registered users
  142.         only. This function can bring in up to 128 character only now. 
  143.  
  144. Connect
  145.     Dial (Psion + D)
  146.         You can choice dialing method from Menu
  147.         Extras/Set preferences/Dial mode. Two mode
  148.         available:
  149.             - Direct     you just enter phone number
  150.             - Directory    you select phone number from
  151.                     list. This list you can edit from
  152.                     Menu/Connect/Edit dial.
  153.  
  154.         Modem dial commands consist of:
  155.  
  156.         Dial prefix + Phone Number + Dial suffix
  157.  
  158.         Last entered phone number in Direct mode will
  159.         be saved as first phone number in list.
  160.  
  161.     Edit dial (Psion + Shift + D)
  162.         You can enter and save up to 6 phone numbers and use it
  163.         for dialing in Directory dialing mode. You can choice this
  164.         dialing method from Menu/Extras/Set preferences/Dial mode.
  165.  
  166.     HangUp (Psion + H)
  167.         Hang Up modem using Settings/Modem/HangUp string.
  168.  
  169.     Initialize (Psion + I)
  170.         Initialize modem using Settings/Modem/Initialize string.        
  171.  
  172. Settings
  173.     Port (Psion + P)
  174.         Sets the serial port options:
  175.             Baud rate    50 ... 19200
  176.             Data bits    5 ... 8
  177.             Stop bits    1,2
  178.             Parity        None,Event,Odd
  179.             Ignore parity    no / yes
  180.             Channel        TTY:A, TTY:B, TTY:C, TTY:D
  181.             a550 driver    Disable / Enable
  182.                 disable/enable to load device driver
  183.                 for using with 3Fax modem.
  184.                 For registered users only.
  185.  
  186.         The unregistered users can use channel "tty:A" only.
  187.         Port settings will be display on status line.
  188.  
  189.     Modem (Psion + M)
  190.         Sets the modem commands string:
  191.             Init string
  192.                 determine string which will be send
  193.                 to modem for modem initializing.
  194.             Hang Up
  195.                 determine string which will be send
  196.                 to modem for modem Hang Up. If you add
  197.                 "*" character in end of this string,
  198.                 TermIt reset comm port after Hang Up.
  199.             Dial prefix
  200.                 determine string which will be send
  201.                 to modem before dialing phone number.
  202.             Dial suffix
  203.                 determine string which will be send
  204.                 to modem after dialing phone number.
  205.  
  206.     Handshake (Psion + K)
  207.         Sets the serial port handshakes:
  208.             Xon/Xoff
  209.             RTS/CTS
  210.             DTR/DSR
  211.  
  212.     Terminal (Psion + N)
  213.         Sets the terminal emulation options:
  214.             Term Type    TTY / VT52  / VT100
  215.                 sets terminal type. VT100 are ANSI compatible.
  216.             Local echo    off / on
  217.                 on/off local echo function.
  218.             Word wrap    off / on
  219.                 determine cursor action after reaching
  220.                 the right screen edge.
  221.             Incoming CR    <CR> / <CR>+<LF> / <LF>
  222.                 determine cursor action of incoming <CR>
  223.                 code 
  224.             Incoming LF    <LF> / <LF>+<CR> / <CR>
  225.                 determine cursor action of incoming <LF>
  226.                 code 
  227.             Destruct BS    off / on
  228.                 determine cursor action of incoming <BS>
  229.                 code: BackSpace or Delete.
  230.             Comm buffer (bytes)    16...254
  231.                 determine incoming bufer length. You can
  232.                 select buffer length for faster communication.
  233.                 Default value is 80.
  234.  
  235.     Translate (Psion + A)
  236.         Sets the translating for transmitted character:
  237.             Enter Key     <CR> / <CR+LF> / <LF>
  238.                 determine which code is transmitted
  239.                 when the Enter key is pressed.
  240.             BackSpace    <DEL> / <BS>
  241.                 determine which code are transmitted
  242.                 when the Delete key is pressed.
  243.             Translation table    off / on
  244.                 If you use this option, you can translate
  245.                 any incoming and outgoing character, using
  246.                 translation table. Translation table is
  247.                 just a file, with 256+256 character code.
  248.                 This option is brilliant for user, who use
  249.                 national code table, i.e. Scandinavian and
  250.                 Russian KOI-8.
  251.  
  252.                 Now available:
  253.                     - for Finland language  - Finish.tbl
  254.                     - for Russian KOI-8     - Koi8rus.tbl
  255.                     - for Russian ALT code  - Alt_rus.tbl
  256.  
  257.                 Any other are welcome!
  258.  
  259.             Table name    <file with translation table>.tbl
  260.                 Select file with translation table. This file
  261.                 extension is ".TBL".
  262.  
  263.     Protocol (Psion + O)
  264.  
  265.         Select the file transmit/receive protocol:
  266.             ASCII
  267.             XModem CRC
  268.             XModem CRC (1k)
  269.             XModem Checksum
  270.             YModem
  271.             YModem (1k)
  272.             YModem-G
  273.             YModem-G (1k)
  274.         Selected protocol will be displayed on status
  275.         line.
  276.  
  277.         Sets the default directory for file transmit:
  278.             Tx dir Name
  279.  
  280.         Sets the default directory for file recieve:
  281.             Rx dir Name
  282.  
  283.     Screen  (Psion + S)
  284.         Sets screen and cursor attributes:
  285.             Cursor flashing    off / on
  286.             Cursor style    Line / Block
  287.             Bold text    Enable / Disable
  288.  
  289.     Save Settings (Psion + Shift + S)
  290.         Save current TermIt settings into selected .INI file.
  291.         This file will be visible under TermIt application on
  292.         System screen, and can be selected and loaded.
  293.  
  294. Extras
  295.     Set preferences (Psion + Q)
  296.         Sets TermIt preferences:
  297.             Auto Dial    off / on
  298.                 If set to on, TermIt will dialing first
  299.                 saved phone number after starting.
  300.             Dial mode    Direct / Directory
  301.                 Sets dialing method. If you select Manual,
  302.                 you can use (and edit directly) one phone
  303.                 number only.
  304.                 If you select Directory, you can use (not edit)
  305.                 up to 6 predefined phone numbers.
  306.             Bell        off / on
  307.                 On/off terminal bell (after incoming char 007)
  308.             PostOp Sound    off / on
  309.                 On/off sound after long time operation
  310.                 (transmit, receive...)
  311.             Clock        off / Time / Timer
  312.                 Show system time or online time in the
  313.                 left corner of the status line.
  314.                 For registered users only.
  315.  
  316.     Reset vt100 (Psion + Shift + E)
  317.         Sets the default parameters to vt100 terminal.
  318.  
  319.     Clear Screen (Psion + E)
  320.         Clears the screen and set cursor to the left top corner.
  321.  
  322.     Zoom in (Psion + Z)
  323.     Zoom out (Psion + Shift + Z)
  324.         Increase/decrease font and window size.
  325.         6x6, 6x8 and 8x8 size available.
  326.         When using big font, on status line you can see
  327.         word "Zoom"
  328.         You can move  window corner-to-corner, using
  329.         Control + Arrow key. Visible window position will be displayed
  330.         on status line.
  331.  
  332.     Register (Psion + Shift + R) 
  333.         Available for unregistered users only.
  334.         Registering TermIt. If you have register code
  335.         just enter it and press Enter. Thank you for
  336.         registering TermIt! You have file Termit.reg
  337.         in your /APP/TERMIT directory now.
  338.  
  339.     About TermIt  (Psion + Shift + A) 
  340.         Show "About TermIt" window.
  341.  
  342.     Exit (Psion + X)
  343.         Leave TermIt. Current settings will be save in 
  344.         current .INI file in /APP/TERMIT/ directory.
  345.  
  346. VT100 keypad emulation
  347. ========================
  348.  
  349. As there is no numeric keypad on the 3a, TermIt can emulate
  350. it using main keyboard.
  351. The <DIAMOND> key turns on keypad mode for one character.
  352. TermIt allow you generate keypad key with two methods:
  353.  
  354. 1. Using alpha and numeric keys
  355.     Ex: for generate keypad <,> key code, press <DIAMOND>,
  356.         than press <f> key.
  357.  
  358.        s3a keyboard                  VT100 keypad
  359.  
  360. +-----+-----+-----+-----+      +-----+-----+-----+-----+
  361. |     |     |     |     |      |     |     |     |     |
  362. |  1  |  2  |  3  |  4  |      | pf1 | pf2 | pf3 | pf4 |
  363. |     |     |     |     |      |     |     |     |     |
  364. +-----+-----+-----+-----+      +-----+-----+-----+-----+
  365. |     |     |     |     |      |     |     |     |     |
  366. |  q  |  w  |  e  |  r  |      |  7  |  8  |  9  |  -  |
  367. |     |     |     |     |      |     |     |     |     |
  368. +-----+-----+-----+-----+      +-----+-----+-----+-----+
  369. |     |     |     |     |      |     |     |     |     |
  370. |  a  |  s  |  d  |  f  |      |  4  |  5  |  6  |  ,  |
  371. |     |     |     |     |      |     |     |     |     |
  372. +-----+-----+-----+-----+      +-----+-----+-----+-----+
  373. |     |     |     |     |      |     |     |     |     |
  374. |  z  |  x  |  c  |  E  |      |  1  |  2  |  3  |  E  |
  375. |     |     |     |  n  |      |     |     |     |  n  |
  376. +-----+-----+-----+  t  |      +-----+-----+-----+  t  |
  377. |           |     |  e  |      |           |     |  e  |
  378. |   Space   |  .  |  r  |      |     0     |  .  |  r  |
  379. |           |     |     |      |           |     |     |
  380. +-----------+-----+-----+      +-----------+-----+-----+
  381.  
  382.  
  383. 2. Using numeric and Shift+numeric keys
  384.     Ex: for generate keypad <,> key code, press <DIAMOND>,
  385.     than press <"> key (Shift+2).
  386.  
  387.        s3a keyboard                   VT100 keypad
  388.  
  389. +-----+-----+-----+-----+      +-----+-----+-----+-----+
  390. |     |     |     |     |      |     |     |     |     |
  391. |  1  |  2  |  3  |  4  |      | pf1 | pf2 | pf3 | pf4 |
  392. |     |     |     |     |      |     |     |     |     |
  393. +-----+-----+-----+-----+      +-----+-----+-----+-----+
  394. |     |     |     |     |      |     |     |     |     |
  395. |  5  |  6  |  7  |  8  |      |  7  |  8  |  9  |  -  |
  396. |     |     |     |     |      |     |     |     |     |
  397. +-----+-----+-----+-----+      +-----+-----+-----+-----+
  398. |     |     | S+1 | S+2 |      |     |     |     |     |
  399. |  9  |  0  | or  | or  |      |  4  |  5  |  6  |  ,  |
  400. |     |     | <!> | <"> |      |     |     |     |     |
  401. +-----+-----+-----+-----+      +-----+-----+-----+-----+
  402. | S+3 | S+4 | S+5 |  S  |      |     |     |     |     |
  403. | or  | or  | or  |  +  |      |  1  |  2  |  3  |  E  |
  404. | <>  | <$> | <%> |  6  |      |     |     |     |  n  |
  405. +-----+-----+-----+     |      +-----+-----+-----+  t  |
  406. |           | S+8 | or  |      |           |     |  e  |
  407. | S+7 or <&>| or  |     |      |     0     |  .  |  r  |
  408. |           | <?> | <^> |      |           |     |     |
  409. +-----------+-----+-----+      +-----------+-----+-----+
  410.  
  411. You can cancel keypad mode by <DIAMOND> again.
  412. Also, you can generate VERTICAL BAR simbol with <DIAMOND> and <b>.
  413.  
  414. Script language
  415. ================
  416.  
  417. Script is ASCII text file, with commands for TermIt terminal emulator.
  418. You can make it, using OPL editor or Word application, but you *MUST* save
  419. file with scripl as TEXT!
  420.  
  421. Script commands:
  422.  
  423.     WAITFOR "string"
  424.         This command waiting for text "string" in
  425.         incoming character sequence.
  426.         When "string" will be find, next script
  427.         command will be executed.
  428.  
  429.     SEND "string"
  430.         This command send text "string" to port
  431.         (modem, host...).
  432.  
  433.     EXIT
  434.         Exit script.
  435.  
  436.  
  437. Any other text string in script file will be skiped.
  438.  
  439. * string parameters *MUST* start and finish by <"> character. 
  440.  
  441. Commands haven't timeout period now. If your script can't execute, because
  442. system answer is not what you want see, just stop script (Psion + f).
  443. While script is running you can enter any commands.
  444.  
  445. Script example:
  446.  
  447. ! UNIX login script
  448.  
  449. SEND "ATDT1234567"   ! Send dialing command to modem
  450.  
  451. WAITFOR "login:"     ! Waiting UNIX login prompt
  452.  
  453. SEND "My_name"       ! Send user name
  454.  
  455. WAITFOR "Password:"  ! Waiting UNIX password prompt
  456.  
  457. SEND "My_password" " ! Send user password
  458.  
  459. EXIT                 ! Exit script
  460.  
  461. ! END UNIX login script
  462.  
  463. If after command 
  464.  
  465. SEND "ATDT1234567"   ! Send dialing command to modem
  466.  
  467. you have response BUSY (phone line is BUSY), script will be BLOCKED,
  468. because it waiting string "login:". In this case you can stop script
  469. and run it again, or directly enter command
  470.  
  471. ATDT1234567
  472.  
  473. to modem from keyboard. After connecting to UNIX host, script will
  474. be continued.
  475.  
  476. Support
  477. ========
  478.  
  479. TermIt have support via e-mail only.
  480. Please send me messages about any bugs in TermIt.
  481. Any comments and questions are welcome.
  482.  
  483. To-do
  484. ======
  485.  
  486. Add "scroll back" function.
  487. Add "brind out" function.
  488. Add Z-Modem protocol to TermIt.
  489.  
  490. Important!
  491. ===========
  492.  
  493. I wrote this program using OPL. Therefore:
  494.  
  495.     - text output to graphics screen working slow
  496.     - screen scrolling  working slow too
  497.     - bold text output working terrible slow
  498.  
  499. as result, you can see "Overflow" error in your screen.
  500.  
  501. For solving this problem you must correctly sets handshakes settings (you must use
  502. the handshaking convention used by the remote computer).
  503. The RTS/CTS working faster, but XON/XOFF work perfectly.
  504. You can disable bold text attributes, for faster text output to screen,
  505. (use Settings/Screen/Bold text  Enable/Disable menu).
  506.  
  507. If you have previous version...
  508. ===============================
  509.  
  510. Just remove  old files in /APP/TERMIT/ directory, exclude "TERMIT.REG."
  511. If you have old .INI files in /APP/TERMIT direstory, you will can see warning "field not found".
  512.  
  513. History
  514. ========
  515.     20 Oct 1995    v1.0a    beta release
  516.     20 Nov 1995    v1.0e    first release
  517.     22 Dec 1995    v1.1a    add VT52 and VT102 futures
  518.                 add character translation table
  519.                 add special graphics character sets
  520.                 some cursor movement bugs fixed -
  521.                     tested using VT100 test by Per Lindberg,
  522.                     Stockholm University Computing Center
  523.     30 Dec 1995    v1.1b    .INI file bug fixed
  524.                 add simple script language
  525.                 add default directory for Tx/Rx
  526.                 add forced  Hang Up command with DTR set/reset.
  527.                         
  528. Thanks
  529. =======
  530.  
  531. Special thanks to:
  532.  
  533.     - Graham P. Tappenden.
  534.     - Klaus Lichtenwalder for betatesting and for
  535.         many good ideas about TermIt.
  536.     - Giancarlo Barbadoro for ideas and testing.
  537.     - Pekka Mannerkorpi for "Translation table" idea
  538.         support, and testing.
  539.  
  540. =========================================================================
  541. The autor takes no responsibility for any loss caused as a result of using 
  542. this program.
  543. =========================================================================
  544.  
  545. Serge Shestopalov
  546.  
  547. 3 Jan 1996.
  548.