Physical DS1 Port

The Physical DS1 Port object defines a DS1 connector on an AM or SG series card, or on a PB3000 or PB3100 adaptor.

Each Physical DS1 Port object is a child of an Adaptor object with adaptor type AM1000 Audio/MF Adaptor, AM1100 Audio/MF Adaptor, AM1200 Audio/MF Adaptor, AM1300 Audio/MF Adaptor, SG1200, SG1100, SG1000, TD1000, TD1100, PB3000, or PB3100.

In the EMS System Explorer, the name shown for each Physical DS1 Port indicates

For example, Physical DS1 Port (Controller B, Slot 3, Port 11) "DS1/2/03/11".

In general, you will add Physical DS1 Port objects using the "create all ports" action on the parent Adaptor object, and should not need to create them individually.

To start using DS1 ports, you need to do the following:


For a Physical DS1 port on an Audio/MF Adaptor, you cannot change the physical encoding or line framing while the parent object is active.



If you attempt to quiesce deactivate the object when it is using a DS0 for MTP2 links, it will not deactivate until you deactivate the signaling cross connect .

Object-Specific Actions
Start local line loopback This action applies only for a DS1 port on a PB3100 adaptor. It puts the DS1 port into line loopback mode. You cannot use this action if the port is already in loopback mode, if the far end is in loopback mode (or a far-end loopback request is outstanding), or if an out-of-service Bit Error Rate Test is running.
Stop local line loopback This action applies only for a DS1 port on a PB3100 adaptor. It takes the DS1 port out of line loopback mode into normal operation. You can use this action only when the port is already in local line loopback mode.
Start far-end line loopback This action applies only for a DS1 port on a PB3100 adaptor with Line framing set to ESF or ESF MF. It requests the remote equipment to operate in line loopback mode. You cannot use this action if the local port is already in loopback mode, if a far-end loopback request is outstanding, or if an out-of-service Bit Error Rate Test is running. Loopback signaling uses the facility data link channel.
Stop far-end line loopback This action applies only for a DS1 port on a PB3100 adaptor with Line framing set to ESF or ESF MF. It requests the remote equipment to move out of line loopback mode into normal operation. Loopback signaling uses the facility data link channel.
Start BERT This action applies only for a DS1 port on a PB3100 adaptor. It starts out-of-service Bit Error Rate Testing on the port. (This is independent of the in-service Bit Error Rate monitoring reported by the Bit Error Rate field.) You cannot use this action if the port is already in local line loopback mode, if a far-end loopback request is outstanding, or if an out-of-service Bit Error Rate Test is already running.
Stop BERT This action applies only for a DS1 port on a PB3100 adaptor. It stops out-of-service Bit Error Rate testing on the port. You can use this action only when the port is already running an out-of-service Bit Error Rate Test.

Parameter

Access

Description
Port name Read only A unique identifier for this device among all other devices on the Media Gateway. This identifier is used by other objects that need to reference this device.
Port number Create An identifier for this Physical DS1 Port. The valid port numbers depend on the parent adaptor type, as follows.
  • An AM1000 or AM1100 adaptor has four child DS1 ports, with port numbers 1 - 4 (corresponding to the physical ports on the adaptor card).
  • An AM1200, AM1300, TD1000, TD1100, or PB3000 adaptor has sixteen child DS1 ports, with port numbers 1 - 16 (corresponding to the physical ports on the adaptor card).
  • A PB3100 adaptor has sixteen child DS1 ports, with port numbers 1 - 16.
  • An SG1000, SG1100 or SG1200 adaptor has eight child DS1 ports, with port numbers 1 - 8 (corresponding to the physical ports on the adaptor card).
Additional information Change A text field that can be used to store information about the Physical DS1 Port. This field is optional; you can supply up to 64 characters of free-form text. The text wraps to the width of the field on screen, or you can use the Enter key to force linebreaks.
Description Read only Information about the controller, chassis slot number and port number associated with this port.
DS1 type Read only Specifies the type of DS1 link. Values:
  • Unknown
    This status is an error. To clear this status, you can perform a hot-swap on the owning adaptor.
  • T1
  • E1
Physical encoding Change Inactive Specifies the physical encoding used on this DS1 port. This setting must match the encoding of the incoming DS1 line; check with the provider of the line if necessary. Values:
  • B8ZS (T1 only)
  • AMI
  • HDB3 (E1 only)
Line framing Change Inactive Specifies the framing used on this DS1 port. This setting must match the framing on the incoming DS1 line; check with the provider of the line if necessary. Values:
  • D4 (T1 only)
    AT&T D4 format DS1 (T1.107)
  • ESF (T1 only)
    Extended SuperFrame DS1 (T1.107)
  • E1 (E1 only)
    ITU-T Recommendation G.704 (Table 4a)
  • E1 CRC (E1 only)
    ITU-T Recommendation G.704 (Table 4b)
The following values are valid only for an AM* or PB* adaptor:
  • D4 MF (T1 only)
    D4 with CAS support enabled
  • ESF MF (T1 only)
    ESF with CAS support enabled
Line length Change Inactive Specifies the approximate length of the DS1 cable connected to this port. This is used to control the transceivers to ensure adequate signal strength on the line. This field is not valid if Line framing is set to E1 or E1 CRC. Values:
  • Up to 133ft (40m)
  • 133 - 266ft (40 - 80m)
  • 266 - 399ft (80-120m)
  • 399 - 533ft (120-160m)
  • Over 533ft (160m)
E1 Line Impedance Change Inactive Indicates the impedance of the E1 line. This field is valid only if Line framing is set to E1 or E1 CRC. Values:
  • 120 Ohms (default)
  • 75 Ohms
Line status Read only Specifies the line status of the DS1 interface. One or more of the following values may be set:
  • AIS
    Alarm indication signal: a remote fault is affecting data that would otherwise be received at this port.
  • RAI
    Remote alarm indication: a remote system is not receiving the data that the local port is sending.
  • LOF
    Loss of framing: the local port is receiving a signal but is unable to synchronize with it to recover the data.
  • LOS
    Loss of signal: no receive signal can be detected.
  • BER
    Bit error rate: a high bit error rate (in the region of 1 x 10^-3 or above) has been detected.
If the interface has one or more of these defects in an elapsed second (a Severely Errored Second) for 5 consecutive seconds, it will be marked as "unavailable"; it will be returned to service when 5 consecutive seconds elapse with no defects.
Bit Error Rate Read only This field appears only for a DS1 port on a PB3100 adaptor. It gives an indication of the current rate at which bit errors are being detected on the DS1 interface. BER is calculated continuously, regardless of whether an out-of-service Bit Error Rate Test is being run. Values:
  • Not Applicable (line out of service)
  • BER being calculated (figure available shortly)
  • BER > 3.2 x 10^-3
  • 3.2 x 10^-4 < BER < 3.2 x 10^-3
  • BER < 3.2 x 10^-4, more accuracy not yet available
  • 3.2 x 10^-5 < BER < 3.2 x 10^-4
  • BER < 3.2 x 10^-5, more accuracy not yet available
  • 3.2 x 10^-6 < BER < 3.2 x 10^-5
  • BER < 3.2 x 10^-6, more accuracy not yet available
  • 3.2 x 10^-7 < BER < 3.2 x 10^-6
  • BER < 3.2 x 10^-7, more accuracy not yet available
  • 3.2 x 10^-8 < BER < 3.2 x 10^-7
  • BER < 3.2 x 10^-8
In normal operation, the BER should be lower than 3.2 x 10^-7 (one of the last three values in this list). If the BER is low, it requires a longer measurement period to obtain an accurate estimate. An increased BER is reported quickly, and then as the BER drops the "more accuracy not yet available" values are used to provide the best information available as quickly as possible.
Clock reference Change Inactive Specifies whether the clocking on this link is used as a general clock reference. You should leave this value set to No. Values:
  • No (default)
    The DS1 link's clocking is not used as a general clock reference.
  • Yes
    The DS1 link's clocking is used as a general clock reference.
  • BITS
    Building Integrated Timing Supply: this DS1 link is used only as a general clock reference, and does not carry data. In the supplied configuration files, port 8 on an SG1100 or SG1200 adaptor is normally configured for use with a BITS source.
Supported terminations Read only Specifies which termination protocols this port supports. Values:
  • ISUP
  • MF (North America only)
  • MTP2
  • GR-303 (North America only)
  • ISDN (North America only)
Deactivation mode Change Specifies how child objects should be deactivated when deactivating this object. Values:
  • Normal (default)
    Shut down child objects normally before deactivating the object.
  • Quiesce
    Deactivating the Physical DS1 Port in quiesce mode will wait for all existing child objects using the port to be completed before deactivation. No new child objects using this port will be accepted during this deactivation period.
  • Abort
    Deactivate the object and all its child objects immediately. (This may result in errors at remote systems.)
Available uses Read only This field applies only in the US.
Loopback - local loopback status Read only This field appears only for a DS1 port on a PB3100 adaptor. Specifies whether the port is currently operating in local loopback mode. This means that all data sent to the port is sent back unchanged to the remote equipment, for use in test procedures such as Bit Error Rate Testing (BERT). Values:
  • No loopback
  • Local line loopback
  • Local line loopback set by the far-end
Loopback - far-end loopback request status Read only This field appears only for a DS1 port on a PB3100 adaptor with Line framing set to ESF or ESF MF. Specifies whether the MetaSwitch NE has requested the remote equipment to operate in loopback mode. This means that all data sent from the port is sent back unchanged by the remote equipment, for use in test procedures such as Bit Error Rate Testing (BERT). Values:
  • No request
  • Requesting line loopback
  • Request for line loopback succeeded
  • Request for line loopback failed
  • Requesting line loopback deactivation
  • Request for line loopback deactivation failed
Loopback - allow automatic loopback activation Change Inactive This field appears only for a DS1 port on a PB3100 adaptor with Line framing set to ESF or ESF MF. Specifies whether this port should automatically accept loopback activation requests from the remote equipment. Values:
  • True
    The port automatically goes into local loopback mode when the remote equipment requests it.
  • False (default)
    The port ignores loopback activation requests from the remote equipment; instead, local loopback must be requested manually using the Start local line loopback pushbutton.
Bit Error Rate Test (BERT) results - test running Read only This field and the following Bit Error Rate Test fields appear only for a DS1 port on a PB3100 adaptor. They relate to out-of-service Bit Error Rate Testing started using the action pushbuttons, which is independent of the in-service monitoring indicated by the Bit Error Rate field. Specifies whether a Bit Error Rate Test is currently running on this port. Values:
  • True
  • False
Bit Error Rate Test (BERT) results - test pattern synchronized Read only This field appears only if Bit Error Rate Test (BERT) results - test running is True. Specifies whether the test pattern used in BERT is currently synchronized (and hence whether the error rate can be measured). Values:
  • True
  • False
Bit Error Rate Test (BERT) results - total test time Read only The length of time in seconds for which the current BERT has been running, or the duration of the most recent BERT if it is not currently running. This field is updated once every minute.
Bit Error Rate Test (BERT) results - loss of synchronization seconds Read only The total length of time in seconds for which synchronization has been lost during the current BERT, or during the most recent BERT if it is not currently running. This field is updated once every minute.
Bit Error Rate Test (BERT) results - loss of signal (LOS) seconds Read only The total length of time in seconds for which there has been a Loss Of Signal condition during the current BERT, or during the most recent BERT if it is not currently running. This field is updated once every minute.
Bit Error Rate Test (BERT) results - Bit Error Rate Read only The Bit Error Rate as measured by the current BERT, or by the most recent BERT if it is not currently running. If the test runs with loss of synchronization conditions, this field shows the measured BER while the test was synchronized. This is displayed as a floating-point number with three significant figures:
  • If no errors are detected, this is displayed as 0.00e+00.
  • If the Bit Error Rate cannot be determined because of loss of signal or loss of test pattern synchronization, this is displayed as 1.00e+00.
  • Otherwise it is displayed in the format N.NNe-MM, where N.NN represents the significant figures and -MM represents the power of 10; for example, 1.23e-05 represents 1.23x10-5.
This field is updated once every minute. The accuracy that can be obtained for a BERT depends on the test duration: 90 seconds: accuracy to order 10-7
15 minutes: accuracy to order 10-8
2.5 hours: accuracy to order 10-9
1 day: accuracy to order 10-10
Bit Error Rate Test (BERT) results - maximum interval Bit Error Rate Read only The highest Bit Error Rate measured during any five-second interval by the current BERT, or by the most recent BERT if it is not currently running. This is displayed as a floating-point number with three significant figures, in the same format as for Bit Error Rate Test (BERT) results - Bit Error Rate.
Alarm state Read only Specifies whether any alarms are currently raised for this object. Values:
  • Clear
    No alarms are currently raised.
  • Attention Required
    Attention Required - the object is not operating normally, and needs operator intervention.
  • Attend To Dependent
    Attention Required elsewhere - another object on which this object depends is not operating normally.
Alarm log correlator Read only Identifier of the log message for the event that caused the last Attention Required alarm state for this object. This field is reset when the Attention Required alarm events field is reset to zero.
Attention Required alarm events Read only / Reset Number of times (since the alarm count was reset) that this object's alarm state has gone to Attention Required.
Alarm state changed timestamp Read only The time at which the Alarm state last changed.
Alarm events reset timestamp Read only The time at which the Attention Required alarm events was last reset to zero.
Diagnostics - log level Change Specifies the level of logs recorded for this object. Logs with a priority equal to or greater than the priority specified are recorded. Set to Default level to use the system-wide default level. Values:
  • Level 10 (diagnostics)
  • Level 20 (verbose statistics)
  • Level 30 (verbose operational)
  • Level 40 (statistics)
  • Level 50 (audit)
  • Level 60 (operational)
  • Level 70 (unexpected)
  • Level 80 (error)
  • Level 90 (fatal)
  • Default level (default)
Diagnostics - API trace enabled Change Specifies whether API tracing is enabled for this object. Values:
  • True
  • False (default)
Diagnostics - trace tag Change An optional diagnostics tag inserted into API tracing and PD logging for this object. This tag may include any ASCII characters.
Requested status Read only Specifies whether an administrator has attempted to activate the port. Values:
  • Active
    The object has been activated.
  • Inactive
    The object has not been activated or has been deactivated.
  • Disabled
    The object has been disabled.
Actual status Read only Specifies the current status of the port. Values:
  • Active
    The object is active.
  • Activating
    Activation is in progress.
  • Deactivating
    Deactivation is in progress.
  • Inactive
    The object is inactive.
  • Disabled
    The object has been disabled.
  • Activation Failed
    The object is inactive because an activation attempt has failed.
  • Failed
    The object was active but has failed.
  • Quiescing
    The object is preparing for normal deactivation. It is operating normally but will not accept any new users.
  • Waiting For Parent
    The object cannot be used because its parent object is not yet active.
  • Parent Failed
    The object cannot be used because its parent object has failed.