find_ports

bpod_core.com.find_ports(**filters)

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 of 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.