Erik Brakkee ed4f75a93d docs: add README with setup instructions and tested hardware

Add comprehensive README.md covering project purpose, CLI usage,
and troubleshooting. Document the udev rule needed to prevent
usbserial from claiming the ANT+ dongle.

Add Tested hardware section listing the ANT USBStick2 and update
setup.md dmesg output accordingly.

Note: the bridge must be run as root to access the USB dongle.

2026-05-27 00:36:06 +02:00

857 B

Raw Blame History

dmesg

Make sure usbserial does not handle this device

cat > /etc/udev/rules.d/99-ant-usb.rules <<EOF
SUBSYSTEM=="usb", ATTRS{idVendor}=="0fcf", ATTRS{idProduct}=="1008", ENV{MODALIAS}="ignore"
EOF

Reload the rules

# remove dongle
sudo modprobe -r usb_serial_simple
sudo udevadm control --reload-rules
sudo udevadm trigger

Output of dmesg

[25649.007539] usb 3-1.2.1: USB disconnect, device number 40
[25651.523030] usb 3-1.2.1: new full-speed USB device number 41 using xhci_hcd
[25651.629681] usb 3-1.2.1: New USB device found, idVendor=0fcf, idProduct=1008, bcdDevice= 1.00
[25651.629693] usb 3-1.2.1: New USB device strings: Mfr=1, Product=2, SerialNumber=3
[25651.629697] usb 3-1.2.1: Product: ANT USBStick2
[25651.629700] usb 3-1.2.1: Manufacturer: Dynastream Innovations
[25651.629703] usb 3-1.2.1: SerialNumber: 123

857 B Raw Blame History

dmesg

857 B

Raw Blame History