interface

《嵌入式系统设计与实例开发实验教材二源码》Linux内核移植与编译实验

    Parameter:
      driver      = driver-Id.
      command     = ISDN_CMD_SETL3
      arg         = channel-number locally to the driver. (starting with 0)
                    logical or'ed with (protocol-Id << 8)
                    protocol-Id is one of the constants ISDN_PROTO_L3...
      parm.fax    = Pointer to T30_s fax struct. (fax usage only)

  ISDN_CMD_GETL2: (currently unused)

    With this command, the HL-driver is told to return the current
    setting of the Layer-3-protocol.

    Parameter:
      driver      = driver-Id.
      command     = ISDN_CMD_GETL3
      arg         = channel-number locally to the driver. (starting with 0)
      parm        = unused.
    Returnvalue:
      current protocol-Id (one of the constants ISDN_L3_PROTO)

  ISDN_CMD_LOCK:

    With this command the HL-driver is told, that it will be used by the
    LL and therefore may not be unloaded. The HL-driver should use
    MOD_INC_USE_COUNT to tell that to the kernel.

    Parameter:
      driver      = driver-Id.
      command     = ISDN_CMD_LOCK
      arg         = unused.
      parm        = unused.

  ISDN_CMD_UNLOCK:

    With this command the HL-driver is told, that it is no more used by the
    LL and therefore may be unloaded. The HL-driver should use
    DEC_INC_USE_COUNT to tell that to the kernel.

    Parameter:
      driver      = driver-Id.
      command     = ISDN_CMD_UNLOCK
      arg         = unused.
      parm        = unused.

  ISDN_CMD_PROCEED: 

    With this command, the HL-driver is told to proceed with a incoming call.

    Parameter:
      driver      = driver-Id.
      command     = ISDN_CMD_PROCEED
      arg         = channel-number locally to the driver. (starting with 0)
      setup.eazmsn= empty string or string send as uus1 in DSS1 with 
                    PROCEED message

  ISDN_CMD_ALERT: 

    With this command, the HL-driver is told to alert a proceeding call.

    Parameter:
      driver      = driver-Id.
      command     = ISDN_CMD_ALERT
      arg         = channel-number locally to the driver. (starting with 0)
      setup.eazmsn= empty string or string send as uus1 in DSS1 with 
                    ALERT message

  ISDN_CMD_REDIR: 

    With this command, the HL-driver is told to redirect a call in proceeding
    or alerting state.  

    Parameter:
      driver      = driver-Id.
      command     = ISDN_CMD_REDIR
      arg         = channel-number locally to the driver. (starting with 0)
      setup.eazmsn= empty string or string send as uus1 in DSS1 protocol
      setup.screen= screening indicator
      setup.phone = redirected to party number

  ISDN_CMD_PROT_IO:

    With this call, the LL-driver invokes protocol specific features through
    the LL.
    The call is not implicitely bound to a connection.

    Parameter:
      driver      = driver-Id
      command     = ISDN_CMD_PROT_IO
      arg         = The lower 8 Bits define the addressed protocol as defined
                    in ISDN_PTYPE..., the upper bits are used to differentiate
                    the protocol specific CMD.  
      
      para        = protocol and function specific. See isdnif.h for detail.


  ISDN_CMD_FAXCMD:

    With this command the HL-driver receives a fax sub-command.
    For details refer to INTERFACE.fax

    Parameter:
      driver      = driver-Id.
      command     = ISDN_CMD_FAXCMD
      arg         = channel-number locally to the driver. (starting with 0)
      parm        = unused.


3. Description of the events to be signaled by the HL-driver to the LL.

  All status-changes are signaled via calling the previously described
  function statcallb(). The field command of the struct isdn_cmd has
  to be set by the HL-driver with the appropriate Status-Id (event-number).
  The field arg has to be set to the channel-number (locally to the driver,
  starting with 0) to which this event applies. (Exception: STAVAIL-event)

  Until now, the following Status-Ids are defined:

  ISDN_STAT_AVAIL:

    With this call, the HL-driver signals the availability of new data
    for readstat(). Used only for debugging-purposes, see description
    of readstat().

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_STAVAIL
      arg         = length of available data.
      parm        = unused.

  ISDN_STAT_ICALL:
  ISDN_STAT_ICALLW:

    With this call, the HL-driver signals an incoming call to the LL.
    If ICALLW is signalled the incoming call is a waiting call without
    a available B-chan.

    Parameter:
      driver            = driver-Id
      command           = ISDN_STAT_ICALL
      arg               = channel-number, locally to the driver. (starting with 0)
      para.setup.phone  = Callernumber.
      para.setup.eazmsn = CalledNumber.
      para.setup.si1    = Service Indicator.
      para.setup.si2    = Additional Service Indicator.
      para.setup.plan   = octet 3 from Calling party number Information Element.
      para.setup.screen = octet 3a from Calling party number Information Element.

    Return:
      0           = No device matching this call.
      1           = At least one device matching this call (RING on ttyI).
                    HL-driver may send ALERTING on the D-channel in this case.
      2           = Call will be rejected.
      3           = Incoming called party number is currently incomplete.
                    Additional digits are required. 
                    Used for signalling with PtP connections.
      4	          = Call will be held in a proceeding state 
                    (HL driver sends PROCEEDING)
                    Used when a user space prog needs time to interpret a call
		    para.setup.eazmsn may be filled with an uus1 message of
		    30 octets maximum. Empty string if no uus. 
      5           = Call will be actively deflected to another party
                    Only available in DSS1/EURO protocol
		    para.setup.phone must be set to destination party number
		    para.setup.eazmsn may be filled with an uus1 message of
		    30 octets maximum. Empty string if no uus. 
      -1          = An error happened. (Invalid parameters for example.)
  The keypad support now is included in the dial command.	        


  ISDN_STAT_RUN:

    With this call, the HL-driver signals availability of the ISDN-card.
    (after initializing, loading firmware)

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_RUN
      arg         = unused.
      parm        = unused.

  ISDN_STAT_STOP:

    With this call, the HL-driver signals unavailability of the ISDN-card.
    (before unloading, while resetting/reconfiguring the card)

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_STOP
      arg         = unused.
      parm        = unused.

  ISDN_STAT_DCONN:

   With this call, the HL-driver signals the successful establishment of
   a D-Channel-connection. (Response to ISDN_CMD_ACCEPTD or ISDN_CMD_DIAL)

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_DCONN
      arg         = channel-number, locally to the driver. (starting with 0)
      parm        = unused.

  ISDN_STAT_BCONN:

   With this call, the HL-driver signals the successful establishment of
   a B-Channel-connection. (Response to ISDN_CMD_ACCEPTB or because the
   remote-station has initiated establishment)

   The HL driver should call this when the logical l2/l3 protocol 
   connection on top of the physical B-channel is established.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_BCONN
      arg         = channel-number, locally to the driver. (starting with 0)
      parm.num    = ASCII-String, containing type of connection (for analog
		    modem only). This will be appended to the CONNECT message
		    e.g. 14400/V.32bis

  ISDN_STAT_DHUP:

   With this call, the HL-driver signals the shutdown of a
   D-Channel-connection. This could be a response to a prior ISDN_CMD_HANGUP,
   or caused by a remote-hangup or if the remote-station has actively
   rejected a call.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_DHUP
      arg         = channel-number, locally to the driver. (starting with 0)
      parm        = unused.

  ISDN_STAT_BHUP:

   With this call, the HL-driver signals the shutdown of a
   B-Channel-connection. This could be a response to a prior ISDN_CMD_HANGUP,
   or caused by a remote-hangup.

   The HL driver should call this as soon as the logical l2/l3 protocol 
   connection on top of the physical B-channel is released.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_BHUP
      arg         = channel-number, locally to the driver. (starting with 0)
      parm        = unused.

  ISDN_STAT_CINF:

   With this call, the HL-driver delivers charge-unit information to the
   LL.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_CINF
      arg         = channel-number, locally to the driver. (starting with 0)
      parm.num    = ASCII string containing charge-units (digits only).

  ISDN_STAT_LOAD: (currently unused)

  ISDN_STAT_UNLOAD:

   With this call, the HL-driver signals that it will be unloaded now. This
   tells the LL to release all corresponding data-structures.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_UNLOAD
      arg         = unused.
      parm        = unused.

  ISDN_STAT_BSENT:

    With this call the HL-driver signals the delivery of a data-packet.
    This callback is used by the network-interfaces only, tty-Emulation
    does not need this call.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_BSENT
      arg         = channel-number, locally to the driver. (starting with 0)
      parm.length = ***CHANGEI.1.21: New field.
		    the driver has to set this to the original length
		    of the skb at the time of receiving it from the linklevel.

  ISDN_STAT_NODCH:

    With this call, the driver has to respond to a prior ISDN_CMD_DIAL, if
    no D-Channel is available.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_NODCH
      arg         = channel-number, locally to the driver. (starting with 0)
      parm        = unused.

  ISDN_STAT_ADDCH: 

    This call is for HL-drivers, which are unable to check card-type
    or numbers of supported channels before they have loaded any firmware
    using ioctl. Those HL-driver simply set the channel-parameter to a
    minimum channel-number when registering, and later if they know
    the real amount, perform this call, allocating additional channels.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_ADDCH
      arg         = number of channels to be added.
      parm        = unused.

  ISDN_STAT_CAUSE:

    With this call, the HL-driver delivers CAUSE-messages to the LL.
    Currently the LL does not use this messages. Their contents is simply
    logged via kernel-messages. Therefore, currently the format of the
    messages is completely free. However they should be printable.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_NODCH
      arg         = channel-number, locally to the driver. (starting with 0)
      parm.num    = ASCII string containing CAUSE-message.

  ISDN_STAT_DISPLAY:

    With this call, the HL-driver delivers DISPLAY-messages to the LL.
    Currently the LL does not use this messages. 

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_DISPLAY
      arg         = channel-number, locally to the driver. (starting with 0)
      para.display= string containing DISPLAY-message.

  ISDN_STAT_PROT:

    With this call, the HL-driver delivers protocol specific infos to the LL.
    The call is not implicitely bound to a connection.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_PROT
      arg         = The lower 8 Bits define the addressed protocol as defined
                    in ISDN_PTYPE..., the upper bits are used to differenciate
                    the protocol specific STAT.  
      
      para        = protocol and function specific. See isdnif.h for detail.

  ISDN_STAT_DISCH:

    With this call, the HL-driver signals the LL to disable or enable the
    use of supplied channel and driver.
    The call may be used to reduce the available number of B-channels after
    loading the driver. The LL has to ignore a disabled channel when searching
    for free channels. The HL driver itself never delivers STAT callbacks for
    disabled channels. 	    
    The LL returns a nonzero code if the operation was not successful or the
    selected channel is actually regarded as busy.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_DISCH
      arg         = channel-number, locally to the driver. (starting with 0)
      parm.num[0] = 0 if channel shall be disabled, else enabled.

  ISDN_STAT_L1ERR:

    ***CHANGEI1.21 new status message.
    A signal can be sent to the linklevel if an Layer1-error results in
    packet-loss on receive or send. The field errcode of the cmd.parm
    union describes the error more precisely.

    Parameter:
      driver      = driver-Id
      command     = ISDN_STAT_L1ERR
      arg         = channel-number, locally to the driver. (starting with 0)
      parm.errcode= ISDN_STAT_L1ERR_SEND:     Packet lost while sending.
		    ISDN_STAT_L1ERR_RECV:     Packet lost while receiving.
  ISDN_STAT_FAXIND:

    With this call the HL-driver signals a fax sub-command to the LL.
    For details refer to INTERFACE.fax

    Parameter:
      driver      = driver-Id.
      command     = ISDN_STAT_FAXIND
      arg         = channel-number, locally to the driver. (starting with 0)
      parm        = unused.