home *** CD-ROM | disk | FTP | other *** search
/ Amiga ISO Collection / AmigaUtilCD1.iso / Fax / afax142.lha / AmigaFax / docs / Class-2.0.txt < prev    next >
Encoding:
Text File  |  1994-12-05  |  6.0 KB  |  189 lines
  1. AmigaFax Service Class-2.0 Interface
  2. ====================================
  3. 14NOV94 DAV
  4.  
  5.  
  6.  Note: Please see "changes" at end for latest modifications
  7.  *****
  8.  
  9. Beta versions of the AmigaFax modules Faa and AFaxSend are available
  10. for testing. The version numbers are currently 1.42beta, compile date
  11. 14NOV94. There is also a new version of getty, uident V1.17-beta.17.
  12.  
  13. The new programs have so far only been tested on a ZyXEL U-1496
  14. FaxModem with Class-2.0 ROMs. I would like to hear from users with
  15. other Class-2.0 modems, eg USR. The ZyXEL also handles Class-2, so
  16. results may not be 100% consistent.
  17.  
  18. No new features have been added, and some changes may be needed to run
  19. on heavily customized Class-2 installations, so I don't advise Class-2
  20. only users to get this version yet.
  21.  
  22.  
  23. Setting Up
  24. ==========
  25.  
  26. You should have a current Version 1.41 installation in place. Copy the
  27. new Faa and AFaxSend for AFAX:c, and the new getty to your normal
  28. getty location (eg UUCP:c). Make sure you have backups of your originals.
  29.  
  30. You must define the configuration variable
  31.  
  32. FCLASS 2.0
  33.  
  34. either in your FAXLIB:Config file, or your global or local environment.
  35.  
  36. SetEnv FCLASS 2.0
  37.  
  38.  
  39. The new getty uses bit 3 of the -F flags to indicate Class-2.0
  40. operation, so you must add 8 to these flags on getty startup.
  41.  
  42. eg
  43.  
  44. getty -Mh -B19200 -x9 -F6 AT&C1&D3+FCC=1,5,0,2
  45.  
  46.  becomes
  47.  
  48. getty -Mh -B19200 -x9 -F14 AT&C1&D3+FCC=1,5,0,2
  49.  
  50.  
  51. If you have any configuration values setup in config file or
  52. environment for WSetup, RSetup, XONXOFF, or various modem command
  53. overrides, you should remove them, or modify them according to
  54. specifications below.
  55.  
  56. AFaxSend
  57. ========
  58.  
  59. For Class-2.0 the default WSetup string is:
  60.  
  61. AT&C1&D3S7=255+FCLASS=2.0+FNR=1,1,1,0+FCC=1,5,0,2
  62.  
  63. Faa
  64. ===
  65.  
  66. For Class-2.0 the default RSetup string is:
  67.  
  68. AT&C1&D3S7=255+FCLASS=2.0+FNR=1,1,1,0+FCR=1+FAA=1+FCC=1,5,0,2 ATS0=2
  69.  
  70. With the change to 2.0, the Phase-C bit order on receive appears to
  71. have been reversed. I am not sure if this is universal, or a fault
  72. with the ZyXEL 6.13 ROMs, as the ZyXEL currently disregards the +FBO
  73. bit-order control. I am currently reversing when in 2.0, UNLESS the
  74. config variable "OldBitOrder" is defined. If you receive faxes that
  75. appear unreadable in Class-2.0 mode, try a
  76.  
  77. SetEnv OldBitOrder 1
  78.  
  79. and see if that helps. If so, PLEASE let me know as soon as possible.
  80.  
  81. Modem Commands
  82. ==============
  83.  
  84. The inbuilt modem commands are shown below. You should not need to
  85. override these, as 2.0 is now an approved standard. Some of these
  86. (eg +FPTS) are not used by AmigaFax.
  87.  
  88. +FCO +FCI +FTI +FCS +FIS +FKS +FPTS +FET +FHS
  89. +FDT +FDR +FLI +FIS
  90.  
  91. Note that some of the Class-2 inbuilts have been modified also.  The
  92. current Class-2 commands are:
  93.  
  94. +FCON +FCSI +FTSI +FDCS +FDIS +FK +FPTS +FET +FHNG
  95. +FDT +FDR +FLID +FDIS
  96.  
  97. Flow Control
  98. ============
  99.  
  100. Class-2.0 defaults to Xon/Xoff flow control, which I am not too fond
  101. of. This will be set automatically (afaxsend only) when in 2.0 mode.
  102. However you can override this with the XONXOFF config variable.
  103.  
  104. SetEnv XonXoff 1
  105.  
  106. will force Xon/Xoff flow control to be used,
  107.  
  108. SetEnv XonXoff 0
  109.  
  110. will disable it, regardless of the FCLASS setting.
  111.  
  112. However if you have hardware handshaking, and want your modem to use
  113. it, you should add
  114.  
  115. AT+FLO=2
  116.  
  117. to your RSetup and WSetup strings, as well as to your getty startup
  118. initialization array. This may become the default later. Comments ?
  119.  
  120. getty
  121. =====
  122.  
  123. Under the original Class-2 specification, it was possible to leave the
  124. modem in FCLASS=0 (data) mode, with FAA=1, and to automatically
  125. receive a fax, along with data on connect speed and remote ID.
  126.  
  127. With the ZyXEL U-1946, supporting Class-2 and Class-2.0, in data mode
  128. the modem reports fax connection parameters in Class-2 format only.
  129. With other Class-2.0 modems, it may not do so at all.
  130. Instead the standard allows for a modem in FCLASS=2.0 with FAA=1 to
  131. automatically detect a data call, and to connect in data mode. The
  132. parameter +FNR=1,1,1,0 must be set in order to get connection data,
  133. and to negotiate transfer rates greater than 2400 baud!
  134.  
  135. To cope with this, the getty -F flag has been extended so that bit 3
  136. set (=8) means connect as FCLASS=2.0. The modem will be set to
  137. FCLASS=2.0, FAA=1, FNR=1,1,1,0. Whenever another program requests use
  138. of the serial port from getty, getty will set the modem back to
  139. FCLASS=0, or data mode. This is also done when getty exits.
  140.  
  141. While adding this code, I also traced and fixed a (long-standing ?) bug
  142. in getty, which was causing my machine to crash when getty shut down.
  143. It was caused by the order of closing in the myexit() function. This
  144. effects other versions of getty, including the one distributed with
  145. AmigaUUCP 1.17beta.
  146.  
  147. Documentation
  148. =============
  149.  
  150. This has not been updated yet, apart from this file. I'll try to do
  151. that before I do a full release, based on feedback from testers.
  152.  
  153. --------------------------------------------------------------------
  154. Changes: Response to Beta testers
  155. =================================
  156.  
  157. 22NOV94
  158. -------
  159. I've made some changes, including level-3 debug now printing
  160. configuration information, so you can now see whether you are in
  161. XonXoff, SyncEOL, etc. modes. To make sure you see all the config.
  162. information, you should use the -d3 command line switch, which will be
  163. checked early in startup (before config-file read in).
  164.  
  165. I've also changed the use of the XonXoff config variable, as follows:
  166.  
  167. XonOff 0  - disabled
  168.        1  - Use maximum buffer (1000 bytes)
  169.       nnn - Use nnn size line buffer
  170.  
  171. This allows you to set the size of the line AmigaFax uses for
  172. asynchronous writes, which controls the granularity of XONXOFF
  173. checking.
  174.  
  175. For testing, I'd start off with something like
  176.  
  177. XonOff 10
  178.  
  179. which means that AmigaFax will check for XOFF every 10 characters sent.
  180. As the value is increased, overall throughput should increase, until
  181. the point where the modem buffer overflows with a single line.
  182.  
  183. If that doesn't help, perhaps the USR hasn't used the default XonXoff
  184. control like it should. You can force this by putting an AT+FLO=1 in
  185. your setting string. Alternatively, AT+FLO=2 will force hardware
  186. handshake, if the modem supports it.
  187.  
  188. --------------------------------------------------------------------
  189.