zephyr/dts/bindings/gpio/ti,stellaris-gpio.yaml

# SPDX-License-Identifier: Apache-2.0

description: TI Stellaris GPIO node

compatible: "ti,stellaris-gpio"

include: [gpio-controller.yaml, base.yaml]

properties:
    reg:
      required: true

    label:
      required: true

    interrupts:
      required: true

    "#gpio-cells":
      const: 2

gpio-cells:
  - pin
  - flags
drivers: gpio: Add DTS support for Stellaris gpio driver. * Add DTS support for gpio controller driver Signed-off-by: Ashokkumar B <ashokkumar@zilogic.com> Signed-off-by: Subash G <subash@zilogic.com> Signed-off-by: Vishnu K <vishnu@zilogic.com> Signed-off-by: Vaishnavi D <vaishnavi.d@zilogic.com> 2018-12-03 04:52:25 +08:00			`# SPDX-License-Identifier: Apache-2.0`

dts: bindings: Remove 'title:' and put all info. into 'description:' Add any useful information from 'title:' to the 'description:' strings (e.g. explanations of acronyms), and remove 'title:' as well as any copy-pasted "this binding gives a ..." boilerplate. Also clean some description strings up a bit. Some other things could probably be cleaned up (replacing 'GPIO node' with 'GPIO controller' on controllers for consistency, for example), but I kept things close to the original to avoid accidentally messing up. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no> 2019-11-19 15:39:11 +08:00			`description: TI Stellaris GPIO node`
drivers: gpio: Add DTS support for Stellaris gpio driver. * Add DTS support for gpio controller driver Signed-off-by: Ashokkumar B <ashokkumar@zilogic.com> Signed-off-by: Subash G <subash@zilogic.com> Signed-off-by: Vishnu K <vishnu@zilogic.com> Signed-off-by: Vaishnavi D <vaishnavi.d@zilogic.com> 2018-12-03 04:52:25 +08:00
scripts: dts: Simplify and improve 'compatible' matching Instead of properties: compatible: constraint: "foo" , just have compatible: "foo" at the top level of the binding. For backwards compatibility, the old 'properties: compatible: ...' form is still accepted for now, and is treated the same as a single-element 'compatible:'. The old syntax was inspired by dt-schema (though it isn't dt-schema-compatible), which is in turn a thin wrapper around json-schema (the idea is to transform .dts files into YAML and then verify them). Maybe the idea was to gradually switch the syntax over to dt-schema and then be able to use unmodified dt-schema bindings, but dt-schema is really a different kind of tool (a completely standalone linter), and works very differently from our stuff (see schemas/dt-core.yaml in the dt-schema repo to get an idea of just how differently). Better to keep it simple. This commit also piggybacks some clarifications to the binding template re. '#cells:'. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no> 2019-08-20 02:32:25 +08:00			`compatible: "ti,stellaris-gpio"`

dts/bindings: Convert bindings to new include syntax Convert from: inherits: !include spi-device.yaml to: include: spi-device.yaml Signed-off-by: Kumar Gala <kumar.gala@linaro.org> 2019-08-22 07:10:12 +08:00			`include: [gpio-controller.yaml, base.yaml]`
dts/bindings: Move common properties into a base.yaml Move common properties like 'compatible', 'reg', 'reg-names', 'interrupts', 'interrupt-names', and 'label' into one common base.yaml that all the other yaml's can inherit from. This removes both duplication and inconsistent definition. The device specific yamls just need to say if a property is 'required' or not. NOTE: due to some generation conflicts we did not covert 'soc-nv-flash.yaml' to use base.yaml. Signed-off-by: Kumar Gala <kumar.gala@linaro.org> 2019-06-08 00:12:49 +08:00
drivers: gpio: Add DTS support for Stellaris gpio driver. * Add DTS support for gpio controller driver Signed-off-by: Ashokkumar B <ashokkumar@zilogic.com> Signed-off-by: Subash G <subash@zilogic.com> Signed-off-by: Vishnu K <vishnu@zilogic.com> Signed-off-by: Vaishnavi D <vaishnavi.d@zilogic.com> 2018-12-03 04:52:25 +08:00			`properties:`
			`reg:`
dts: bindings: Have 'required: true/false' instead of 'category: ...' The 'category: required/optional' setting for properties is just a yes/no thing. Using a boolean makes it clearer, so have 'required: true/false' instead. Print a clear error when 'category:' is used: edtlib.EDTError: please put 'required: true' instead of 'category: required' in 'properties: foo: ...' in test-bindings/sub-node-parent.yaml - 'category' has been removed The old scripts in scripts/dts/ ignore this setting, and only print a warning if 'category: required' in an inherited binding is changed to 'category: optional'. Remove that code, since the new scripts already have the same check. The replacement was done with git ls-files 'dts/bindings/.yaml' \| xargs sed -i \ -e 's/category:\srequired/required: true/' \ -e 's/category:\s*optional/required: false/' dts/binding-template.yaml is updated as well. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no> 2019-08-28 06:22:01 +08:00			`required: true`
drivers: gpio: Add DTS support for Stellaris gpio driver. * Add DTS support for gpio controller driver Signed-off-by: Ashokkumar B <ashokkumar@zilogic.com> Signed-off-by: Subash G <subash@zilogic.com> Signed-off-by: Vishnu K <vishnu@zilogic.com> Signed-off-by: Vaishnavi D <vaishnavi.d@zilogic.com> 2018-12-03 04:52:25 +08:00
			`label:`
dts: bindings: Have 'required: true/false' instead of 'category: ...' The 'category: required/optional' setting for properties is just a yes/no thing. Using a boolean makes it clearer, so have 'required: true/false' instead. Print a clear error when 'category:' is used: edtlib.EDTError: please put 'required: true' instead of 'category: required' in 'properties: foo: ...' in test-bindings/sub-node-parent.yaml - 'category' has been removed The old scripts in scripts/dts/ ignore this setting, and only print a warning if 'category: required' in an inherited binding is changed to 'category: optional'. Remove that code, since the new scripts already have the same check. The replacement was done with git ls-files 'dts/bindings/.yaml' \| xargs sed -i \ -e 's/category:\srequired/required: true/' \ -e 's/category:\s*optional/required: false/' dts/binding-template.yaml is updated as well. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no> 2019-08-28 06:22:01 +08:00			`required: true`
drivers: gpio: Add DTS support for Stellaris gpio driver. * Add DTS support for gpio controller driver Signed-off-by: Ashokkumar B <ashokkumar@zilogic.com> Signed-off-by: Subash G <subash@zilogic.com> Signed-off-by: Vishnu K <vishnu@zilogic.com> Signed-off-by: Vaishnavi D <vaishnavi.d@zilogic.com> 2018-12-03 04:52:25 +08:00
			`interrupts:`
dts: bindings: Have 'required: true/false' instead of 'category: ...' The 'category: required/optional' setting for properties is just a yes/no thing. Using a boolean makes it clearer, so have 'required: true/false' instead. Print a clear error when 'category:' is used: edtlib.EDTError: please put 'required: true' instead of 'category: required' in 'properties: foo: ...' in test-bindings/sub-node-parent.yaml - 'category' has been removed The old scripts in scripts/dts/ ignore this setting, and only print a warning if 'category: required' in an inherited binding is changed to 'category: optional'. Remove that code, since the new scripts already have the same check. The replacement was done with git ls-files 'dts/bindings/.yaml' \| xargs sed -i \ -e 's/category:\srequired/required: true/' \ -e 's/category:\s*optional/required: false/' dts/binding-template.yaml is updated as well. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no> 2019-08-28 06:22:01 +08:00			`required: true`
drivers: gpio: Add DTS support for Stellaris gpio driver. * Add DTS support for gpio controller driver Signed-off-by: Ashokkumar B <ashokkumar@zilogic.com> Signed-off-by: Subash G <subash@zilogic.com> Signed-off-by: Vishnu K <vishnu@zilogic.com> Signed-off-by: Vaishnavi D <vaishnavi.d@zilogic.com> 2018-12-03 04:52:25 +08:00
dts/bindings: use const to validate #<FOO>-cells In most cases #<FOO>-cells should be a constant. For example in spi controller #address-cells should be 1, and #size-cells should be 0. Use the const attribute to specify such single known values. Add const value to missing bindings which have cells. Signed-off-by: Kumar Gala <kumar.gala@linaro.org> 2019-08-10 03:54:26 +08:00			`"#gpio-cells":`
			`const: 2`

scripts: dts: Generalize '#cells' to allow multiple sources Implement a nice generalization suggested by Bobby Noelte. Instead of having a generic #cells key in bindings, have source-specific -cells keys. Some examples: interrupt-cells: - irq - priority - flags gpio-cells: - pin - flags pwm-cells: - channel - period This makes bindings a bit easier to read, and allows a node to be a controller for many different 'phandle-array' properties. The prefix before -cells is derived from the property name, meaning there's no fixed set of *-cells keys. This is possible because of the earlier 'phandle-array' generalization. The older #cells key is supported for backwards compatibility, but generates a deprecation warning. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no> 2019-09-27 02:34:13 +08:00			`gpio-cells:`
drivers: gpio: Add DTS support for Stellaris gpio driver. * Add DTS support for gpio controller driver Signed-off-by: Ashokkumar B <ashokkumar@zilogic.com> Signed-off-by: Subash G <subash@zilogic.com> Signed-off-by: Vishnu K <vishnu@zilogic.com> Signed-off-by: Vaishnavi D <vaishnavi.d@zilogic.com> 2018-12-03 04:52:25 +08:00			`- pin`
			`- flags`