patrick/zephyr
1
0
Fork 0
Code Issues Pull requests Actions 7 Packages Projects Releases Wiki Activity
zephyr/dts/bindings/i2c/microchip,xec-i2c.yaml

42 lines
898 B
YAML
Raw Normal View History

dts: mchp: Add Microchip I2C SoC device tree Expose MEC1501 5 I2C/SMB controllers Add Microchip specific I2C device tree properties Signed-off-by: Jose Alberto Meza <jose.a.meza.arellano@intel.com>
2019-04-22 23:36:40 +02:00
# Copyright (c) 2019 Intel Corporation
# 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 00:03:49 +02:00
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: Microchip I2C/SMB controller
dts: mchp: Add Microchip I2C SoC device tree Expose MEC1501 5 I2C/SMB controllers Add Microchip specific I2C device tree properties Signed-off-by: Jose Alberto Meza <jose.a.meza.arellano@intel.com>
2019-04-22 23:36:40 +02: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: "microchip,xec-i2c"
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 01:10:12 +02:00
include: i2c-controller.yaml
dts: mchp: Add Microchip I2C SoC device tree Expose MEC1501 5 I2C/SMB controllers Add Microchip specific I2C device tree properties Signed-off-by: Jose Alberto Meza <jose.a.meza.arellano@intel.com>
2019-04-22 23:36:40 +02: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
dts: mchp: Add Microchip I2C SoC device tree Expose MEC1501 5 I2C/SMB controllers Add Microchip specific I2C device tree properties Signed-off-by: Jose Alberto Meza <jose.a.meza.arellano@intel.com>
2019-04-22 23:36:40 +02:00
port_sel:
type: int
description: soc block mapping to pin
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: bindings: microchip,xec-i2c: Add GIRQ fields Add the girq and girq-bit fields to the binding. This allows encoding GIRQ related information inside device tree. Signed-off-by: Francisco Munoz <francisco.munoz.ruiz@intel.com> Signed-off-by: Rajavardhan Gundi <rajavardhan.gundi@intel.com>
2020-09-08 21:10:28 +02:00
girq:
type: int
required: true
description: GIRQ for this device
girq-bit:
type: int
required: true
description: Bit position in GIRQ for this device
drivers: i2c: MEC15xx: Improved error handling 1. Check I2C Clock and Data is high through GPIO driver instead of the I2C bitbang registers 2. i2c_xec_poll_write() and i2c_xec_poll_read() will poll to check I2C clock and data lines are high before initiating the transaction. The polling will be every 25us for a cumulative max of 2.5ms 3. wait_completion() will not call recover_from_error() to reset the controller. Instead will poll for 10ms for the PIN bit to clear before returning error. 4. wait_completion() will send STOP if the 9th bit is NACK 5. If any errors with current transaction: (a) Set error_seen flag. (b) In the next transaction do the recovery process (reset the i2c controller) if the clk and data lines are high. Note: error_seen flag is set for Address NACK with Repeated Start as well. 6. If timeout error occurs in wait_completion(): (a) Set timeout_seen flag; (b) Wait till the slave will release the clock. (c) Once slave releases clock send STOP on the bus. If the timeout occurred while master read, read the I2C DATA register for the hardware to proceed. Signed-off-by: Jay Vasanth <jay.vasanth@microchip.com>
2022-02-22 18:17:25 +01:00
sda-gpios:
type: phandle-array
required: true
description: |
The SDA pin for the selected port. Pin choice for port is
determined by chip and package.
scl-gpios:
type: phandle-array
required: true
description: |
The SCL pin for the selected port. Pin choice for port is
determined by chip and package.
Reference in a new issue Copy permalink