DioDmSetStartTrigger

Function

Sets the start condition for sampling/generating.

Format

Ret = DioDmSetStartTrigger ( Id , Direction , Start )

Parameters

Id [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
Specify the device ID retrieved from DioInit.

Direction [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
Set the transfer direction.

Definition

Value

[Dec]

Description

DIODM_DIR_IN

Input

DIODM_DIR_OUT

Output

Start [ VB.NET: Short ] [ C, C++: short ] [ C#: short ] [ Python: ctypes.c_short ]
Set the start condition.

Definition	Value [Dec]	Description
DIODM_START_SOFT	1	Software start
DIODM_START_EXT_RISE	2	Rising edge of external trigger
DIODM_START_EXT_FALL	3	Falling edge of external trigger
DIODM_START_PATTERN	4	Pattern matching (Input only)
DIODM_START_EXTSIG_1	5	SC connector EXTSIG1
DIODM_START_EXTSIG_2	6	SC connector EXTSIG2
DIODM_START_EXTSIG_3	7	SC connector EXTSIG3

EXTSIG1, EXTSIG2 and EXTSIG3 are only valid for the slave.

Return Value

Ret [ VB.NET: Integer ] [ C, C++: long ] [ C#: int ] [ Python: ctypes.c_long ]

Definition	Value [Dec]	Description
DIO_ERR_SUCCESS	0	Normal completed.
DIO_ERR_SYS_RECOVERED_FROM_STANDBY	7	Execute DioResetDevice function because the device has recovered from standby mode.
DIO_ERR_DLL_INVALID_ID	10001	Invalid ID specified.
DIO_ERR_DLL_CALL_DRIVER	10002	Not call the driver (Failure on DEVICE I/O CONTROL).
DIO_ERR_SYS_NOT_SUPPORTED	20001	This board couldn't use this function.
DIO_ERR_SYS_IODIRECTION	20500	Direction value is out of range.
DIO_ERR_SYS_START	21001	Start conditions are outside the setting range.

The others (See also: Details of Error Code)

Initial Value

The default is software start.

Remarks

It is necessary to set the start condition to make the application operation regular. Please use the DioDmSetStartPattern function to set the comparison pattern to specify the pattern matching for the start condition.

Example

Sets software start for input transfer.

VB.NET	Dim Ret As Integer Ret = DioDmSetStartTrigger ( Id , DIODM_DIR_IN , DIODM_START_SOFT )
C, C++	long Ret; Ret = DioDmSetStartTrigger ( Id , DIODM_DIR_IN , DIODM_START_SOFT );
C#	int Ret; Ret = dio.DmSetStartTrigger ( Id , (short)CdioConst.DIODM_DIR_IN , (short)CdioConst.DIODM_START_SOFT );
Python	Ret = ctypes.c_long() Ret.value = cdio.DioDmSetStartTrigger ( Id , cdio.DIODM_DIR_IN , cdio.DIODM_START_SOFT )