DioSetPwmPulsePeriod

機能

指定したチャネルのPWMパルス周期の設定を行います。

書式

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

引数

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

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

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

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

設定範囲：5μsec ～ 1sec(0.1μsec単位)

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

定義

値

[Dec]

意味

DIO_PWM_PULSE_PERIOD_UNIT_S

1

sec単位

DIO_PWM_PULSE_PERIOD_UNIT_MS

2

msec単位

DIO_PWM_PULSE_PERIOD_UNIT_US

3

μsec単位

DIO_PWM_PULSE_PERIOD_UNIT_NS

4

nsec単位

戻り値

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

定義

値

[Dec]

意味

DIO_ERR_SUCCESS

0

正常終了

DIO_ERR_SYS_RECOVERED_FROM_STANDBY

7

スタンバイモードから復帰したため、DioResetDevice関数を実行してください

DIO_ERR_DLL_INVALID_ID

10001

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

DIO_ERR_DLL_CALL_DRIVER

10002

ドライバーを呼び出せません(デバイスI/Oコントロールに失敗)。

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_PWM_PERIOD_UNIT

20901

PWMパルス周期単位が指定可能範囲外です。

DIO_ERR_SYS_PWM_RUNNING_PWM

20904

PWM動作中のため実行できません。

DIO_ERR_SYS_DEVICE_ERR_DRIVER_IC_ERR

21200

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

DIO_ERR_SYS_DEVICE_ERR_PCOM_FAILURE

21201

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

その他のエラー（参照：エラーコード詳細）

初期値

5μsec

説明

指定したチャネルのPWMパルス周期の設定を行います。

PWM動作中に実行することはできません。

0.1µsec（=100nsec）単位でPWMパルス周期を設定したい場合は、
PulsePeriodUnit = DIO_PWM_PULSE_PERIOD_UNIT_NS を選び、PWMパルス周期(PulsePeriodValue)をナノ秒（nsec）で指定してください。

使用例

チャネル0のPWMパルス周期を10μsec、チャネル1のPWMパルス周期を50μsecに設定します。

VB.NET

Dim Ret As Integer
Dim ChNo(1) As Short
Dim PulsePeriodValue(1) As ULong
Dim PulsePeriodUnit(1) As UShort

ChNo(0) = 0
ChNo(1) = 1
PulsePeriodValue(0) = 10
PulsePeriodValue(1) = 50
PulsePeriodUnit(0) = DIO_PWM_PULSE_PERIOD_UNIT_US
PulsePeriodUnit(1) = DIO_PWM_PULSE_PERIOD_UNIT_US
Ret = DioSetPwmPulsePeriod( Id , ChNo , 2 , PulsePeriodValue , PulsePeriodUnit )
　

C, C++

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

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

C#

int Ret;
short[] ChNo = new short[2];
ulong[] PulsePeriodValue = new ulong[2];
ushort[] PulsePeriodUnit = new ushort[2];

ChNo[0] = 0;
ChNo[1] = 1;
PulsePeriodValue[0] = 10;
PulsePeriodValue[1] = 50;
PulsePeriodUnit[0] = DIO_PWM_PULSE_PERIOD_UNIT_US;
PulsePeriodUnit[1] = DIO_PWM_PULSE_PERIOD_UNIT_US;
Ret = dio.SetPwmPulsePeriod( Id , ref ChNo , 2 , out PulsePeriodValue , out PulsePeriodUnit );
　

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
PulsePeriodValue[0] = 10
PulsePeriodValue[1] = 50
PulsePeriodUnit[0] = cdio.DIO_PWM_PULSE_PERIOD_UNIT_US
PulsePeriodUnit[1] = cdio.DIO_PWM_PULSE_PERIOD_UNIT_US
Ret.value = cdio.DioSetPwmPulsePeriod( Id , ChNo , 2 , PulsePeriodValue , PulsePeriodUnit )
　

関連項目

DioGetPwmPulsePeriod