DioGetPwmPulsePeriod


機能

指定したチャネルのPWMパルス周期を取得します。

書式

Ret = DioGetPwmPulsePeriod( Id , ChNo , ChNum , PulsePeriodValue , PulsePeriodUnit )

引数

Id [ C, C++: short ] [ Python: ctypes.c_short ]
DioInitで取得したデバイスIDを指定します。

ChNo [ C, C++: short * ] [ Python: ctypes.POINTER(ctypes.c_short) ]
設定取得を行うチャネル番号を格納した配列の先頭アドレスを指定します。

ChNum [ C, C++: short ] [ Python: ctypes.c_short ]
ChNoで指定したチャネル数を指定します。

PulsePeriodValue [ C, C++: unsigned long long * ] [ Python: ctypes.POINTER(ctypes.c_ulonglong) ]
PWMパルスの周期設定を格納する配列の先頭アドレスを指定します。
パルス周期はパルス周期単位との組み合わせで以下の範囲になります。

設定範囲:5μsec ~ 1sec(0.1μsec単位)

PulsePeriodUnit [ C, C++: unsigned short * ] [ Python: ctypes.POINTER(ctypes.c_ushort) ]
PWMパルスの周期単位を格納した配列の先頭アドレスを指定します。 

戻り値

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

定義

[Dec]

意味

DIO_ERR_SUCCESS

0

正常終了

DIO_ERR_DLL_INVALID_ID

10001

無効なIDが指定されました。

DIO_ERR_DLL_CALL_DRIVER

10002

ドライバを呼び出せません(ioctlに失敗)。

DIO_ERR_DLL_BUFF_ADDRESS

10100

データバッファアドレスが不正です。

DIO_ERR_SYS_NOT_SUPPORTED

20001

このデバイスではこの関数は使用できません。

DIO_ERR_SYS_CH_NO

20105

チャネル番号が指定可能範囲外です。

DIO_ERR_SYS_CH_NUM

20106

チャネル数が指定可能範囲外です。

DIO_ERR_SYS_DEVICE_ERR_DRIVER_IC_ERR

21200

ドライバICエラーが発生しました。

DIO_ERR_SYS_DEVICE_ERR_PCOM_FAILURE

21201

PCOM電源異常が発生しました。

その他のエラー(参照:エラーコード詳細

説明

指定したチャネルのPWMパルス周期を取得します。

取得する周期の単位は第5引数(PulsePeriodUnit)で指定します。
パルス周期が指定した周期単位未満の場合、値は「0」で関数は正常終了します。

使用例

チャネル0とチャネル1のPWMパルス周期をμsec単位で取得します。

C, C++

long Ret;
short ChNo[2];
unsigned long long PulsePeriodValue[2];
unsigned short PulsePeriodUnit[2];

ChNo[0] = 0;
ChNo[1] = 1;
PulsePeriodUnit[0] = DIO_PWM_PULSE_PERIOD_UNIT_US;
PulsePeriodUnit[1] = DIO_PWM_PULSE_PERIOD_UNIT_US;
Ret = DioGetPwmPulsePeriod( Id , &ChNo[0] , 2 , &PulsePeriodValue[0] , &PulsePeriodUnit[0] );
 

Python

Ret = ctypes.c_long()
ChNoType = ctypes.c_short * 2
ChNo = ChNoType()
PulsePeriodValueType = ctypes.c_ulonglong * 2
PulsePeriodValue = PulsePeriodValueType()
PulsePeriodUnitType = ctypes.c_ushort * 2
PulsePeriodUnit = PulsePeriodUnitType()

ChNo[0] = 0
ChNo[1] = 1
PulsePeriodUnit[0] = cdio.DIO_PWM_PULSE_PERIOD_UNIT_US
PulsePeriodUnit[1] = cdio.DIO_PWM_PULSE_PERIOD_UNIT_US
Ret.value = cdio.DioGetPwmPulsePeriod( Id , ChNo , 2 , PulsePeriodValue , PulsePeriodUnit )
 

関連項目

DioSetPwmPulsePeriod