michaelh/zephyr
1
0
Fork 0
Code Releases Activity

doc: porting: shields: Update instructions for nodelabel definitions

Browse source 
Update requirements regarding board connectors compatibility now that
dtc versions prior to 1.4.2 can't be used anymore (current required
version is 1.4.6).

Signed-off-by: Erwan Gouriou <erwan.gouriou@linaro.org>
This commit is contained in:
Erwan Gouriou 2022-09-08 13:42:09 +02:00 • committed by Carles Cufí
commit 656382e7a4
1 changed files with 2 additions and 13 deletions
Download patch file Download diff file Expand all files Collapse all files

15
doc/hardware/porting/shields.rst
View file

@ -50,23 +50,12 @@ This should be done at two different level:
* Pinmux: Connector pins should be correctly configured to match shield pins
* Devicetree: A board :ref:`devicetree <dt-guide>` file,
:file:`BOARD.dts` should define a node alias for each connector interface.
:file:`BOARD.dts` should define an alternate nodelabel for each connector interface.
For example, for Arduino I2C:
.. code-block:: devicetree
#define arduino_i2c i2c1
aliases {
arduino,i2c = &i2c1;
};
Note: With support of dtc v1.4.2, above will be replaced with the recently
introduced overriding node element:
.. code-block:: devicetree
arduino_i2c:i2c1{};
arduino_i2c: &i2c1 {};
Board specific shield configuration
-----------------------------------