Documentation/devicetree/bindings/tpm/tcg,tpm_tis-spi.yaml

# SPDX-License-Identifier: (GPL-2.0-only OR BSD-2-Clause)
%YAML 1.2
---
$id: http://devicetree.org/schemas/tpm/tcg,tpm_tis-spi.yaml#
$schema: http://devicetree.org/meta-schemas/core.yaml#

title: SPI-attached Trusted Platform Module conforming to TCG TIS specification

maintainers:
  - Lukas Wunner <lukas@wunner.de>

description: |
  The Trusted Computing Group (TCG) has defined a multi-vendor standard
  for accessing a TPM chip.  It can be transported over various buses,
  one of them being SPI.  The standard is named:
  TCG PC Client Specific TPM Interface Specification (TIS)
  https://trustedcomputinggroup.org/resource/pc-client-work-group-pc-client-specific-tpm-interface-specification-tis/

properties:
  compatible:
    items:
      - enum:
          - atmel,attpm20p
          - infineon,slb9670
          - st,st33htpm-spi
          - st,st33zp24-spi
      - const: tcg,tpm_tis-spi

allOf:
  - $ref: tpm-common.yaml#
  - $ref: /schemas/spi/spi-peripheral-props.yaml#
  - if:
      properties:
        compatible:
          contains:
            const: st,st33zp24-spi
    then:
      properties:
        spi-max-frequency:
          maximum: 10000000

required:
  - compatible
  - reg

unevaluatedProperties: false

examples:
  - |
    spi {
        #address-cells = <1>;
        #size-cells = <0>;

        tpm@0 {
            reg = <0>;
            compatible = "infineon,slb9670", "tcg,tpm_tis-spi";
            spi-max-frequency = <10000000>;
        };
    };

  - |
    #include <dt-bindings/gpio/gpio.h>
    #include <dt-bindings/interrupt-controller/irq.h>
    spi {
        #address-cells = <1>;
        #size-cells = <0>;

        tpm@0 {
            reg = <0>;
            compatible = "st,st33zp24-spi", "tcg,tpm_tis-spi";
            spi-max-frequency = <10000000>;
            interrupt-parent = <&gpio5>;
            interrupts = <7 IRQ_TYPE_LEVEL_HIGH>;
            lpcpd-gpios = <&gpio5 15 GPIO_ACTIVE_HIGH>;
        };
    };