xref: /freebsd/sys/contrib/device-tree/Bindings/rng/arm-cctrng.yaml (revision c66ec88fed842fbaad62c30d510644ceb7bd2d71)
1*c66ec88fSEmmanuel Vadot# SPDX-License-Identifier: (GPL-2.0 OR BSD-2-Clause)
2*c66ec88fSEmmanuel Vadot%YAML 1.2
3*c66ec88fSEmmanuel Vadot---
4*c66ec88fSEmmanuel Vadot$id: http://devicetree.org/schemas/rng/arm-cctrng.yaml#
5*c66ec88fSEmmanuel Vadot$schema: http://devicetree.org/meta-schemas/core.yaml#
6*c66ec88fSEmmanuel Vadot
7*c66ec88fSEmmanuel Vadottitle: Arm TrustZone CryptoCell TRNG engine
8*c66ec88fSEmmanuel Vadot
9*c66ec88fSEmmanuel Vadotmaintainers:
10*c66ec88fSEmmanuel Vadot  - Hadar Gat <hadar.gat@arm.com>
11*c66ec88fSEmmanuel Vadot
12*c66ec88fSEmmanuel Vadotdescription: |+
13*c66ec88fSEmmanuel Vadot  Arm TrustZone CryptoCell TRNG (True Random Number Generator) engine.
14*c66ec88fSEmmanuel Vadot
15*c66ec88fSEmmanuel Vadotproperties:
16*c66ec88fSEmmanuel Vadot  compatible:
17*c66ec88fSEmmanuel Vadot    enum:
18*c66ec88fSEmmanuel Vadot      - arm,cryptocell-713-trng
19*c66ec88fSEmmanuel Vadot      - arm,cryptocell-703-trng
20*c66ec88fSEmmanuel Vadot
21*c66ec88fSEmmanuel Vadot  interrupts:
22*c66ec88fSEmmanuel Vadot    maxItems: 1
23*c66ec88fSEmmanuel Vadot
24*c66ec88fSEmmanuel Vadot  reg:
25*c66ec88fSEmmanuel Vadot    maxItems: 1
26*c66ec88fSEmmanuel Vadot
27*c66ec88fSEmmanuel Vadot  arm,rosc-ratio:
28*c66ec88fSEmmanuel Vadot    description:
29*c66ec88fSEmmanuel Vadot      Arm TrustZone CryptoCell TRNG engine has 4 ring oscillators.
30*c66ec88fSEmmanuel Vadot      Sampling ratio values for these 4 ring oscillators. (from calibration)
31*c66ec88fSEmmanuel Vadot    $ref: /schemas/types.yaml#/definitions/uint32-array
32*c66ec88fSEmmanuel Vadot    maxItems: 4
33*c66ec88fSEmmanuel Vadot
34*c66ec88fSEmmanuel Vadot  clocks:
35*c66ec88fSEmmanuel Vadot    maxItems: 1
36*c66ec88fSEmmanuel Vadot
37*c66ec88fSEmmanuel Vadotrequired:
38*c66ec88fSEmmanuel Vadot  - compatible
39*c66ec88fSEmmanuel Vadot  - interrupts
40*c66ec88fSEmmanuel Vadot  - reg
41*c66ec88fSEmmanuel Vadot  - arm,rosc-ratio
42*c66ec88fSEmmanuel Vadot
43*c66ec88fSEmmanuel VadotadditionalProperties: false
44*c66ec88fSEmmanuel Vadot
45*c66ec88fSEmmanuel Vadotexamples:
46*c66ec88fSEmmanuel Vadot  - |
47*c66ec88fSEmmanuel Vadot    arm_cctrng: rng@60000000 {
48*c66ec88fSEmmanuel Vadot        compatible = "arm,cryptocell-713-trng";
49*c66ec88fSEmmanuel Vadot        interrupts = <0 29 4>;
50*c66ec88fSEmmanuel Vadot        reg = <0x60000000 0x10000>;
51*c66ec88fSEmmanuel Vadot        arm,rosc-ratio = <5000 1000 500 0>;
52*c66ec88fSEmmanuel Vadot    };
53