162306a36Sopenharmony_ci# SPDX-License-Identifier: GPL-2.0
262306a36Sopenharmony_ci%YAML 1.2
362306a36Sopenharmony_ci---
462306a36Sopenharmony_ci$id: http://devicetree.org/schemas/dma/dma-common.yaml#
562306a36Sopenharmony_ci$schema: http://devicetree.org/meta-schemas/core.yaml#
662306a36Sopenharmony_ci
762306a36Sopenharmony_cititle: DMA Engine Common Properties
862306a36Sopenharmony_ci
962306a36Sopenharmony_cimaintainers:
1062306a36Sopenharmony_ci  - Vinod Koul <vkoul@kernel.org>
1162306a36Sopenharmony_ci
1262306a36Sopenharmony_cidescription:
1362306a36Sopenharmony_ci  Generic binding to provide a way for a driver using DMA Engine to
1462306a36Sopenharmony_ci  retrieve the DMA request or channel information that goes from a
1562306a36Sopenharmony_ci  hardware device to a DMA controller.
1662306a36Sopenharmony_ci
1762306a36Sopenharmony_ciselect: false
1862306a36Sopenharmony_ci
1962306a36Sopenharmony_ciproperties:
2062306a36Sopenharmony_ci  "#dma-cells":
2162306a36Sopenharmony_ci    minimum: 1
2262306a36Sopenharmony_ci    # Should be enough
2362306a36Sopenharmony_ci    maximum: 255
2462306a36Sopenharmony_ci    description:
2562306a36Sopenharmony_ci      Used to provide DMA controller specific information.
2662306a36Sopenharmony_ci
2762306a36Sopenharmony_ci  dma-channel-mask:
2862306a36Sopenharmony_ci    description:
2962306a36Sopenharmony_ci      Bitmask of available DMA channels in ascending order that are
3062306a36Sopenharmony_ci      not reserved by firmware and are available to the
3162306a36Sopenharmony_ci      kernel. i.e. first channel corresponds to LSB.
3262306a36Sopenharmony_ci      The first item in the array is for channels 0-31, the second is for
3362306a36Sopenharmony_ci      channels 32-63, etc.
3462306a36Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/uint32-array
3562306a36Sopenharmony_ci    items:
3662306a36Sopenharmony_ci      minItems: 1
3762306a36Sopenharmony_ci      # Should be enough
3862306a36Sopenharmony_ci      maxItems: 255
3962306a36Sopenharmony_ci
4062306a36Sopenharmony_ci  dma-channels:
4162306a36Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/uint32
4262306a36Sopenharmony_ci    description:
4362306a36Sopenharmony_ci      Number of DMA channels supported by the controller.
4462306a36Sopenharmony_ci
4562306a36Sopenharmony_ci  dma-requests:
4662306a36Sopenharmony_ci    $ref: /schemas/types.yaml#/definitions/uint32
4762306a36Sopenharmony_ci    description:
4862306a36Sopenharmony_ci      Number of DMA request signals supported by the controller.
4962306a36Sopenharmony_ci
5062306a36Sopenharmony_cirequired:
5162306a36Sopenharmony_ci  - "#dma-cells"
5262306a36Sopenharmony_ci
5362306a36Sopenharmony_ciadditionalProperties: true
54