Return to hs CVS log

Up to [MW Coherent from dump] / coherent / a / usr / man / COHERENT

Annotation of coherent/a/usr/man/COHERENT/hs, revision 1.1

1.1     ! root        1: 
        !             2: 
        !             3: hs                        Device Driver                        hs
        !             4: 
        !             5: 
        !             6: 
        !             7: 
        !             8: Device driver for polled serial ports
        !             9: 
        !            10: 
        !            11: The COHERENT hhss driver adds support for up to eight serial lines,
        !            12: /ddeevv/hhss0000 through /ddeevv/hhss0077.
        !            13: 
        !            14: Serial lines controlled via the hhss driver can be opened in one of
        !            15: two ways, as follows:
        !            16: 
        !            17: /ddeevv/hhss??
        !            18:      Polled, local mode (no modem control).
        !            19: 
        !            20: /ddeevv/hhss??rr
        !            21:      Polled, remote mode (modem control).
        !            22: 
        !            23: Any port  used with  the hhss device  driver will be  polled, i.e.,
        !            24: interrupt  operation is  not used.  Please  refer to  the Lexicon
        !            25: article  ccoomm  for explanations  of  ``local''  vs ``remote''  and
        !            26: ``polled'' vs ``interrupt-driven''.
        !            27: 
        !            28: To use the hhss driver,  first configure it to match your equipment
        !            29: (see  below), then  load the driver  using the  following command
        !            30: while running as the superuser rroooott:
        !            31: 
        !            32: 
        !            33:         /etc/drvld -r /drv/hs
        !            34: 
        !            35: 
        !            36: To unload the driver without rebooting COHERENT, first use the ppss
        !            37: command with the -dd option  to get the process identifier for the
        !            38: hhss driver  process, then unload  the driver process  by using the
        !            39: kkiillll command.   Note that the  hhss driver process  will not unload
        !            40: until all ooppeenned ports have been closed.  For example (user input
        !            41: shown in bold):
        !            42: 
        !            43: 
        !            44:         $ ppss -dd
        !            45:         TTY       PID
        !            46:         -------     0  <idle>
        !            47:         -------    38  <hs>
        !            48:         ...
        !            49:         $ kkiillll kkiillll 3388
        !            50: 
        !            51: 
        !            52: The present  version of  COHERENT limits ``polled''  operation to
        !            53: one device driver at a time.  Therefore, if any of the ccoomm family
        !            54: of devices  is used  in polled mode,  hhss devices cannot  be used.
        !            55: Conversely,  /ddeevv/ccoomm11ppll   through  /ddeevv/ccoomm44ppll  and  /ddeevv/ccoomm11pprr
        !            56: through /ddeevv/ccoomm44pprr  cannot be used  if the hhss driver  is in use.
        !            57: Both drivers can be present  at the same time, but polled devices
        !            58: may not be  ooppeenn under both drivers at the  same time.  Note that
        !            59: enabling a port via /eettcc/eennaabbllee keeps it open continuously.
        !            60: 
        !            61: 
        !            62: 
        !            63: 
        !            64: COHERENT Lexicon                                           Page 1
        !            65: 
        !            66: 
        !            67: 
        !            68: 
        !            69: hs                        Device Driver                        hs
        !            70: 
        !            71: 
        !            72: 
        !            73: ***** Port Configuration *****
        !            74: 
        !            75: The default configuration for the hhss driver is for four ports, at
        !            76: hexadecimal addresses 0x3F8,  0x2F8, 0x3E8, and 0x2E8, at a speed
        !            77: of 9600 baud.  The  driver is configured by setting the following
        !            78: parameters:
        !            79: 
        !            80: 11.   The number of ports.
        !            81: 
        !            82: 22.   The I/O address for each port.
        !            83: 
        !            84: 33.   The default speed of each port.
        !            85: 
        !            86: All  steps in  the configuration  must be  done as  the superuser
        !            87: rroooott.   Patch the  number of ports  into driver  variable HHSSNNUUMM_.
        !            88: For example, if you wish to support three ports, enter:
        !            89: 
        !            90: 
        !            91:         /conf/patch /drv/hs HSNUM_=3
        !            92: 
        !            93: 
        !            94: Address and speed information are stored sequentially starting at
        !            95: variable HHSS_PPOORRTTSS_.  The speed  for each port is indicated by the
        !            96: corresponding value  found in <ssggttttyy.hh>,  from one, corresponding
        !            97: to  50 baud,  to 16,  corresponding to 9600  baud.  If  the three
        !            98: ports in the example  above are at hexadecimal adresses of 0x2A0,
        !            99: 0x2B0,  and 0x2C0,  with  speeds of  2400, 2400,  and 9600  baud,
        !           100: respectively, then the following three patches must be performed:
        !           101: 
        !           102: 
        !           103:         /conf/patch /drv/hs HS_PORTS_=0x2A0 HS_PORTS_+2=12
        !           104:         /conf/patch /drv/hs HS_PORTS_+4=0x2B0 HS_PORTS_+6=12
        !           105:         /conf/patch /drv/hs HS_PORTS_+8=0x2C0 HS_PORTS_+10=16
        !           106: 
        !           107: 
        !           108: Finally,  nodes must  be created  for each  port using  the mmkknnoodd
        !           109: command.  The  major device  number is  7; the minor  number will
        !           110: range  from 0  through 7 for  ports /ddeevv/hhss0000  through /ddeevv/hhss0077,
        !           111: respectively, with 128 added  to the device minor number if modem
        !           112: control is  desired.  The following  commands will make  nodes in
        !           113: /ddeevv  for local  and remote  versions of the  three ports  in the
        !           114: example:
        !           115: 
        !           116: 
        !           117:         /etc/mknod -f /dev/hs00  c  7  0
        !           118:         /etc/mknod -f /dev/hs01  c  7  1
        !           119:         /etc/mknod -f /dev/hs02  c  7  2
        !           120:         /etc/mknod -f /dev/hs00r c  7  128
        !           121:         /etc/mknod -f /dev/hs01r c  7  129
        !           122:         /etc/mknod -f /dev/hs02r c  7  130
        !           123: 
        !           124: 
        !           125: ***** See Also ***** ccoomm, ddeevviiccee ddrriivveerrss, ddrrvvlldd
        !           126: 
        !           127: 
        !           128: 
        !           129: 
        !           130: COHERENT Lexicon                                           Page 2
        !           131: 
        !           132: 
        !           133: 
        !           134: 
        !           135: hs                        Device Driver                        hs
        !           136: 
        !           137: 
        !           138: 
        !           139: ***** Diagnostics *****
        !           140: 
        !           141: An  attempt to  open a  non-existent  device will  generate error
        !           142: messages.  This can occur if hardware is absent or not turned on.
        !           143: 
        !           144: ***** Notes *****
        !           145: 
        !           146: Note that if  any ccoomm device driver is used  in polling mode, the
        !           147: hhss driver cannot be used, and vice versa.
        !           148: 
        !           149: 
        !           150: 
        !           151: 
        !           152: 
        !           153: 
        !           154: 
        !           155: 
        !           156: 
        !           157: 
        !           158: 
        !           159: 
        !           160: 
        !           161: 
        !           162: 
        !           163: 
        !           164: 
        !           165: 
        !           166: 
        !           167: 
        !           168: 
        !           169: 
        !           170: 
        !           171: 
        !           172: 
        !           173: 
        !           174: 
        !           175: 
        !           176: 
        !           177: 
        !           178: 
        !           179: 
        !           180: 
        !           181: 
        !           182: 
        !           183: 
        !           184: 
        !           185: 
        !           186: 
        !           187: 
        !           188: 
        !           189: 
        !           190: 
        !           191: 
        !           192: 
        !           193: 
        !           194: 
        !           195: 
        !           196: COHERENT Lexicon                                           Page 3
        !           197: 
        !           198: 

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.