メインコンテンツまでスキップ
バージョン: 4.00

構造体定義(共通)

本製品の共通の構造体定義を説明します。

主に使うAPI​

定義一覧​

型名意味合い
StMPXAPIVersionAPIのバージョン情報
StMPXDeviceInfoMicroPeckerXのデバイス情報
StMPXLogログ取得API用ログ情報

定義詳細​

StMPXAPIVersion​

StMPXAPIVersion構造体(APIのバージョン情報)のメンバは、以下の通りです。

変数名型名意味合い
APIVersionint8_t [32]APIのバージョン番号

StMPXDeviceInfo​

StMPXDeviceInfo構造体(MicroPeckerXのデバイス情報)のメンバは、以下の通りです。

変数名型名意味合い備考
Serialuint32_tシリアル番号MicroPeckerXに貼付されているシリアルNoシールの記載と同じです。
Modelint8_t [64]製品型名(例:S810-MX-FD2) 

StMPXLog​

StMPXLog構造体(ログ取得API用ログ情報)のメンバは、以下の通りです。

変数名型名意味合い備考
mSecuint32_tタイムスタンプ(ミリ秒)タイムスタンプは、mSecとuSecの値を組み合わせて表現します。
例えば12.345ms(12msと345us)の場合、mSecが12、uSecが345となります。
uSecuint16_tタイムスタンプ(マイクロ秒)
Protocoluint8_tプロトコル値の意味合いについては「ログ種別」を参照してください。
Diruint8_t方向値の意味合いについては「ログ方向」を参照してください。
Miscunion雑多情報CAN通信とLIN通信で異なる情報を集めた共用体です(詳細は「StMPXLog構造体のMisc」を参照)。
Datauint8_t [64]データ要素番号(0~63)は、データのD1~D64にそれぞれ対応します。
LIN通信では、DLと同じ要素番号がチェックサムとなります。

補足情報​

StMPXLog構造体のMisc​

StMPXLog構造体のMiscは、プロトコル(CAN/LIN)に応じて「有効な枝」が切り替わる共用体となっています。
以下のようにProtocolの値からプロトコルを判定し、その結果に応じて有効な枝を読んでください(共用体は同一メモリを共有しますので、同時に複数の枝を読むことはできません)。

判定条件(Protocol)有効メンバ
以下のいずれか
MPX_LOG_TYPE_CAN, MPX_LOG_TYPE_CANFD, MPX_LOG_TYPE_CANFD_NOBRS
Misc.CAN
MPX_LOG_TYPE_LINMisc.LIN

StMPXLog構造体のMisc.CAN​

StMPXLog構造体のMisc.CANは、以下のメンバを有する構造体となっています。

変数名型名意味合い備考
IDuint32_tCAN ID(標準IDまたは拡張ID)標準IDの場合は、下位11ビット(ビット10~ビット0)にセットされます。
RTRuint8_tリモート送信要求(RTR)値の意味合いについては「CANリモート送信要求」を参照してください。
IDEuint8_tIDフォーマット(IDE)値の意味合いについては「CAN IDフォーマット」を参照してください。
DLuint8_tデータ長(DL) 
Erroruint8_tエラーフラグ値の意味合いについては「CANエラーフラグ」を参照してください。
ErrorInfouint32_tエラー情報値の意味合いについては「CANエラー情報」を参照してください。

StMPXLog構造体のMisc.LIN​

StMPXLog構造体のMisc.LINは、以下のメンバを有する構造体となっています。

変数名型名意味合い備考
IDuint8_tLIN ID 
SBLenuint8_tSyncBreak幅 
WakeupWidthuint16_tウェイクアップパルス幅 
Typeuint8_tLINログ種別値の意味合いについては「LINログ種別」を参照してください。
DLuint8_tデータ長(DL) 
Reserved1uint8_t [2]予約領域1 
ErrorCodeuint8_tエラーコード値の意味合いについては「LINエラーコード」を参照してください。
Reserved2uint8_t [3]予約領域2