SeedBus: Added can_filters parameter in SeedBus.__init__ method

[varunpenumudi]

This pull request resolves issue #1995 by adding support for configuring the hardware acceptance filter and mask during SeeedBus initialization.

Previously, setting a hardware filter was not possible directly through the init call of SeedBus. Users had to use a workaround by manually overwriting internal attributes (filter_id, mask_id) and re-calling the internal init_frame() method after the bus was already created. This process was unintuitive, broke encapsulation, and was prone to errors.

This PR implements the standard can_filters parameter in the SeeedBus.init method, adhering to the BusABC interface. This allows users to set a hardware filter cleanly in a single step upon bus creation.

Key Changes:

• Added the can_filters parameter to SeeedBus.__init__.
• The implementation validates that only one filter is provided, raising a can.CanInitializationError if more are given, in accordance with the SeedBus protocol limitation.
• Updated the seeedstudio.rst documentation to reflect the new parameter and its usage
• Added a news fragment for the changelog.

Note: This change is fully backward-compatible. If can_filters is not provided or None, the bus defaults to the previous behavior of accepting all messages.

Testing
I have personally tested this feature on a Waveshare USB to CAN Adapter (Model A), which uses the same serial protocol, and can confirm that it works as expected for both default (no filter) and filtered modes.

[zariiii9003]

You could use the software fallback of python-can if the user passes multiple filters. Check the implementation in BusABC.

[varunpenumudi]

Good Idea will implement it

[varunpenumudi]

I have completed the re-implementation of the can_filters for SeeedBus, incorporating the software fallback mechanism.

[varunpenumudi]

Also updated the changelog and done all the tox tests

[zariiii9003]

The _recv_internal method should also be updated. It returns a message and a boolean value:

python-can/can/bus.py

Line 169 in efd4de5

2. a bool that is True if message filtering has already

If you are using hardware filtering, you should return True, for software filtering return False. You can add an attribute self._is_filtered and return that in in _recv_internal

[zariiii9003]

Ignore the pylint errors, i assume they are caused by the new wrapt version.

[varunpenumudi]

The _recv_internal method should also be updated. It returns a message and a boolean value:

python-can/can/bus.py

Line 169 in efd4de5

2. a bool that is True if message filtering has already

If you are using hardware filtering, you should return True, for software filtering return False. You can add an attribute self._is_filtered and return that in in _recv_internal

Sorry, I haven't observed this, now i also updated the _recv_internal method of SeedBus to return the boolean of whether message i already filtered by hardware or to be filtered by software

[varunpenumudi]

Again, except that lint error all the tests were passed.

[zariiii9003]

Looks good, thank you 👍