icc.h 3.0 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697
  1. /**
  2. * @file icc.h
  3. * @brief Instruction Controller Cache(ICC) function prototypes and data types.
  4. */
  5. /* ****************************************************************************
  6. * Copyright (C) 2017 Maxim Integrated Products, Inc., All Rights Reserved.
  7. *
  8. * Permission is hereby granted, free of charge, to any person obtaining a
  9. * copy of this software and associated documentation files (the "Software"),
  10. * to deal in the Software without restriction, including without limitation
  11. * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  12. * and/or sell copies of the Software, and to permit persons to whom the
  13. * Software is furnished to do so, subject to the following conditions:
  14. *
  15. * The above copyright notice and this permission notice shall be included
  16. * in all copies or substantial portions of the Software.
  17. *
  18. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  19. * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
  20. * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
  21. * IN NO EVENT SHALL MAXIM INTEGRATED BE LIABLE FOR ANY CLAIM, DAMAGES
  22. * OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
  23. * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
  24. * OTHER DEALINGS IN THE SOFTWARE.
  25. *
  26. * Except as contained in this notice, the name of Maxim Integrated
  27. * Products, Inc. shall not be used except as stated in the Maxim Integrated
  28. * Products, Inc. Branding Policy.
  29. *
  30. * The mere transfer of this software does not imply any licenses
  31. * of trade secrets, proprietary technology, copyrights, patents,
  32. * trademarks, maskwork rights, or any other form of intellectual
  33. * property whatsoever. Maxim Integrated Products, Inc. retains all
  34. * ownership rights.
  35. *
  36. * $Date: 2018-12-18 15:37:22 -0600 (Tue, 18 Dec 2018) $
  37. * $Revision: 40072 $
  38. *
  39. *************************************************************************** */
  40. /* Define to prevent redundant inclusion */
  41. #ifndef _ICC_H_
  42. #define _ICC_H_
  43. /* **** Includes **** */
  44. #include <stdint.h>
  45. #include "icc_regs.h"
  46. #ifdef __cplusplus
  47. extern "C" {
  48. #endif
  49. /**
  50. * @defgroup icc Internal Cache Controller (ICC)
  51. * @ingroup periphlibs
  52. * @{
  53. */
  54. /**
  55. * @brief Enumeration type for the Cache ID Register
  56. */
  57. typedef enum {
  58. ICC_CACHE_ID_RELNUM, // Identifies the RTL release version
  59. ICC_CACHE_ID_PARTNUM, // Specifies the value of C_ID Port Number
  60. ICC_CACHE_ID_CCHID // Specifies the value of Cache ID
  61. } icc_cache_id_t;
  62. /**
  63. * @brief Reads the data from the Cache Id Register.
  64. * @param cid Enumeration type for Cache Id Register.
  65. * @retval Returns the contents of Cache Id Register.
  66. */
  67. int ICC_ID(icc_cache_id_t cid);
  68. /**
  69. * @brief Enable the instruction cache controller.
  70. */
  71. void ICC_Enable(void);
  72. /**
  73. * @brief Disable the instruction cache controller.
  74. */
  75. void ICC_Disable(void);
  76. /**
  77. * @brief Flush the instruction cache controller.
  78. */
  79. void ICC_Flush(void);
  80. /**@} end of group icc */
  81. #ifdef __cplusplus
  82. }
  83. #endif
  84. #endif /* _ICC_H_ */