csl_mpu.h 3.2 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798
  1. /**
  2. * @file csl_mpu.h
  3. *
  4. * @brief
  5. * This is the header file for the MPU CSL Functional Layer.
  6. *
  7. * \par
  8. * ============================================================================
  9. * @n (C) Copyright 2011 Texas Instruments, Inc.
  10. *
  11. * Redistribution and use in source and binary forms, with or without
  12. * modification, are permitted provided that the following conditions
  13. * are met:
  14. *
  15. * Redistributions of source code must retain the above copyright
  16. * notice, this list of conditions and the following disclaimer.
  17. *
  18. * Redistributions in binary form must reproduce the above copyright
  19. * notice, this list of conditions and the following disclaimer in the
  20. * documentation and/or other materials provided with the
  21. * distribution.
  22. *
  23. * Neither the name of Texas Instruments Incorporated nor the names of
  24. * its contributors may be used to endorse or promote products derived
  25. * from this software without specific prior written permission.
  26. *
  27. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  28. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  29. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  30. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  31. * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  32. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  33. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  34. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  35. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  36. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  37. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  38. *
  39. */
  40. /** @defgroup CSL_MPU_API MPU
  41. *
  42. * @section Introduction
  43. * The MPU performs memory protection checking for a CBA bus. It inputs a VBUSM
  44. * or VBUSP bus, checks the address against the fixed and programmable regions
  45. * to see if the access is allowed. If allowed the transfer is passed unmodified
  46. * to the output VBUSM or VBUSP bus. If the transfer is illegal (fails the
  47. * protection check) then the MPU does not pass the transfer to the output bus
  48. * but rather services the transfer internally back to the input bus (to prevent
  49. * a hang) returning the fault status to the requestor as well as generating an
  50. * interrupt about the fault.
  51. *
  52. * @subsection References
  53. * -# MPU Module Specification.
  54. */
  55. #ifndef CSL_MPU_H
  56. #define CSL_MPU_H
  57. #ifdef __cplusplus
  58. extern "C" {
  59. #endif
  60. #include <ti/csl/soc.h>
  61. #include <ti/csl/csl.h>
  62. #include <ti/csl/cslr_mpu.h>
  63. /**
  64. @defgroup CSL_MPU_SYMBOL MPU Symbols Defined
  65. @ingroup CSL_MPU_API
  66. */
  67. /**
  68. @defgroup CSL_MPU_DATASTRUCT MPU Data Structures
  69. @ingroup CSL_MPU_API
  70. */
  71. /**
  72. @defgroup CSL_MPU_FUNCTION MPU Functions
  73. @ingroup CSL_MPU_API
  74. */
  75. /** @addtogroup CSL_MPU_DATASTRUCT
  76. @{ */
  77. /** @brief This is the handle to the MPU Register */
  78. typedef volatile CSL_MpuRegs* CSL_MpuHandle;
  79. /**
  80. @}
  81. */
  82. /* Device specific API which opens the MPU instance and returns a handle used in all subsequent calls */
  83. extern CSL_MpuHandle CSL_MPU_Open (Int32 instNum);
  84. #ifdef __cplusplus
  85. }
  86. #endif
  87. #endif /* CSL_MPU_H */