1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
// This file is part of fpgad, an application to manage FPGA subsystem together with device-tree and kernel modules.
//
// Copyright 2025 Canonical Ltd.
//
// SPDX-License-Identifier: GPL-3.0-only
//
// fpgad is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License version 3, as published by the Free Software Foundation.
//
// fpgad is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranties of MERCHANTABILITY, SATISFACTORY QUALITY, or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
//! DBus proxy interfaces for the fpgad daemon.
//!
//! This module provides auto-generated DBus proxy traits that allow the CLI to communicate
//! with the fpgad daemon over the system DBus. The proxies are generated using the `zbus`
//! crate's `#[proxy]` macro and provide type-safe, asynchronous access to the daemon's
//! DBus interfaces.
//!
//! # Modules
//!
//! - [`control_proxy`] - Write operations (load bitstreams, apply overlays, set properties)
//! - [`status_proxy`] - Read-only operations (query device state, platform info, overlays)
//!
//! # DBus Service Information
//!
//! - **Service Name**: `com.canonical.fpgad`
//! - **Control Interface**: `com.canonical.fpgad.control` at `/com/canonical/fpgad/control`
//! - **Status Interface**: `com.canonical.fpgad.status` at `/com/canonical/fpgad/status`
//!
//! # Usage
//!
//! These proxies are used internally by the CLI's command handlers ([`load`], [`remove`],
//! [`set`], [`status`]) to communicate with the fpgad daemon. Callers are responsible for
//! creating and managing the `zbus::Connection` and passing it to the proxy constructors;
//! the proxies then handle method call marshalling and unmarshalling automatically.
//!
//! For more information on the DBus interfaces, see the
//! [fpgad daemon crate](https://docs.rs/crate/fpgad/latest/daemon/comm/dbus/control_interface/index.html)
//!
//! [`load`]: ../load/index.html
//! [`remove`]: ../remove/index.html
//! [`set`]: ../set/index.html
//! [`status`]: ../status/index.html