The Devicetree bindings document does not have to say in the title that it is a "binding", but instead just describe the hardware. Drop trailing "bindings" in various forms (also with trailing full stop): find Documentation/devicetree/bindings/ -type f -name '*.yaml' \ -not -name 'trivial-devices.yaml' \ -exec sed -i -e 's/^title: \(.*\) [bB]indings\?\.\?$/title: \1/' {} \; Signed-off-by: Krzysztof Kozlowski <krzysztof.kozlowski@linaro.org> Acked-by: Alexandre Belloni <alexandre.belloni@bootlin.com> Acked-by: Matti Vaittinen <mazziesaccount@gmail.com> # ROHM Acked-by: Ulf Hansson <ulf.hansson@linaro.org> # MMC Acked-by: Stephen Boyd <sboyd@kernel.org> # clk Acked-by: Dmitry Torokhov <dmitry.torokhov@gmail.com> # input Acked-by: Mark Brown <broonie@kernel.org> Acked-by: Hans Verkuil <hverkuil-cisco@xs4all.nl> # media Acked-by: Sebastian Reichel <sre@kernel.org> # power Acked-by: Viresh Kumar <viresh.kumar@linaro.org> # cpufreq Link: https://lore.kernel.org/r/20221216163815.522628-7-krzysztof.kozlowski@linaro.org Signed-off-by: Rob Herring <robh@kernel.org>
55 lines
1.4 KiB
YAML
55 lines
1.4 KiB
YAML
# SPDX-License-Identifier: GPL-2.0
|
|
%YAML 1.2
|
|
---
|
|
$id: http://devicetree.org/schemas/firmware/qemu,fw-cfg-mmio.yaml#
|
|
$schema: http://devicetree.org/meta-schemas/core.yaml#
|
|
|
|
title: QEMU Firmware Configuration
|
|
|
|
maintainers:
|
|
- Rob Herring <robh@kernel.org>
|
|
|
|
description: |
|
|
Various QEMU emulation / virtualization targets provide the following
|
|
Firmware Configuration interface on the "virt" machine type:
|
|
|
|
- A write-only, 16-bit wide selector (or control) register,
|
|
- a read-write, 64-bit wide data register.
|
|
|
|
QEMU exposes the control and data register to guests as memory mapped
|
|
registers; their location is communicated to the guest's UEFI firmware in the
|
|
DTB that QEMU places at the bottom of the guest's DRAM.
|
|
|
|
The authoritative guest-side hardware interface documentation to the fw_cfg
|
|
device can be found in "docs/specs/fw_cfg.txt" in the QEMU source tree.
|
|
|
|
|
|
properties:
|
|
compatible:
|
|
const: qemu,fw-cfg-mmio
|
|
|
|
reg:
|
|
maxItems: 1
|
|
description: |
|
|
* Bytes 0x0 to 0x7 cover the data register.
|
|
* Bytes 0x8 to 0x9 cover the selector register.
|
|
* Further registers may be appended to the region in case of future interface
|
|
revisions / feature bits.
|
|
|
|
dma-coherent: true
|
|
|
|
required:
|
|
- compatible
|
|
- reg
|
|
|
|
additionalProperties: false
|
|
|
|
examples:
|
|
- |
|
|
|
|
fw-cfg@9020000 {
|
|
compatible = "qemu,fw-cfg-mmio";
|
|
reg = <0x9020000 0xa>;
|
|
};
|
|
...
|