https://github.com/rust-osdev/acpi

Rust library for parsing ACPI tables and interpreting AML
https://github.com/rust-osdev/acpi

acpi aml osdev rust

Last synced: about 11 hours ago
JSON representation

Rust library for parsing ACPI tables and interpreting AML

• Host: GitHub
• URL: https://github.com/rust-osdev/acpi
• Owner: rust-osdev
• License: apache-2.0
• Created: 2018-05-03T15:52:19.000Z (over 6 years ago)
• Default Branch: main
• Last Pushed: 2024-11-25T11:18:14.000Z (about 1 month ago)
• Last Synced: 2024-12-21T05:14:29.754Z (7 days ago)
• Topics: acpi, aml, osdev, rust
• Language: Rust
• Homepage:
• Size: 840 KB
• Stars: 204
• Watchers: 11
• Forks: 66
• Open Issues: 42
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • Funding: .github/FUNDING.yml

Awesome Lists containing this project

README

        
# Acpi

![Build Status](https://github.com/rust-osdev/acpi/actions/workflows/build.yml/badge.svg)

[![Version](https://img.shields.io/crates/v/rsdp.svg?style=rounded-square)](https://crates.io/crates/rsdp/)

[![Version](https://img.shields.io/crates/v/acpi.svg?style=rounded-square)](https://crates.io/crates/acpi/)

[![Version](https://img.shields.io/crates/v/aml.svg?style=rounded-square)](https://crates.io/crates/aml/)

### [Documentation (`rsdp`)](https://docs.rs/rsdp)

### [Documentation (`acpi`)](https://docs.rs/acpi)

### [Documentation (`aml`)](https://docs.rs/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). It can be used from environments that have allocators, and ones that don't (but with reduced functionality).

- `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:

- [The ACPI specification](https://uefi.org/specifications)

- [OSDev Wiki](https://wiki.osdev.org/ACPI)

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

This project is dual-licenced under:

- Apache Licence, Version 2.0 ([LICENCE-APACHE](LICENCE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)

- MIT license ([LICENCE-MIT](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.