|
int MX370x__TransducerInitAndStartAutoRefresh |
( |
xsd__unsignedLong |
ulTransducerSelection, |
|
|
xsd__unsignedLong |
ulChannelMask, |
|
|
xsd__unsignedLong |
ulAverageMode, |
|
|
xsd__unsignedLong |
ulAverageValue, |
|
|
xsd__unsignedLong |
ulDivisionFactor, |
|
|
xsd__unsignedLong |
ulTriggerAction, |
|
|
xsd__unsignedLong |
ulHardwareTriggerCount, |
|
|
xsd__unsignedLong |
ulHardwareTriggerFilterTime, |
|
|
xsd__unsignedLong |
ulByTriggerNbrOfSeqToAcquire, |
|
|
xsd__unsignedLong |
ulOption1, |
|
|
xsd__unsignedLong |
ulOption2, |
|
|
xsd__unsignedLong |
ulOption3, |
|
|
xsd__unsignedLong |
ulOption4, |
|
|
struct MX370x__Response * |
Response | |
|
) |
| | |
- Parameters:
-
[in] | ulTransducerSelection | : Transducer type selection |
[in] | ulChannelMask | : Mask of the channel to acquire by the auto refresh (1 bit = 1 Channel) for example :
- 0x3 : Channel 0, channel 1
- 0xFF : Channel 0 to 7
- 0xF0 : Channel 3 to 7
|
[in] | ulAverageMode | : Set the average mode :
- 0 : not used
- 1 : average per Sequence : All sequences are acquired x times to compute an average value per channel.
- 2 : average per channel : Each channel is acquired x times to compute an average value for the channel.
|
[in] | ulAverageValue | : Set the average value (only used, when average is used)
- 0 : average not used
- max value : 255
|
[in] | ulDivisionFactor | : Division factor (min: 5, max: 255) |
[in] | ulTriggerAction | : Trigger action :
Hardware Trigger Start D0 - D7
Bit 3,2,1,0 : Define the trigger mode
- 0000 : Trigger disabled
- 0001 : One shot trigger : After the software start, the module is waiting for a trigger signal to start the acquisition. After this the trigger signal is ignored.
- 0010 : Sequence trigger : After the software start the module is waiting for the trigger signal and acquires x sequences (also adjustable) and then wait again.
Bit 7,6 : define the active front (Only if hardware trigger selected)
- 01 : rising front (Only if hardware trigger selected)
- 10 : falling front (Only if hardware trigger selected)
- 11 : Both front (Only if hardware trigger selected)
Synchronisation Trigger Start : D8-D15
Bit 11,10,9,8 : Define the trigger mode
- 0000 : trigger disabled
- 0001 : One shot trigger : After the software start, the module is waiting for a trigger signal to start the acquisition. After this the trigger signal is ignored.
- 0010 : Sequence trigger : After the software start the module is waiting for the trigger signal and acquires x sequences (also adjustable) and then wait again.
Hardware Trigger Stop D16 - D19
The hardware trigger stop can only be activated when :
- The hardware trigger start is not used.
- The hardware trigger start is used in one shot mode.
The stop of the acquisition is really do at the end of a sequence acquisition(to avoid that the acquisition is stop in the middle of a sequence).
Bit 16 : Define the trigger stop is enable or not
- 0 : Stop trigger disabled
- 1 : Stop trigger enabled.
Bit 18,17 : define the active front (Only if hardware trigger stop selected)
- 01 : rising front (Only if hardware trigger stop selected)
- 10 : falling front (Only if hardware trigger stop selected)
- 11 : Both front (Only if hardware trigger stop selected)
Bit 19 : define if the hardware trigger stop use the ulHardwareTriggerCount (Only if hardware trigger stop selected)
- 0 : ulHardwareTriggerCount not used : First hardware trigger stop will stop the acquisition
- 1 : ulHardwareTriggerCount is used : The ulHardwareTriggerCount hardware trigger will stop the acquisition
|
[in] | ulHardwareTriggerCount | : Define the number of trigger events before the trigger action occur
0 or 1 : all trigger event start the trigger action
max value : 65535 |
[in] | ulHardwareTriggerFilterTime | : Filter time for the hardware trigger (= multiplier from 250 ns step)
max value : 65535 |
[in] | ulByTriggerNbrOfSeqToAcquire | : Define the number of sequence to acquire by each trigger event |
[in] | ulOption1 | : Data format option
D0 : Time stamp information
- 0 : no time stamp information
- 1 : time stamp information
D1 : Data format
- 0 : Digital value
- 1 : Analog value (in mm)
D2 : invert value
- 0 : don't invert the channel value
- 1 : invert the channel value (-2 mm -> + 2mm)
|
[in] | ulOption2 | : Reserved |
[in] | ulOption3 | : Reserved |
[in] | ulOption4 | : Reserved |
[out] | Response | :
iReturnValue :
- 0: success
- -1: means an system error occurred
- -2: Transducer selection error
- -3: Channel mask error : can not be null
- -4: Channel mask error
- -5: Average mode error
- -6: Average value error
- -7: Division factor error
- -8: Incorrect value for Hardware Trigger Mode
- -9: Incorrect value for Hardware Trigger front
- -10: Incorrect value for Synchro Trigger Mode
- -11: Incorrect value for Hardware Trigger count
- -12: Incorrect value for Hardware Trigger filter time
- -13: Incorrect value for "trigger number of sequence to acquire"
- -14: Wrong data format parameter (ulOption1)
- -15: A value for Hardware Trigger front was defined but Hardware Trigger Mode is not set
- -16: Cannot use both triggers at the same time
- -17: Incorrect value for the hardware trigger stop front
- -18: Hardware trigger stop can not be used by this configuration of hardware trigger start
- -100: TransducerInit kernel function error
- -101: InitConvertTimeDivisionFactor kernel function error
- -102: SetAutoRefreshAverageValue kernel function error
- -103: InitDigitalInputFilter kernel function error
- -104: InitEnableDisableHardwareTrigger kernel function error
- -105: SynchroTrigger Init/Enable/Disable kernel function error
- -106: SetTriggerSequenceCount kernel function error
- -107: StartAutoRefresh kernel function error
syserrno : System-error code (the value of the libc "errno" code)
Its value is significant only when the iReturnValue returned an error (-1 or <= -100)
Give this value to the MXCommon_Strerror to get the string describing the error number. |
- Returns:
- 0: SOAP_OK
- <> 0: See SOAP error
|