DioGetPwmPulseDuty

Function

Retrieves the PWM pulse duty cycle for the specified channel.

Format

Ret = DioGetPwmPulseDuty( Id , ChNo , ChNum , PulseDuty )

Parameters

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

ChNo [ C, C++: short * ] [ Python: ctypes.POINTER(ctypes.c_short) ]
Specify the start address of the array that stores the channel numbers to get setting.

ChNum [ C, C++: short ] [ Python: ctypes.c_short ]
Specify the number of channels specified in ChNo.

PulseDuty [ C, C++: unsigned short * ] [ Python: ctypes.POINTER(ctypes.c_ushort) ]
Specify the start address of the array that stores the PWM pulse duty cycle settings.
When the value is 0, the duty cycle is 0%. When the value is 65535, the duty cycle is 100%.

Setting range: 0 to 65535

Return Value

Ret [ C, C++: long ] [ Python: ctypes.c_long ]

Definition	Value [Dec]	Description
DIO_ERR_SUCCESS	0	Normal completed.
DIO_ERR_DLL_INVALID_ID	10001	Invalid ID specified.
DIO_ERR_DLL_CALL_DRIVER	10002	Driver cannot be called (failed in ioctl).
DIO_ERR_DLL_BUFF_ADDRESS	10100	Invalid data buffer address.
DIO_ERR_SYS_NOT_SUPPORTED	20001	This board couldn't use this function.
DIO_ERR_SYS_CH_NO	20105	Channel No. is outside the setting range.
DIO_ERR_SYS_CH_NUM	20106	Channel number is outside the setting range.

The others (See also: Details of Error Code)

Remarks

Retrieves the PWM pulse duty cycle for the specified channel.
When the value is 0, the duty cycle is 0%. When the value is 65535, the duty cycle is 100%.

Example

Retrieves the PWM pulse duty cycle for channels 0 and 1.

C, C++	long Ret; short ChNo[2]; unsigned short PulseDuty[2]; ChNo[0] = 0; ChNo[1] = 1; Ret = DioGetPwmPulseDuty( Id , &ChNo[0] , 2 , &PulseDuty[0] );
Python	Ret = ctypes.c_long() ChNoType = ctypes.c_short * 2 ChNo = ChNoType() PulseDutyType = ctypes.c_ushort * 2 PulseDuty = PulseDutyType() ChNo[0] = 0 ChNo[1] = 1 Ret.value = cdio.DioGetPwmPulseDuty( Id , ChNo , 2 , PulseDuty )