:orphan: .. raw:: html .. dtcompatible:: quicklogic,eos-s3-pinctrl .. _dtbinding_quicklogic_eos_s3_pinctrl: quicklogic,eos-s3-pinctrl ######################### Vendor: :ref:`QuickLogic Corp. ` Description *********** .. code-block:: none Quicklogic EOS S3 IO MUX binding covers the 46 IOMUX_PAD_x_CTRL registers that can be used to set the direction and the function of a pad. Device pin configuration should be placed in the child nodes of this node. Populate the 'pinmux' field with IO function and pin number. For example, setting pins 44 and 45 for use as UART would look like this: #include &pinctrl { uart0_rx_default: uart0_rx_default { pinmux = ; input-enable; }; uart0_tx_default: uart0_tx_default { pinmux = ; output-enable; }; }; Properties ********** Top level properties ==================== These property descriptions apply to "quicklogic,eos-s3-pinctrl" nodes themselves. This page also describes child node properties in the following sections. .. tabs:: .. group-tab:: Node specific properties Properties not inherited from the base binding file. (None) .. group-tab:: Deprecated node specific properties Deprecated properties not inherited from the base binding file. (None) .. group-tab:: Base properties Properties inherited from the base binding file, which defines common properties that may be set on many nodes. Not all of these may apply to the "quicklogic,eos-s3-pinctrl" compatible. .. list-table:: :widths: 1 1 4 :header-rows: 1 * - Name - Type - Details * - ``reg`` - ``array`` - .. code-block:: none register space This property is **required**. See :ref:`dt-important-props` for more information. * - ``status`` - ``string`` - .. code-block:: none indicates the operational status of a device Legal values: ``'ok'``, ``'okay'``, ``'disabled'``, ``'reserved'``, ``'fail'``, ``'fail-sss'`` See :ref:`dt-important-props` for more information. * - ``compatible`` - ``string-array`` - .. code-block:: none compatible strings This property is **required**. See :ref:`dt-important-props` for more information. * - ``reg-names`` - ``string-array`` - .. code-block:: none name of each register space * - ``interrupts`` - ``array`` - .. code-block:: none interrupts for device See :ref:`dt-important-props` for more information. * - ``interrupts-extended`` - ``compound`` - .. code-block:: none extended interrupt specifier for device * - ``interrupt-names`` - ``string-array`` - .. code-block:: none name of each interrupt * - ``interrupt-parent`` - ``phandle`` - .. code-block:: none phandle to interrupt controller node * - ``label`` - ``string`` - .. code-block:: none Human readable string describing the device (used as device_get_binding() argument) See :ref:`dt-important-props` for more information. This property is **deprecated**. * - ``clocks`` - ``phandle-array`` - .. code-block:: none Clock gate information * - ``clock-names`` - ``string-array`` - .. code-block:: none name of each clock * - ``#address-cells`` - ``int`` - .. code-block:: none number of address cells in reg property * - ``#size-cells`` - ``int`` - .. code-block:: none number of size cells in reg property * - ``dmas`` - ``phandle-array`` - .. code-block:: none DMA channels specifiers * - ``dma-names`` - ``string-array`` - .. code-block:: none Provided names of DMA channel specifiers * - ``io-channels`` - ``phandle-array`` - .. code-block:: none IO channels specifiers * - ``io-channel-names`` - ``string-array`` - .. code-block:: none Provided names of IO channel specifiers * - ``mboxes`` - ``phandle-array`` - .. code-block:: none mailbox / IPM channels specifiers * - ``mbox-names`` - ``string-array`` - .. code-block:: none Provided names of mailbox / IPM channel specifiers * - ``wakeup-source`` - ``boolean`` - .. code-block:: none Property to identify that a device can be used as wake up source. When this property is provided a specific flag is set into the device that tells the system that the device is capable of wake up the system. Wake up capable devices are disabled (interruptions will not wake up the system) by default but they can be enabled at runtime if necessary. * - ``power-domain`` - ``phandle`` - .. code-block:: none Power domain the device belongs to. The device will be notified when the power domain it belongs to is either suspended or resumed. * - ``zephyr,pm-device-runtime-auto`` - ``boolean`` - .. code-block:: none Automatically configure the device for runtime power management after the init function runs. Child node properties ===================== .. list-table:: :widths: 1 1 4 :header-rows: 1 * - Name - Type - Details * - ``pinmux`` - ``array`` - .. code-block:: none Quicklogic EOS S3 pin's configuration (pin, IO function). This property is **required**. * - ``slew-rate`` - ``string`` - .. code-block:: none The default value "slow" matches the power-on reset value. Default value: ``slow`` Legal values: ``'slow'``, ``'fast'`` * - ``quicklogic,control-selection`` - ``string`` - .. code-block:: none Control selection for IO output. It's either controlled from registers of the A0 always-on domain, fabric-controlled for signaling with FPGA, or other-controller for bidirectional signals. The default value "a0registers" matches the power-on reset value. Default value: ``a0registers`` Legal values: ``'a0registers'``, ``'others'``, ``'fabric'`` * - ``bias-high-impedance`` - ``boolean`` - .. code-block:: none high impedance mode ("third-state", "floating") * - ``bias-pull-up`` - ``boolean`` - .. code-block:: none enable pull-up resistor * - ``bias-pull-down`` - ``boolean`` - .. code-block:: none enable pull-down resistor * - ``drive-strength`` - ``int`` - .. code-block:: none maximum sink or source current in mA * - ``input-enable`` - ``boolean`` - .. code-block:: none enable input on pin (e.g. enable an input buffer, no effect on output) * - ``input-schmitt-enable`` - ``boolean`` - .. code-block:: none enable schmitt-trigger mode * - ``output-enable`` - ``boolean`` - .. code-block:: none enable output on a pin without actively driving it (e.g. enable an output buffer)