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:
- Port is not available
poeSignalAcquisition set chasID cardID portID
Sets the options associated with a particular PoE port. Specific errors are:
- No connection to the chassis
- Invalid port - not available or in use
poeSignalAcquisition setDefault
Sets to IxTclHal default values for all configuration options.
EXAMPLES
See examples under poePoweredDevice.