24 releases (13 stable)
|5.0.0||Sep 13, 2023|
|4.1.1||Aug 1, 2022|
|4.1.0||Nov 4, 2021|
|3.1.0||Jul 21, 2021|
|0.1.0||May 3, 2018|
#60 in Hardware support
5,393 downloads per month
Used in 3 crates
A library to parse ACPI tables and AML, written in pure Rust. Designed to be easy to use from Rust bootloaders and kernels. The library is split into three crates:
rsdpparses the RSDP and can locate it on BIOS platforms. It does not depend on
alloc, so is suitable to use from bootloaders without heap alloctors. All of its functionality is reexported by
acpiparses the static tables (useful but not feature-complete). It can be used from environments that have allocators, and ones that don't (but with reduced functionality).
amlparses the AML tables (can be useful, far from feature-complete).
There is also the
acpi-dumper utility to easily dump a platform's ACPI tables (this currently only works on Linux).
Contributions are more than welcome! You can:
- Write code - the ACPI spec is huge and there are bound to be things we don't support yet!
- Improve our documentation!
- Use the crates within your kernel and file bug reports and feature requests!
Useful resources for contributing are:
You can run the AML test suite with
cargo run --bin aml_tester -- -p tests.
You can run fuzz the AML parser with
cd aml && cargo fuzz run fuzz_target_1 (you may need to
cargo install cargo-fuzz).
This project is dual-licenced under:
- Apache Licence, Version 2.0 (LICENCE-APACHE or http://www.apache.org/licenses/LICENSE-2.0)
- MIT license (LICENCE-MIT or http://opensource.org/licenses/MIT)
Unless you explicitly state otherwise, any contribution submitted for inclusion in this work by you, as defined in the Apache-2.0 licence, shall be dual licenced as above, without additional terms or conditions.