michaelh/zephyr
1
0
Fork 0
Code Releases Activity
zephyr/dts/bindings/gpio/atmel,sam-gpio.yaml

39 lines
566 B
YAML
Raw Permalink Normal View History

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 08:39:11 +01:00
description: SAM GPIO PORT node
drivers: GPIO Added GPIO for SAM family. Added GPIO driver for SAM family of SoCs. Signed-off-by: Justin Watson <jwatson5@gmail.com>
2018-03-02 16:14:16 -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-19 20:32:25 +02:00
compatible: "atmel,sam-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-21 18:10:12 -05: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-07 11:12:49 -05:00
drivers: GPIO Added GPIO for SAM family. Added GPIO driver for SAM family of SoCs. Signed-off-by: Justin Watson <jwatson5@gmail.com>
2018-03-02 16:14:16 -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:\s*required/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 00:22:01 +02:00
required: true
drivers: GPIO Added GPIO for SAM family. Added GPIO driver for SAM family of SoCs. Signed-off-by: Justin Watson <jwatson5@gmail.com>
2018-03-02 16:14:16 -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:\s*required/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 00:22:01 +02:00
required: true
drivers: GPIO Added GPIO for SAM family. Added GPIO driver for SAM family of SoCs. Signed-off-by: Justin Watson <jwatson5@gmail.com>
2018-03-02 16:14:16 -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:\s*required/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 00:22:01 +02:00
required: true
drivers: GPIO Added GPIO for SAM family. Added GPIO driver for SAM family of SoCs. Signed-off-by: Justin Watson <jwatson5@gmail.com>
2018-03-02 16:14:16 -08:00
peripheral-id:
type: int
description: peripheral ID
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:\s*required/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 00:22:01 +02:00
required: true
dts: atmel: Add missing GPIO properties The gpio controllers on SAM4S, SAME70, and SAMD were missing properties related to GPIO pin generation. Add the missing details into the yaml and dts files to allow boards to specific gpio pins. Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2018-09-28 14:56:13 -05: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-09 14:54:26 -05:00
"#gpio-cells":
const: 2
dts: atmel sam: gpio: Add support for atmel,pins property The atmel,pins property will be utilized to describe pin mux configuration. The property will be a phandle-array in which the phandle points to the given GPIO port the pin is on, the pin number, and the mux configuration. This change updates the atmel,sam-gpio binding to support that phandle-array and updates the associated SoC dtsi files as well. Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2020-04-07 14:38:04 -05:00
"#atmel,pin-cells":
type: int
required: true
const: 2
description: Number of items to expect in a atmel,pins specifier
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-26 20:34:13 +02:00
gpio-cells:
dts: atmel: Add missing GPIO properties The gpio controllers on SAM4S, SAME70, and SAMD were missing properties related to GPIO pin generation. Add the missing details into the yaml and dts files to allow boards to specific gpio pins. Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2018-09-28 14:56:13 -05:00
- pin
- flags
dts: atmel sam: gpio: Add support for atmel,pins property The atmel,pins property will be utilized to describe pin mux configuration. The property will be a phandle-array in which the phandle points to the given GPIO port the pin is on, the pin number, and the mux configuration. This change updates the atmel,sam-gpio binding to support that phandle-array and updates the associated SoC dtsi files as well. Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2020-04-07 14:38:04 -05:00
atmel,pin-cells:
- pin
- peripheral
Copy permalink