1# SPDX-License-Identifier: GPL-2.0
2%YAML 1.2
3---
4$id: http://devicetree.org/schemas/firmware/qemu,fw-cfg-mmio.yaml#
5$schema: http://devicetree.org/meta-schemas/core.yaml#
6
7title: QEMU Firmware Configuration bindings
8
9maintainers:
10  - Rob Herring <robh@kernel.org>
11
12description: |
13  Various QEMU emulation / virtualization targets provide the following
14  Firmware Configuration interface on the "virt" machine type:
15
16  - A write-only, 16-bit wide selector (or control) register,
17  - a read-write, 64-bit wide data register.
18
19  QEMU exposes the control and data register to guests as memory mapped
20  registers; their location is communicated to the guest's UEFI firmware in the
21  DTB that QEMU places at the bottom of the guest's DRAM.
22
23  The authoritative guest-side hardware interface documentation to the fw_cfg
24  device can be found in "docs/specs/fw_cfg.txt" in the QEMU source tree.
25
26
27properties:
28  compatible:
29    const: qemu,fw-cfg-mmio
30
31  reg:
32    maxItems: 1
33    description: |
34      * Bytes 0x0 to 0x7 cover the data register.
35      * Bytes 0x8 to 0x9 cover the selector register.
36      * Further registers may be appended to the region in case of future interface
37        revisions / feature bits.
38
39  dma-coherent: true
40
41required:
42  - compatible
43  - reg
44
45additionalProperties: false
46
47examples:
48  - |
49
50    fw-cfg@9020000 {
51        compatible = "qemu,fw-cfg-mmio";
52        reg = <0x9020000 0xa>;
53    };
54...
55