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;

Dokumentation der Mitgliederfunktionen

QCanSignalDescription::QCanSignalDescription()

Erzeugt eine leere Signalbeschreibung.

QCanSignalDescription::QCanSignalDescription(const QCanSignalDescription &other)

Erzeugt eine Signalbeschreibung mit den aus other kopierten Werten.

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

Erzeugt eine Signalbeschreibung durch Verschieben von other.

[noexcept] QCanSignalDescription::~QCanSignalDescription()

Zerstört diese Signalbeschreibung.

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

Fügt eine neue multiplexor signal für dieses Signal hinzu. Der Parameter name enthält den Namen des Multiplexer-Signals und der Parameter ranges enthält die gewünschten Wertebereiche.

Wenn dieses Signal bereits Sollwertbereiche für das Multiplexersignal name hat, werden die Bereiche überschrieben.

Siehe auch multiplexState(), multiplexSignals(), clearMultiplexSignals(), und setMultiplexSignals().

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

Dies ist eine überladene Funktion.

Es handelt sich um eine Komfortüberladung für den Fall, dass das Multiplexer-Signal nur einen bestimmten Wert und nicht einen Wertebereich haben soll.

Der Parameter name enthält den Namen des Multiplexer-Signals, und der Parameter value enthält den gewünschten Wert.

Wenn dieses Signal bereits Sollwertbereiche für das Multiplexorsignal name hat, werden die Bereiche überschrieben.

Siehe auch multiplexState(), multiplexSignals(), clearMultiplexSignals(), und setMultiplexSignals().

quint16 QCanSignalDescription::bitLength() const

Gibt die Bitlänge des Signalwerts zurück.

Siehe auch setBitLength(), startBit(), und setStartBit().

void QCanSignalDescription::clearMultiplexSignals()

Entfernt alle multiplexor signals für dieses Signal.

Siehe auch multiplexSignals(), setMultiplexSignals(), und addMultiplexSignal().

QString QCanSignalDescription::comment() const

Gibt den Kommentar für das Signal zurück.

Dieser Parameter wird nur zur zusätzlichen Beschreibung eingeführt. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch setComment().

QSysInfo::Endian QCanSignalDescription::dataEndian() const

Gibt das Datenendian des Signalwerts zurück.

Standardmäßig wird BigEndian verwendet.

Siehe auch setDataEndian() und QSysInfo::Endian.

QtCanBus::DataFormat QCanSignalDescription::dataFormat() const

Gibt das Datenformat des Signalwerts zurück.

Standardmäßig wird SignedInteger verwendet.

Siehe auch setDataFormat() und QtCanBus::DataFormat.

QtCanBus::DataSource QCanSignalDescription::dataSource() const

Gibt die Datenquelle für den Wert des Signals zurück.

Standardmäßig wird Payload verwendet.

Siehe auch setDataSource() und QtCanBus::DataSource.

double QCanSignalDescription::factor() const

Gibt den Faktor zurück, der verwendet wird, um den Wert des Signals in einen physikalischen Wert und zurück zu konvertieren.

Standardmäßig gibt die Funktion qQNaN() zurück, was bedeutet, dass kein Faktor verwendet wird.

Der Abschnitt Value Conversions erklärt, wie dieser Parameter verwendet wird.

Siehe auch setFactor(), offset(), und scaling().

bool QCanSignalDescription::isValid() const

Gibt true zurück, wenn die Signalbeschreibung gültig ist, und andernfalls false.

Eine gültige Signalbeschreibung muss die folgenden Bedingungen erfüllen:

• hat eine nicht leere name()
• hat bitLength() == 32 wenn dataFormat() ist Float
• hat bitLength() == 64, wenn dataFormat() ist Double
• bitLength() muss ein Vielfaches von 8 sein, wenn dataFormat() ist AsciiString
• ist , muss bitLength() größer als 0 und kleiner als oder gleich 64 sein.

Siehe auch bitLength(), dataFormat(), und name().

double QCanSignalDescription::maximum() const

Gibt den maximal unterstützten Wert für das Signal zurück.

Standardmäßig gibt die Funktion qQNaN() zurück, was bedeutet, dass es keinen Maximalwert gibt.

Siehe auch setRange() und minimum().

double QCanSignalDescription::minimum() const

Gibt den minimalen unterstützten Wert für das Signal zurück.

Standardmäßig gibt die Funktion qQNaN() zurück, was bedeutet, dass es keinen Mindestwert gibt.

Siehe auch setRange() und maximum().

QCanSignalDescription::MultiplexSignalValues QCanSignalDescription::multiplexSignals() const

Gibt die multiplexor signals und ihre gewünschten Werte zurück, die zur korrekten Identifizierung dieses Signals verwendet werden.

Der zurückgegebene Hash enthält Signalnamen als Schlüssel und die jeweiligen gewünschten Wertebereiche als Werte.

Der Wert dieses Signals kann nur dann aus der Nutzlast extrahiert werden, wenn alle Signale aus dem Hash die erwarteten Werte haben.

Siehe auch multiplexState(), clearMultiplexSignals(), setMultiplexSignals(), und addMultiplexSignal().

QtCanBus::MultiplexState QCanSignalDescription::multiplexState() const

Gibt den Multiplex-Status des Signals zurück.

Weitere Einzelheiten zu gemultiplexten Signalen finden Sie im Abschnitt Multiplexed Signals Explained.

Standardmäßig gibt diese Methode None zurück.

Siehe auch setMultiplexState() und QtCanBus::MultiplexState.

QString QCanSignalDescription::name() const

Gibt den Namen des Signals zurück.

Siehe auch setName() und isValid().

double QCanSignalDescription::offset() const

Gibt den Offset zurück, der verwendet wird, um den Wert des Signals in einen physikalischen Wert und zurück zu konvertieren.

Standardmäßig gibt die Funktion qQNaN() zurück, was bedeutet, dass kein Offset verwendet wird.

Der Abschnitt Value Conversions erklärt, wie dieser Parameter verwendet wird.

Siehe auch setOffset(), factor(), und scaling().

QString QCanSignalDescription::physicalUnit() const

Gibt die physikalische Einheit (z. B. km/h) des Signalwerts zurück oder einen leeren String, wenn die Einheit nicht festgelegt ist.

Dieser Parameter wird nur zur zusätzlichen Beschreibung eingeführt. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch setPhysicalUnit().

QString QCanSignalDescription::receiver() const

Gibt den Empfängerknoten für dieses Signal zurück.

Dieser Parameter wird nur zur zusätzlichen Beschreibung eingeführt. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch setReceiver().

double QCanSignalDescription::scaling() const

Gibt die Skalierung zurück, die verwendet wird, um den Wert des Signals in einen physikalischen Wert und zurück zu konvertieren.

Standardmäßig gibt die Funktion qQNaN() zurück, was bedeutet, dass die Skalierung nicht verwendet wird.

Der Abschnitt Value Conversions erklärt, wie dieser Parameter verwendet wird.

Siehe auch setScaling(), offset(), und factor().

void QCanSignalDescription::setBitLength(quint16 length)

Setzt die Bitlänge des Signalwerts auf length.

Siehe auch bitLength(), startBit(), und setStartBit().

void QCanSignalDescription::setComment(const QString &text)

Setzt den Kommentar für das Signal auf text.

Dieser Parameter wird nur zur zusätzlichen Beschreibung eingeführt. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch comment().

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

Setzt das Datenendian des Signalwerts auf endian.

Siehe auch dataEndian() und QSysInfo::Endian.

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

Setzt das Datenformat des Signalwerts auf format.

Siehe auch dataFormat() und QtCanBus::DataFormat.

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

Setzt die Datenquelle für den Wert des Signals auf source.

Siehe auch dataSource() und QtCanBus::DataSource.

void QCanSignalDescription::setFactor(double factor)

Legt den Faktor fest, der verwendet wird, um den Wert des Signals in einen physikalischen Wert und zurück in factor zu konvertieren.

Übergeben Sie qQNaN() an diese Methode, um diesen Parameter während der Konvertierung zu überspringen.

Der Faktor kann nicht 0 sein. Der Versuch, einen Null-Faktor zu setzen, ist gleichbedeutend mit dem Setzen auf qQNaN().

Der Abschnitt Value Conversions erklärt, wie dieser Parameter verwendet wird.

Siehe auch factor(), setOffset(), und setScaling().

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

Setzt die multiplexor signals für dieses Signal auf multiplexorSignals.

Der Hash multiplexorSignals muss Signalnamen als Schlüssel und die jeweiligen gewünschten Wertebereiche als Werte enthalten.

Siehe auch multiplexState(), multiplexSignals(), clearMultiplexSignals(), und addMultiplexSignal().

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

Setzt den Multiplex-Status des Signals auf state.

Weitere Einzelheiten zu gemultiplexten Signalen finden Sie im Abschnitt Multiplexed Signals Explained.

Siehe auch multiplexState() und QtCanBus::MultiplexState.

void QCanSignalDescription::setName(const QString &name)

Setzt den Namen des Signals auf name.

Der Name des Signals muss innerhalb einer CAN-Nachricht eindeutig sein.

Siehe auch name().

void QCanSignalDescription::setOffset(double offset)

Legt den Offset fest, der verwendet wird, um den Wert des Signals in einen physikalischen Wert und zurück in offset zu konvertieren.

Übergeben Sie qQNaN() an diese Methode, um diesen Parameter während der Konvertierung zu überspringen.

Der Abschnitt Value Conversions erklärt, wie dieser Parameter verwendet wird.

Siehe auch offset(), setFactor(), und setScaling().

void QCanSignalDescription::setPhysicalUnit(const QString &unit)

Legt den physikalischen unit (z.B. km/h) des Signalwertes fest.

Dieser Parameter wird nur zur zusätzlichen Beschreibung eingeführt. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch physicalUnit().

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

Legt die Parameter minimum und maximum für den Wert des Signals fest.

Die Einstellung eines oder beider Parameter auf qQNaN() bedeutet, dass der entsprechende Grenzwert nicht verwendet wird.

Siehe auch minimum() und maximum().

void QCanSignalDescription::setReceiver(const QString &receiver)

Legt den receiver Knoten für dieses Signal fest.

Dieser Parameter wird nur zur zusätzlichen Beschreibung eingeführt. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch receiver().

void QCanSignalDescription::setScaling(double scaling)

Legt die Skalierung fest, die verwendet wird, um den Wert des Signals in einen physikalischen Wert und zurück in scaling umzuwandeln.

Übergeben Sie qQNaN() an diese Methode, um diesen Parameter während der Konvertierung zu überspringen.

Die Skalierung kann nicht 0 sein. Der Versuch, eine Null-Skalierung einzustellen, ist gleichbedeutend mit der Einstellung auf qQNaN().

Der Abschnitt Value Conversions erklärt, wie dieser Parameter verwendet wird.

Siehe auch scaling(), setOffset(), und setFactor().

void QCanSignalDescription::setStartBit(quint16 bit)

Setzt das Startbit des Signalwerts in dataSource() auf bit.

Siehe auch startBit(), bitLength(), und setBitLength().

quint16 QCanSignalDescription::startBit() const

Gibt das Startbit des Signalwerts in der Datei dataSource() zurück.

Siehe auch setStartBit(), bitLength(), und setBitLength().

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

Verschieben - weist die Werte von other dieser Signalbeschreibung zu.

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

Weist dieser Signalbeschreibung die Werte von other zu.