Home | History | Annotate | Line # | Download | only in bfin
      1 /* Common Blackfin device stuff.
      2 
      3    Copyright (C) 2010-2024 Free Software Foundation, Inc.
      4    Contributed by Analog Devices, Inc.
      5 
      6    This file is part of simulators.
      7 
      8    This program is free software; you can redistribute it and/or modify
      9    it under the terms of the GNU General Public License as published by
     10    the Free Software Foundation; either version 3 of the License, or
     11    (at your option) any later version.
     12 
     13    This program is distributed in the hope that it will be useful,
     14    but WITHOUT ANY WARRANTY; without even the implied warranty of
     15    MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
     16    GNU General Public License for more details.
     17 
     18    You should have received a copy of the GNU General Public License
     19    along with this program.  If not, see <http://www.gnu.org/licenses/>.  */
     20 
     21 #ifndef DEVICES_H
     22 #define DEVICES_H
     23 
     24 #include "hw-base.h"
     25 #include "hw-main.h"
     26 #include "hw-device.h"
     27 #include "hw-tree.h"
     28 
     29 #include "bfin-sim.h"
     30 
     31 /* We keep the same initial structure layout with DMA enabled devices.  */
     32 struct dv_bfin {
     33   bu32 base;
     34   struct hw *dma_master;
     35   bool acked;
     36 };
     37 
     38 #define BFIN_MMR_16(mmr) mmr, __pad_##mmr
     39 
     40 /* Most peripherals have either one interrupt or these three.  */
     41 #define DV_PORT_TX   0
     42 #define DV_PORT_RX   1
     43 #define DV_PORT_STAT 2
     44 
     45 unsigned int dv_get_bus_num (struct hw *);
     46 
     47 static inline bu8 dv_load_1 (const void *ptr)
     49 {
     50   const unsigned char *c = ptr;
     51   return c[0];
     52 }
     53 
     54 static inline void dv_store_1 (void *ptr, bu8 val)
     55 {
     56   unsigned char *c = ptr;
     57   c[0] = val;
     58 }
     59 
     60 static inline bu16 dv_load_2 (const void *ptr)
     61 {
     62   const unsigned char *c = ptr;
     63   return (c[1] << 8) | dv_load_1 (ptr);
     64 }
     65 
     66 static inline void dv_store_2 (void *ptr, bu16 val)
     67 {
     68   unsigned char *c = ptr;
     69   c[1] = val >> 8;
     70   dv_store_1 (ptr, val);
     71 }
     72 
     73 static inline bu32 dv_load_4 (const void *ptr)
     74 {
     75   const unsigned char *c = ptr;
     76   return (c[3] << 24) | (c[2] << 16) | dv_load_2 (ptr);
     77 }
     78 
     79 static inline void dv_store_4 (void *ptr, bu32 val)
     80 {
     81   unsigned char *c = ptr;
     82   c[3] = val >> 24;
     83   c[2] = val >> 16;
     84   dv_store_2 (ptr, val);
     85 }
     86 
     87 /* Helpers for MMRs where only the specified bits are W1C.  The
     89    rest are left unmodified.  */
     90 #define dv_w1c(ptr, val, bits) (*(ptr) &= ~((val) & (bits)))
     91 static inline void dv_w1c_2 (bu16 *ptr, bu16 val, bu16 bits)
     92 {
     93   dv_w1c (ptr, val, bits);
     94 }
     95 static inline void dv_w1c_4 (bu32 *ptr, bu32 val, bu32 bits)
     96 {
     97   dv_w1c (ptr, val, bits);
     98 }
     99 
    100 /* Helpers for MMRs where all bits are RW except for the specified
    101    bits -- those ones are W1C.  */
    102 #define dv_w1c_partial(ptr, val, bits) \
    103   (*(ptr) = ((val) | (*(ptr) & (bits))) & ~((val) & (bits)))
    104 static inline void dv_w1c_2_partial (bu16 *ptr, bu16 val, bu16 bits)
    105 {
    106   dv_w1c_partial (ptr, val, bits);
    107 }
    108 static inline void dv_w1c_4_partial (bu32 *ptr, bu32 val, bu32 bits)
    109 {
    110   dv_w1c_partial (ptr, val, bits);
    111 }
    112 
    113 /* XXX: Grubbing around in device internals is probably wrong, but
    115         until someone shows me what's right ...  */
    116 static inline struct hw *
    117 dv_get_device (SIM_CPU *cpu, const char *device_name)
    118 {
    119   SIM_DESC sd = CPU_STATE (cpu);
    120   void *root = STATE_HW (sd);
    121   return hw_tree_find_device (root, device_name);
    122 }
    123 
    124 static inline void *
    125 dv_get_state (SIM_CPU *cpu, const char *device_name)
    126 {
    127   return hw_data (dv_get_device (cpu, device_name));
    128 }
    129 
    130 #define DV_STATE(cpu, dv) dv_get_state (cpu, "/core/bfin_"#dv)
    131 
    132 #define DV_STATE_CACHED(cpu, dv) \
    133   ({ \
    134     struct bfin_##dv *__##dv = BFIN_CPU_STATE.dv##_cache; \
    135     if (!__##dv) \
    136       BFIN_CPU_STATE.dv##_cache = __##dv = dv_get_state (cpu, "/core/bfin_"#dv); \
    137     __##dv; \
    138   })
    139 
    140 void dv_bfin_mmr_invalid (struct hw *, address_word, unsigned nr_bytes, bool write);
    142 bool dv_bfin_mmr_require (struct hw *, address_word, unsigned nr_bytes, unsigned size, bool write);
    143 /* For 32-bit memory mapped registers that allow 16-bit or 32-bit access.  */
    144 bool dv_bfin_mmr_require_16_32 (struct hw *, address_word, unsigned nr_bytes, bool write);
    145 /* For 32-bit memory mapped registers that only allow 16-bit access.  */
    146 #define dv_bfin_mmr_require_16(hw, addr, nr_bytes, write) dv_bfin_mmr_require (hw, addr, nr_bytes, 2, write)
    147 /* For 32-bit memory mapped registers that only allow 32-bit access.  */
    148 #define dv_bfin_mmr_require_32(hw, addr, nr_bytes, write) dv_bfin_mmr_require (hw, addr, nr_bytes, 4, write)
    149 
    150 #define HW_TRACE_WRITE() \
    152   HW_TRACE ((me, "write 0x%08lx (%s) length %u with 0x%x", \
    153 	     (unsigned long) addr, mmr_name (mmr_off), nr_bytes, value))
    154 #define HW_TRACE_READ() \
    155   HW_TRACE ((me, "read 0x%08lx (%s) length %u", \
    156 	     (unsigned long) addr, mmr_name (mmr_off), nr_bytes))
    157 
    158 #define HW_TRACE_DMA_WRITE() \
    159   HW_TRACE ((me, "dma write 0x%08lx length %u", \
    160 	     (unsigned long) addr, nr_bytes))
    161 #define HW_TRACE_DMA_READ() \
    162   HW_TRACE ((me, "dma read 0x%08lx length %u", \
    163 	     (unsigned long) addr, nr_bytes))
    164 
    165 #endif
    166