MATRIX RHAL is the Rust implementation of MATRIX HAL. The goal is to center around calling the MATRIX Kernel Modules and eventually implement all of HAL's features in this layer.
Breaking changes are going to be really common until
v0.1.0
Add this to your Cargo.toml
:
[dependencies]
matrix_rhal = "0.0.6"
Below are the current/planned features in RHAL. While this library is being put together, updates will be pushed to crates.io as v0.0.*
for users to try.
- Device information
- Sensor Reading
- UV
- Pressure
- Humidity
- IMU
- Everloop
- GPIO
- Digital Input/Output
- PWM
- Microphone
- Documentation
Run the following commands individually on your Raspberry Pi.
# Add matrix repository & key
curl https://apt.matrix.one/doc/apt-key.gpg | sudo apt-key add -
echo "deb https://apt.matrix.one/raspbian $(lsb_release -sc) main" | sudo tee /etc/apt/sources.list.d/matrixlabs.list
# Update packages
sudo apt-get update
sudo apt-get upgrade
# Install MATRIX Init Package
sudo apt-get install matrixio-creator-init
# Restart system
sudo reboot
# Install MATRIX kernel Modules
sudo apt install matrixio-kernel-modules
# Restart a second time
sudo reboot
Building directly on your Raspberry Pi will lead to slower compilation times, due to the lack processing power.
Install git.
sudo apt install git
Clone the repository.
git clone https://github.com/Hermitter/matrix-rhal
Install Rust on the pi.
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
Add MATRIX RHAL as a dependency to your Rust project.
To reduce compilation times, it's recommended to build RHAL on your computer and deploy it to the Pi. This ends up saving time and sanity during development. Below are some guides to help set up this workflow: