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 からコピーされた値を用いて、シグナルの記述を作成します。

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

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

[constexpr noexcept default] 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)

これは、マルチプレクサ信号が値の範囲ではなく、特定の値のみをとることが予想される場合のための便利なオーバーロードです。

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() が次の場合、bitLength()== 32 を持つことFloat
• dataFormat()が次の場合、bitLength()は== 64 でなければならない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 を設定します。

いずれか一方、または両方のパラメータをqQNaN()に設定すると、対応する制限は適用されなくなります。

minimum() およびmaximum()も参照してください 。

void QCanSignalDescription::setReceiver(const QString &receiver)

この信号の「receiver 」ノードを設定します。

このパラメータは、説明を補足するためにのみ導入されたものです。信号処理の際には使用されません。

receiver()も参照してください 。

void QCanSignalDescription::setScaling(double scaling)

信号の値を物理値に変換し、再びscaling に戻す際に使用されるスケーリングを設定します。

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

スケーリングは 0 に設定できません。スケーリングを 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)

other の値を、この信号記述に「移動代入」します。

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

other の値をこの信号記述に割り当てます。