include/linux/adreno-smmu-priv.h

   1 // SPDX-License-Identifier: GPL-2.0-only
   2 /*
   3  * Copyright (C) 2020 Google, Inc
   4  */
   5
   6 #ifndef __ADRENO_SMMU_PRIV_H
   7 #define __ADRENO_SMMU_PRIV_H
   8
   9 #include <linux/io-pgtable.h>
  10
  11 /**
  12  * struct adreno_smmu_fault_info - container for key fault information
  13  *
  14  * @far: The faulting IOVA from ARM_SMMU_CB_FAR
  15  * @ttbr0: The current TTBR0 pagetable from ARM_SMMU_CB_TTBR0
  16  * @contextidr: The value of ARM_SMMU_CB_CONTEXTIDR
  17  * @fsr: The fault status from ARM_SMMU_CB_FSR
  18  * @fsynr0: The value of FSYNR0 from ARM_SMMU_CB_FSYNR0
  19  * @fsynr1: The value of FSYNR1 from ARM_SMMU_CB_FSYNR0
  20  * @cbfrsynra: The value of CBFRSYNRA from ARM_SMMU_GR1_CBFRSYNRA(idx)
  21  *
  22  * This struct passes back key page fault information to the GPU driver
  23  * through the get_fault_info function pointer.
  24  * The GPU driver can use this information to print informative
  25  * log messages and provide deeper GPU specific insight into the fault.
  26  */
  27 struct adreno_smmu_fault_info {
  28         u64 far;
  29         u64 ttbr0;
  30         u32 contextidr;
  31         u32 fsr;
  32         u32 fsynr0;
  33         u32 fsynr1;
  34         u32 cbfrsynra;
  35 };
  36
  37 /**
  38  * struct adreno_smmu_priv - private interface between adreno-smmu and GPU
  39  *
  40  * @cookie:        An opque token provided by adreno-smmu and passed
  41  *                 back into the callbacks
  42  * @get_ttbr1_cfg: Get the TTBR1 config for the GPUs context-bank
  43  * @set_ttbr0_cfg: Set the TTBR0 config for the GPUs context bank.  A
  44  *                 NULL config disables TTBR0 translation, otherwise
  45  *                 TTBR0 translation is enabled with the specified cfg
  46  * @get_fault_info: Called by the GPU fault handler to get information about
  47  *                  the fault
  48  * @set_stall:     Configure whether stall on fault (CFCFG) is enabled.  Call
  49  *                 before set_ttbr0_cfg().  If stalling on fault is enabled,
  50  *                 the GPU driver must call resume_translation()
  51  * @resume_translation: Resume translation after a fault
  52  *
  53  *
  54  * The GPU driver (drm/msm) and adreno-smmu work together for controlling
  55  * the GPU's SMMU instance.  This is by necessity, as the GPU is directly
  56  * updating the SMMU for context switches, while on the other hand we do
  57  * not want to duplicate all of the initial setup logic from arm-smmu.
  58  *
  59  * This private interface is used for the two drivers to coordinate.  The
  60  * cookie and callback functions are populated when the GPU driver attaches
  61  * it's domain.
  62  */
  63 struct adreno_smmu_priv {
  64     const void *cookie;
  65     const struct io_pgtable_cfg *(*get_ttbr1_cfg)(const void *cookie);
  66     int (*set_ttbr0_cfg)(const void *cookie, const struct io_pgtable_cfg *cfg);
  67     void (*get_fault_info)(const void *cookie, struct adreno_smmu_fault_info *info);
  68     void (*set_stall)(const void *cookie, bool enabled);
  69     void (*resume_translation)(const void *cookie, bool terminate);
  70 };
  71
  72 #endif /* __ADRENO_SMMU_PRIV_H */