Linux kernel mirror (for testing) git.kernel.org/pub/scm/linux/kernel/git/torvalds/linux.git
kernel os linux

dt-bindings: misc: ge-achc: Convert to DT schema format

Convert the binding to DT schema format. Also update the binding
to fix shortcomings

* Add "nxp,kinetis-k20" fallback compatible
* add programming SPI interface and reset GPIO
* add main clock
* add voltage supplies
* drop spi-max-frequency from required properties,
driver will setup max. frequency

Reviewed-by: Rob Herring <robh@kernel.org>
Signed-off-by: Sebastian Reichel <sebastian.reichel@collabora.com>
Link: https://lore.kernel.org/r/20210802172309.164365-2-sebastian.reichel@collabora.com
Signed-off-by: Greg Kroah-Hartman <gregkh@linuxfoundation.org>

authored by

Sebastian Reichel and committed by
Greg Kroah-Hartman
f9d8f4b3 61106bd2

+65 -26
-26
Documentation/devicetree/bindings/misc/ge-achc.txt
··· 1 - * GE Healthcare USB Management Controller 2 - 3 - A device which handles data aquisition from compatible USB based peripherals. 4 - SPI is used for device management. 5 - 6 - Note: This device does not expose the peripherals as USB devices. 7 - 8 - Required properties: 9 - 10 - - compatible : Should be "ge,achc" 11 - 12 - Required SPI properties: 13 - 14 - - reg : Should be address of the device chip select within 15 - the controller. 16 - 17 - - spi-max-frequency : Maximum SPI clocking speed of device in Hz, should be 18 - 1MHz for the GE ACHC. 19 - 20 - Example: 21 - 22 - spidev0: spi@0 { 23 - compatible = "ge,achc"; 24 - reg = <0>; 25 - spi-max-frequency = <1000000>; 26 - };
+65
Documentation/devicetree/bindings/misc/ge-achc.yaml
··· 1 + # SPDX-License-Identifier: GPL-2.0 OR BSD-2-Clause 2 + # Copyright (C) 2021 GE Inc. 3 + # Copyright (C) 2021 Collabora Ltd. 4 + %YAML 1.2 5 + --- 6 + $id: http://devicetree.org/schemas/misc/ge-achc.yaml# 7 + $schema: http://devicetree.org/meta-schemas/core.yaml# 8 + 9 + title: GE Healthcare USB Management Controller 10 + 11 + description: | 12 + A device which handles data acquisition from compatible USB based peripherals. 13 + SPI is used for device management. 14 + 15 + Note: This device does not expose the peripherals as USB devices. 16 + 17 + maintainers: 18 + - Sebastian Reichel <sre@kernel.org> 19 + 20 + properties: 21 + compatible: 22 + items: 23 + - const: ge,achc 24 + - const: nxp,kinetis-k20 25 + 26 + clocks: 27 + maxItems: 1 28 + 29 + vdd-supply: 30 + description: Digital power supply regulator on VDD pin 31 + 32 + vdda-supply: 33 + description: Analog power supply regulator on VDDA pin 34 + 35 + reg: 36 + items: 37 + - description: Control interface 38 + - description: Firmware programming interface 39 + 40 + reset-gpios: 41 + description: GPIO used for hardware reset. 42 + maxItems: 1 43 + 44 + required: 45 + - compatible 46 + - clocks 47 + - reg 48 + - reset-gpios 49 + 50 + additionalProperties: false 51 + 52 + examples: 53 + - | 54 + #include <dt-bindings/gpio/gpio.h> 55 + spi { 56 + #address-cells = <1>; 57 + #size-cells = <0>; 58 + 59 + spi@1 { 60 + compatible = "ge,achc", "nxp,kinetis-k20"; 61 + reg = <1>, <0>; 62 + clocks = <&achc_24M>; 63 + reset-gpios = <&gpio3 6 GPIO_ACTIVE_LOW>; 64 + }; 65 + };