home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 3 Comm / 03-Comm.zip / SLIDCO.ZIP / README < prev    next >
Text File  |  1993-02-02  |  4KB  |  114 lines
  1.                                  INTRODUCTION
  2.                                  ------------
  3.  
  4.  
  5. Slidcom is a PM "Slider" application that uses the IOCTL commands
  6. to communicate via COM1, 2, 3, or 4, to a dumb terminal or similar
  7. device. For example: The user hooks up a dumb terminal to one of the
  8. COM  ports.  Sets the dumb terminal to 9600 baud, 8 bit, no parity, 1 stop
  9. bit. Next bring up Slidcom from an OS2 prompt. Using the pull down menus,
  10. select a  COM port and then initialize the line settings to match the
  11. dumb terminal. A null modem may/may not be needed. Next, click on the
  12. slider. Moving the slider arm will cause ASCII characters to be displayed on
  13. the  dumb terminal. Entering a value between 0 and 100 followed by <cr> at
  14. the  dumb terminal,  will move the slider arm to the corresponding
  15. position.
  16.  
  17.  
  18. APPLICATION SPECIFIC NOTES:
  19.  
  20. 1. Make the sure the line settings on the dumb terminal match that of
  21.    the  slider.
  22.  
  23. 2. A null modem may or may not be required.
  24.  
  25. 3. I noticed that this application runs somewhat differently depending
  26.    whether or not the OS2 service pack updates have been applied to
  27.    your  system.  Suggest you install these updates.
  28.  
  29. 4. Debug messages were left in. These will typically occur when trying
  30.    to  select an invalid COM port. The RC number displayed is the return
  31.    code  of the API call that failed. This code is displayed in Appendix B
  32.    of the Control Program Programming Reference.
  33.  
  34.  
  35. USAGE:
  36.  
  37.   The slider has most of the "slider type features". The slider arm can
  38.   be moved by clicking on the "indents", the arrows under the  numbers.
  39.   The slider arm can also be moved by placing the mouse on  the slider
  40.   shaft on either side of the slider indent and clicking. It can also be
  41.   moved by clicking on the direction arrows at the right end of the slider
  42.   shaft. The left and right arrow keyboard keys can also be used. The 
  43.   home and end keys also work, however make sure the slider arm has the
  44.   focus. You can do this by using the up or down arrow keys.
  45.  
  46.   You will notice a slight delay for the ASCII numbers that appear at
  47.   the   dumb terminal when moving the slider arm. This delay was deliberately
  48.   put in to keep the user from flooding the IOCTL commands with output
  49.   by rapidly and constantly dragging the slider arm back and forth.
  50.  
  51.  
  52.                            DEVELOPER NOTES:
  53.  
  54. OVERVIEW
  55. --------
  56.  
  57. There are three task for this application. The main task runs all the
  58. window stuff. The two remaining task are a "transmit" and "receive"
  59. task used for sending and receiving data via the COM port and dumb
  60. terminal.
  61.  
  62.  
  63. SLIDCOM Module
  64. --------------
  65.  
  66. This module contains the basic code to bring up and display the
  67. window. It handles all the necessary window functions required. It 
  68. also contains a number of common subroutines used by the other
  69. modules.
  70.  
  71.  
  72. SLIDDLG Module
  73. --------------
  74.  
  75. This module contains all the code to handle the Dialog boxes used for
  76. setting up the COM port, line initialization and the slider itself. Each
  77. of these have its own dialog procedure.
  78.  
  79. The slider dialog code collects the slider position number and displays
  80. it in the side window.  A  window timer function comes around every 750
  81. msecs to pickup the latest value and sends it to the dumb terminal driver
  82. task via a function call. 
  83.  
  84.  
  85.  
  86. PMCOMDRV  Module
  87. ----------------
  88.  
  89. This  module contains the I/O driver code and tasks for sending and
  90. receiving data via COM port and dumb terminal.
  91.  
  92. The receive task collects a character at a time and upon receipt of <CR>
  93. sends the data via  the "WinPostMsg" API. This is then picked up in the
  94. Slider dialog code, (SLIDDLG module) via WM_TERMINAL_MSG and  displayed
  95. at the slider.
  96.  
  97. For the transmit task, when the timer in SLIDDLG module comes around it
  98. collects the data from the slider and via function call PrintTerm(void *ptr)
  99. sends the message to the transmit task. The PrintTerm functions allocates
  100. some shared memory, copies the data over and then does a DosWriteQueue.
  101. The transmit task is pending on this queue. When it gets a message off
  102. the queue it then sends it to the dumb terminal and deallocates the message
  103. buffer.
  104.  
  105.  
  106. This application was developed using the OS2 toolkit and C Set/2 tools
  107.  
  108.  
  109. Regards,
  110.  
  111. Dale G. Herrig
  112. 72740,467
  113.  
  114.