poeSignalAcquisition

poeSignalAcquisition - measure time period between PoE events

SYNOPSIS

poeSignalAcquisition sub-command options

DESCRIPTION

The poeSignalAcquisition command is used to set up and capture the time between two signal transition events. The amplitude of the a signal may also be measured a fixed time after the first signal transition.

The startTriggerSource, startTriggerSlope and startTriggerValue are used to indicate the signal to be used for the first event, the slope that it should transition (positive or negative) and the value that should be matched. Similarly, the stopTriggerSource, stopTriggerSlope and stopTriggerValue are used to indicate the signal to be used for the second event. The enableTime, enableAmplitude and amplitudeMeasurementDelay options are used to condition the measurements made.

Arming of the signal acquisition is accomplished through the use of the portGroup command with the armPoeTrigger value, or the ixArmPoeTrigger and ixArmPortPoeTrigger high-level commands. The arming may be aborted through the use of the portGroup command with the abortPoeTrigger value, or the ixAbortPortPoeArm high-level commands.

A number of statistics available through the stat, statGroup, statList, and statWatch commands support operation of this command. The status of the arming may be read from the statPoeTimeArmStatus and statPoeAmplitudeArmStatus options. The status of the triggering may be read from the statPoeTimeDoneStatus and statPoEAmplitudeDoneStatus options. The time and amplitude values are visible in the statPoeMonitorTime and statPoeMonitorAmplitudeDCVolts and statPoeMonitorAmplitudeDCAmps options after a trigger has completed.

STANDARD OPTIONS
amplitudeMeasurementDelay

If enableAmplitude is true, then this value indicates the amount of time after the start trigger has been satisfied at which the amplitude measurement of the signal indicated in startTriggerSource is measured. Expressed in ms. (default = )

enableAmplitude true | false

If true, amplitude measurements is made. The amplitude measurement of the signal indicated in startTriggerSource is made amplitudeMeasurementDelay ms after the start trigger has been satisfied. (default = )

enableTime true | false

If true, then the time between the start trigger event and the stop trigger event is measured. (default = )

startTriggerSlope

Indicates which slope of the startTriggerSignal satisfies the start trigger event.

Option

Value

Usage

poeTriggerSlopePositive

0

(default ) A positive slope.

poeTriggerSlopeNegative

1

A negative slope.

startTriggerSource

Indicates which signal characteristic is to be used to trigger the start event and to be measured if enableAmplitude is true.

Option

Value

Usage

poeTriggerSourceDCVolts

0

(default ) DC voltage

poeTriggerSourceDCAmps

1

DC amperage

startTriggerValue

Indicates the value to be used as a threshold for the start trigger event. Expressed in volts or amps, depending on the setting of startTriggerSource. (default = )

stopTriggerSlope

Indicates which slope of the stopTriggerSignal satisfies the stop trigger event.

Option

Value

Usage

poeTriggerSlopePositive

0

(default ) A positive slope.

poeTriggerSlopeNegative

1

A negative slope.

stopTriggerSource

Indicates which signal characteristic is to be used to trigger the stop event.

Option

Value

Usage

poeTriggerSourceDCVolts

0

(default ) DC voltage

poeTriggerSourceDCAmps

1

DC amperage

stopTriggerValue

Indicates the value to be used as a threshold for the stop trigger event. Expressed in volts or amps, depending on the setting of stopTriggerSource. (default = )

COMMANDS

The poeSignalAcquisition command is invoked with the following sub-commands. If no sub-command is specified, returns a list of all sub-commands available.

poeSignalAcquisition cget option

Returns the current value of the configuration option given by option. Option may have any of the values accepted by the poeSignalAcquisition command.

poeSignalAcquisition config option value

Modify the configuration options of the poeSignalAcquisition. If no option is specified, returns a list describing all of the available options (see STANDARD OPTIONS) for poeSignalAcquisition.

poeSignalAcquisition get chasID cardID portID

Gets the options associated with a particular PoE port. Specific errors are:

poeSignalAcquisition set chasID cardID portID

Sets the options associated with a particular PoE port. Specific errors are:

poeSignalAcquisition setDefault

Sets to IxTclHal default values for all configuration options.

EXAMPLES

See examples under poePoweredDevice.

SEE ALSO

poePoweredDevice.