drivers/gpu/arm/mali400/mali/common/mali_mmu.h

   1 /*
   2  * Copyright (C) 2010-2015 ARM Limited. All rights reserved.
   3  *
   4  * This program is free software and is provided to you under the terms of the GNU General Public License version 2
   5  * as published by the Free Software Foundation, and any use by you of this program is subject to the terms of such GNU licence.
   6  *
   7  * A copy of the licence is included with the program, and can also be obtained from Free Software
   8  * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
   9  */
  10
  11 #ifndef __MALI_MMU_H__
  12 #define __MALI_MMU_H__
  13
  14 #include "mali_osk.h"
  15 #include "mali_mmu_page_directory.h"
  16 #include "mali_hw_core.h"
  17
  18 /* Forward declaration from mali_group.h */
  19 struct mali_group;
  20
  21 /**
  22  * MMU register numbers
  23  * Used in the register read/write routines.
  24  * See the hardware documentation for more information about each register
  25  */
  26 typedef enum mali_mmu_register {
  27         MALI_MMU_REGISTER_DTE_ADDR = 0x0000, /**< Current Page Directory Pointer */
  28         MALI_MMU_REGISTER_STATUS = 0x0004, /**< Status of the MMU */
  29         MALI_MMU_REGISTER_COMMAND = 0x0008, /**< Command register, used to control the MMU */
  30         MALI_MMU_REGISTER_PAGE_FAULT_ADDR = 0x000C, /**< Logical address of the last page fault */
  31         MALI_MMU_REGISTER_ZAP_ONE_LINE = 0x010, /**< Used to invalidate the mapping of a single page from the MMU */
  32         MALI_MMU_REGISTER_INT_RAWSTAT = 0x0014, /**< Raw interrupt status, all interrupts visible */
  33         MALI_MMU_REGISTER_INT_CLEAR = 0x0018, /**< Indicate to the MMU that the interrupt has been received */
  34         MALI_MMU_REGISTER_INT_MASK = 0x001C, /**< Enable/disable types of interrupts */
  35         MALI_MMU_REGISTER_INT_STATUS = 0x0020 /**< Interrupt status based on the mask */
  36 } mali_mmu_register;
  37
  38 /**
  39  * MMU interrupt register bits
  40  * Each cause of the interrupt is reported
  41  * through the (raw) interrupt status registers.
  42  * Multiple interrupts can be pending, so multiple bits
  43  * can be set at once.
  44  */
  45 typedef enum mali_mmu_interrupt {
  46         MALI_MMU_INTERRUPT_PAGE_FAULT = 0x01, /**< A page fault occured */
  47         MALI_MMU_INTERRUPT_READ_BUS_ERROR = 0x02 /**< A bus read error occured */
  48 } mali_mmu_interrupt;
  49
  50 typedef enum mali_mmu_status_bits {
  51         MALI_MMU_STATUS_BIT_PAGING_ENABLED      = 1 << 0,
  52         MALI_MMU_STATUS_BIT_PAGE_FAULT_ACTIVE   = 1 << 1,
  53         MALI_MMU_STATUS_BIT_STALL_ACTIVE        = 1 << 2,
  54         MALI_MMU_STATUS_BIT_IDLE                = 1 << 3,
  55         MALI_MMU_STATUS_BIT_REPLAY_BUFFER_EMPTY = 1 << 4,
  56         MALI_MMU_STATUS_BIT_PAGE_FAULT_IS_WRITE = 1 << 5,
  57         MALI_MMU_STATUS_BIT_STALL_NOT_ACTIVE    = 1 << 31,
  58 } mali_mmu_status_bits;
  59
  60 /**
  61  * Definition of the MMU struct
  62  * Used to track a MMU unit in the system.
  63  * Contains information about the mapping of the registers
  64  */
  65 struct mali_mmu_core {
  66         struct mali_hw_core hw_core; /**< Common for all HW cores */
  67         _mali_osk_irq_t *irq;        /**< IRQ handler */
  68 };
  69
  70 _mali_osk_errcode_t mali_mmu_initialize(void);
  71
  72 void mali_mmu_terminate(void);
  73
  74 struct mali_mmu_core *mali_mmu_create(_mali_osk_resource_t *resource, struct mali_group *group, mali_bool is_virtual);
  75 void mali_mmu_delete(struct mali_mmu_core *mmu);
  76
  77 _mali_osk_errcode_t mali_mmu_reset(struct mali_mmu_core *mmu);
  78 mali_bool mali_mmu_zap_tlb(struct mali_mmu_core *mmu);
  79 void mali_mmu_zap_tlb_without_stall(struct mali_mmu_core *mmu);
  80 void mali_mmu_invalidate_page(struct mali_mmu_core *mmu, u32 mali_address);
  81
  82 void mali_mmu_activate_page_directory(struct mali_mmu_core *mmu, struct mali_page_directory *pagedir);
  83 void mali_mmu_activate_empty_page_directory(struct mali_mmu_core *mmu);
  84 void mali_mmu_activate_fault_flush_page_directory(struct mali_mmu_core *mmu);
  85
  86 void mali_mmu_page_fault_done(struct mali_mmu_core *mmu);
  87
  88 MALI_STATIC_INLINE enum mali_interrupt_result mali_mmu_get_interrupt_result(struct mali_mmu_core *mmu)
  89 {
  90         u32 rawstat_used = mali_hw_core_register_read(&mmu->hw_core, MALI_MMU_REGISTER_INT_RAWSTAT);
  91         if (0 == rawstat_used) {
  92                 return MALI_INTERRUPT_RESULT_NONE;
  93         }
  94
  95         return MALI_INTERRUPT_RESULT_ERROR;
  96 }
  97
  98
  99 MALI_STATIC_INLINE u32 mali_mmu_get_int_status(struct mali_mmu_core *mmu)
 100 {
 101         return mali_hw_core_register_read(&mmu->hw_core, MALI_MMU_REGISTER_INT_STATUS);
 102 }
 103
 104 MALI_STATIC_INLINE u32 mali_mmu_get_rawstat(struct mali_mmu_core *mmu)
 105 {
 106         return mali_hw_core_register_read(&mmu->hw_core, MALI_MMU_REGISTER_INT_RAWSTAT);
 107 }
 108
 109 MALI_STATIC_INLINE void mali_mmu_mask_all_interrupts(struct mali_mmu_core *mmu)
 110 {
 111         mali_hw_core_register_write(&mmu->hw_core, MALI_MMU_REGISTER_INT_MASK, 0);
 112 }
 113
 114 MALI_STATIC_INLINE u32 mali_mmu_get_status(struct mali_mmu_core *mmu)
 115 {
 116         return mali_hw_core_register_read(&mmu->hw_core, MALI_MMU_REGISTER_STATUS);
 117 }
 118
 119 MALI_STATIC_INLINE u32 mali_mmu_get_page_fault_addr(struct mali_mmu_core *mmu)
 120 {
 121         return mali_hw_core_register_read(&mmu->hw_core, MALI_MMU_REGISTER_PAGE_FAULT_ADDR);
 122 }
 123
 124 #endif /* __MALI_MMU_H__ */