2 releases

0.1.1 Sep 21, 2022
0.1.0 Aug 26, 2022

#1967 in Hardware support


Used in stm32-bootloader-client

MIT/Apache

20KB
465 lines

MCP2221-rs

This library allows your code to control an MCP2221 or MCP2221A over USB for the purposes of talking I2C or using the GPIO pins. It doesn't support the UART feature of the MCP2221 although PRs are welcome.

I2C traits from the embedded-hal are used, allowing relatively easy switching between this I2C interface and something like linux-embedded-hal for devices that are supported directly by the kernel.

This library has only been tested on Linux, but it uses rusb to access the USB bus and that supports other platforms, so there's a moderate chance it will work on more than just Linux.

Example

See examples/scan_bus.rs.

Granting access to the device

In order to allow access to the USB device, it's recommended to create a udev rule. e.g. create /etc/udev/rules.d/71-mcp.rules with the following content:

SUBSYSTEM=="usb", ATTRS{idVendor}=="04d8", ATTRS{idProduct}=="00dd", GROUP="plugdev", TAG+="uaccess"

This rule allows access to the device by the user physically logged into the computer (uaccess) and to anyone in the plugdev group.

Contributing

See docs/contributing.md.

Disclaimer

This is not an officially supported Google product.

License

This project is licensed under either of

at your option.

Dependencies

~1.5MB
~34K SLoC