QCanFrameProcessor Class

メンバ関数のドキュメント

QCanFrameProcessor::QCanFrameProcessor()

CANフレームプロセッサを作成します。

[noexcept] QCanFrameProcessor::~QCanFrameProcessor()

このフレームプロセッサを破棄します。

void QCanFrameProcessor::addMessageDescriptions(const QList<QCanMessageDescription> &descriptions)

利用可能なメッセージの説明に、新しいメッセージの説明「descriptions 」を追加します。

すべてのメッセージ説明には、一意のIDを割り当てる必要があります。

一部のメッセージ説明で一意の ID が重複している場合、最後の説明のみが使用されます。

パーサーにすでに同じ一意の ID を持つメッセージ記述が存在する場合、その記述は上書きされます。

messageDescriptions()、setMessageDescriptions()、およびclearMessageDescriptions()も参照してください 。

void QCanFrameProcessor::clearMessageDescriptions()

このフレームプロセッサに関するすべてのメッセージの説明を削除します。

messageDescriptions()、addMessageDescriptions()、およびsetMessageDescriptions()も参照してください 。

QCanFrameProcessor::Error QCanFrameProcessor::error() const

最後のエラーを返します。

errorString()、prepareFrame()、およびparseFrame()も参照してください 。

QString QCanFrameProcessor::errorString() const

直近のエラーに関する説明テキストを返します。

error()、prepareFrame()、およびparseFrame()も参照してください 。

QList<QCanMessageDescription> QCanFrameProcessor::messageDescriptions() const

このフレームプロセッサで現在使用されているすべてのメッセージの説明を返します。

addMessageDescriptions()、setMessageDescriptions()、およびclearMessageDescriptions()も参照してください 。

QCanFrameProcessor::ParseResult QCanFrameProcessor::parseFrame(const QCanBusFrame &frame)

指定されたメッセージ記述を使用して、フレーム「frame 」を解析します。

解析のプロセスは以下の通りです：

1. uniqueIdDescription() を使用して、メッセージの一意の識別子を抽出します。
2. 抽出された一意の識別子を使用して、利用可能なすべてのmessageDescriptions()のリストから適切なQCanMessageDescription を検索します。
3. 一致したQCanMessageDescription を使用して、フレームから信号値を抽出します。

このメソッドは、抽出された一意の識別子と、信号およびその値を含むQVariantMap の両方を含むQCanFrameProcessor::ParseResult を返します。マップのキーはsignal names であり、マップの値は信号値です。

デコード中にエラーが発生した場合、signalValues が空の結果が返されます。そのような場合、error()およびerrorString()メソッドを使用して、エラーに関する情報を取得できます。

関連項目： addMessageDescriptions()、error()、errorString()、およびwarnings()。

QCanBusFrame QCanFrameProcessor::prepareFrame(QtCanBus::UniqueId uniqueId, const QVariantMap &signalValues)

uniqueId およびsignalValues を使用してCANデータフレームを構築し、構築されたQCanBusFrame を返します。

signalValues パラメータには、キーとして信号名、値として予想される信号値を含める必要があります。

フレームの作成プロセスは以下の通りです：

1. uniqueId を使用して、適切なメッセージ記述を検索します。
2. メッセージ記述が見つかった場合、指定されたサイズのペイロードを持つQCanBusFrame が作成されます。ペイロードのすべてのバイト、およびフレーム ID は、ゼロに初期化されます。
3. uniqueIdDescription() 関数を使用して、uniqueId をフレームの適切な部分（フレームIDまたはペイロード）にエンコードします。
4. 選択されたメッセージ記述を使用して、すべてのsignalValues をフレームにエンコードします。
5. 一意の ID や既存のシグナル記述の対象とならないフレームの部分は変更されず（したがって、引き続きゼロが含まれます）、そのまま残ります。

エンコード中にエラーが発生した場合、無効なQCanBusFrame が返されます。そのような場合、error() およびerrorString() メソッドを使用して、エラーに関する情報を取得できます。

関連項目: addMessageDescriptions()、error()、errorString()、およびwarnings()。

void QCanFrameProcessor::setMessageDescriptions(const QList<QCanMessageDescription> &descriptions)

このフレームプロセッサで使用されている現在のメッセージ記述を、新しいメッセージ記述descriptions に置き換えます。

messageDescriptions()、addMessageDescriptions()、およびclearMessageDescriptions()も参照してください 。

void QCanFrameProcessor::setUniqueIdDescription(const QCanUniqueIdDescription &description)

一意の識別子の説明を「description 」に設定します。

CANバスフレームのエンコードまたはデコードを行うには、一意の識別子の説明が有効である必要があります。詳細については、QCanUniqueIdDescription クラスのドキュメントを参照してください。

uniqueIdDescription() およびQCanUniqueIdDescriptionも参照してください 。

QCanUniqueIdDescription QCanFrameProcessor::uniqueIdDescription() const

一意の識別子の説明を返します。

CANバスフレームのエンコードまたはデコードを行うには、一意の識別子の記述が有効である必要があります。詳細については、QCanUniqueIdDescription クラスのドキュメントを参照してください。

setUniqueIdDescription() およびQCanUniqueIdDescriptionも参照してください 。

QStringList QCanFrameProcessor::warnings() const

前回のエンコードまたはデコードの呼び出し中に生成された警告のリストを返します。

error()、errorString()、prepareFrame()、およびparseFrame()も参照してください 。