DioSetPwmPulseDuty

Function

Sets the PWM pulse duty cycle for the specified channel.

Format

Ret = DioSetPwmPulseDuty( 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 set.

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 stored 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.
DIO_ERR_SYS_PWM_PULSE_DUTY	20902	The PWM pulse duty ratio is out of range.
DIO_ERR_SYS_DEVICE_ERR_DRIVER_IC_ERR	21200	Driver IC error occurred.
DIO_ERR_SYS_DEVICE_ERR_PCOM_FAILURE	21201	PCOM power failure occurred.

The others (See also: Details of Error Code)

Initial Value

Remarks

Sets 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

Set the duty cycle of channel 0 to 30%(19660) and the duty cycle of channel 1 to 80%(52428).

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