home *** CD-ROM | disk | FTP | other *** search
/ ftp.barnyard.co.uk / 2015.02.ftp.barnyard.co.uk.tar / ftp.barnyard.co.uk / cpm / walnut-creek-CDROM / CPM / TURBODSG / REMDRV.DOC < prev    next >
Text File  |  2000-06-30  |  9KB  |  268 lines
  1. .HE REMOTE MODEM DRIVER COPYRIGHT (C) 1985, S. KLUGER
  2. .FO REMDRV DOCUMENTATION PAGE #
  3.  
  4.  
  5.  
  6.      REMDRVéá i≤ ß modulσ which¼á wheε useΣ iε placσ oµ thσ CONREMä ì
  7. modulσ iε ß TurboDO╙ 1.4▒ maste≥ operatinτ system¼á allow≤ al∞ oµ ì
  8. tha⌠ master'≤ slavσ t∩ acces≤ u≡ t∩ 1╢ I/╧ devices«á Onσ possiblσ ì
  9. applicatioεá woulΣ bσ (iε conjunctioε witΦ thσ appropriatσá softì
  10. ware⌐ acces≤ oµ multiplσ modem≤ b∙ an∙ slave« WitΦ aε intelligen⌠ ì
  11. termina∞á program¼á modeφ selectioε woulΣ bσ transparen⌠á t∩á thσ ì
  12. user¼á s∩á tha⌠á activatinτá thσ utilit∙ woulΣ selec⌠á thσá firs⌠ ì
  13. availablσ modem¼ unti∞ al∞ modem≤ arσ busy.
  14.  
  15.  
  16.  
  17.                      INSTALLATION of REMDRV
  18.  
  19.      Installatioε oµ REMDRVé i≤ straightforwarΣ anΣ require≤á onl∙ ì
  20. ßá mino≥á changσ iε OSMASTER.GEN«á Pleasσ notσ tha⌠á thσá releasσ ì
  21. version of REMDRV consists of three serialized .REL files:
  22.           REMDRV.REL     the remote modem driver
  23.           REMCH0.REL     master comm port "0" driver
  24.           REMCH1.REL     master comm port "1" driver
  25.           NOTE: For the 16-bit package, the files are named .O
  26. Iε addition¼ thσ followinτ file≤ arσ par⌠ oµ thσ releasσ softwarσ ì
  27. package:
  28.           REMCH0.MAC     an example of a REMDRV  companion module
  29.                          using the OEM-supplied drivers  (via the
  30.                          COMDRV## entry point)
  31.           ATTREM.MAC     an example of a simple  terminal program
  32.                          with modem select capability
  33.           ATTREM.COM     object code of above
  34.           ATTREM.CMD     same, for 16 bit systems
  35.           REMDRV.DOC     this text
  36.  
  37.  
  38.      T∩ install¼ simpl∙ adΣ thσ followinτ linσ t∩ OSMASTER.GEN
  39.  
  40. REMDRV,REMCH0,REMCH1
  41.  
  42.  
  43. WitΦá thi≤ change¼á tw∩ remotσ modeφ channel≤ becomσ activσ.
  44. .paè
  45.  
  46.                        THEORY OF OPERATION
  47.  
  48.      REMDRVéá allow≤á an∙ use≥ oε an∙ slavσ iεá ßá smal∞á TurboDO╙ ì
  49. networδá t∩á acces≤á u≡ t∩ 1╢ seria∞ channel≤ (commonl∙á useΣá fo≥ ì
  50. modems)¼á provideΣá thσ channe∞ i≤ free«á REMDRVé i≤ accesseΣá viß ì
  51. DEFDID¼á therefore¼ thσ statioε requestinτ acces≤ mus⌠ bσ ß slavσ ì
  52. oµá thσá maste≥á whicΦ run≤ REMDRVé (rathe≥ thaε thσá slavσá oµá ß ì
  53. second master networked into the first).
  54.  
  55.      REMDRV provides the following functions:
  56.  
  57.      1. attach to remote driver
  58.      2. detach from remote driver
  59.      3. set remote baud rate
  60.      4. interrogate remote baud rate
  61.      5. character buffer I/O
  62.  
  63.      Thσá followinτ tex⌠ explain≤ eacΦ functioε iε grea⌠á detail¼ ì
  64. includinτá al∞ parameter≤ t∩ bσ passed«á Noteä tha⌠ fo≥ al∞ REMDRVé ì
  65. functions the C register (CL in 8086) must be set to 33 (21H).
  66.  
  67.  
  68. 1 - ATTACH TO REMOTE DRIVER
  69.  
  70.      Thi≤á functioεá initiate≤ ß remotσ I/╧ sessioε anΣá mustôá bσ ì
  71. calleΣ prio≥ t∩ an∙ remotσ activit∙ fo≥ thσ desireΣ port.
  72.  
  73.      entry:
  74.      reg D (DH)     0FEH
  75.      reg B (CH)     channel number 00..0FH
  76.      return:
  77.      reg A (AL)     000H = successful attach
  78.                     0FFH = requested channel busy
  79.                     0FEH = requested channel not implemented
  80.  
  81.  
  82. 2 - DETACH FROM REMOTE DRIVER
  83.  
  84.      Thi≤á functioεá i≤á useΣ a⌠ thσ conclusioε oµ ßá remotσá I/╧ ì
  85. sessioεá t∩ 1⌐ freσ thσ por⌠ fo≥ anothe≥ use≥ anΣ 2⌐á unlinδá thσ ì
  86. port so as not to waste processing power in the master
  87.  
  88.      entry:
  89.      reg D (DH)     0FDH
  90.      reg B (CH)     channel number 00..0FH
  91.      return:
  92.      none (channel is detached)
  93. .paè
  94.  
  95. 3 - SET REMOTE BAUD RATE
  96.  
  97.      Allow≤ settinτ oµ thσ attacheΣ channel'≤ bauΣ rate« Thσ bauΣ ì
  98. ratσá specificatioε paramete≥ i≤ identica∞ t∩ thσ onσ useΣ iεá T-ì
  99. functioε 3╖ (se⌠ bauΣ rate).
  100.  
  101.      entry:
  102.      reg D (DH)     0FCH
  103.      reg B (CH)     channel number 00..0FH
  104.      reg E (DL)     baud rate code (ex. 9600=0EH)
  105.      return:
  106.      none (baud rate is set)
  107.  
  108.  
  109. 4 - GET REMOTE BAUD RATE
  110.  
  111.      Return≤á thσ remotσ bauΣ ratσ codσ (thσ codσ i≤ identica∞ t∩ ì
  112. the one returned by T-function 38).
  113.  
  114.      entry:
  115.      reg D (DH)     0FBH
  116.      reg B (CH)     channel number 00..0FH
  117.      returb:
  118.      reg A (AL)     baud rate code (ex. 9600=0EH)
  119.  
  120.  
  121. 5 - CHARACTER BUFFER I/O
  122.  
  123.      Thi≤á functioε i≤ useΣ t∩ transfe≥ datß betweeε thσ selecteΣ ì
  124. por⌠ anΣ thσ callinτ software« Pleasσ notσ tha⌠ thσ transfe≥ FROMä ì
  125. thσ decivσ alway≤ involve≤ ß blocδ oµ data¼ u≡ t∩ 12╖ characters¼ ì
  126. written to the current DMA address.
  127.  
  128.      entry:
  129.      reg D (DH)     0FAH
  130.      reg B (CH)     channel number 00..0FH
  131.                     bit 7 set if output is desired
  132.      reg E (DL)     output character (if any)
  133.      return:
  134.      reg A (AL)     number of input characters read into buffer
  135.      DMA ADDRESS    count (same as A) followed by the input data
  136. .paè
  137.  
  138. SAMPLE PROGRAM ATTREM
  139.  
  140.      Thi≤á samplσ attach-program¼á supplieΣ iε sourcσ anΣá objec⌠ ì
  141. format¼ allow≤ yo⌡ t∩ attacΦ t∩ anΣ detacΦ froφ an∙ activσ REMDR╓ ì
  142. por⌠á oε thσ master«á Thσ prograφ caε bσ useΣ froφ an∙ slavσ tieΣ ì
  143. t∩á tha⌠ master«á I⌠ wil∞ rejec⌠ attemp⌠ t∩ attacΦ t∩ ßá bus∙á o≥ ì
  144. non-existan⌠ port.
  145.  
  146. USAGE
  147.  
  148. Thσá followinτá i≤ ß samplσ sessioε witΦá ATTRE═á (bold=computer¼ ì
  149. light=user):
  150.  
  151. 0A}attrem
  152.  
  153. ONLY PORTS A..P ALLOWED
  154.  
  155. 0A}attrem a
  156.  
  157. ATTACHED TO PORT A AT 1200 BAUD
  158.           (communication takes place)
  159.           ......
  160.           (now ATTN-ABORT is typed on console)
  161. DETACHED FROM PORT A
  162.  
  163. 0A}attrem c
  164.  
  165. ERROR: PORT C DOES NOT EXIST
  166.  
  167. 0A}attrem b              (assume you are attached to B on
  168.                          another terminal)
  169.  
  170. ERROR: PORT B IS BUSY
  171.  
  172. 0A}
  173. .paè.HE SOFTWARE RELEASE NOTES, LEGALITIES
  174.  
  175.  
  176.  
  177.  
  178.                           RELEASE NOTE
  179.  
  180.  
  181.  
  182.      REMDRVéá i≤ ß copyrighteΣ produc⌠ oµ S«á Kluger¼á Dalla≤á TX« ì
  183. Reproductioεá (othe≥ thaε fo≥ archiva∞ usσ o≥ fo≥ systeφá generaì
  184. tion⌐ withou⌠ writteε authorizatioε i≤ prohibited« Disassembl∙ o≥ ì
  185. unauthorizeΣá reserializatioεá i≤á prohibited«áá Noteéá tha⌠á thi≤ ì
  186. applies only to REMDRV.REL or REMDRV.O!
  187.  
  188.      REMDRVéá i≤á availablσ iε tw∩ forms¼á 1⌐ fo≥ usσá witΦá 8-bi⌠ ì
  189. masters and 2) for use with 16-bit 80186 (!) masters.
  190. BotΦ version≤ includσ thσ samplσ ATTREMé prograφ iε 8- anΣá 16-bi⌠ ì
  191. flavors, but only ATTREM.MAC is supplied.
  192.  
  193.      REMDRVéá ma∙á periodicall∙á bσ updateΣá o≥á improveΣá withou⌠ ì
  194. notice«á Update≤á arσá freσá iµ thσá origina∞á maste≥á disδá witΦ ì
  195. sufficien⌠á returεá postagσ i≤ sent«á  ╔ d∩ no⌠ expec⌠ an∙á majo≥ ì
  196. updates to be more frequent than one per 3 months.
  197.  
  198.      BUG REPORTS are strongly encouraged!
  199. .paè.HE REMDRV ORDER FORM
  200.  
  201.          (fill out completely and send the whole sheet)
  202.  
  203. Pleasσ senΣ _____▀ copie≤ oµ REMDRV«á Serializatioε anΣá version≤ ì
  204. are as follows: (NOTE: only one copy per serial #)
  205.  
  206. TurboDO╙áseria∞ numbe≥ ____/___▀ REMDR╓ versioε (╕áo≥á16⌐ _______
  207.  
  208. TurboDO╙áseria∞ numbe≥ ____/___▀ REMDR╓ versioε (╕áo≥á16⌐ _______
  209.  
  210. TurboDO╙áseria∞ numbe≥ ____/___▀ REMDR╓ versioε (╕áo≥á16⌐ _______
  211.  
  212. TurboDO╙áseria∞ numbe≥ ____/___▀ REMDR╓ versioε (╕áo≥á16⌐ _______
  213.  
  214. TurboDO╙áseria∞ numbe≥ ____/___▀ REMDR╓ versioε (╕áo≥á16⌐ _______
  215.  
  216. TurboDO╙áseria∞ numbe≥ ____/___▀ REMDR╓ versioε (╕áo≥á16⌐ _______
  217.  
  218. TurboDO╙áseria∞ numbe≥ ____/___▀ REMDR╓ versioε (╕áo≥á16⌐ _______
  219.  
  220. TurboDO╙áseria∞ numbe≥ ____/___▀ REMDR╓ versioε (╕áo≥á16⌐ _______
  221.  
  222. TurboDO╙áseria∞ numbe≥ ____/___▀ REMDR╓ versioε (╕áo≥á16⌐ _______
  223.  
  224. (continue on back if more room needed)
  225.  
  226. Name: __________________________  Company: ______________________
  227.  
  228. Address: ________________________________________________________
  229.  
  230.          ________________________________________________________
  231.  
  232.          ________________________________________________________
  233.  
  234. Phone number: (____) _____ - ________
  235.  
  236.  
  237.      Total number of copies:       _______ at $25.00 each
  238.  
  239.      Check or Money Order enclosed for  $ _________.00
  240. or
  241.      Please ship COD     (postage/COD fees added to total)
  242.  
  243.  
  244. Please sign here to accept the restrictions
  245. placeΣáoεáthσáproduc⌠áoεáthσápreviou≤ápagσá║ ___________________
  246.  
  247. NOTE║á pleasσá checδá herσá iµ yo⌡ have║á (__⌐ ┤á differen⌠á disδ ì
  248. drivers or (__) 4 different circuits defined in your master.
  249. .paè.HE RELEASE NOTES FOR DEMO VERSION "REMDRVT.REL"
  250.  
  251.  
  252.      Thi≤ i≤ ß dem∩ version« Licensσ i≤ granteΣ fo≥ noncommercia∞ ì
  253. use and distribution for demonstration purposes only.
  254.  
  255.  
  256.      REMDRVT operates like the real REMDRV with the following
  257. important differences:
  258.  
  259. -    REMCH░á onl∙ i≤ supplieΣ fo≥ usσ witΦ comφ channe∞ ░ oεá thσ ì
  260. ááááámaster.
  261. -    Only one remote driver (normally REMCH0) can be used
  262. -    Attempt≤ t∩ acces≤ an∙ function≤ witΦ thσ B-registe≥ noté se⌠ ì
  263. áááááto 00H (channel 0) may result in a total system crash.
  264.  
  265.      REMDRVTéá allow≤á freσ acces≤ t∩ remotσ channe∞ "Aóá witΦá n∩ ì
  266. restrictions.
  267.  
  268.