Lines Matching +full:1275 +full:- +full:1994
10 Some of these -- the ones beginning with ``DT_INST_`` -- require a special
19 .. _devicetree-generic-apis:
33 :ref:`devicetree-property-access` API.
45 .. doxygengroup:: devicetree-generic-id
47 .. _devicetree-property-access:
52 The following general-purpose macros can be used to access node properties.
53 There are special-purpose APIs for accessing the :ref:`devicetree-ranges-property`,
54 :ref:`devicetree-reg-property` and :ref:`devicetree-interrupts-property`.
59 .. doxygengroup:: devicetree-generic-prop
61 .. _devicetree-ranges-property:
66 Use these APIs instead of :ref:`devicetree-property-access` to access the
71 `PCI Bus Binding to: IEEE Std 1275-1994 Standard for Boot (Initialization Configuration) Firmware`_
73 .. _PCI Bus Binding to\: IEEE Std 1275-1994 Standard for Boot (Initialization Configuration) Firmwa…
76 .. doxygengroup:: devicetree-ranges-prop
78 .. _devicetree-reg-property:
83 Use these APIs instead of :ref:`devicetree-property-access` to access the
88 .. doxygengroup:: devicetree-reg-prop
90 .. _devicetree-interrupts-property:
95 Use these APIs instead of :ref:`devicetree-property-access` to access the
102 .. doxygengroup:: devicetree-interrupts-prop
104 For-each macros
110 There is currently only one "generic" for-each macro,
114 There are special-purpose for-each macros, like
118 .. doxygengroup:: devicetree-generic-foreach
129 .. doxygengroup:: devicetree-generic-exist
131 .. _devicetree-dep-ord:
133 Inter-node dependencies
142 - every non-root node directly depends on its parent node
143 - a node directly depends on any nodes its properties refer to by phandle
144 - a node directly depends on its ``interrupt-parent`` if it has an
146 - a parent node inherits all dependencies from its child nodes
150 *dependency ordinal* is then its zero-based index in that list. Thus, for two
154 - ``d1 != d2``
155 - if ``n1`` depends on ``n2``, then ``d1 > d2``
156 - ``d1 > d2`` does **not** necessarily imply that ``n1`` depends on ``n2``
164 There are instance number-based conveniences as well; see
167 .. doxygengroup:: devicetree-dep-ord
177 .. doxygengroup:: devicetree-generic-bus
179 .. _devicetree-inst-apis:
181 Instance-based APIs
185 ``DT_DRV_COMPAT`` to the lowercase-and-underscores compatible the device driver
188 .. code-block:: devicetree
193 current-speed = <115200>;
199 .. code-block:: c
212 :ref:`devicetree-generic-apis`. The equivalent generic API can be found by
217 and :c:macro:`DT_INST_FOREACH_STATUS_OKAY` are special-purpose helpers without
224 specific hardware; these are documented in :ref:`devicetree-hw-api`.
226 .. doxygengroup:: devicetree-inst
228 .. _devicetree-hw-api:
236 .. _devicetree-can-api:
244 .. doxygengroup:: devicetree-can
252 .. doxygengroup:: devicetree-clocks
260 .. doxygengroup:: devicetree-dmas
262 .. _devicetree-flash-api:
267 These conveniences may be used for the special-purpose ``fixed-partitions``
269 device tree. See See :dtcompatible:`fixed-partition` for more details.
271 .. doxygengroup:: devicetree-fixed-partition
273 .. _devicetree-gpio-api:
281 .. doxygengroup:: devicetree-gpio
289 .. doxygengroup:: devicetree-io-channels
291 .. _devicetree-mbox-api:
299 .. doxygengroup:: devicetree-mbox
301 .. _devicetree-pinctrl-api:
309 as pin mux) settings. These are expressed using ``pinctrl-<index>`` properties
311 from 0. These may also be named using the ``pinctrl-names`` property.
315 .. code-block:: DTS
319 pinctrl-0 = <&foo &bar ...>;
320 pinctrl-1 = <&baz ...>;
321 pinctrl-names = "default", "sleep";
324 Above, ``pinctrl-0`` has name ``"default"``, and ``pinctrl-1`` has name
325 ``"sleep"``. The ``pinctrl-<index>`` property values contain phandles. The
329 .. doxygengroup:: devicetree-pinctrl
337 .. doxygengroup:: devicetree-pwms
345 .. doxygengroup:: devicetree-reset-controller
353 .. doxygengroup:: devicetree-spi
355 .. _devicetree-chosen-nodes:
361 system-wide settings. The :c:macro:`DT_CHOSEN()` macro can be used to get a node
364 .. doxygengroup:: devicetree-generic-chosen
366 Zephyr-specific chosen nodes
369 The following table documents some commonly used Zephyr-specific chosen nodes.
372 of a Kconfig option which in turn configures a hardware-specific device. This
380 .. list-table:: Zephyr-specific chosen properties
381 :header-rows: 1
384 * - Property
385 - Purpose
386 * - zephyr,bt-c2h-uart
387 - Selects the UART used for host communication in the
388 :zephyr:code-sample:`bluetooth_hci_uart`
389 * - zephyr,bt-mon-uart
390 - Sets UART device used for the Bluetooth monitor logging
391 * - zephyr,bt-hci
392 - Selects the HCI device used by the Bluetooth host stack
393 * - zephyr,canbus
394 - Sets the default CAN controller
395 * - zephyr,ccm
396 - Core-Coupled Memory node on some STM32 SoCs
397 * - zephyr,code-partition
398 - Flash partition that the Zephyr image's text section should be linked
400 * - zephyr,console
401 - Sets UART device used by console driver
402 * - zephyr,display
403 - Sets the default display controller
404 * - zephyr,keyboard-scan
405 - Sets the default keyboard scan controller
406 * - zephyr,dtcm
407 - Data Tightly Coupled Memory node on some Arm SoCs
408 * - zephyr,entropy
409 - A device which can be used as a system-wide entropy source
410 * - zephyr,flash
411 - A node whose ``reg`` is sometimes used to set the defaults for
413 * - zephyr,flash-controller
414 - The node corresponding to the flash controller device for
416 * - zephyr,gdbstub-uart
417 - Sets UART device used by the :ref:`gdbstub` subsystem
418 * - zephyr,ieee802154
419 - Used by the networking subsystem to set the IEEE 802.15.4 device
420 * - zephyr,ipc
421 - Used by the OpenAMP subsystem to specify the inter-process communication
423 * - zephyr,ipc_shm
424 - A node whose ``reg`` is used by the OpenAMP subsystem to determine the
426 interprocess-communication (IPC)
427 * - zephyr,itcm
428 - Instruction Tightly Coupled Memory node on some Arm SoCs
429 * - zephyr,log-uart
430 - Sets the UART device(s) used by the logging subsystem's UART backend.
432 * - zephyr,ocm
433 - On-chip memory node on Xilinx Zynq-7000 and ZynqMP SoCs
434 * - zephyr,osdp-uart
435 - Sets UART device used by OSDP subsystem
436 * - zephyr,ot-uart
437 - Used by the OpenThread to specify UART device for Spinel protocol
438 * - zephyr,pcie-controller
439 - The node corresponding to the PCIe Controller
440 * - zephyr,ppp-uart
441 - Sets UART device used by PPP
442 * - zephyr,settings-partition
443 - Fixed partition node. If defined this selects the partition used
445 * - zephyr,shell-uart
446 - Sets UART device used by serial shell backend
447 * - zephyr,sram
448 - A node whose ``reg`` sets the base address and size of SRAM memory
450 * - zephyr,tracing-uart
451 - Sets UART device used by tracing subsystem
452 * - zephyr,uart-mcumgr
453 - UART used for :ref:`device_mgmt`
454 * - zephyr,uart-pipe
455 - Sets UART device used by serial pipe driver
456 * - zephyr,usb-device
457 - USB device node. If defined and has a ``vbus-gpios`` property, these
459 * - zephyr,led-strip
460 - A LED-strip node which is used to determine the timings of the
462 * - zephyr,touch
463 - touchscreen controller device node.