1 unstable release
0.1.0 | Jul 11, 2024 |
---|
#314 in Embedded development
145KB
4K
SLoC
iowarrior-embedded-hal
A Rust library that provides access to the IOWarrior GPIO, I2C, PWM, SPI, and ADC peripherals.
Both embedded-hal v0.2.7 and v1 are supported.
Backends
There are three different backends available to interact with the IOWarrior boards. The backends can be selected as a crate feature:
-
iowkit: This is the default backend, written in C, provided by Code Mercenaries. The iowkit library is dynamically loaded at runtime. You have to 'install' the official IOWarrior-SDK. This backend is supported by Windows and Linux.
-
usbhid: This is an experimental backend and is only available on Windows. It is a pure Rust implementation and interacts directly with the WIN32 HID API.
-
ioctrl: This is also an experimental backend and is only available on Linux. It is a pure Rust implementation and interacts directly with the ioctrl kernel interface.
The backends can be selected as a Rust feature. By default, iowkit is selected.
License
Licensed under MIT license.Linux Prerequisites
Example for Ubuntu 24.04, other distros may differ:
# Auto load iowarrior kernel module at boot
echo 'iowarrior' | sudo tee /etc/modules-load.d/iowarrior.conf
# Allow dialout user group to access IOWarrior devices
echo 'KERNEL=="iowarrior*", NAME="usb/iowarrior%n", OWNER="root", GROUP="dialout", MODE="0666"' | sudo tee /etc/udev/rules.d/99-iowarrior.rules
# Repeat for every user: Add user X to dialout group
sudo usermod -a -G dialout X
# Reboot to let changes take place
sudo reboot
Dependencies
~0.7–42MB
~606K SLoC