csl_msmc.h 3.7 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145
  1. /**
  2. * @file csl_msmc.h
  3. *
  4. * @brief
  5. * This is the main header file for the MSMC Module which defines
  6. * all the data structures and exported API.
  7. *
  8. * \par
  9. * ============================================================================
  10. * @n (C) Copyright 2008, 2009, Texas Instruments, Inc.
  11. *
  12. * Redistribution and use in source and binary forms, with or without
  13. * modification, are permitted provided that the following conditions
  14. * are met:
  15. *
  16. * Redistributions of source code must retain the above copyright
  17. * notice, this list of conditions and the following disclaimer.
  18. *
  19. * Redistributions in binary form must reproduce the above copyright
  20. * notice, this list of conditions and the following disclaimer in the
  21. * documentation and/or other materials provided with the
  22. * distribution.
  23. *
  24. * Neither the name of Texas Instruments Incorporated nor the names of
  25. * its contributors may be used to endorse or promote products derived
  26. * from this software without specific prior written permission.
  27. *
  28. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  29. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  30. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
  31. * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
  32. * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
  33. * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
  34. * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
  35. * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
  36. * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
  37. * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
  38. * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
  39. *
  40. */
  41. /** @defgroup CSL_MSMC_API MSMC
  42. *
  43. * @section Introduction
  44. *
  45. * @subsection xxx Overview
  46. * The MSMC is a module designed to manage traffic between multiple processor cores, other
  47. * mastering peripherals or DMA and the EMIF in a multi-core SoC. The MSMC provides a shared
  48. * on-chip memory that can be used either as a shared on-chip SRAM or a cache for external
  49. * memory traffic. It is part of the compute infrastructure for CGEM 0.5 and hence is designed to
  50. * work with the CGEM 0.5 processor cores.
  51. *
  52. * @subsection References
  53. * -# MSMC User's Guide
  54. *
  55. * @subsection Assumptions
  56. * The abbreviations MSMC, msmc and Msmc have been used throughout this
  57. * document to refer to Multi-Core Shared Memory Controller
  58. */
  59. #ifndef CSL_MSMC_H
  60. #define CSL_MSMC_H
  61. #ifdef __cplusplus
  62. extern "C" {
  63. #endif
  64. #include <ti/csl/soc.h>
  65. #include <ti/csl/csl.h>
  66. #include <ti/csl/cslr_msmc.h>
  67. /**
  68. @defgroup CSL_MSMC_SYMBOL MSMC Symbols Defined
  69. @ingroup CSL_MSMC_API
  70. */
  71. /**
  72. @defgroup CSL_MSMC_DATASTRUCT MSMC Data Structures
  73. @ingroup CSL_MSMC_API
  74. */
  75. /**
  76. @defgroup CSL_MSMC_FUNCTION MSMC Functions
  77. @ingroup CSL_MSMC_API
  78. */
  79. /**
  80. @addtogroup CSL_MSMC_SYMBOL
  81. @{
  82. */
  83. /**
  84. * Handle to access MSMC registers accessible through config bus.
  85. */
  86. #define hMsmc ((CSL_MsmcRegs*)CSL_MSMC_CFG_REGS)
  87. /**
  88. @}
  89. */
  90. /** @addtogroup CSL_MSMC_DATASTRUCT
  91. @{ */
  92. typedef struct {
  93. Uint16 baddr;
  94. Uint8 segSz;
  95. }CSL_MSMC_SMSMPAXH;
  96. typedef struct {
  97. Uint16 raddr;
  98. Uint32 sr;
  99. Uint32 sw;
  100. Uint32 sx;
  101. Uint32 ur;
  102. Uint32 uw;
  103. Uint32 ux;
  104. }CSL_MSMC_SMSMPAXL;
  105. typedef struct {
  106. Uint32 baddr;
  107. Uint32 be;
  108. Uint32 ai;
  109. Uint8 segSz;
  110. }CSL_MSMC_SESMPAXH;
  111. typedef struct {
  112. Uint32 raddr;
  113. Uint32 sr;
  114. Uint32 sw;
  115. Uint32 sx;
  116. Uint32 ur;
  117. Uint32 uw;
  118. Uint32 ux;
  119. }CSL_MSMC_SESMPAXL;
  120. /* @} */
  121. /** @addtogroup CSL_MSMC_FUNCTION
  122. @{ */
  123. /* @} */
  124. #ifdef __cplusplus
  125. }
  126. #endif
  127. #endif /* CSL_MSMC_H */