1 /* 2 * \file trc_mem_acc_mapper.h 3 * \brief OpenCSD : 4 * 5 * \copyright Copyright (c) 2015, ARM Limited. All Rights Reserved. 6 */ 7 8 /* 9 * Redistribution and use in source and binary forms, with or without modification, 10 * are permitted provided that the following conditions are met: 11 * 12 * 1. Redistributions of source code must retain the above copyright notice, 13 * this list of conditions and the following disclaimer. 14 * 15 * 2. Redistributions in binary form must reproduce the above copyright notice, 16 * this list of conditions and the following disclaimer in the documentation 17 * and/or other materials provided with the distribution. 18 * 19 * 3. Neither the name of the copyright holder nor the names of its contributors 20 * may be used to endorse or promote products derived from this software without 21 * specific prior written permission. 22 * 23 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS 'AS IS' AND 24 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 25 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. 26 * IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, 27 * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES 28 * (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; 29 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND 30 * ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 31 * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS 32 * SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. 33 */ 34 35 #ifndef ARM_TRC_MEM_ACC_MAPPER_H_INCLUDED 36 #define ARM_TRC_MEM_ACC_MAPPER_H_INCLUDED 37 38 #include <vector> 39 40 #include "opencsd/ocsd_if_types.h" 41 #include "interfaces/trc_tgt_mem_access_i.h" 42 #include "interfaces/trc_error_log_i.h" 43 #include "mem_acc/trc_mem_acc_base.h" 44 #include "mem_acc/trc_mem_acc_cache.h" 45 46 typedef enum _memacc_mapper_t { 47 MEMACC_MAP_GLOBAL, 48 } memacc_mapper_t; 49 50 class TrcMemAccMapper : public ITargetMemAccess 51 { 52 public: 53 TrcMemAccMapper(); 54 TrcMemAccMapper(bool using_trace_id); 55 virtual ~TrcMemAccMapper(); 56 57 // decoder memory access interface 58 virtual ocsd_err_t ReadTargetMemory( const ocsd_vaddr_t address, 59 const uint8_t cs_trace_id, 60 const ocsd_mem_space_acc_t mem_space, 61 uint32_t *num_bytes, 62 uint8_t *p_buffer); 63 64 virtual void InvalidateMemAccCache(const uint8_t cs_trace_id); 65 66 // mapper memory area configuration interface 67 68 // add an accessor to this map 69 virtual ocsd_err_t AddAccessor(TrcMemAccessorBase *p_accessor, const uint8_t cs_trace_id) = 0; 70 71 // remove a specific accessor 72 virtual ocsd_err_t RemoveAccessor(const TrcMemAccessorBase *p_accessor) = 0; 73 74 75 // clear all attached accessors from the map 76 void RemoveAllAccessors(); 77 78 // remove a single accessor based on address. 79 ocsd_err_t RemoveAccessorByAddress(const ocsd_vaddr_t st_address, const ocsd_mem_space_acc_t mem_space, const uint8_t cs_trace_id = 0); 80 81 // set the error log. 82 void setErrorLog(ITraceErrorLog *err_log_i); 83 84 // print out the ranges in this mapper. 85 virtual void logMappedRanges() = 0; 86 87 protected: 88 virtual bool findAccessor(const ocsd_vaddr_t address, const ocsd_mem_space_acc_t mem_space, const uint8_t cs_trace_id) = 0; // set m_acc_curr if found valid range, leave unchanged if not. 89 virtual bool readFromCurrent(const ocsd_vaddr_t address, const ocsd_mem_space_acc_t mem_space, const uint8_t cs_trace_id) = 0; 90 virtual TrcMemAccessorBase *getFirstAccessor() = 0; 91 virtual TrcMemAccessorBase *getNextAccessor() = 0; 92 virtual void clearAccessorList() = 0; 93 94 void LogMessage(const std::string &msg); 95 void LogWarn(const ocsd_err_t err, const std::string &msg); 96 97 TrcMemAccessorBase *m_acc_curr; // most recently used - try this first. 98 uint8_t m_trace_id_curr; // trace ID for the current accessor 99 const bool m_using_trace_id; // true if we are using separate memory spaces by TraceID. 100 ITraceErrorLog *m_err_log; // error log to print out mappings on request. 101 TrcMemAccCache m_cache; // memory accessor caching. 102 }; 103 104 105 // address spaces common to all sources using this mapper. 106 // trace id unused. 107 class TrcMemAccMapGlobalSpace : public TrcMemAccMapper 108 { 109 public: 110 TrcMemAccMapGlobalSpace(); 111 virtual ~TrcMemAccMapGlobalSpace(); 112 113 // mapper creation interface - prevent overlaps 114 virtual ocsd_err_t AddAccessor(TrcMemAccessorBase *p_accessor, const uint8_t cs_trace_id); 115 116 // print out the ranges in this mapper. 117 virtual void logMappedRanges(); 118 119 protected: 120 virtual bool findAccessor(const ocsd_vaddr_t address, const ocsd_mem_space_acc_t mem_space, const uint8_t cs_trace_id); 121 virtual bool readFromCurrent(const ocsd_vaddr_t address,const ocsd_mem_space_acc_t mem_space, const uint8_t cs_trace_id); 122 virtual TrcMemAccessorBase *getFirstAccessor(); 123 virtual TrcMemAccessorBase *getNextAccessor(); 124 virtual void clearAccessorList(); 125 virtual ocsd_err_t RemoveAccessor(const TrcMemAccessorBase *p_accessor); 126 127 std::vector<TrcMemAccessorBase *> m_acc_global; 128 std::vector<TrcMemAccessorBase *>::iterator m_acc_it; 129 }; 130 131 #endif // ARM_TRC_MEM_ACC_MAPPER_H_INCLUDED 132 133 /* End of File trc_mem_acc_mapper.h */ 134