Struct IdFilter 

pub struct IdFilter { /* private fields */ }

ID filter for single ID or mask-based matching

Supports both exact ID matching and mask-based matching.

Example

use canlink_hal::filter::IdFilter;

// Exact match for ID 0x123
let filter = IdFilter::new(0x123);

// Mask match: matches 0x120-0x12F
let filter = IdFilter::with_mask(0x120, 0x7F0);

Implementations

impl IdFilter

pub fn new(id: u32) -> Self

Create a new filter for exact ID match (standard frame)

Arguments

• id - The CAN ID to match (must be <= 0x7FF)

Panics

Panics if id exceeds the maximum standard ID.

pub fn with_mask(id: u32, mask: u32) -> Self

Create a new filter with mask (standard frame)

Arguments

• id - The target ID
• mask - Bits set to 1 must match, bits set to 0 are ignored

Example

use canlink_hal::filter::IdFilter;

// Match IDs 0x120-0x12F (mask ignores lower 4 bits)
let filter = IdFilter::with_mask(0x120, 0x7F0);

pub fn new_extended(id: u32) -> Self

Create a new filter for extended frame

Arguments

• id - The CAN ID to match (must be <= 0x1FFFFFFF)

Panics

Panics if id exceeds the maximum extended ID.

pub fn with_mask_extended(id: u32, mask: u32) -> Self

Create a new filter with mask for extended frame

pub fn try_new(id: u32) -> Result<Self, FilterError>

Try to create a new filter, returning error if ID is invalid

Errors

Returns FilterError::IdOutOfRange if id exceeds the maximum standard ID.

pub fn try_new_extended(id: u32) -> Result<Self, FilterError>

Try to create a new extended filter, returning error if ID is invalid

Errors

Returns FilterError::IdOutOfRange if id exceeds the maximum extended ID.

pub fn set_hardware(&mut self, hardware: bool)

Set whether this filter can use hardware acceleration

pub fn id(&self) -> u32

Get the target ID

pub fn mask(&self) -> u32

Get the mask

pub fn is_extended(&self) -> bool

Check if this filter is for extended frames

Trait Implementations

impl Clone for IdFilter

fn clone(&self) -> IdFilter

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for IdFilter

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl MessageFilter for IdFilter

fn matches(&self, message: &CanMessage) -> bool

Check if a message matches this filter

fn priority(&self) -> u32

Get the filter priority

fn is_hardware(&self) -> bool

Check if this is a hardware filter