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 zu Member-Funktionen

QCanSignalDescription::QCanSignalDescription()

Erstellt eine leere Signalbeschreibung.

QCanSignalDescription::QCanSignalDescription(const QCanSignalDescription &other)

Erstellt eine Signalbeschreibung mit den Werten, die von other kopiert wurden.

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

Erstellt eine Signalbeschreibung, indem ein Objekt aus ` other` verschoben wird.

[constexpr noexcept default] QCanSignalDescription::~QCanSignalDescription()

Löscht diese Signalbeschreibung.

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

Fügt ein neues „ multiplexor signal “ für dieses Signal hinzu. Der Parameter „ name “ enthält den Namen des Multiplexorsignals, und der Parameter „ ranges “ enthält die gewünschten Wertebereiche.

Falls für dieses Signal bereits Sollwertbereiche für das Multiplexorsignal „ name “ vorhanden sind, werden diese überschrieben.

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

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

Dies ist eine Komfortüberladung für den Fall, dass das Multiplexorsignal voraussichtlich nur einen bestimmten Wert und keinen Wertebereich annimmt.

Der Parameter „ name “ enthält den Namen des Multiplexorsignals, und der Parameter „ value “ enthält den gewünschten Wert.

Wenn für das Multiplexorsignal „ name “ bereits gewünschte Wertebereiche vorhanden sind, werden diese ü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 zum Signal zurück.

Dieser Parameter dient lediglich der zusätzlichen Beschreibung. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch setComment().

QSysInfo::Endian QCanSignalDescription::dataEndian() const

Gibt die Daten-Endian-Reihenfolge 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 des Signalwerts zurück.

Standardmäßig wird „ Payload “ verwendet.

Siehe auch „ setDataSource()“ und „ QtCanBus::DataSource “.

double QCanSignalDescription::factor() const

Gibt den Faktor zurück, der zur Umwandlung des Signalwerts in einen physikalischen Wert und zurück verwendet wird.

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

Im Abschnitt „ Value Conversions “ wird erläutert, 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, andernfalls „ false “.

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

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

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 kleinsten unterstützten Wert für das Signal zurück.

Standardmäßig gibt die Funktion „ qQNaN()“ zurück, was bedeutet, dass kein Mindestwert vorhanden ist.

Siehe auch „ setRange()“ und „ maximum()“.

QCanSignalDescription::MultiplexSignalValues QCanSignalDescription::multiplexSignals() const

Gibt die „ multiplexor signals “ und deren gewünschte Werte zurück, die zur eindeutigen 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 aufweisen.

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

QtCanBus::MultiplexState QCanSignalDescription::multiplexState() const

Gibt den Multiplex-Status des Signals zurück.

Weitere Informationen zu multiplexierten 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 zur Umwandlung des Signalwerts in einen physikalischen Wert und zurück verwendet wird.

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

Im Abschnitt „ Value Conversions “ wird erläutert, 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 eine leere Zeichenkette, wenn keine Einheit festgelegt ist.

Dieser Parameter dient lediglich der zusätzlichen Beschreibung. 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 dient lediglich der zusätzlichen Beschreibung. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch „ setReceiver()“.

double QCanSignalDescription::scaling() const

Gibt den Skalierungsfaktor zurück, der verwendet wird, um den Wert des Signals in einen physikalischen Wert umzuwandeln und umgekehrt.

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

Im Abschnitt „ Value Conversions “ wird erläutert, wie dieser Parameter verwendet wird.

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

void QCanSignalDescription::setBitLength(quint16 length)

Legt die Bitlänge des Signalwerts auf „ length “ fest.

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

void QCanSignalDescription::setComment(const QString &text)

Setzt den Kommentar für das Signal auf „ text “.

Dieser Parameter dient lediglich der zusätzlichen Beschreibung. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch „ comment()“.

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

Legt die Daten-Endian-Reihenfolge des Signalwerts auf „ endian “ fest.

Siehe auch „ dataEndian()“ und „ QSysInfo::Endian “.

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

Legt das Datenformat des Signalwerts auf „ format “ fest.

Siehe auch „ dataFormat()“ und „ QtCanBus::DataFormat “.

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

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

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 “ umzuwandeln.

Übergeben Sie ` qQNaN()` an diese Methode, um diesen Parameter bei der Umwandlung zu überspringen.

Der Faktor darf nicht 0 sein. Der Versuch, einen Faktor von Null festzulegen, entspricht der Festlegung auf ` qQNaN()`.

Im Abschnitt „ Value Conversions “ wird erläutert, wie dieser Parameter verwendet wird.

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

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

Legt den Hash „ multiplexor signals “ für dieses Signal auf „ multiplexorSignals “ fest.

Das Hash „ multiplexorSignals “ muss Signalnamen als Schlüssel und die entsprechenden 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 Informationen zu multiplexierten Signalen finden Sie im Abschnitt „ Multiplexed Signals Explained “.

Siehe auch „ multiplexState()“ und „ QtCanBus::MultiplexState “.

void QCanSignalDescription::setName(const QString &name)

Legt den Namen des Signals auf „ name “ fest.

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 zu „ offset “ zu konvertieren.

Übergeben Sie ` qQNaN()` an diese Methode, um diesen Parameter bei der Umwandlung zu überspringen.

Im Abschnitt „ Value Conversions “ wird erläutert, wie dieser Parameter verwendet wird.

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

void QCanSignalDescription::setPhysicalUnit(const QString &unit)

Legt die physikalische Ein unit einheit (z. B. km/h) des Signalwerts fest.

Dieser Parameter dient lediglich der zusätzlichen Beschreibung. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch „ physicalUnit()“.

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

Legt die Werte für „ minimum “ und „ maximum “ für den Signalwert fest.

Wird einer oder beide Parameter auf qQNaN() gesetzt, bedeutet dies, dass die entsprechende Begrenzung nicht angewendet wird.

Siehe auch minimum() und maximum().

void QCanSignalDescription::setReceiver(const QString &receiver)

Legt den Knoten „ receiver “ für dieses Signal fest.

Dieser Parameter dient lediglich der zusätzlichen Beschreibung. Er wird bei der Signalverarbeitung nicht verwendet.

Siehe auch „ receiver()“.

void QCanSignalDescription::setScaling(double scaling)

Legt den Skalierungsfaktor fest, der verwendet wird, um den Wert des Signals in einen physikalischen Wert und zurück zu „ scaling “ zu konvertieren.

Übergeben Sie ` qQNaN()` an diese Methode, um diesen Parameter bei der Umwandlung zu überspringen.

Der Skalierungsfaktor darf nicht 0 sein. Der Versuch, den Skalierungsfaktor auf Null zu setzen, entspricht der Einstellung auf ` qQNaN()`.

Im Abschnitt „ Value Conversions “ wird erläutert, wie dieser Parameter verwendet wird.

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

void QCanSignalDescription::setStartBit(quint16 bit)

Setzt das Startbit des Signalwerts in der Funktion „ dataSource()“ auf „ bit “.

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

quint16 QCanSignalDescription::startBit() const

Gibt das Startbit des Signalwerts in der Funktion „ dataSource()“ zurück.

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

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

Überträgt die Werte aus „ other “ in diese Signalbeschreibung.

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

Weist dieser Signalbeschreibung die Werte aus „ other “ zu.