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