Rust library for parsing ACPI tables and interpreting AML

Ethin Probst 8661e9fe89 Add fixed flags and boot architecture flags. vor 3 Jahren
.github 7266cd15e4 Add sponser button for me vor 4 Jahren
acpi 8661e9fe89 Add fixed flags and boot architecture flags. vor 3 Jahren
acpi-dumper 90d6bd062a Add acpi-dumper vor 5 Jahren
aml e42a898494 add test vor 3 Jahren
aml_tester 1fcb226a7b Fix some warnings vor 3 Jahren
rsdp bdba41fa9c rsdp v2.0.0 vor 3 Jahren
tests 0d3947980d Use PCI CRS from QEMU ASL & clean up vor 4 Jahren
.gitignore 3dcc84653d Add EOF newline in gitignore vor 4 Jahren
Cargo.toml 85152b3771 Publish rsdp v1.0.0 vor 4 Jahren
LICENCE-APACHE 3d72f67501 Init Cargo and add licenses and readme vor 7 Jahren
LICENCE-MIT 3d72f67501 Init Cargo and add licenses and readme vor 7 Jahren
README.md 81e52a6689 Add version shields for rsdp and aml crates to README vor 3 Jahren
rustfmt.toml 36159b1017 Rustfmt is bad at wrapping comments vor 4 Jahren

README.md

Acpi

Build Status Version Version Version

Documentation (rsdp)

Documentation (acpi)

Documentation (aml)

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:

  • rsdp parses 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 acpi.
  • acpi parses the static tables (useful but not feature-complete)
  • aml parses 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).

Contributing

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).

Licence

Acpi is dual-licenced under:

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.