f315a9be3b
Phase 5 — Laptop ACPI events (LG Gram 16Z90TP compatibility plan):
- Vendor acpi-rs crate (rev 90cbe88) into base fork with a real
Opcode::Notify executor; upstream panicked on every Notify opcode,
which is the backbone of ACPI event flow on real laptop firmware.
Handler::handle_notify hook added; acpid + amlserde pointed at the
path dep so every consumer sees the same fork.
- gpe.rs: FADT-driven GPE block register map (status half + enable
half), write-1-to-clear status bits, read-modify-write enable
preserving every other GPE's firmware state. PM1 fixed-event bits
(PWRBTN/SLPBTN/RTC) per ACPI 6.4 §4.8.3.1.
- power_events.rs: init builds the GPE map, discovers the EC via ECDT
(ACPI 6.4 §5.2.16) with a _HID=PNP0C09 probe fallback over conven-
tional paths, enables the EC GPE + PM1 fixed events, discovers lid
and ACPI 4.0 fan devices. handle_sci dispatches PM1 → EC query loop
(bounded at 32) → AML notification drain, following Linux 7.1
evgpe.c / ec.c / button.c.
- notifications.rs: shared AmlNotifications queue (parking_lot::Mutex)
populated by the vendored acpi-rs handle_notify hook, drained by the
SCI handler and redbear-upower.
- ec.rs: sci_evt_set() and query() exposed on Ec for the SCI handler.
- scheme.rs: new handle kinds Lid, LidState, ButtonDir, Button,
Notifications, Fan, FanState, FanSpeed with proper dir/file
separation. Fan _FST on read, _FSL on write (percent clamped 0-100).
- main.rs: subscribes /scheme/irq/{sci_irq} (default 9) on the event
queue, dispatches SCI events through handle_sci. PowerButton incre-
ments edge counter and triggers the shutdown path; SleepButton incre-
ments counter and calls enter_s2idle.
- acpi.rs: AcpiContext gained gpe, ec_device, lid_device, lid_state,
power_button_events, sleep_button_events, fan_devices fields (all
RwLock-guarded). evaluate_acpi_method and enter_s2idle changed from
&mut self to &self (AML mutation goes through RwLock inner state).
- aml_physmem.rs: handle_notify impl pushes onto the shared queue.
Phase 4.4 — HID report descriptor parser (i2c-hidd):
- report_desc.rs: HID 1.11 §6.2.2 descriptor parser + decoder. Global-
state stack (Push/Pop), usage-min/max expansion, sign-extended
fields, contact reconstruction (id, tip, x, y). 3 unit tests.
- input.rs: forward_layout_report dispatches descriptor-driven reports
through forward_decoded: first touching contact → absolute
MouseEvent; two simultaneous contacts → vertical ScrollEvent (two-
finger scroll); buttons → ButtonEvent; keyboard-page reports fall
back to the existing boot-protocol path.
- hid.rs: stream_input_reports parses the descriptor once and uses
forward_layout_report when layouts are non-empty, otherwise keeps the
boot-protocol summary path.
Reference: Linux 7.1 drivers/acpi/{evgpeblk.c,evgpe.c,ec.c,button.c}
and drivers/hid/hid-core.c.
All affected crates compile for x86_64-unknown-redox; i2c-hidd 3/3
unit tests pass on host; acpid host-side tests still can't link
(pre-existing libredox limitation — must run via redoxer).
33 lines
1.9 KiB
Markdown
33 lines
1.9 KiB
Markdown
# Acpi
|
|

|
|
[](https://crates.io/crates/acpi/)
|
|
|
|
### [Documentation](https://docs.rs/acpi)
|
|
|
|
`acpi` is a Rust library for interacting with the Advanced Configuration and Power Interface, a
|
|
complex framework for power management and device discovery and configuration. ACPI is used on
|
|
modern x64, as well as some ARM and RISC-V platforms. An operating system needs to interact with
|
|
ACPI to correctly set up a platform's interrupt controllers, perform power management, and fully
|
|
support many other platform capabilities.
|
|
|
|
This crate provides a limited API that can be used without an allocator, for example for use
|
|
from a bootloader. This API will allow you to search for the RSDP, enumerate over the available
|
|
tables, and interact with the tables using their raw structures. All other functionality is
|
|
behind an `alloc` feature (enabled by default) and requires an allocator.
|
|
|
|
With an allocator, this crate provides a richer higher-level interfaces to the static tables, as
|
|
well as a dynamic interpreter for AML - the bytecode format encoded in the DSDT and SSDT tables.
|
|
|
|
See the library documentation for example usage. You will almost certainly need to read portions
|
|
of the [ACPI Specification](https://uefi.org/specifications) too (however, be aware that firmware often
|
|
ships with ACPI tables that are not spec-compliant).
|
|
|
|
## 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.
|