|
| 1 | +# Acpi |
| 2 | +⚠️**WARNING: The `rsdp` crate was previously a component of the `acpi` ecosystem, but has been deprecated. Its |
| 3 | +functionality is now entirely supported by the `acpi` crate, including a subset of functionality that will work in |
| 4 | +an environment that does not have an allocator. This crate will likely not receive further updates**⚠️ |
| 5 | + |
| 6 | + |
| 7 | +[](https://crates.io/crates/rsdp/) |
| 8 | +[](https://crates.io/crates/acpi/) |
| 9 | +[](https://crates.io/crates/aml/) |
| 10 | + |
| 11 | +### [Documentation (`rsdp`)](https://docs.rs/rsdp) |
| 12 | +### [Documentation (`acpi`)](https://docs.rs/acpi) |
| 13 | +### [Documentation (`aml`)](https://docs.rs/aml) |
| 14 | + |
| 15 | +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: |
| 16 | +- `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 |
| 17 | + functionality is reexported by `acpi`. |
| 18 | +- `acpi` parses 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). |
| 19 | +- `aml` parses the AML tables (can be useful, far from feature-complete). |
| 20 | + |
| 21 | +There is also the `acpi-dumper` utility to easily dump a platform's ACPI tables (this currently only works on Linux). |
| 22 | + |
| 23 | +## Contributing |
| 24 | +Contributions are more than welcome! You can: |
| 25 | +- Write code - the ACPI spec is huge and there are bound to be things we don't support yet! |
| 26 | +- Improve our documentation! |
| 27 | +- Use the crates within your kernel and file bug reports and feature requests! |
| 28 | + |
| 29 | +Useful resources for contributing are: |
| 30 | +- [The ACPI specification](https://uefi.org/specifications) |
| 31 | +- [OSDev Wiki](https://wiki.osdev.org/ACPI) |
| 32 | + |
| 33 | +You can run the AML test suite with `cargo run --bin aml_tester -- -p tests`. |
| 34 | +You can run fuzz the AML parser with `cd aml && cargo fuzz run fuzz_target_1` (you may need to `cargo install cargo-fuzz`). |
| 35 | + |
| 36 | +## Licence |
| 37 | +This project is dual-licenced under: |
| 38 | +- Apache Licence, Version 2.0 ([LICENCE-APACHE](LICENCE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0) |
| 39 | +- MIT license ([LICENCE-MIT](LICENCE-MIT) or http://opensource.org/licenses/MIT) |
| 40 | + |
| 41 | +Unless you explicitly state otherwise, any contribution submitted for inclusion in this work by you, |
| 42 | +as defined in the Apache-2.0 licence, shall be dual licenced as above, without additional terms or |
| 43 | +conditions. |
0 commit comments