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() も参照して ください。