<!--
SPDX-FileCopyrightText: 2026 KUNBUS GmbH <support@kunbus.com>

SPDX-License-Identifier: GPL-2.0-or-later
-->

# D-Bus

## Datentypen

Hier ist eine **Liste der standardisierten D‑Bus-Datentypen** (Signaturen), wie
sie u. a. in Introspection/XML (`type="..."`) verwendet werden.

## Basis-Typen (Basic Types)

| Signatur | Bedeutung                           |
|----------|-------------------------------------|
| `y`      | Byte (unsigned 8-bit)               |
| `b`      | Boolean                             |
| `n`      | Int16 (signed)                      |
| `q`      | UInt16 (unsigned)                   |
| `i`      | Int32 (signed)                      |
| `u`      | UInt32 (unsigned)                   |
| `x`      | Int64 (signed)                      |
| `t`      | UInt64 (unsigned)                   |
| `d`      | Double (IEEE 754)                   |
| `s`      | String (UTF‑8)                      |
| `o`      | Object Path                         |
| `g`      | Signature (Typ-Signatur als String) |

## Container-Typen (Compound/Container)

| Form       | Bedeutung                                       | Beispiel                        |
|------------|-------------------------------------------------|---------------------------------|
| `aX`       | Array von `X`                                   | `as` = Array von Strings        |
| `(XYZ...)` | Struct/Tupel                                    | `(is)` = (Int32, String)        |
| `{KV}`     | Dict-Entry (nur innerhalb eines Arrays erlaubt) | `a{sv}` = Dict String → Variant |

## Spezial-Typ

| Signatur | Bedeutung                                         |
|----------|---------------------------------------------------|
| `v`      | Variant (beliebiger Typ, zur Laufzeit festgelegt) |

## Häufig genutzte Kombis (Praxis)

- `as` → Liste von Strings
- `ao` → Liste von Object Paths
- `a{sv}` → „Properties“-Map (String → Variant), sehr verbreitet bei
  `org.freedesktop.DBus.Properties`
- `a{ss}` → String → String Map