bpod_core.com.find_ports

bpod_core.com.find_ports(**filters) → list[ListPortInfo]

Find serial ports matching specified criteria.

Multiple filters use AND logic. Iterables within a single filter use OR logic.

Parameters:

**filters (FilterValue) –

Port attributes to filter by. Values can be:

• Scalar: exact match

• Sequence: match any item (OR logic)

• re.Pattern: regex match (use re.compile())

Returns:

Ports matching all criteria.

Return type:

list[ListPortInfo]

Examples

Find by vendor ID:

find_ports(vid=0x16C0)

Find using regex pattern:

find_ports(device=re.compile(r'/dev/ttyACM\d+'))

Find multiple values:

find_ports(pid=[0x0483, 0x048B])

Combine filters:

find_ports(vid=0x16C0, device=re.compile(r'/dev/ttyACM\d+'))

Notes

Strings use exact matching. Use re.compile() for regex patterns.