draft of DTE group for modem mib

[Jim Barnes <[e-mail]>]

Here is a draft of the changes for the DTE group of the modem mib.  

I'm not sure about some of the descriptions.  For example, if 
mdmDTEActionOnDTROnToOff is set to ignore(1), should mdmDTEActionOnDTROffToOn
also be set to ignore?  What happens if one is ignore, and the other
is not?  Comments and suggestions from modem experts gladly accepted.

There is already an object in the RS-232 MIB for synchronous timing
source (rs232SyncPortClockSource), but the enumerated values of that
object are different than mdmDTESyncTimingSource.  Does that matter?
How are the two objects related, if at all?


  Jim Barnes ([e-mail])



-- units of conformance


mdmDTEInterfaceGroup    OBJECT-GROUP
    OBJECTS { mdmDTEActionOnDTROnToOff, mdmDTEActionOnDTROffToOn,
		mdmDTESyncTimingSource, mdmDTESyncAsyncMode  }
    STATUS  current
    DESCRIPTION
            "A collection of objects that describe the configuration and
            state of the modem's DTE interface."
    ::= { mdmGroups 3 }


...



-- DTE Interface Group

mdmDTEInterface OBJECT IDENTIFIER ::= { mdmMIB 3 }

mdmDTEActionOnDTROnToOff OBJECT-TYPE
    SYNTAX      INTEGER {
                    ignore(1),
                    escapetocommandmode(2),
                    disconnetcall(3),
                    resetmodem(4)
                }
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
            "Defines the action the modem will take when DTR drops.
	     
	     If the value is set to ignore(1), the modem takes no action
	     when DTR drops and operates as if DTR was still high.
	     Typically, mdmDTEActionOnDTROffToOn would also be set to
	     ignore(1) if this object is set to ignore(1).

	     If the value is escapetocommandmode(2), the modem enters
	     command mode.  If the value is disconnectcall(3), the current
	     call (if any) is terminated.  If the value is resetmodem(4),
	     the current call (if any) is terminated and the modem is
	     reset."
    DEFVAL { disconnectcall }
    ::= { mdmDTEInterface 1 }

mdmDTEActionOnDTROffToOn OBJECT-TYPE
    SYNTAX      INTEGER {
                    ignore(1),
                    enabledial(2),
                    autoAnswerEnable(3),
                    establishConnection(4)
                }
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
            "Defines the action the modem will take when DTR is raised.

	     If the value is set to ignore(1), the modem takes no action
	     when DTR is raised.  Typically, mdmDTEActionOnDTROnToOff 
	     would also be set to ignore(1) if this object is set to 
	     ignore(1).

	     If the value is set to enabledial(2), the modem prepares to
	     dial an outgoing call.  The number to dial still must be
	     specified.  If the value is set to autoAnswerEnable(3),
	     the modem will automatically answer an incoming call.  If
	     the value is set to establishConnection(4), the modem dials
	     a number that has been previously stored in NVRAM."
    DEFVAL { autoAnswerEnable }
    ::= { mdmDTEInterface 2 }

mdmDTESyncTimingSource OBJECT-TYPE
    SYNTAX      INTEGER {
                    internal(1),
                    external(2),
                    loopback(3),
                    network(4)
                }
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
            "The clock source for synchronous transmissions.  If set to
	     internal(1), the modem is the clock source and sends the clock
	     signals to the DTE.  If set to external(2), the transmit clock 
	     signals are provided by the DTE.  If loopback(3), the modem
	     receiver clock is used for the transmit clock.  If network(4),
	     the clock signals are supplied by the DCE interface.

	     If the modem is not in synchronous mode, setting this object
	     will have no effect on the current operations of the modem."
    DEFVAL { internal }
    ::= { mdmDTEInterface 3 }

mdmDTESyncAsyncMode OBJECT-TYPE
    SYNTAX      INTEGER {
                    async(1),
                    sync(2),
                    syncAfterDial(3)
                }
    MAX-ACCESS  read-write
    STATUS      current
    DESCRIPTION
            "The operational mode of the modem.  If the value is 
	     syncAfterDial(3), the modem will accept commands in asynchronous
	     mode and changes to synchronous mode to pass date."
    DEFVAL { async }
    ::= { mdmDTEInterface 4 }