home *** CD-ROM | disk | FTP | other *** search
/ Enter 1998 December / ENTER12_1.iso / os2 / Watchcat / serial.cnf < prev    next >
Encoding:
Text File  |  1995-05-16  |  16.7 KB  |  507 lines
  1. ; Configuration file for WatchCat 2.1
  2. ;
  3. ; To control WatchCat over a serial line from a terminal or another
  4. ; PC running a terminal emulation program, edit this file. Many settings
  5. ; are probably not needed to be changed, but look through the whole file
  6. ; to check if all settings suit your needs.
  7. ;
  8. ; Recommendations to get a good remote control of WatchCat:
  9. ;
  10. ; - Your serial cable should feature DSR/DTR and RTS/CTS lines to get
  11. ;   a full hardware handshake and nearly error-free communicatios
  12. ;
  13. ; - 8 databits, no parity, 1 stop bit is always a good thing
  14. ;
  15. ; - starting with 9600 baud, speed is high enough to make the screen
  16. ;   updates good enough. With a cable featuring the hardware handshake
  17. ;   lines, you can normally safely go up to 57600 baud.
  18. ;
  19. ;
  20. ; In case of problems:
  21. ;
  22. ; Check your cable, use a terminal program to check the connection. If there
  23. ; is something displayed but the display is corrupt, lower the baud rate.
  24. ; There are zillions of different terminal emulations, all with other
  25. ; characteristics. If you suspect your emulation to make problems, try
  26. ; setting the control sequence strings below to "", where possible. This
  27. ; makes WatchCat use only the most common sequences supported by ALL terminals.
  28. ; It will be slower, though. So try to reenable some of the strings to get
  29. ; some performance back.
  30.  
  31. ; Note:
  32. ;
  33. ; The freely available version of WatchCat only demonstrates this remote
  34. ; control feature. The registered version has no limits. The version
  35. ; accompanying the 1st Aid Package in addition has the feature to pop up
  36. ; WatchCat on the remote side when activated.
  37. ;
  38. ; Problems? Send eMail to  watchcat@fmi.uni-passau.de
  39.  
  40. ;----------------------------------------------------------------------------
  41.  
  42. ; SERIAL DEVICE.
  43. ; Default: COM2
  44. ; Values : COM1, COM2, COM3, COM4, etc.
  45. ; Note   : You can use any serial device compatible with COM ports.
  46.  
  47. SerialDevice=COM2
  48.  
  49.  
  50. ; BAUD RATE.
  51. ; Default: system default (often only 1200 or 2400 baud, depends on driver)
  52. ; Values : DEFAULT, 300, 1200, 2400, 4800, 9600, 19200, 38400, 57600, 115200
  53. ; Note   : 115200 baud can't be used with standard AT UARTS using OS/2's
  54. ;          COM drivers. If setting a baud rate fails, setting the baud rate
  55. ;          for an enhanced serial port is tried.
  56.  
  57. BaudRate=9600
  58.  
  59.  
  60. ; PARITY.
  61. ; Default: system default (often even parity, sometimes no parity)
  62. ; Values : DEFAULT, NONE, ODD, EVEN, MARK, SPACE
  63. ; Note   : Using no parity (NONE) is common and recommended.
  64.  
  65. Parity=NONE
  66.  
  67.  
  68. ; DATA BITS.
  69. ; Default: system default (often 7 data bits, depends on driver used)
  70. ; Values : DEFAULT, 7, 8
  71. ; Note   : Using 8 data bits is recommended.
  72.  
  73. DataBits=8
  74.  
  75.  
  76. ; STOP BITS.
  77. ; Default: system default (often 1 stop bit)
  78. ; Values : DEFAULT, 1, 1.5, 2
  79. ; Note   : Using one stop bit is recommended.
  80.  
  81. StopBits=1
  82.  
  83.  
  84. ; XON/XOFF FLOW CONTROL FOR RECEIVING.
  85. ; Default: system default (often enabled)
  86. ; Values : DEFAULT, ON, OFF
  87. ; Note   : Enable Xon/Xoff handshaking only if you don't use a cable
  88. ;          with hardware handshake lines (RTS/CTS, DSR/DTR) or if the
  89. ;          receiving side doesn't use hardware handshaking.
  90.  
  91. XonXoffReceiveFlowControl=OFF
  92.  
  93.  
  94. ; XON/OFF FLOW CONTROL FOR TRANSMITTING.
  95. ; Default: system default (often enabled)
  96. ; Values : DEFAULT, ON, OFF
  97. ; Note   : Enable Xon/Xoff handshaking only if you don't use a cable
  98. ;          with hardware handshake lines (RTS/CTS, DSR/DTR) or if the
  99. ;          receiving side doesn't use hardware handshaking.
  100. ;          Xon/Xoff handshaking should normally be set to the same value
  101. ;          for receiving and transmitting.
  102.  
  103. XonXoffTransmitFlowControl=OFF
  104.  
  105.  
  106. ; 16550 HARDWARE BUFFER.
  107. ; Default: system default (often disabled)
  108. ; Values : DEFAULT, ON, OFF
  109. ; Note   : Enable the hardware buffer if your serial card features one.
  110. ;          If you are not sure, it is better to use OFF.
  111.  
  112. Fifo16550=OFF
  113.  
  114.  
  115. ; 16550 HARDWARE BUFFER RECEIVE TRIGGER.
  116. ; Default: system default (often 1)
  117. ; Values : DEFAULT, 1, 4, 8, 14
  118. ; Note   : This setting controls how many received characters are to
  119. ;          be buffered before they are transferred to the application.
  120. ;          Using 1 character is highly recommended.
  121.  
  122. Fifo16550ReceiveTrigger=1
  123.  
  124.  
  125. ; 16550 HARDWARE BUFFER LOAD COUNT.
  126. ; Default: system default (often 1)
  127. ; Values : DEFAULT, 1, 16
  128. ; Note   : This setting controls how many outgoing characters are to be
  129. ;          buffered before they are transmitted to the receiving side.
  130. ;          Using a load count of one is recommended.
  131.  
  132. Fifo16550TransmitBufferLoadCount=1
  133.  
  134.  
  135. ; DSR INPUT SENSITIVITY.
  136. ; Default: system default (often disabled)
  137. ; Values : DEFAULT, DISABLE, ENABLE
  138. ; Note   : If your cable features the DSR (Data Set Ready) line and the
  139. ;          other side controls this signal, enable this setting. This way,
  140. ;          the remote terminal indicates its presence.
  141.  
  142. DSRInputSensitivity=ENABLE
  143.  
  144.  
  145. ; DSR OUPUT HANDSHAKING.
  146. ; Default: system default (often disabled)
  147. ; Values : DEFAULT, DISABLE, ENABLE
  148. ; Note   : If your cable features the DSR (Data Set Ready) line and the
  149. ;          other side controls this signal, enable this setting. This way,
  150. ;          the remote terminal and your computer indicates their presence.
  151.  
  152. DSROutputHandshaking=ENABLE
  153.  
  154.  
  155. ; DTR CONTROL MODE.
  156. ; Default: system default (often disabled)
  157. ; Values : DEFAULT, DISABLE, ENABLE, INPUT_HANDSHAKING
  158. ; Note   : If your cable features the DTR (Data Terminal Ready) line and
  159. ;          the remote terminal makes use of this signal, enable this setting.
  160. ;          This way, your computer starts shaking hands with the other side.
  161.  
  162. DTRControlMode=ENABLE
  163.  
  164.  
  165. ; RTS CONTROL MODE.
  166. ; Default: system default (often disabled)
  167. ; values : DEFAULT, DISABLE, ENABLE, INPUT_HANDSHAKING
  168. ; Note   : If your cable features the RTS (Request To Send) line and the
  169. ;          remote terminal supports this signal, enable this setting. It
  170. ;          is used to control the data flow by hardware.
  171.  
  172. RTSControlMode=ENABLE
  173.  
  174.  
  175. ; CTS OUTPUT HANDSHAKING.
  176. ; Default: system default (often disabled)
  177. ; Values : DEFAULT, DISABLE, ENABLE
  178. ; Note   : If your cable features the CTS (Clear To Send) line and the
  179. ;          remote terminal supports this signal, enable this setting. It
  180. ;          is used to control the data flow by hardware.
  181.  
  182. CTSOutputHandshaking=ENABLE
  183.  
  184.  
  185. ; DCD OUTPUT HANDSHAKING.
  186. ; Default: system default (often disabled)
  187. ; Values : DEFAULT, DISABLE, ENABLE
  188. ; Note   : If your cable features the the DCD (Data Carrier Detect) line
  189. ;          and your remote terminal outputs this signal (which is rarely
  190. ;          used by other devices than modems), enable this setting.
  191. ;          Disabling is recommended in any case.
  192.  
  193. DCDOutputHandshaking=DISABLE
  194.  
  195.  
  196. ; RECEIVE FLOW CONTROL.
  197. ; Default: system default (often normal)
  198. ; Values : DEFAULT, NORMAL, FULLDUPLEX
  199. ; Note   : Using full duplex control isn't supported, so use normal.
  200.  
  201. ReceiveFlowControl=NORMAL
  202.  
  203.  
  204. ; TERMINAL EMULATION.
  205. ; Default: ANSI
  206. ; Values : ANSI, VT52, VT100, VT102, VT110, VT220, VT320
  207. ; Note   : Try ANSI if you're not sure. If your terminal emulation
  208. ;          isn't supported, edit the control strings below to suit your
  209. ;          requirements.
  210.  
  211. Emulation=ANSI
  212.  
  213.  
  214. ; COLOR EMULATION.
  215. ; DEFAULT: NONE
  216. ; Values : NONE, BW, COLOR
  217. ; Note   : Use NONE to get a black/white transmission (fastest).
  218. ;          Use BW if your terminal supports inverse video.
  219. ;          Use COLOR if your terminal supports ANSI colors.
  220.  
  221. Colors=COLOR
  222.  
  223.  
  224. ; NUMER OF SCREEN LINES.
  225. ; Default: 25
  226. ; Values : 24, 25
  227. ; Note   : If your terminal only supports 24 lines, set to 24.
  228. ;          PC terminal programs often have a status line, so the software
  229. ;          might only use 24 of the PC screen's 25 lines. If you are used
  230. ;          to 43 or 50 lines, please setup your software for 24 or 25 lines.
  231.  
  232. ScreenLines=25
  233.  
  234.  
  235. ; NUMBER OF SCREEN COLUMNS
  236. ; Default: 80
  237. ; Values : 80
  238. ; Note   : Does anyone use a display with <> 80 chars/line?
  239. ;          Don't expect good results with values other than 80.
  240.  
  241. ScreenColumns=80
  242.  
  243.  
  244. ; CHARACTER SET FILTER.
  245. ; Default: IBMPC
  246. ; Values : IBMPC, ASCII
  247. ; Note   : If your remote terminal can display the 256 IBM PC characters,
  248. ;          use IBMPC. If you specify ASCII, all non-ASCII chars are replaced
  249. ;          with blanks. If you want a pure ASCII display, is recommended to
  250. ;          set this setting to IBMPC but use the IBMPC2ASCII filter below.
  251. ;          If there is a PC on the remote side, try IBMPC. If it is a terminal,
  252. ;          chances are that you have to use ASCII.
  253.  
  254. CharsetFilter=IBMPC
  255.  
  256.  
  257. ; CHARACTER SET TRANSLATION.
  258. ; Default: NONE
  259. ; Values : NONE, IBMPC2ASCII
  260. ; Note   : Using the IBMPC2ASCII translation replaces every non-ASCII
  261. ;          character that is sent to the remote side with an ASCII character
  262. ;          that is supposed to look like the replaced one. This is a kludge,
  263. ;          but often, results are good enough.
  264.  
  265. CharsetTranslation=NONE
  266.  
  267.  
  268. ; CONTROL SEQUENCE TO ERASE AN ENTIRE SCREEN LINE
  269. ; Default: "\e[%iH\e[K"
  270. ; Note   : %i is replaced with the screen row to be erased (1-25)
  271. ;          If your terminal doesn't know the ESC [ K control sequence, you
  272. ;          can set this setting to "" - in this case it is likely that you
  273. ;          also have to set ANSIEraseStartBlanks to "".
  274.  
  275. ;ANSIEraseLine=""
  276. ANSIEraseLine="\e[%iH\e[K"
  277.  
  278.  
  279. ; CONTROL SEQUENCE TO FILL THE BEGINNING OF A LINE WITH BLANKS
  280. ; Default: "\e[%i;%iH\e[1K"
  281. ; Note   : The first %i is replaced with the screen row;
  282. ;          the second %i corresponds to the number of spaces.
  283. ;          If your terminal doesn't know the ESC [ 1 K control sequence,
  284. ;          set this item to "". Expect certain performance penalties.
  285.  
  286. ;ANSIEraseStartBlanks=""
  287. ANSIEraseStartBlanks="\e[%i;%iH\e[1K"
  288.  
  289.  
  290. ; CONTROL SEQUENCE TO SET THE CURSOR POSITION
  291. ; Default: "\e[%i;%iH"
  292. ; Note   : The first %i is replaced with the screen row;
  293. ;          the second %i corresponds to the column.
  294.  
  295. ANSISetCurPos="\e[%i;%iH"
  296.  
  297.  
  298. ; CONTROL SEQUENCE TO POSITION CURSOR AT THE START OF A LINE
  299. ; Default: "\e[%iH"
  300. ; Note   : %i is replaced with the row.
  301. ;          If your terminal emulation isn't 100% ANSI and you have
  302. ;          display errors, try "\e[%i;1H".
  303.  
  304. ANSIStartOfLine="\e[%iH"
  305.  
  306.  
  307. ; CONTROL SEQUENCE TO MOVE THE CURSOR RIGHT
  308. ; Default: "\e[%iC"
  309. ; Note   : %i is replaced with the number of character positions;
  310. ;          if your terminal doesn't support this control sequence, set it
  311. ;          to "". In this case, there will be a certain performance penalty.
  312.  
  313. ;ANSICursorRight=""
  314. ANSICursorRight="\e[%iC"
  315.  
  316.  
  317. ; CONTROL SEQUENCE TO ERASE TO END OF LINE
  318. ; Default: "\e[K"
  319. ; Note   : If your terminal doesn't support the ESC [ K sequence, set this
  320. ;          item to "". Expect a certain performance penalty.
  321.  
  322. ;ANSIEraseToEOL=""
  323. ANSIEraseToEOL="\e[K"
  324.  
  325.  
  326. ; CONTROL SEQUENCE TO CLEAR THE SCREEN
  327. ; Default: "\e[2J"
  328. ; Note   : If your terminal doesn't support this control sequence, set
  329. ;          it to "". Then, clearing the screen is a little slower...
  330.  
  331. ;ANSIClearScreen=""
  332. ANSIClearScreen="\e[2J"
  333.  
  334.  
  335. ; CONTROL SEQUENCE TO SCROLL THE SCREEN ONE LINE UP
  336. ; Default: "\e[S"
  337. ; Note   : Not all ANSI terminals are 100% ANSI compatible and might
  338. ;          miss this feature. I.e. OS/2's screen ANSI support doesn't
  339. ;          know this sequence. In this case, set this item to "" and
  340. ;          don't forget to set the TerminalLines setting correctly.
  341.  
  342. ;ANSIScrollUp=""
  343. ANSIScrollUp="\e[S"
  344.  
  345.  
  346. ; CONTROL SEQUENCE TO ERASE ONE LINE OF THE SCREEN, USING COLOR
  347. ; Default: "\e[%iH%s\e[K"
  348. ; Note   : %i is replaced with the row number,
  349. ;          %s is replaced with a color control sequence
  350. ;          If your terminal doesn't know the ESC [ K control sequence, you
  351. ;          can set this setting to "" - in this case it is likely that you
  352. ;          also have to set ANSIEraseStartBlanksColor to "".
  353.  
  354. ;ANSIEraseLineColor=""
  355. ANSIEraseLineColor="\e[%iH%s\e[K"
  356.  
  357.  
  358. ; CONTROL SEQUENCE TO ERASE THE START OF A LINE, USING COLOR
  359. ; Default: "\e[%i;%iH%s\e[1K"
  360. ; Note   : the first %i is replaced with the line number;
  361. ;          the second %i is replaced with the next column;
  362. ;          %s is replaced with a color control sequence
  363.  
  364. ;ANSIEraseStartBlanksColor=""
  365. ANSIEraseStartBlanksColor="\e[%i;%iH%s\e[1K"
  366.  
  367.  
  368. ; CONTROL SEQUENCE TO ERASE TO END OF LINE, USING COLOR
  369. ; Default: "%s\e[K"
  370. ; Note   : %s is replaced with a color control sequence
  371.  
  372. ;ANSIEraseToEOLColor=""
  373. ANSIEraseToEOLColor="%s\e[K"
  374.  
  375.  
  376. ; CONTROL SEQUENCE TO SCROLL ONE LINE UP, FILL NEW LINE WITH DEFAULT COLOR
  377. ; Default: "\e[0m\e[S"
  378. ; Note   : Not all ANSI terminals are 100% ANSI compatible and might
  379. ;          miss this feature. I.e. OS/2's screen ANSI support doesn't
  380. ;          know this sequence. In this case, set this item to "" and
  381. ;          don't forget to set the TerminalLines setting correctly.
  382.  
  383. ;ANSIScrollUpColor=""
  384. ANSIScrollUpColor="\e[0m\e[S"
  385.  
  386.  
  387. ; CONTROL SEQUENCE TO SET INTENSITY, FOREGROUND AND BACKGROUND COLOR
  388. ; Default: "\e[%i;%i;%im"
  389. ; Note   : the first %i is replaced with the intensity flag (1=on, 0=off),
  390. ;          the second %i is replaced with the foreground color code,
  391. ;          the third %i is replaced with the background color code.
  392.  
  393. ANSIInFgBg="\e[%i;%i;%im"
  394.  
  395.  
  396. ; CONTROL SEQUENCE TO SET FOREGROUND AND BACKGROUND COLOR
  397. ; Default: "\e[%i;%im"
  398. ; Note   : the first %i is replaced with the foreground color code,
  399. ;          the second %i is replaced with the background color code.
  400.  
  401. ANSIFgBg="\e[%i;%im"
  402.  
  403.  
  404. ; CONTROL SEQUENCE TO SET FOREGROUND COLOR
  405. ; Default: "\e[%im"
  406. ; Note   : %i is replaced with the foreground color code.
  407.  
  408. ANSIFg="\e[%im"
  409.  
  410.  
  411. ; CONTROL SEQUENCE TO SET BACKGROUND COLOR
  412. ; Default: "\e[%im"
  413. ; Note   : %i is replaced with the background color code.
  414.  
  415. ANSIBg="\e[%im"
  416.  
  417.  
  418. ; SCREEN UPDATE FREQUENCY.
  419. ; Default: 1000
  420. ; Values : any number of the range 0 ... n
  421. ; Note   : This is the number of milli-seconds to sleep after a screen
  422. ;          update was sent to the remote terminal. Use 0 for fast updates
  423. ;          that use lots of CPU time on your local machine. Any value
  424. ;          starting with 500 is acceptable.
  425.  
  426. UpdateFrequency=1000
  427.  
  428.  
  429. ; SCREEN UPDATE PRIORITY.
  430. ; Default: REGULAR
  431. ; Values : IDLE, REGULAR, TIMECRITICAL
  432. ; Note   : Specify which priority the screen updates should have.
  433. ;          IDLE is only active if no other processes are active,
  434. ;          REGULAR is the standard priority, TIMECRITICAL processes
  435. ;          get CPU time with highest priority.
  436.  
  437. UpdatePriority=REGULAR
  438.  
  439.  
  440. ; SCREEN UPDATE PRIORITY DELTA.
  441. ; Default: DEFAULT
  442. ; Values : MINIMUM, DEFAULT, MAXIMUM
  443. ; Note   : Specify if screen updates are to be run with minimum, default
  444. ;          or maximum priority within their priority class. Beware of
  445. ;          using MAXIMUM together with TIMECRITICAL priority. Don't
  446. ;          wonder about nothing happening - the screen update routine will
  447. ;          pull all CPU power off WatchCat...
  448.  
  449. UpdatePriorityDelta=MAXIMUM
  450.  
  451.  
  452. ; TERMINAL INITIALISATION STRING
  453. ; Default: "\e[?2l\e<\e[0m\e[2J"
  454. ; Note   : It is a good idea to reset your terminal to default settings...
  455. ;          The default string jumps in and out of VT52 mode, clears all
  456. ;          attributes and clears the screen.
  457.  
  458. InitString="\e[?2l\e<\e[0m\e[2J"
  459.  
  460.  
  461. ; CURSOR UPDATE.
  462. ; Default: CHANGE
  463. ; Values : NEVER, CHANGE, ALWAYS
  464. ; Note   : Specify if the cursor position on your terminal shall NEVER
  465. ;          reflect the cursor position on the local machine, if it shall
  466. ;          be updated if something changed on the local screen or if the
  467. ;          cursor position is to be updated every screen update.
  468.  
  469. CursorUpdate=CHANGE
  470.  
  471.  
  472. ; LAST CHARACTER MODE.
  473. ; Default: OFF
  474. ; Values : ON, OFF, INSERT
  475. ; Note   : Most terminals can't print the last character of the last line
  476. ;          on their screen without scrolling up one line thereafter,
  477. ;          destroying the screen contents. If this is the case, either turn
  478. ;          off the update of this character by using OFF, or try INSERT and
  479. ;          see if this trick works on your terminal.
  480.  
  481. LastChar=INSERT
  482.  
  483. ; NUMER OF LINES YOUR TERMINAL CAN USE TO DISPLAY CHARACTERS
  484. ; Default: 25
  485. ; Values : 25-50
  486.  
  487. TerminalLines=25
  488.  
  489.  
  490. ; HOTKEY FOR SCREEN REFRESH
  491. ; Default: ESC R
  492. ; Values : any string representing a hotkey code sequence your terminal sends.
  493. ; Note   : To refresh the screen in case of data corruption or start of the
  494. ;          remote terminal (program) after WatchCat, use this hotkey sequence
  495. ;          on the remote terminal to force a screen refresh.
  496.  
  497. RefreshSequence="\er"
  498.  
  499.  
  500. ; HOTKEY FOR COLOR TOGGLE
  501. ; Default: ESC c
  502. ; Values : any string representing a hotkey code sequence your terminal sends.
  503. ; Note   : To toggle color/mono display at runtime, use this hotkey.
  504.  
  505. ColorToggleSequence="\ec"
  506.  
  507.