mlua-periphery
| Crates.io | mlua-periphery |
| lib.rs | mlua-periphery |
| version | |
| source | src |
| created_at | 2023-10-07 12:18:57.253746+00 |
| updated_at | 2025-03-28 15:34:13.569501+00 |
| description | A Rust-native implementation of lua-periphery for mlua. |
| homepage | https://on-prem.net |
| repository | https://gitlab.com/megalithic-llc/mlua-periphery.git |
| max_upload_size | |
| id | 996269 |
| Cargo.toml error: | TOML parse error at line 18, column 1 | 18 | autolib = false | ^^^^^^^ unknown field `autolib`, expected one of `name`, `version`, `edition`, `authors`, `description`, `readme`, `license`, `repository`, `homepage`, `documentation`, `build`, `resolver`, `links`, `default-run`, `default_dash_run`, `rust-version`, `rust_dash_version`, `rust_version`, `license-file`, `license_dash_file`, `license_file`, `licenseFile`, `license_capital_file`, `forced-target`, `forced_dash_target`, `autobins`, `autotests`, `autoexamples`, `autobenches`, `publish`, `metadata`, `keywords`, `categories`, `exclude`, `include` |
| size | 0 |
David Rauschenbach (drauschenbach)
documentation
README
mlua-periphery
A Rust-native implementation of lua-periphery for mlua.
From lua-periphery:
lua-periphery is a library for GPIO, LED, PWM, SPI, I2C, MMIO, and Serial peripheral I/O interface access in userspace Linux. It is useful in embedded Linux environments (including Raspberry Pi, BeagleBone, etc. platforms) for interfacing with external peripherals.
Using Python or C? Check out the python-periphery and c-periphery projects.
Installing
Add to your Rust project using one of MLua's features: [lua51, lua52, lua53, lua54, luajit, luajit52].
$ cargo add mlua-periphery --features luajit
Using
use mlua::Lua;
let lua = Lua::new();
mlua_periphery::preload(&lua);
let script = r#"
local LED = require('periphery.LED')
local led = LED('led0')
return led:read(), led.brightness, led.max_brightness
"#;
let (value, brightness, max_brightness): (bool, u32, u32) = lua.load(script).eval()?;
Testing
An integration_tests.rs file exists in each submodule and demonstrates:
- Read metrics from the BMC on a BitScope Cluster Blade via serial
- Reading the battery voltage of a Sixfab UPS HAT via I²C
- Controlling the fan speed of an Argon Fan HAT via I²C
- Interacting with GPIO and LED pins
Running the i2cdetect example
$ cargo run -v --example i2cdetect --features lua54
0 1 2 3 4 5 6 7 8 9 a b c d e f
00: -- -- -- -- -- -- -- -- -- -- -- -- --
10: -- -- -- -- -- -- -- -- -- -- 1a -- -- -- -- --
20: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
30: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
40: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
50: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
60: -- -- -- -- -- -- -- -- -- -- -- -- -- -- -- --
70: -- -- -- -- -- -- -- --