OrgZephyr/zephyr
OrgZephyr
/
zephyr
mirror of https://github.com/zephyrproject-rtos/zephyr.git
1
0
Fork 0
Code Issues Releases Wiki Activity
zephyr/dts/bindings/arm/nxp,kinetis-sim.yaml

39 lines
618 B
YAML
Raw Normal View History

dts: Add Kinetis SIM clock bindings Adds device tree bindings for the Kinetis System Integration Module (SIM), and defines peripheral source clocks (e.g., system clock or bus clock) and clock gates for all Kinetis SoCs. Signed-off-by: Maureen Helm <maureen.helm@nxp.com>
2017-08-26 06:13:39 +08:00
# Copyright (c) 2017, NXP
# SPDX-License-Identifier: Apache-2.0
yaml: Remove redundant document separators YAML document separators are needed e.g. when doing $ cat doc1.yaml doc2.yaml | <parser> For the bindings, we never parse concatenated documents. Assume we don't for any other .yaml files either. Having document separators in e.g. base.yaml makes !include a bit confusing, since the !included files are merged and not separate documents (the merging is done in Python code though, so it makes no difference for behavior). The replacement was done with $ git ls-files '*.yaml' | \ xargs sed -i -e '${/\s*\.\.\.\s*/d;}' -e 's/^\s*---\s*$//' First pattern removes ... at the end of files, second pattern clears a line with a lone --- on it. Some redundant blank lines at the end of files were cleared with $ git ls-files '*.yaml' | xargs sed -i '${/^\s*$/d}' This is more about making sure people can understand why every part of a binding is there than about removing some text. Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-06-19 06:03:49 +08:00
dts: Add Kinetis SIM clock bindings Adds device tree bindings for the Kinetis System Integration Module (SIM), and defines peripheral source clocks (e.g., system clock or bus clock) and clock gates for all Kinetis SoCs. Signed-off-by: Maureen Helm <maureen.helm@nxp.com>
2017-08-26 06:13:39 +08:00
title: Kinetis System Integration Module (SIM)
dts: bindings: Preserve newlines in descriptions With https://github.com/zephyrproject-rtos/zephyr/pull/20185, multi-line descriptions will be formatted nicely, but using '>' breaks it, because it removes internal newlines (including between paragraphs). See https://yaml-multiline.info/. Replace 'description: >' with 'description: |' to encourage '|'. That'll prevent '>' from getting copied around and messing up long descriptions. This will lead to some extra newlines in the output, but it's fine. Line-wrapping messes up any manual formatting. The replacement was done with $ git ls-files 'dts/bindings/*.yaml' | \ xargs sed -i 's/description:\s*>/description: |/' Signed-off-by: Ulf Magnusson <Ulf.Magnusson@nordicsemi.no>
2019-10-29 00:34:12 +08:00
description: |
dts: Add Kinetis SIM clock bindings Adds device tree bindings for the Kinetis System Integration Module (SIM), and defines peripheral source clocks (e.g., system clock or bus clock) and clock gates for all Kinetis SoCs. Signed-off-by: Maureen Helm <maureen.helm@nxp.com>
2017-08-26 06:13:39 +08:00
This is a representation of the Kinetis SIM IP node
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: "nxp,kinetis-sim"
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: 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
dts: Add Kinetis SIM clock bindings Adds device tree bindings for the Kinetis System Integration Module (SIM), and defines peripheral source clocks (e.g., system clock or bus clock) and clock gates for all Kinetis SoCs. Signed-off-by: Maureen Helm <maureen.helm@nxp.com>
2017-08-26 06:13:39 +08:00
properties:
yaml: fix properties syntax to 'mapping' instead of 'series' According to yaml syntaxic rules, 'properties' described in dts bindings yaml files could be seen as 'mapping'(key/value couple), instead of 'series' (list of single elements). yaml 'mappings' will then be converted by yaml python library as python 'dict' which will ease treatment (instead of current list as were before this commit). Same treatment is applied to 'inherits'. script extract_dts_inlcude is updated to take change of yaml_list structre into account. This allows some code simplification. Largest impact is yaml_collapse function which works now allow complete overload method on all the attributes of a yaml nodes. Signed-off-by: Erwan Gouriou <erwan.gouriou@linaro.org>
2017-11-23 15:48:10 +08:00
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 06:22:01 +08:00
required: true
dts: Add Kinetis SIM clock bindings Adds device tree bindings for the Kinetis System Integration Module (SIM), and defines peripheral source clocks (e.g., system clock or bus clock) and clock gates for all Kinetis SoCs. Signed-off-by: Maureen Helm <maureen.helm@nxp.com>
2017-08-26 06:13:39 +08:00
yaml: fix properties syntax to 'mapping' instead of 'series' According to yaml syntaxic rules, 'properties' described in dts bindings yaml files could be seen as 'mapping'(key/value couple), instead of 'series' (list of single elements). yaml 'mappings' will then be converted by yaml python library as python 'dict' which will ease treatment (instead of current list as were before this commit). Same treatment is applied to 'inherits'. script extract_dts_inlcude is updated to take change of yaml_list structre into account. This allows some code simplification. Largest impact is yaml_collapse function which works now allow complete overload method on all the attributes of a yaml nodes. Signed-off-by: Erwan Gouriou <erwan.gouriou@linaro.org>
2017-11-23 15:48:10 +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 06:22:01 +08:00
required: true
dts: Add Kinetis SIM clock bindings Adds device tree bindings for the Kinetis System Integration Module (SIM), and defines peripheral source clocks (e.g., system clock or bus clock) and clock gates for all Kinetis SoCs. Signed-off-by: Maureen Helm <maureen.helm@nxp.com>
2017-08-26 06:13:39 +08:00
drivers: clock_control_mcux_sim: add support for clkout Add support for CLKOUT source selection and divider as found on the NXP Kinetis KE1xF SoC series. Signed-off-by: Henrik Brix Andersen <hebad@vestas.com>
2019-05-10 18:25:38 +08:00
clkout-source:
type: int
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 06:22:01 +08:00
required: false
drivers: clock_control_mcux_sim: add support for clkout Add support for CLKOUT source selection and divider as found on the NXP Kinetis KE1xF SoC series. Signed-off-by: Henrik Brix Andersen <hebad@vestas.com>
2019-05-10 18:25:38 +08:00
description: clkout clock source
clkout-divider:
type: int
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 06:22:01 +08:00
required: false
drivers: clock_control_mcux_sim: add support for clkout Add support for CLKOUT source selection and divider as found on the NXP Kinetis KE1xF SoC series. Signed-off-by: Henrik Brix Andersen <hebad@vestas.com>
2019-05-10 18:25:38 +08:00
description: clkout divider
dts/bindings: Add missing clock-cells property A number of bindings were missing the #clock-cells property in their bindings. Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2019-07-10 00:22:12 +08:00
"#clock-cells":
type: int
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 06:22:01 +08:00
required: false
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
const: 3
dts/bindings: Add missing clock-cells property A number of bindings were missing the #clock-cells property in their bindings. Signed-off-by: Kumar Gala <kumar.gala@linaro.org>
2019-07-10 00:22:12 +08:00
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
clock-cells:
dts: Add Kinetis SIM clock bindings Adds device tree bindings for the Kinetis System Integration Module (SIM), and defines peripheral source clocks (e.g., system clock or bus clock) and clock gates for all Kinetis SoCs. Signed-off-by: Maureen Helm <maureen.helm@nxp.com>
2017-08-26 06:13:39 +08:00
- name
- offset
- bits