alt_remap_uncached.c 3.4 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354
  1. /******************************************************************************
  2. * *
  3. * License Agreement *
  4. * *
  5. * Copyright (c) 2003,2007 Altera Corporation, San Jose, California, USA. *
  6. * 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 in *
  16. * all copies or substantial portions of the Software. *
  17. * *
  18. * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR *
  19. * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, *
  20. * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE *
  21. * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER *
  22. * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING *
  23. * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER *
  24. * DEALINGS IN THE SOFTWARE. *
  25. * *
  26. * This agreement shall be governed in all respects by the laws of the State *
  27. * of California and by the laws of the United States of America. *
  28. * *
  29. ******************************************************************************/
  30. #include "sys/alt_warning.h"
  31. #include "sys/alt_cache.h"
  32. #include "system.h"
  33. /*
  34. * Convert a pointer to a block of cached memory into a block of uncached memory.
  35. * Return a pointer that should be used to access the uncached memory.
  36. *
  37. * This routine was created for Nios II Gen1 cores which allow mixing cacheable and
  38. * uncachable data in the same data cache line. So, they could take any memory region
  39. * and make it uncached. However, Nios II Gen2 cores don't support mixing cacheable
  40. * and uncachable data in the same data cache line so require the memory region to
  41. * be aligned to a cache line boundary and must be an integer number of cache line
  42. * bytes in size. So, software on a Nios II Gen2 core shouldn't really be using this
  43. * function so it fails with a link error.
  44. */
  45. volatile void*
  46. alt_remap_uncached(void* ptr, alt_u32 len)
  47. {
  48. /* Generate a link time error, should this function ever be called. */
  49. ALT_LINK_ERROR("alt_remap_uncached() is not available because Nios II Gen2 cores with data caches don't support mixing cacheable and uncacheable data on the same line.");
  50. return NULL;
  51. }