[wiki:Component SocLib Components General Index] '''UNDER DEVELOPMENT''' = ARM7TDMI Processor Functional Description = This hardware component is a ARM7TDMI processor core. This is only an ISS, which should be wrapped with an [wiki:Component/IssWrapper IssWrapper]. The simulation model is actually an instruction set simulator with an ARM7TDMI pipeline. Currently it only exists in bigendian form. = IMPORTANT: steps to apply before using the ARM7TDMI = Before compiling any SoClib simulator using the ARM7TDMI you will need to download the UNISIM ( http://www.unisim.org ) library (well, just a piece of it, the unisim_lib). To do so just download it using svn from [https://unisim.org/svn/devel/unisim_lib] with the following command: * svn export https://unisim.org/svn/devel/unisim_lib You will have to enter a username and password. If you do not have access to the UNISIM development, you can simply use 'guest' for username (no password is needed). Once you have downloaded UNISIM you will need to create a link in trunk/soclib/lib/arm7tdmi/include/iss/ and trunk/soclib/lib/arm7tdmi/src/iss/ to /unisim. If you wish you can download the full UNISIM library by downloading unisim_tools and unisim_simulators: * svn export https://unisim.org/svn/devel/unisim_tools * svn export https://unisim.org/svn/devel/unisim_simulators Finally you will have to set your soclib.conf (source:trunk/soclib/utils/conf/soclib.conf) file to compile correctly the ARM7TDMI component. Here you have an example of configuration that correctly sets the flags to compile ARM7TDMI: {{{ # -*- python -*- def _platform(): """ Retrieves platform information and make it look-like systemc's lib-xxx thing. Working so far with: * linux * darwin """ import sys pf = sys.platform # Strip numeric suffix from platform name while pf[-1] in "0123456789": pf = pf[:-1] remap_pf = {'darwin':'macosx'} if pf in remap_pf: pf = remap_pf[pf] return pf config.systemc = Config( base = config.systemc, dir = "${SYSTEMC}", os = _platform(), ) config.my_toolchain = Config( base = config.toolchain, cflags = ['-ggdb', '-DSOCLIB', '-D__STDC_CONSTANT_MACROS', '-Wall', '-Wno-pmf-conversions'], ) config.default = Config( base = config.build_env, systemc = config.systemc, toolchain = config.my_toolchain, repos = "/tmp/build/sc", ) }}} The flags you will need to compile the ARM7TDMI component are: -DSOCLID and -D!__STDC_CONSTANT_MACROS. In the previous example you can see that the default toolchain has been augmented to define those flags. = Component definition = Available in source:trunk/soclib/soclib/lib/arm7tdmi/metadata/arm7tdmi.sd == Usage == ARM7TDMI has no parameters. {{{ Uses('iss_wrapper', iss_t = 'common:arm7tdmi') }}} = ARM7TDMI Processor ISS Implementation = The implementation is in * source:trunk/soclib/lib/arm7tdmi/include/iss/arm7tdmi.h * source:trunk/soclib/lib/arm7tdmi/src/iss/arm7tdmi.cpp The previous files use the ARM7TDMI implementation provided in the UNISIM library. == Template parameters == This component has no template parameters. == Constructor parameters == {{{ ARM7TDMIIss( sc_module_name name, // Instance Name int ident); // processor id }}} == Visible registers == '''UNDER DEVELOPMENT''' == Interrupts == '''UNDER DEVELOPMENT''' The handling and prioritization of the interrupts is deferred to software. == Ports == None, it is to the wrapper to provide them. = Compiling programs for ARM7TDMI with SoClib = Before compiling a program for the ARM7TDMI with the SoClib framework you will need to define some system variables (usually on the ~/.soclib/soft_compilers.conf) needed to find the ARM compiler. Below you have an example: {{{ arm7tdmi_CC_PREFIX = armv5b-softfloat-linux- arm7tdmi_CFLAGS = -nostdinc -gstabs+ arm7tdmi_LDFLAGS = -nostdlib }}}