sdk/fidl/fuchsia.hardware.platform.device/platform-device.fidl

// Copyright 2022 The Fuchsia Authors. All rights reserved.
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.
library fuchsia.hardware.platform.device;

using fuchsia.hardware.power;
using zx;

type DeviceInfo = table {
    /// Vendor ID, specified in //zircon/system/ulib/ddk-platform-defs/include/lib/ddk/platform-defs.h
    1: vid uint32;
    /// Platform ID, specified in //zircon/system/ulib/ddk-platform-defs/include/lib/ddk/platform-defs.h
    2: pid uint32;
    /// Device ID, specified in //zircon/system/ulib/ddk-platform-defs/include/lib/ddk/platform-defs.h
    3: did uint32;
    /// The number of MMIO regions provided to this device.
    4: mmio_count uint32;
    /// The number of interrupts provided to this device.
    5: irq_count uint32;
    /// The number of bus transaction initiaitors provided to this device.
    6: bti_count uint32;
    /// The number of secure monitor call resources provided to this device.
    7: smc_count uint32;
    /// The number of metadata blobs associated provided this device.
    8: metadata_count uint32;
    /// The name the board driver provided for this device.
    9: name string:32;
};

type BoardInfo = table {
    /// Vendor ID for the board.
    1: vid uint32;
    /// Product ID for the board.
    2: pid uint32;
    /// Board name from the boot image platform ID record,
    /// (or from the BIOS on x86 platforms).
    3: board_name string:32;
    /// Board specific revision number.
    4: board_revision uint32;
};

type Mmio = resource table {
    /// Offset from beginning of VMO where the mmio region begins.
    1: offset zx.Off;
    /// Size of mmio region.
    2: size uint64;
    /// The virtual memory object which should be mapped into the driver's address space.
    3: vmo zx.Handle:VMO;
};

@discoverable
open protocol Device {
    /// Returns a memory mapped IO (MMIO) resource for the given |index|.
    flexible GetMmio(struct {
        index uint32;
    }) -> (Mmio) error zx.Status;

    /// Returns an interrupt handle for the given |index|.
    /// |flags| is forwarded as the |options| parameter to `zx_interrupt_create`.
    flexible GetInterrupt(struct {
        index uint32;
        flags uint32;
    }) -> (resource struct {
        irq zx.Handle:INTERRUPT;
    }) error zx.Status;

    /// Returns an bus transaction initiator (bti) handle for the given |index|.
    flexible GetBti(struct {
        index uint32;
    }) -> (resource struct {
        bti zx.Handle:BTI;
    }) error zx.Status;

    /// Returns an secure monitor call (smc) handle for the given |index|.
    flexible GetSmc(struct {
        index uint32;
    }) -> (resource struct {
        smc zx.Handle:RESOURCE;
    }) error zx.Status;

    /// Returns power configuration for the device the driver has bound to.
    flexible GetPowerConfiguration() -> (struct {
        config vector<fuchsia.hardware.power.PowerElementConfiguration>:32;
    }) error zx.Status;

    /// Returns information about the device the driver has bound to.
    flexible GetDeviceInfo() -> (DeviceInfo) error zx.Status;

    /// Return information about the board the device is attached to.
    flexible GetBoardInfo() -> (BoardInfo) error zx.Status;
};

service Service {
    device client_end:Device;
};