이 페이지에서

QCanSignalDescription Class

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

헤더: #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비트 값을 인코딩할 것입니다.

리틀 엔디안

리틀 엔디안의 경우, 데이터 레이아웃은 다음 그림과 같이 나타낼 수 있습니다.

리틀 엔디안 CAN 신호 비트 배열: 파란색 및 주황색 블록은 바이트 0~2에 걸쳐 두 값을 나타내며, LSB 및 MSB 위치를 표시합니다.

여기서 열은 비트 번호를, 행은 바이트 번호를 나타냅니다. 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
빅 엔디안

다음 이미지는 빅 엔디안 경우의 값 레이아웃을 나타냅니다:

빅 엔디안 CAN 신호 비트 배열: 파란색 및 주황색 블록은 바이트 0~2에 걸쳐 두 개의 값을 나타내며, 각 값의 최상위 비트(MSB)와 최하위 비트(LSB) 위치를 보여줍니다.

값들은 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 에서 복사한 값을 사용하여 신호 설명을 생성합니다.

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

other 에서 정보를 가져와 신호 설명을 생성합니다.

참고: 이동된 QCanSignalDescription객체는 소멸되거나 할당될 수만 있습니다. 소멸자나 할당 연산자 중 하나를 제외한 다른 함수를 호출할 경우 그 결과는 정의되지 않습니다.

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

참고: ` 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 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 &QCanSignalDescription::operator=(const QCanSignalDescription &other)

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

© 2026 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.