QCanSignalDescription Class

QCanSignalDescription signal1;
signal1.setDataEndian(QSysInfo::Endian::LittleEndian);
signal1.setStartBit(0);
signal1.setBitLength(12);
// other parameters for signal1

QCanSignalDescription signal2;
signal2.setDataEndian(QSysInfo::Endian::LittleEndian);
signal2.setStartBit(12);
signal2.setBitLength(12);
// other parameters for signal2

QCanSignalDescription signal1;
signal1.setDataEndian(QSysInfo::Endian::BigEndian);
signal1.setStartBit(7);
signal1.setBitLength(12);
// other parameters for signal1

QCanSignalDescription signal2;
signal2.setDataEndian(QSysInfo::Endian::BigEndian);
signal2.setStartBit(11);
signal2.setBitLength(12);
// other parameters for signal2

physicalValue = scaling * (signalValue * factor + offset);
signalValue = (physicalValue / scaling - offset) / factor;

メンバ関数ドキュメント

QCanSignalDescription::QCanSignalDescription()

空のシグナル記述を作成します。

QCanSignalDescription::QCanSignalDescription(const QCanSignalDescription &other)

other からコピーした値でシグナル記述を作成します。

[noexcept] QCanSignalDescription::QCanSignalDescription(QCanSignalDescription &&other)

other から移動してシグナル記述を作成する。

[noexcept] QCanSignalDescription::~QCanSignalDescription()

このシグナル記述を破棄します。

void QCanSignalDescription::addMultiplexSignal(const QString &name, const QCanSignalDescription::MultiplexValues &ranges)

このシグナルの新しいmultiplexor signal を追加します。name パラメータにはマルチプレクサ・シグナルの名前が含まれ、ranges パラメータには希望する値の範囲が含まれる。

このシグナルが、マルチプレクサ・シグナルname の希望値範囲を既に持っている場合、その範囲は上書きされます。

multiplexState()、multiplexSignals()、clearMultiplexSignals()、setMultiplexSignals()も参照 。

void QCanSignalDescription::addMultiplexSignal(const QString &name, const QVariant &value)

これはオーバーロードされた関数である。

これは、マルチプレクサ・シグナルが値の範囲ではなく、特定の1つの値のみを持つことが期待される場合の便宜的なオーバーロードです。

name パラメータにはマルチプレクサ信号の名前が入り、value パラメータには希望する値が入ります。

このシグナルが、マルチプレクサ・シグナルname の希望する値の範囲を既に持っている場合、その範囲は上書きされる。

multiplexState()、multiplexSignals()、clearMultiplexSignals()、setMultiplexSignals()も参照 。

quint16 QCanSignalDescription::bitLength() const

シグナルの値のビット長を返す。

setBitLength()、startBit()、およびsetStartBit() も参照 。

void QCanSignalDescription::clearMultiplexSignals()

このシグナルのmultiplexor signals をすべて削除します。

multiplexSignals()、setMultiplexSignals()、addMultiplexSignal() も参照 。

QString QCanSignalDescription::comment() const

シグナルのコメントを返します。

このパラメータは、補足説明のためだけに導入されています。シグナル処理中には使用されません。

setComment()も参照 。

QSysInfo::Endian QCanSignalDescription::dataEndian() const

シグナルの値のデータ・エンディアンを返します。

デフォルトでは、BigEndian が使用されます。

setDataEndian() およびQSysInfo::Endianも参照 。

QtCanBus::DataFormat QCanSignalDescription::dataFormat() const

シグナルの値のデータ・フォーマットを返します。

デフォルトでは、SignedInteger が使用されます。

setDataFormat() およびQtCanBus::DataFormat も参照 。

QtCanBus::DataSource QCanSignalDescription::dataSource() const

シグナル値のデータ・ソースを返します。

デフォルトでは、Payload が使用されます。

setDataSource() およびQtCanBus::DataSource も参照して ください。

double QCanSignalDescription::factor() const

係数： シグナルの値を物理的な値に変換するために使用される係数を返します。

デフォルトでは、この関数はqQNaN() を返し、係数は使用されません。

このパラメータがどのように使用されるかは、Value Conversions のセクションで説明します。

setFactor()、offset()、scaling()も参照 。

bool QCanSignalDescription::isValid() const

シグナルの記述が有効な場合はtrue を返し、そうでない場合はfalse を返す。

有効なシグナル記述は、以下の条件を満たす必要があります：

• name() が空でない。
• dataFormat() が== 32 の場合、bitLength() を持つ。Float
• dataFormat() が== 64 の場合、bitLength() がある。Double
• dataFormat() が8 の場合、bitLength() は の倍数でなければならない。AsciiString
• bitLength() は、0 より大きく、64 以下でなければならない。

bitLength()、dataFormat()、name()も参照の こと。

double QCanSignalDescription::maximum() const

シグナルのサポートされる最大値を返す。

デフォルトでは、この関数はqQNaN() を返す。

setRange() およびminimum()も参照 。

double QCanSignalDescription::minimum() const

対応するシグナルの最小値を返す。

デフォルトでは、この関数はqQNaN() を返し、これは最小値がないことを意味する。

setRange() およびmaximum() も参照 。

QCanSignalDescription::MultiplexSignalValues QCanSignalDescription::multiplexSignals() const

このシグナルを正しく識別するために使用されるmultiplexor signals とその値を返します。

返されるハッシュには、キーとしてシグナル名、値としてそれぞれの希望する値の範囲が含まれる。

このシグナルの値は、ハッシュのすべてのシグナルが期待される値を持つ場合にのみ、ペイロードから抽出することができる。

multiplexState()、clearMultiplexSignals()、setMultiplexSignals()、addMultiplexSignal()も参照 。

QtCanBus::MultiplexState QCanSignalDescription::multiplexState() const

シグナルの多重状態を返す。

多重化されたシグナルの詳細については、Multiplexed Signals Explained のセクションを参照してください。

デフォルトでは、このメソッドはNone を返す。

setMultiplexState() およびQtCanBus::MultiplexStateも参照 。

QString QCanSignalDescription::name() const

シグナルの名前を返します。

setName() およびisValid()も参照 。

double QCanSignalDescription::offset() const

オフセット： シグナルの値を物理的な値に変換するために使用されるオフセットを返します。

デフォルトでは、この関数はqQNaN() を返し、オフセットは使用されません。

このパラメータの使用方法については、Value Conversions のセクションを参照してください。

setOffset()、factor()、scaling()も参照 。

QString QCanSignalDescription::physicalUnit() const

信号値の物理単位（km/h など）を返すか、単位が設定されていない場合は空文字列を返す。

このパラメータは、補足説明のためだけに導入されている。信号処理中には使用されません。

setPhysicalUnit()も参照 。

QString QCanSignalDescription::receiver() const

このシグナルの受信ノードを返します。

このパラメータは補足説明のためだけに導入された。シグナル処理中には使用されない。

setReceiver()も参照 。

double QCanSignalDescription::scaling() const

信号の値を物理的な値に変換するために使用されるスケーリングを返します。

デフォルトでは、この関数はqQNaN() を返します。これは、スケーリングが使用されないことを意味します。

このパラメータの使用方法については、Value Conversions のセクションを参照してください。

setScaling(),offset(),factor()も参照 。

void QCanSignalDescription::setBitLength(quint16 length)

信号値のビット長をlength に設定する。

bitLength （）、startBit （）、setStartBit （）も参照 。

void QCanSignalDescription::setComment(const QString &text)

シグナルのコメントをtext に設定します。

このパラメータは、補足説明のためだけに導入されています。シグナル処理中には使用されません。

comment()も参照 。

void QCanSignalDescription::setDataEndian(QSysInfo::Endian endian)

シグナルの値のデータ・エンディアンをendian に設定します。

dataEndian() およびQSysInfo::Endian も参照 。

void QCanSignalDescription::setDataFormat(QtCanBus::DataFormat format)

シグナルの値のデータ・フォーマットをformat に設定します。

dataFormat() およびQtCanBus::DataFormat も参照 。

void QCanSignalDescription::setDataSource(QtCanBus::DataSource source)

シグナルの値のデータ・ソースをsource に設定します。

dataSource() およびQtCanBus::DataSource も参照 。

void QCanSignalDescription::setFactor(double factor)

シグナルの値を物理的な値に変換するために使用される係数をfactor に設定します。

変換中にこのパラメータをスキップするには、このメソッドにqQNaN() を渡します。

係数を 0 にすることはできません。係数を 0 に設定しようとすると、qQNaN() に設定したのと同じことになります。

Value Conversions セクションで、このパラメータの使用方法を説明しています。

factor （）、setOffset （）、setScaling （）も参照 。

void QCanSignalDescription::setMultiplexSignals(const QCanSignalDescription::MultiplexSignalValues &multiplexorSignals)

このシグナルのmultiplexor signals をmultiplexorSignals に設定する。

multiplexorSignals ハッシュには、キーとしてシグナル名、値として希望する値の範囲を含める必要がある。

multiplexState()、multiplexSignals()、clearMultiplexSignals()、addMultiplexSignal()も参照 。

void QCanSignalDescription::setMultiplexState(QtCanBus::MultiplexState state)

シグナルの多重状態をstate に設定する。

多重化信号の詳細については、Multiplexed Signals Explained のセクションを参照。

multiplexState() およびQtCanBus::MultiplexStateも参照 。

void QCanSignalDescription::setName(const QString &name)

シグナルの名前をname に設定する。

シグナルの名前は、CANメッセージ内で一意でなければならない。

name()も参照 。

void QCanSignalDescription::setOffset(double offset)

シグナルの値を物理的な値に変換するために使用されるオフセットをoffset に設定します。

変換中にこのパラメータをスキップするには、このメソッドにqQNaN() を渡します。

Value Conversions のセクションでは、このパラメータの使用方法を説明しています。

offset()、setFactor()、およびsetScaling()も参照して ください。

void QCanSignalDescription::setPhysicalUnit(const QString &unit)

信号値の物理的なunit (例：km/h) を設定します。

このパラメータは、補足説明のためだけに導入されている。信号処理中には使用されません。

physicalUnit()も参照 。

void QCanSignalDescription::setRange(double minimum, double maximum)

信号値のminimum とmaximum を設定する。

パラメータの1つまたは両方をqQNaN() に設定すると、対応する制限値は使用されない。

minimum() およびmaximum()も参照 。

void QCanSignalDescription::setReceiver(const QString &receiver)

このシグナルのreceiver ノードを設定する。

このパラメータは、補足説明のためだけに導入されている。信号処理中には使用されない。

receiver()も参照 。

void QCanSignalDescription::setScaling(double scaling)

シグナルの値を物理的な値に変換し、scaling に戻すために使用されるスケーリングを設定します。

変換時にこのパラメータをスキップするには、このメソッドにqQNaN() を渡します。

スケーリングを 0 に設定しようとすると、qQNaN() に設定したのと同じことになります。

Value Conversions セクションで、このパラメータの使用方法を説明しています。

scaling(),setOffset(),setFactor()も参照 。

void QCanSignalDescription::setStartBit(quint16 bit)

dataSource() の信号値の開始ビットをbit に設定する。

startBit()、bitLength()、およびsetBitLength() も参照 。

quint16 QCanSignalDescription::startBit() const

dataSource() のシグナルの値の開始ビットを返す。

setStartBit()、bitLength()、setBitLength() も参照 。

[noexcept] QCanSignalDescription &QCanSignalDescription::operator=(QCanSignalDescription &&other)

move-このシグナル記述に、other からの値を割り当てる。

QCanSignalDescription &QCanSignalDescription::operator=(const QCanSignalDescription &other)

other の値をこのシグナル記述に代入します。