QCanSignalDescription Class

QCanSignalDescription 클래스는 CAN 프레임에서 하나의 값을 추출하여 애플리케이션 정의 형식으로 표현하는 규칙을 설명합니다. 더 보기...

Header: #include <QCanSignalDescription>
CMake: find_package(Qt6 REQUIRED COMPONENTS SerialBus)
target_link_libraries(mytarget PRIVATE Qt6::SerialBus)
qmake: QT += serialbus
이후: Qt 6.5
상태: 예비

이 클래스는 개발 중이며 변경될 수 있습니다.

공용 유형

공용 함수

QCanSignalDescription()
QCanSignalDescription(const QCanSignalDescription &other)
QCanSignalDescription(QCanSignalDescription &&other)
~QCanSignalDescription()
void addMultiplexSignal(const QString &name, const QCanSignalDescription::MultiplexValues &ranges)
void addMultiplexSignal(const QString &name, const QVariant &value)
quint16 bitLength() const
void clearMultiplexSignals()
QString comment() const
QSysInfo::Endian dataEndian() const
QtCanBus::DataFormat dataFormat() const
QtCanBus::DataSource dataSource() const
double factor() const
bool isValid() const
double maximum() const
double minimum() const
QCanSignalDescription::MultiplexSignalValues multiplexSignals() const
QtCanBus::MultiplexState multiplexState() const
QString name() const
double offset() const
QString physicalUnit() const
QString receiver() const
double scaling() const
void setBitLength(quint16 length)
void setComment(const QString &text)
void setDataEndian(QSysInfo::Endian endian)
void setDataFormat(QtCanBus::DataFormat format)
void setDataSource(QtCanBus::DataSource source)
void setFactor(double factor)
void setMultiplexSignals(const QCanSignalDescription::MultiplexSignalValues &multiplexorSignals)
void setMultiplexState(QtCanBus::MultiplexState state)
void setName(const QString &name)
void setOffset(double offset)
void setPhysicalUnit(const QString &unit)
void setRange(double minimum, double maximum)
void setReceiver(const QString &receiver)
void setScaling(double scaling)
void setStartBit(quint16 bit)
quint16 startBit() const
QCanSignalDescription &operator=(QCanSignalDescription &&other)
QCanSignalDescription &operator=(const QCanSignalDescription &other)

상세 설명

QCanSignalDescription 클래스는 신호 설명을 제공하고 나중에 수신된 QCanBusFrame 을 디코딩하거나 입력 데이터를 수신자에게 전송할 수 있는 QCanBusFrame 으로 인코딩하는 데 사용할 수 있습니다.

일반 설명

각 CAN 프레임은 여러 값을 포함할 수 있습니다. CAN 프레임에서 값을 추출하는 규칙은 다음과 같습니다:

  • 데이터 소스(프레임 ID 또는 페이로드).
  • 데이터 엔디안. 자세한 내용은 Data Endianness Processing 섹션을 참조하세요.
  • 데이터 형식.
  • 시작 비트 위치.
  • 비트 단위의 데이터 길이입니다.
  • 멀티플렉싱 옵션.

시작 비트 위치는 선택한 데이터 소스를 기준으로 지정됩니다. 비트는 LSB부터 카운트됩니다.

데이터가 추출되면 애플리케이션 정의 형식으로 변환해야 할 수 있습니다. 이를 위해 다음 매개변수를 사용할 수 있습니다:

  • 추출된 값을 실제 값으로 변환하기 위한 다양한 매개변수(계수, 오프셋, 스케일).
  • 예상 데이터 범위.
  • 데이터 단위.

QCanSignalDescription 클래스는 이러한 모든 파라미터를 제어하는 메서드를 제공합니다.

데이터 엔디안 처리

리틀 엔디안과 빅 엔디안 데이터는 다르게 인코딩됩니다. 빅 엔디안 값의 경우, 가장 중요한 비트에 대해 시작 비트 위치가 지정됩니다. 리틀 엔디안 값의 경우, 시작 비트 위치는 최하위 비트의 위치입니다.

두 가지 예를 살펴보겠습니다. 두 예제 모두 3바이트 페이로드에 두 개의 12비트 값을 인코딩합니다.

리틀 엔디안

리틀 엔디안의 경우 데이터 레이아웃은 다음 이미지로 표현할 수 있습니다:

여기서 열은 비트 수를 나타내고 행은 바이트 수를 나타냅니다. LSB 은 값의 첫 번째(최하위) 비트를 표시하고 MSB 은 값의 마지막(최상위) 비트를 표시합니다. 파란색은 첫 번째 값을 표시하고 주황색은 두 번째 값을 표시합니다.

이러한 값에 대한 정보는 다음과 같은 방식으로 QCanSignalDescription에 인코딩됩니다:

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에 표현할 수 있습니다:

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

시작 비트가 작은 엔디안의 경우와 어떻게 다른지 주목하세요. 또한 값이 다르게 정렬됩니다.

다중화된 신호 설명

CAN 페이로드의 데이터를 인코딩하는 일반적인 방법에는 두 가지가 있습니다:

  • 각 비트 범위는 항상 동일한 신호를 나타냅니다. 예를 들어, 페이로드에서 Bytes 0-1 은 엔진 속도(rpm)를 나타내고 Bytes 2-3 은 차량 속도(km/h)를 나타낼 수 있습니다.
  • 페이로드의 다른 비트 값에 따라 동일한 범위의 비트가 다른 데이터를 나타낼 수 있습니다. 예를 들어 Byte 0 값이 0 인 경우 Bytes 1-2 는 엔진 속도(rpm)를 나타내고 Byte 0 값이 1 인 경우 동일한 Bytes 1-2 는 차량 속도(km/h)를 나타냅니다.

두 번째 경우는 신호 멀티플렉싱을 사용합니다. 제공된 예제에서는 세 개의 신호가 있습니다. 첫 번째 신호는 Byte 0 의 값을 나타내며 멀티플렉서 신호처럼 작동합니다. 나머지 두 신호는 각각 엔진 속도와 차량 속도를 나타내지만 한 번에 하나만 CAN 페이로드에서 추출할 수 있습니다. 어떤 신호를 추출할지는 멀티플렉서 신호의 값에 의해 정의됩니다.

더 복잡한 경우에는 페이로드에 멀티플렉서 신호가 여러 개 있을 수 있습니다. 이러한 경우 모든 멀티플렉서에 예상 값이 포함되어 있을 때만 페이로드에서 신호를 추출할 수 있습니다.

값 변환

대부분의 경우 CAN 버스를 통해 전송되는 신호는 해당 신호가 나타내는 물리적 값의 전체 범위를 담을 수 없습니다. 이러한 한계를 극복하기 위해 물리적 값은 전송 전에 더 작은 범위로 변환되며, 수신 측에서 복원할 수 있습니다.

다음 공식을 사용하여 물리적 값과 신호의 값 사이를 변환합니다:

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

계수 및 스케일링 매개변수는 0 과 같을 수 없습니다.

매개변수 중 하나라도 qQNaN()와 같으면 변환 중에 사용되지 않습니다. 모든 매개변수가 qQNaN()(기본값)와 같으면 변환이 수행되지 않습니다.

회원 유형 문서

[alias] QCanSignalDescription::MultiplexSignalValues

[alias] QCanSignalDescription::MultiplexValues

멤버 기능 문서

QCanSignalDescription::QCanSignalDescription()

빈 신호 설명을 생성합니다.

QCanSignalDescription::QCanSignalDescription(const QCanSignalDescription &other)

other 에서 복사한 값으로 신호 설명을 생성합니다.

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

other 에서 이동하여 신호 설명을 생성합니다.

참고: QCanSignalDescription에서 이동한 객체는 소멸하거나 할당할 수만 있습니다. 소멸자 또는 할당 연산자 중 하나가 아닌 다른 함수를 호출하는 효과는 정의되지 않았습니다.

[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)

이것은 과부하 기능입니다.

멀티플렉서 신호에 여러 값 범위가 아닌 하나의 특정 값만 있을 것으로 예상되는 경우의 편의성 과부하입니다.

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 이 사용됩니다.

참고: dataFormat()가 AsciiString 으로 설정된 경우 데이터 엔디안은 무시됩니다.

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 을 반환합니다.

유효한 신호 설명은 다음 조건을 충족해야 합니다:

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 signalsmultiplexorSignals 으로 설정합니다.

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)

신호 값으로 minimummaximum 을 설정합니다.

매개변수 중 하나 또는 둘 모두를 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 &QCanSignalDescription::operator=(const QCanSignalDescription &other)

other 의 값을 이 신호 설명에 할당합니다.

© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.