packages/hal/arm/sa11x0/nano/v2_0/include/plf_mmap.h

   1 #ifndef CYGONCE_HAL_SA11X0_PLATFORM_PLF_MMAP_H
   2 #define CYGONCE_HAL_SA11X0_PLATFORM_PLF_MMAP_H
   3 /*=============================================================================
   4 //
   5 //      plf_mmap.h
   6 //
   7 //      Platform specific memory map support
   8 //
   9 //=============================================================================
  10 //####ECOSGPLCOPYRIGHTBEGIN####
  11 // -------------------------------------------
  12 // This file is part of eCos, the Embedded Configurable Operating System.
  13 // Copyright (C) 1998, 1999, 2000, 2001, 2002 Red Hat, Inc.
  14 //
  15 // eCos is free software; you can redistribute it and/or modify it under
  16 // the terms of the GNU General Public License as published by the Free
  17 // Software Foundation; either version 2 or (at your option) any later version.
  18 //
  19 // eCos is distributed in the hope that it will be useful, but WITHOUT ANY
  20 // WARRANTY; without even the implied warranty of MERCHANTABILITY or
  21 // FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General Public License
  22 // for more details.
  23 //
  24 // You should have received a copy of the GNU General Public License along
  25 // with eCos; if not, write to the Free Software Foundation, Inc.,
  26 // 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA.
  27 //
  28 // As a special exception, if other files instantiate templates or use macros
  29 // or inline functions from this file, or you compile this file and link it
  30 // with other works to produce a work based on this file, this file does not
  31 // by itself cause the resulting work to be covered by the GNU General Public
  32 // License. However the source code for this file must still be made available
  33 // in accordance with section (3) of the GNU General Public License.
  34 //
  35 // This exception does not invalidate any other reasons why a work based on
  36 // this file might be covered by the GNU General Public License.
  37 //
  38 // Alternative licenses for eCos may be arranged by contacting Red Hat, Inc.
  39 // at http://sources.redhat.com/ecos/ecos-license/
  40 // -------------------------------------------
  41 //####ECOSGPLCOPYRIGHTEND####
  42 //=============================================================================
  43 //#####DESCRIPTIONBEGIN####
  44 //
  45 // Author(s):    hmt
  46 // Contributors: hmt
  47 // Date:         2001-01-04
  48 // Purpose:      Intel SA11x0 series platform-specific memory mapping macros
  49 // Description:  Macros to convert a cached, virtual address to
  50 //               1) an uncached adddress for the same memory (if available)
  51 //               2) the equivalent physical address for giving to external
  52 //               hardware eg. DMA engines.
  53 //
  54 //               NB: this mapping is expressed here statically, independent
  55 //               of the actual mapping installed in the MMAP table.  So if
  56 //               someone changes that, or its initialisation is changed,
  57 //               then this module must change.  This is intended to be
  58 //               efficient at a cost of generality.  It is also intended to
  59 //               be called with constants (such as &my_struct) as input
  60 //               args, so that all the work can be done at compile time,
  61 //               with optimization on.
  62 //
  63 // Usage:        #include <cyg/hal/hal_cache.h>
  64 //               (which includes this file itself)
  65 //
  66 //####DESCRIPTIONEND####
  67 //
  68 //===========================================================================*/
  69
  70 #include <cyg/hal/hal_misc.h>
  71
  72 // Get the pagesize for a particular virtual address:
  73
  74 // This does not depend on the vaddr.
  75 #define HAL_MM_PAGESIZE( vaddr, pagesize ) CYG_MACRO_START      \
  76     (pagesize) = SZ_1M;                                         \
  77 CYG_MACRO_END
  78
  79 // Get the physical address from a virtual address:
  80
  81 // Only RAM and ROM are mapped; we just pass through all other values,
  82 // rather than detecting nonexistent areas here.
  83
  84 #define HAL_VIRT_TO_PHYS_ADDRESS( vaddr, paddr ) CYG_MACRO_START        \
  85     cyg_uint32 _v_ = (cyg_uint32)(vaddr);                               \
  86     cyg_uint32 _p_ = hal_virt_to_phys_address(_v_);                     \
  87     if ( _p_ )                                                          \
  88         (paddr) = _p_;                                                  \
  89     else                                                                \
  90         (paddr) = _v_;                                                  \
  91 CYG_MACRO_END
  92
  93 // Get the virtual address for a physical address:
  94
  95 // Only RAM and ROM are mapped; we just pass through all other values,
  96 // rather than detecting nonexistent areas here.
  97
  98 #define HAL_PHYS_TO_VIRT_ADDRESS( paddr, vaddr ) CYG_MACRO_START        \
  99     cyg_uint32 _p_ = (cyg_uint32)(paddr);                               \
 100     cyg_uint32 _v_ = hal_phys_to_virt_address(_p_);                     \
 101     if ( _v_ )                                                          \
 102         (vaddr) = _v_;                                                  \
 103     else                                                                \
 104         (vaddr) = _p_;                                                  \
 105 CYG_MACRO_END
 106
 107 // Get a non-cacheable address for accessing the same store as a virtual
 108 // (assumed cachable) address:
 109
 110 // Only RAM is mapped: ROM is only available cachable, everything else is
 111 // not cachable anyway.
 112
 113 #define HAL_VIRT_TO_UNCACHED_ADDRESS( vaddr, uaddr ) CYG_MACRO_START    \
 114     cyg_uint32 _v_ = (cyg_uint32)(vaddr);                               \
 115     cyg_uint32 _u_ = hal_virt_to_uncached_address(_v_);                 \
 116     if ( _u_ )                                                          \
 117         (uaddr) = _u_;                                                  \
 118     else                                                                \
 119         (uaddr) = _v_ ;                                                 \
 120 CYG_MACRO_END
 121
 122
 123 //---------------------------------------------------------------------------
 124 #endif // CYGONCE_HAL_SA11X0_PLATFORM_PLF_MMAP_H
 125 // EOF plf_mmap.h