DioStartPwm


機能

指定したチャネルのPWMパルス出力を開始します。

書式

Ret = DioStartPwm( Id , ChNo , ChNum )

引数

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) ]
PWMパルス出力を開始するチャネル番号を格納した配列の先頭アドレスを指定します。

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

戻り値

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_RUNNING_PWM

20904

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

DIO_ERR_SYS_DEVICE_ERR_DRIVER_IC_ERR

21200

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

DIO_ERR_SYS_DEVICE_ERR_PCOM_FAILURE

21201

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

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

説明

指定したチャネルのPWMパルス出力を開始します。

PWMパルス出力中であっても、まだ動作していない別のチャネルを、新たに開始させることができます。

すでにPWMパルス出力中のチャネルを、再度開始させようとすると、動作中エラーを返し、デバイスに設定を反映しません。

複数のチャネルを指定しDioStartPwm関数を呼び出した場合、指定したすべてのチャネルのPWMパルス出力は同じタイミングで同期して開始します。
ただし、パルス出力開始させるチャネルの中に、1つでも動作中のチャネルが含まれている場合、デバイスに設定を反映せずエラーをかえします。

異なるタイミングでDioStartPwm関数を呼び出したチャネル同士は、PWMパルス出力のタイミングが同期しません。
例えば、1チャネルずつ指定しDioStartPwm関数を呼び出す場合、タイミングはそろいません。

チャネル間でPWMパルス出力のタイミングを同期させたい場合は、まずDioStopPwm関数で動作中のPWMパルス出力を停止させてください。
そのうえで、同期させたいすべてのチャネルをまとめて指定し、DioStartPwm関数を呼び出してください。

使用例

チャネル0、および、チャネル1のPWMパルス出力を開始します

VB.NET

Dim Ret As Integer
Dim ChNo(1) As Short

ChNo(0) = 0
ChNo(1) = 1
Ret = DioStartPwm( Id , ChNo , 2 )
 

C, C++

long Ret;
short ChNo[2]

ChNo[0] = 0;
ChNo[1] = 1;
Ret = DioStartPwm( Id , &ChNo[0] , 2 );
 

C#

int Ret;
short[] ChNo = new short[2];

ChNo[0] = 0;
ChNo[1] = 1;
Ret = dio.StartPwm( Id , out ChNo , 2 );
 

Python

Ret = ctypes.c_long()
ChNoType = ctypes.c_short * 2
ChNo = ChNoType()

ChNo[0] = 0
ChNo[1] = 1
Ret.value = cdio.DioStartPwm( Id , ChNo , 2 )
 

関連項目

DioStopPwm