home *** CD-ROM | disk | FTP | other *** search
/ Power-Programmierung / CD1.mdf / basic / library / qb_pds / communic / qbfs10 / qbfoss.doc < prev    next >
Encoding:
Text File  |  1994-04-18  |  6.8 KB  |  197 lines
  1. ┌─────────────────────────────────────────────────────────────────────────────┐
  2. │  ████┐  █████┐  ██████┐  ████┐   ████┐   ████┐                              │
  3. │ ██┌─██┐ ██┌─██┐ ██┌───┘ ██┌─██┐ ██┌─██┐ ██┌─██┐     QuickBASIC V4.5 & VBDOS │
  4. │ ██│ ██│ ██│ ██│ ██│     ██│ ██│ ██│ └─┘ ██│ └─┘                             │
  5. │ ██│ ██│ █████┌┘ ████┐   ██│ ██│ └████┐  └████┐                              │
  6. │ ██│ ██│ ██┌─██┐ ██┌─┘   ██│ ██│  └──██┐  └──██┐         FOSSIL-Library V1.0 │
  7. │ ██│██┌┘ ██│ ██│ ██│     ██│ ██│ ██  ██│ ██  ██│                             │
  8. │ └███┐█┐ █████┌┘ ██│     └████┌┘ └████┌┘ └████┌┘                             │
  9. │  └──┘└┘ └────┘  └─┘      └───┘   └───┘   └───┘                              │
  10. └─────────────────────────────────────────────────────────────────────────────┘
  11.  
  12.   I needed some good routines to use a FOSSIL for creating communication-
  13.   programms/utils in QuickBASIC (V4.5) or VBDOS, I found some other librarys
  14.   which didn't work correctly or weren't the routines i was looking for.
  15.  
  16.   I needed some WORKING and RELIABLE routines, i didn't find any, so i
  17.   decided to write my own library, so here it is: QBFOSS.
  18.  
  19.   QBFOSS has all the routines you need to use a FOSSIL for communications,
  20.   it's fast and reliable.
  21.  
  22.   And last but not least: QBFOSS is FREEWARE!
  23.  
  24. ┌─────────────────────────────────────────────────────────────────────────────┐
  25. │ ▒▒▒▒ Disclaimer ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  26. └─────────────────────────────────────────────────────────────────────────────┘
  27.  
  28.   QBFOSS is supplied as is. The author disclaims all warranties, expressed
  29.   or implied, including, without limitation, the warranties of
  30.   merchantability and of fitness for any purpose.
  31.  
  32.   The author assumes no liability for damages, direct or consequential, which
  33.   may result from the use of QBFOSS.
  34.  
  35.   Feel free to share QBFOSS with your friends, but please do not give it away
  36.   altered or as part of another system.
  37.  
  38.   In commercial environments QBFOSS may only be used when the author has
  39.   given his explicit permission.
  40.  
  41. ┌─────────────────────────────────────────────────────────────────────────────┐
  42. │ ▒▒▒▒ Requires ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  43. └─────────────────────────────────────────────────────────────────────────────┘
  44.  
  45.   QBFOSS requires the following: QuickBASIC V4.5 or VBDOS
  46.  
  47.   QBFOSS uses about 2048 bytes conventional memory.
  48.  
  49. ┌─────────────────────────────────────────────────────────────────────────────┐
  50. │ ▒▒▒▒ Usage ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  51. └─────────────────────────────────────────────────────────────────────────────┘
  52.  
  53.   To use QBFOSS in the interperter, type:
  54.  
  55.     QB /LQBFOSS
  56.  
  57.     or
  58.  
  59.     VBDOS /LQBFOSS
  60.  
  61.   When QuickBASIC/VBDOS is loaded, you must load/merge QBFOSS.BI for the
  62.   declarations of the SUB-Routines and FUNCTIONS QBFOSS contains.
  63.  
  64.   All fossil-routines uses port-definations as used by a FOSSIL,
  65.   starting with zero: COM1: is FOSSIL-Port 0
  66.                       COM2: is FOSSIL-Port 1
  67.                       etc.
  68.  
  69.   The FOSSINIT routines must be called as first procedure before any of
  70.   the other routines can be used.
  71.  
  72.  
  73.   The following sub-routines are availble:
  74.   
  75.   Name       : FOSSDTR
  76.   Declaration: DECLARE SUB fossdtr (Port%, DTRState%)
  77.   Description: With FOSSDTR you change the DTR state, when DTRState% is
  78.                0 you disable DTR (Disconnect), something else will
  79.                enable DTR.
  80.   Example    : FOSSDTR 0
  81.  
  82.  
  83.   Name       : FOSSEXIT
  84.   Declaration: DECLARE SUB fossexit (Port%)
  85.   Description: Close FOSSIL-Port Port%.
  86.   Example    : FOSSEXIT 0
  87.  
  88.  
  89.   Name       : FOSSFLUSHOUT
  90.   Declaration: DECLARE SUB fossflushout (Port%)
  91.   Description: Flushes the output-buffer, waits until buffer is empty.
  92.   Example    : FOSSFLUSHOUT 0
  93.  
  94.  
  95.   Name       : FOSSPURGEIN
  96.   Declaration: DECLARE SUB fosspurgein (Port%)
  97.   Description: Purge input-buffer.
  98.   Example    : FOSSPURGEIN
  99.  
  100.  
  101.   Name       : FOSSPURGEOUT
  102.   Declaration: DECLARE SUB fosspurgeout (Port%)
  103.   Description: Purge output-buffer.
  104.   Example    : FOSSPURGEOUT
  105.  
  106.  
  107.   Name       : FOSSSENDC
  108.   Declaration: DECLARE SUB fosssendc (Port%, Char$)
  109.   Description: Sends a character, does NOT wait until sended.
  110.   Example    : FOSSSENDC 0, "A"
  111.  
  112.  
  113.   Name       : FOSSSENDCW
  114.   Declaration: DECLARE SUB fosssendcw (Port%, Char$)
  115.   Description: Sends a character, waits until charachter is sended.
  116.   Example    : FOSSSENDCW 0, "A"
  117.  
  118.  
  119.   Name       : FOSSWRITE
  120.   Declaration: DECLARE SUB fosswrite (Port%, Write$)
  121.   Description: Sends a string, waits until whole string is sended.
  122.   Example    : FOSSWRITE 0, "This text is send to the FOSSIL"
  123.  
  124.  
  125.  
  126.  
  127.   The following functions are availble:
  128.  
  129.   Name       : FOSSCARRIER
  130.   Declaration: DECLARE FUNCTION fosscarrier% (Port%)
  131.   Description: Returns -1 when a carrier is detected, 0 when not.
  132.   Example    : CD% = FOSSCARRIER%(0)
  133.  
  134.  
  135.   Name       : FOSSINIT
  136.   Declaration: DECLARE FUNCTION fossinit% (Port%)
  137.   Description: Initialize FOSSIL, returns -1 when succesfull, 0 when not.
  138.   Example    : STATUS% = FOSSINIT%(0)
  139.  
  140.  
  141.   Name       : FOSSINWAIT
  142.   Declaration: DECLARE FUNCTION fossinwait% (Port%)
  143.   Description: Returns -1 when data is waiting in the input-buffer,
  144.                0 when input-buffer is empty.
  145.   Example    : WAITING% = FOSSINWAIT%(0)
  146.  
  147.  
  148.   Name       : FOSSOUTROOM
  149.   Declaration: DECLARE FUNCTION fossoutroom% (Port%)
  150.   Description: Returns -1 when there is room in the output-buffer,
  151.                0 when output-buffer is full.
  152.   Example    : ROOM% = FOSSOUTROOM%(0)
  153.  
  154.  
  155.   Name       : FOSSREAD
  156.   Declaration: DECLARE FUNCTION fossread$ (Port%)
  157.   Description: Read input-buffer as string, returns a empty string when
  158.                input-buffer is empty.
  159.   Example    : READ$ = FOSSREAD$(0)
  160.  
  161.  
  162.   Name       : FOSSRECVCW
  163.   Declaration: DECLARE FUNCTION fossrecvcw$ (Port%)
  164.   Description: Wait on a charachter to be received.
  165.   Example    : CHAR$ = FOSSRECVCW$(0)
  166.  
  167.  
  168.   Name       : FOSSSTATUS
  169.   Declaration: DECLARE FUNCTION fossstatus% (Port%)
  170.   Description: Returns FOSSIL status.
  171.   Example    : CHAR$ = FOSSSTATUS(0)
  172.  
  173. ┌─────────────────────────────────────────────────────────────────────────────┐
  174. │ ▒▒▒▒ Support ▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒▒ │
  175. └─────────────────────────────────────────────────────────────────────────────┘
  176.  
  177.   For bug-reports, suggestions or other things concerning QBFOSS, you can
  178.   write me a letter at the followin address:
  179.  
  180.     C.Buijs
  181.     De Spil 22
  182.     1507 CX Zaandam
  183.     Netherlands
  184.  
  185.   Or phone to my BBS:
  186.  
  187.     Action Board Zaandam
  188.     Phone: +31-(0)75-704890
  189.     Speeds: 1200,2400 HST MNP V42 V42Bis 14.400
  190.  
  191.   Or send me Email, FidoNet   : 2:280/407.16
  192.                     InterNet  : 100117.3242@compuserve.com
  193.                     Compuserve: 100117,3242
  194.  
  195.   Have Fun...
  196.  
  197.