Класс Filter

(QCanBusDevice::Filter)

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

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

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

Открытые типы

перечисление	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/qt-5.9/qcanbusdevice-filter.html