Book a Demo!
CoCalc Logo Icon
StoreFeaturesDocsShareSupportNewsAboutPoliciesSign UpSign In
torvalds
GitHub Repository: torvalds/linux
 Path: blob/master/Documentation/devicetree/bindings/dma/ingenic,dma.yaml
26308 views
1
# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)

2
%YAML 1.2

3
---

4
$id: http://devicetree.org/schemas/dma/ingenic,dma.yaml#

5
$schema: http://devicetree.org/meta-schemas/core.yaml#

6


7
title: Ingenic SoCs DMA Controller

8


9
maintainers:

10
  - Paul Cercueil <paul@crapouillou.net>

11


12
allOf:

13
  - $ref: dma-controller.yaml#

14


15
properties:

16
  compatible:

17
    oneOf:

18
      - enum:

19
          - ingenic,jz4740-dma

20
          - ingenic,jz4725b-dma

21
          - ingenic,jz4755-dma

22
          - ingenic,jz4760-dma

23
          - ingenic,jz4760-bdma

24
          - ingenic,jz4760-mdma

25
          - ingenic,jz4760b-dma

26
          - ingenic,jz4760b-bdma

27
          - ingenic,jz4760b-mdma

28
          - ingenic,jz4770-dma

29
          - ingenic,jz4780-dma

30
          - ingenic,x1000-dma

31
          - ingenic,x1830-dma

32
      - items:

33
          - const: ingenic,jz4770-bdma

34
          - const: ingenic,jz4760b-bdma

35


36
  reg:

37
    items:

38
      - description: Channel-specific registers

39
      - description: System control registers

40


41
  interrupts:

42
    maxItems: 1

43


44
  clocks:

45
    maxItems: 1

46


47
  "#dma-cells":

48
    enum: [2, 3]

49
    description: >

50
      DMA clients must use the format described in dma.txt, giving a phandle

51
      to the DMA controller plus the following integer cells:

52


53
      - Request type: The DMA request type specifies the device endpoint that

54
        will be the source or destination of the DMA transfer.

55
        If "#dma-cells" is 2, the request type is a single cell, and the

56
        direction will be unidirectional (either RX or TX but not both).

57
        If "#dma-cells" is 3, the request type has two cells; the first

58
        one corresponds to the host to device direction (TX), the second one

59
        corresponds to the device to host direction (RX). The DMA channel is

60
        then bidirectional.

61


62
      - Channel: If set to 0xffffffff, any available channel will be allocated

63
        for the client. Otherwise, the exact channel specified will be used.

64
        The channel should be reserved on the DMA controller using the

65
        ingenic,reserved-channels property.

66


67
  ingenic,reserved-channels:

68
    $ref: /schemas/types.yaml#/definitions/uint32

69
    description: >

70
      Bitmask of channels to reserve for devices that need a specific

71
      channel. These channels will only be assigned when explicitly

72
      requested by a client. The primary use for this is channels 0 and

73
      1, which can be configured to have special behaviour for NAND/BCH

74
      when using programmable firmware.

75


76
required:

77
  - compatible

78
  - reg

79
  - interrupts

80
  - clocks

81


82
unevaluatedProperties: false

83


84
examples:

85
  - |

86
    #include <dt-bindings/clock/ingenic,jz4780-cgu.h>

87
    dma: dma-controller@13420000 {

88
      compatible = "ingenic,jz4780-dma";

89
      reg = <0x13420000 0x400>, <0x13421000 0x40>;

90


91
      interrupt-parent = <&intc>;

92
      interrupts = <10>;

93


94
      clocks = <&cgu JZ4780_CLK_PDMA>;

95


96
      #dma-cells = <2>;

97


98
      ingenic,reserved-channels = <0x3>;

99
    };

100


101