dts: bindings: improve documentation for Nordic IPs
Add some details to help new users learn how to manage the nodes
for compatibles corresponding to IP blocks on Nordic SoCs.
The focus is on IP blocks where the pinmux is configured in
devicetree. These typically have individual properties for each pin,
like a SCK pin on a SPI peripheral, which correspond directly to a
PSEL register value. These violate the usual devicetree convention of
using a 'foo-gpios <&gpioX ...>' phandle property and work in ways
that only make sense if you understand the underlying register map, so
it's worth explaining them a bit more carefully.
Skip these two bindings, which have no drivers: nordic,nrf-i2s.yaml,
nordic,nrf-pdm.yaml.
Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
- dts/bindings/flash_controller/nordic,nrf-qspi.yaml[diff]
- dts/bindings/i2c/nordic,nrf-twi-common.yaml[diff]
- dts/bindings/i2c/nordic,nrf-twi.yaml[diff]
- dts/bindings/i2c/nordic,nrf-twim.yaml[diff]
- dts/bindings/i2c/nordic,nrf-twis.yaml[diff]
- dts/bindings/pwm/nordic,nrf-pwm.yaml[diff]
- dts/bindings/sensor/nordic,nrf-qdec.yaml[diff]
- dts/bindings/serial/nordic,nrf-uart-common.yaml[Added - diff]
- dts/bindings/serial/nordic,nrf-uart.yaml[diff]
- dts/bindings/serial/nordic,nrf-uarte.yaml[diff]
- dts/bindings/spi/nordic,nrf-spi-common.yaml[diff]
- dts/bindings/spi/nordic,nrf-spis.yaml[diff]
12 files changed
