Documentation/devicetree/bindings/crypto/ti,sa2ul.yaml

   1 # SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
   2 %YAML 1.2
   3 ---
   4 $id: http://devicetree.org/schemas/crypto/ti,sa2ul.yaml#
   5 $schema: http://devicetree.org/meta-schemas/core.yaml#
   6
   7 title: K3 SoC SA2UL crypto module
   8
   9 maintainers:
  10   - Tero Kristo <t-kristo@ti.com>
  11
  12 properties:
  13   compatible:
  14     enum:
  15       - ti,j721e-sa2ul
  16       - ti,am654-sa2ul
  17       - ti,am64-sa2ul
  18       - ti,am62-sa3ul
  19
  20   reg:
  21     maxItems: 1
  22
  23   power-domains:
  24     maxItems: 1
  25
  26   dmas:
  27     items:
  28       - description: TX DMA Channel
  29       - description: 'RX DMA Channel #1'
  30       - description: 'RX DMA Channel #2'
  31
  32   dma-names:
  33     items:
  34       - const: tx
  35       - const: rx1
  36       - const: rx2
  37
  38   "#address-cells":
  39     const: 2
  40
  41   "#size-cells":
  42     const: 2
  43
  44   ranges:
  45     description:
  46       Address translation for the possible RNG child node for SA2UL
  47
  48   clocks:
  49     items:
  50       - description: Clock used by PKA
  51       - description: Main Input Clock
  52       - description: Clock used by rng
  53
  54   clock-names:
  55     items:
  56       - const: pka_in_clk
  57       - const: x1_clk
  58       - const: x2_clk
  59
  60 patternProperties:
  61   "^rng@[a-f0-9]+$":
  62     type: object
  63     description:
  64       Child RNG node for SA2UL
  65
  66 required:
  67   - compatible
  68   - reg
  69   - dmas
  70   - dma-names
  71
  72 allOf:
  73   - if:
  74       properties:
  75         compatible:
  76           contains:
  77             const: ti,am62-sa3ul
  78     then:
  79       properties:
  80         power-domains: false
  81     else:
  82       required:
  83         - power-domains
  84
  85 additionalProperties: false
  86
  87 examples:
  88   - |
  89     #include <dt-bindings/soc/ti,sci_pm_domain.h>
  90
  91     main_crypto: crypto@4e00000 {
  92         compatible = "ti,j721e-sa2ul";
  93         reg = <0x4e00000 0x1200>;
  94         power-domains = <&k3_pds 264 TI_SCI_PD_EXCLUSIVE>;
  95         dmas = <&main_udmap 0xc000>, <&main_udmap 0x4000>,
  96                <&main_udmap 0x4001>;
  97         dma-names = "tx", "rx1", "rx2";
  98     };