Класс Filter

(QCanBusDevice::Filter)

Структура QCanBusDevice::Filter определяет фильтр для сообщений CAN-шины. Подробнее...

Заголовок:	#include <Filter>
qmake:	QT += serialbus
С момента:	Qt 5.6

Список всех членов, включая унаследованные члены

Типы публичного доступа

Перечисление	FormatFilter { MatchBaseFormat, MatchExtendedFormat, MatchBaseAndExtendedFormat }
Флаги	FormatFilters

Общедоступные переменные

FormatFilter	format = MatchBaseAndExtendedFormat
quint32	frameId = 0
quint32	frameIdMask = 0
QCanBusFrame::FrameType	type = QCanBusFrame::InvalidFrame

Подробное описание

Структура QCanBusDevice::Filter определяет фильтр для сообщений CAN-шины.

Список экземпляров QCanBusDevice::Filter передаётся в QCanBusDevice::setConfigurationParameter() для включения фильтрации. Если полученное сообщение CAN соответствует хотя бы одному из фильтров в списке, QCanBusDevice его примет.

Пример использования структуры:

QCanBusDevice::Filter filter;
QList<QCanBusDevice::Filter> filterList;

// filter all CAN bus packages with id 0x444 (base) or 0xXXXXX444 (extended)
filter.frameId = 0x444u;
filter.frameIdMask = 0x7FFu;
filter.format = QCanBusDevice::Filter::MatchBaseAndExtendedFormat;
filter.type = QCanBusFrame::InvalidFrame;
filterList.append(filter);

// filter all DataFrames with extended CAN bus package format
filter.frameId = 0x0;
filter.frameIdMask = 0x0;
filter.format = QCanBusDevice::Filter::MatchExtendedFormat;
filter.type = QCanBusFrame::DataFrame;
filterList.append(filter);

// apply filter
device->setConfigurationParameter(QCanBusDevice::RawFilterKey, QVariant::fromValue(filterList));

Документация по типам членов

Перечисление Filter::FormatFilterфлаги Filter::FormatFilters

Это перечисление описывает шаблон формата, используемый для фильтрации входящих сообщений CAN-шины.

Константа	Значение	Описание
`QCanBusDevice::Filter::MatchBaseFormat`	`0x0001`	Сообщение CAN-шины должно использовать базовый формат сообщения (11-битовый идентификатор).
`QCanBusDevice::Filter::MatchExtendedFormat`	`0x0002`	Сообщение CAN-шины должно использовать расширенный формат сообщения (29-битовый идентификатор).
`QCanBusDevice::Filter::MatchBaseAndExtendedFormat`	`0x0003`	Сообщение CAN-шины может иметь базовый или расширенный формат сообщения.

Тип FormatFilters является псевдонимом для QFlags<FormatFilter>. Он хранит логическое ИЛИ сочетание значений FormatFilter.

Документация по переменным-членам

FormatFilter Filter::format = MatchBaseAndExtendedFormat

Эта переменная содержит формат сообщения сопоставляемого сообщения CAN-шины.

По умолчанию это поле установлено в QCanBusDevice::Filter::MatchBaseAndExtendedFormat.

quint32 Filter::frameId = 0

Эта переменная содержит идентификатор кадра, используемый для фильтрации входящих сообщений.

frameId используется совместно с frameIdMask. Сопоставление успешно, если следующее выражение равно true:

(receivedFrameId & frameIdMask) == (frameId & frameIdMask)

По умолчанию это поле установлено в 0x0.

См. также frameIdMask.

quint32 Filter::frameIdMask = 0

Эта переменная содержит битовую маску, применяемую к идентификатору кадра фильтра и полученного сообщения.

Два идентификатора кадров совпадают, если следующее выражение равно true:

(receivedFrameId & frameIdMask) == (frameId & frameIdMask)

По умолчанию это поле установлено в 0x0.

См. также frameId.

QCanBusFrame::FrameType Filter::type = QCanBusFrame::InvalidFrame

Эта переменная содержит тип сообщения, подлежащего фильтрации.

Любой тип сообщения CAN-шины может быть сопоставлен, если эта переменная установлена в QCanBusFrame::InvalidFrame. Объект фильтра недействителен, если тип равен QCanBusFrame::UnknownFrame.

По умолчанию это поле установлено в QCanBusFrame::InvalidFrame.

См. также QCanBusFrame::FrameType.

© The Qt Company Ltd
Licensed under the GNU Free Documentation License, Version 1.3.
https://doc.qt.io/archives/qt-5.6/qcanbusdevice-filter.html