Commit 140a9d04 authored by Igor Korotin's avatar Igor Korotin Committed by Danilo Krummrich
Browse files

samples: rust: add ACPI match table example to platform driver 



Extend the Rust sample platform driver to probe using device/driver name
matching, OF ID table matching, or ACPI ID table matching.

Signed-off-by: default avatarIgor Korotin <igor.korotin.linux@gmail.com>
Link: https://lore.kernel.org/r/20250620154552.299932-1-igor.korotin.linux@gmail.com


[ Use 'LNUXBEEF' as ACPI ID. - Danilo ]
Signed-off-by: default avatarDanilo Krummrich <dakr@kernel.org>
parent 8411e6f0

samples/rust/rust_driver_platform.rs

+69 −1
Original line number Diff line number Diff line
@@ -2,8 +2,68 @@ 


//! Rust Platform driver sample.



//! ACPI match table test

//!

//! This demonstrates how to test an ACPI-based Rust platform driver using QEMU

//! with a custom SSDT.

//!

//! Steps:

//!

//! 1. **Create an SSDT source file** (`ssdt.dsl`) with the following content:

//!

//!     ```asl

//!     DefinitionBlock ("", "SSDT", 2, "TEST", "VIRTACPI", 0x00000001)

//!     {

//!         Scope (\_SB)

//!         {

//!             Device (T432)

//!             {

//!                 Name (_HID, "LNUXBEEF")  // ACPI hardware ID to match

//!                 Name (_UID, 1)

//!                 Name (_STA, 0x0F)        // Device present, enabled

//!                 Name (_CRS, ResourceTemplate ()

//!                 {

//!                     Memory32Fixed (ReadWrite, 0xFED00000, 0x1000)

//!                 })

//!             }

//!         }

//!     }

//!     ```

//!

//! 2. **Compile the table**:

//!

//!     ```sh

//!     iasl -tc ssdt.dsl

//!     ```

//!

//!     This generates `ssdt.aml`

//!

//! 3. **Run QEMU** with the compiled AML file:

//!

//!     ```sh

//!     qemu-system-x86_64 -m 512M \

//!         -enable-kvm \

//!         -kernel path/to/bzImage \

//!         -append "root=/dev/sda console=ttyS0" \

//!         -hda rootfs.img \

//!         -serial stdio \

//!         -acpitable file=ssdt.aml

//!     ```

//!

//!     Requirements:

//!     - The `rust_driver_platform` must be present either:

//!         - built directly into the kernel (`bzImage`), or

//!         - available as a `.ko` file and loadable from `rootfs.img`

//!

//! 4. **Verify it worked** by checking `dmesg`:

//!

//!     ```

//!     rust_driver_platform LNUXBEEF:00: Probed with info: '0'.

//!     ```

//!



use kernel::{

    c_str,

    acpi, c_str,

    device::{

        self,

        property::{FwNodeReferenceArgs, NArgs},
@@ -28,9 +88,17 @@ struct SampleDriver { 
    [(of::DeviceId::new(c_str!("test,rust-device")), Info(42))]

);



kernel::acpi_device_table!(

    ACPI_TABLE,

    MODULE_ACPI_TABLE,

    <SampleDriver as platform::Driver>::IdInfo,

    [(acpi::DeviceId::new(c_str!("LNUXBEEF")), Info(0))]

);



impl platform::Driver for SampleDriver {

    type IdInfo = Info;

    const OF_ID_TABLE: Option<of::IdTable<Self::IdInfo>> = Some(&OF_TABLE);

    const ACPI_ID_TABLE: Option<acpi::IdTable<Self::IdInfo>> = Some(&ACPI_TABLE);



    fn probe(

        pdev: &platform::Device<Core>,