Initial commit
This commit is contained in:
		
							
								
								
									
										35
									
								
								Libs/RiscV/NEORV32/rtl/processor_templates/README.md
									
									
									
									
									
										Normal file
									
								
							
							
						
						
									
										35
									
								
								Libs/RiscV/NEORV32/rtl/processor_templates/README.md
									
									
									
									
									
										Normal file
									
								
							| @@ -0,0 +1,35 @@ | ||||
| # SoC/Processor Templates | ||||
|  | ||||
| This folder provides exemplary templates that wrap the processor top entity and provide a simplified | ||||
| set of configuration generics and IOs. These setups are intended to allow beginner an easy start by | ||||
| hiding much of the processor's configuration complexity. Furthermore, these setups are used by many | ||||
| of the provided [example setups](https://github.com/stnolting/neorv32/tree/master/setups). | ||||
|  | ||||
| Alternatively, you can directly instantiate the processor's top entity | ||||
| [`rtl/core/neorv32_top.vhd`](https://github.com/stnolting/neorv32/blob/master/rtl/core/neorv32_top.vhd) | ||||
| to have full access to _all_ features. | ||||
|  | ||||
| ### [`neorv32_ProcessorTop_Minimal.vhd`](https://github.com/stnolting/neorv32/blob/master/rtl/processor_templates/neorv32_ProcessorTop_Minimal.vhd) | ||||
|  | ||||
| This setup used the ["Direct Boot Configuration"](https://stnolting.github.io/neorv32/#_boot_configuration). | ||||
| Application software is installed directly into the processor-internal instruction memory (IMEM) during | ||||
| synthesis. This memory is implemented as ROM and these is no bootloader available. Hence, the executable | ||||
| remains unchangeable is executed right after reset. | ||||
|  | ||||
| The setup only provides 3 PWM channels as IO. | ||||
|  | ||||
| ### [`neorv32_ProcessorTop_MinimalBoot.vhd`](https://github.com/stnolting/neorv32/blob/master/rtl/processor_templates/neorv32_ProcessorTop_MinimalBoot.vhd) | ||||
|  | ||||
| This setup used the ["Indirect Boot Configuration"](https://stnolting.github.io/neorv32/#_boot_configuration). | ||||
| The NEORV32 bootloader is enabled in this setup allowing to upload new application software at any time | ||||
| via a UART connection. | ||||
|  | ||||
| The setup provides 8 GPIO outputs and the UART communication lines as IO. | ||||
|  | ||||
| ### [`neorv32_ProcessorTop_UP5KDemo.vhd`](https://github.com/stnolting/neorv32/blob/master/rtl/processor_templates/neorv32_ProcessorTop_UP5KDemo.vhd) | ||||
|  | ||||
| This is a more complex template that implements a small microcontroller-like NEORV32. | ||||
| It was originally designed for _UPDuino V3_ board, which features a Lattice iCE40up5k FPGA, but has | ||||
| also been ported to other boards that provide the same FPGA. | ||||
|  | ||||
| This setup provides a rich set of IOs including GPIO, SPI, TWI and PWM. | ||||
| @@ -0,0 +1,246 @@ | ||||
| -- ################################################################################################# | ||||
| -- # << NEORV32 - Minimal setup without a bootloader >>                                            # | ||||
| -- # ********************************************************************************************* # | ||||
| -- # BSD 3-Clause License                                                                          # | ||||
| -- #                                                                                               # | ||||
| -- # Copyright (c) 2021, Stephan Nolting. All rights reserved.                                     # | ||||
| -- #                                                                                               # | ||||
| -- # Redistribution and use in source and binary forms, with or without modification, are          # | ||||
| -- # permitted provided that the following conditions are met:                                     # | ||||
| -- #                                                                                               # | ||||
| -- # 1. Redistributions of source code must retain the above copyright notice, this list of        # | ||||
| -- #    conditions and the following disclaimer.                                                   # | ||||
| -- #                                                                                               # | ||||
| -- # 2. Redistributions in binary form must reproduce the above copyright notice, this list of     # | ||||
| -- #    conditions and the following disclaimer in the documentation and/or other materials        # | ||||
| -- #    provided with the distribution.                                                            # | ||||
| -- #                                                                                               # | ||||
| -- # 3. Neither the name of the copyright holder nor the names of its contributors may be used to  # | ||||
| -- #    endorse or promote products derived from this software without specific prior written      # | ||||
| -- #    permission.                                                                                # | ||||
| -- #                                                                                               # | ||||
| -- # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS   # | ||||
| -- # OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF               # | ||||
| -- # MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE    # | ||||
| -- # COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,     # | ||||
| -- # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE # | ||||
| -- # GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED    # | ||||
| -- # AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING     # | ||||
| -- # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED  # | ||||
| -- # OF THE POSSIBILITY OF SUCH DAMAGE.                                                            # | ||||
| -- # ********************************************************************************************* # | ||||
| -- # The NEORV32 Processor - https://github.com/stnolting/neorv32              (c) Stephan Nolting # | ||||
| -- ################################################################################################# | ||||
|  | ||||
| library ieee; | ||||
| use ieee.std_logic_1164.all; | ||||
| use ieee.numeric_std.all; | ||||
|  | ||||
| library neorv32; | ||||
|  | ||||
| entity neorv32_ProcessorTop_Minimal is | ||||
|   generic ( | ||||
|     CLOCK_FREQUENCY              : natural := 0;      -- clock frequency of clk_i in Hz | ||||
|     HW_THREAD_ID                 : natural := 0;      -- hardware thread id (32-bit) | ||||
|  | ||||
|     -- RISC-V CPU Extensions -- | ||||
|     CPU_EXTENSION_RISCV_A        : boolean := false;  -- implement atomic extension? | ||||
|     CPU_EXTENSION_RISCV_C        : boolean := false;  -- implement compressed extension? | ||||
|     CPU_EXTENSION_RISCV_E        : boolean := false;  -- implement embedded RF extension? | ||||
|     CPU_EXTENSION_RISCV_M        : boolean := false;  -- implement mul/div extension? | ||||
|     CPU_EXTENSION_RISCV_U        : boolean := false;  -- implement user mode extension? | ||||
|     CPU_EXTENSION_RISCV_Zfinx    : boolean := false;  -- implement 32-bit floating-point extension (using INT regs!) | ||||
|     CPU_EXTENSION_RISCV_Zicsr    : boolean := true;   -- implement CSR system? | ||||
|     CPU_EXTENSION_RISCV_Zifencei : boolean := false;  -- implement instruction stream sync.? | ||||
|  | ||||
|     -- Extension Options -- | ||||
|     FAST_MUL_EN                  : boolean := false;  -- use DSPs for M extension's multiplier | ||||
|     FAST_SHIFT_EN                : boolean := false;  -- use barrel shifter for shift operations | ||||
|     CPU_CNT_WIDTH                : natural := 34;     -- total width of CPU cycle and instret counters (0..64) | ||||
|  | ||||
|     -- Physical Memory Protection (PMP) -- | ||||
|     PMP_NUM_REGIONS              : natural := 0;       -- number of regions (0..64) | ||||
|     PMP_MIN_GRANULARITY          : natural := 8*1024;  -- minimal region granularity in bytes, has to be a power of 2, min 8 bytes | ||||
|  | ||||
|     -- Hardware Performance Monitors (HPM) -- | ||||
|     HPM_NUM_CNTS                 : natural := 0;       -- number of implemented HPM counters (0..29) | ||||
|     HPM_CNT_WIDTH                : natural := 40;      -- total size of HPM counters (0..64) | ||||
|  | ||||
|     -- Internal Instruction memory -- | ||||
|     MEM_INT_IMEM_EN              : boolean := true;    -- implement processor-internal instruction memory | ||||
|     MEM_INT_IMEM_SIZE            : natural := 8*1024;  -- size of processor-internal instruction memory in bytes | ||||
|  | ||||
|     -- Internal Data memory -- | ||||
|     MEM_INT_DMEM_EN              : boolean := true;    -- implement processor-internal data memory | ||||
|     MEM_INT_DMEM_SIZE            : natural := 64*1024; -- size of processor-internal data memory in bytes | ||||
|  | ||||
|     -- Internal Cache memory -- | ||||
|     ICACHE_EN                    : boolean := false;  -- implement instruction cache | ||||
|     ICACHE_NUM_BLOCKS            : natural := 4;      -- i-cache: number of blocks (min 1), has to be a power of 2 | ||||
|     ICACHE_BLOCK_SIZE            : natural := 64;     -- i-cache: block size in bytes (min 4), has to be a power of 2 | ||||
|     ICACHE_ASSOCIATIVITY         : natural := 1;      -- i-cache: associativity / number of sets (1=direct_mapped), has to be a power of 2 | ||||
|  | ||||
|     -- Processor peripherals -- | ||||
|     IO_MTIME_EN                  : boolean := false;  -- implement machine system timer (MTIME)? | ||||
|     IO_PWM_NUM_CH                : natural := 3;      -- number of PWM channels to implement (0..60); 0 = disabled | ||||
|     IO_WDT_EN                    : boolean := false   -- implement watch dog timer (WDT)? | ||||
|   ); | ||||
|   port ( | ||||
|     clk_i      : in  std_logic; | ||||
|     rstn_i     : in  std_logic; | ||||
|  | ||||
|     -- PWM (available if IO_PWM_NUM_CH > 0) -- | ||||
|     pwm_o      : out std_ulogic_vector(IO_PWM_NUM_CH-1 downto 0) | ||||
|   ); | ||||
| end entity; | ||||
|  | ||||
| architecture neorv32_ProcessorTop_Minimal_rtl of neorv32_ProcessorTop_Minimal is | ||||
|  | ||||
| begin | ||||
|  | ||||
|   -- The core of the problem ---------------------------------------------------------------- | ||||
|   -- ------------------------------------------------------------------------------------------- | ||||
|   neorv32_inst: entity neorv32.neorv32_top | ||||
|   generic map ( | ||||
|     -- General -- | ||||
|     CLOCK_FREQUENCY              => CLOCK_FREQUENCY,  -- clock frequency of clk_i in Hz | ||||
|     INT_BOOTLOADER_EN            => false,            -- boot configuration: true = boot explicit bootloader; false = boot from int/ext (I)MEM | ||||
|     HW_THREAD_ID                 => HW_THREAD_ID,     -- hardware thread id (32-bit) | ||||
|  | ||||
|     -- On-Chip Debugger (OCD) -- | ||||
|     ON_CHIP_DEBUGGER_EN          => false,  -- implement on-chip debugger? | ||||
|  | ||||
|     -- RISC-V CPU Extensions -- | ||||
|     CPU_EXTENSION_RISCV_A        => CPU_EXTENSION_RISCV_A,         -- implement atomic extension? | ||||
|     CPU_EXTENSION_RISCV_C        => CPU_EXTENSION_RISCV_C,         -- implement compressed extension? | ||||
|     CPU_EXTENSION_RISCV_E        => CPU_EXTENSION_RISCV_E,         -- implement embedded RF extension? | ||||
|     CPU_EXTENSION_RISCV_M        => CPU_EXTENSION_RISCV_M,         -- implement mul/div extension? | ||||
|     CPU_EXTENSION_RISCV_U        => CPU_EXTENSION_RISCV_U,         -- implement user mode extension? | ||||
|     CPU_EXTENSION_RISCV_Zfinx    => CPU_EXTENSION_RISCV_Zfinx,     -- implement 32-bit floating-point extension (using INT regs!) | ||||
|     CPU_EXTENSION_RISCV_Zicsr    => CPU_EXTENSION_RISCV_Zicsr,     -- implement CSR system? | ||||
|     CPU_EXTENSION_RISCV_Zicntr   => true,                          -- implement base counters? | ||||
|     CPU_EXTENSION_RISCV_Zifencei => CPU_EXTENSION_RISCV_Zifencei,  -- implement instruction stream sync.? | ||||
|  | ||||
|     -- Extension Options -- | ||||
|     FAST_MUL_EN                  => FAST_MUL_EN,    -- use DSPs for M extension's multiplier | ||||
|     FAST_SHIFT_EN                => FAST_SHIFT_EN,  -- use barrel shifter for shift operations | ||||
|     CPU_CNT_WIDTH                => CPU_CNT_WIDTH,  -- total width of CPU cycle and instret counters (0..64) | ||||
|  | ||||
|     -- Physical Memory Protection (PMP) -- | ||||
|     PMP_NUM_REGIONS              => PMP_NUM_REGIONS,       -- number of regions (0..64) | ||||
|     PMP_MIN_GRANULARITY          => PMP_MIN_GRANULARITY,   -- minimal region granularity in bytes, has to be a power of 2, min 8 bytes | ||||
|  | ||||
|     -- Hardware Performance Monitors (HPM) -- | ||||
|     HPM_NUM_CNTS                 => HPM_NUM_CNTS,          -- number of implemented HPM counters (0..29) | ||||
|     HPM_CNT_WIDTH                => HPM_CNT_WIDTH,         -- total size of HPM counters (1..64) | ||||
|  | ||||
|     -- Internal Instruction memory -- | ||||
|     MEM_INT_IMEM_EN              => MEM_INT_IMEM_EN,       -- implement processor-internal instruction memory | ||||
|     MEM_INT_IMEM_SIZE            => MEM_INT_IMEM_SIZE,     -- size of processor-internal instruction memory in bytes | ||||
|  | ||||
|     -- Internal Data memory -- | ||||
|     MEM_INT_DMEM_EN              => MEM_INT_DMEM_EN,       -- implement processor-internal data memory | ||||
|     MEM_INT_DMEM_SIZE            => MEM_INT_DMEM_SIZE,     -- size of processor-internal data memory in bytes | ||||
|  | ||||
|     -- Internal Cache memory -- | ||||
|     ICACHE_EN                    => ICACHE_EN,             -- implement instruction cache | ||||
|     ICACHE_NUM_BLOCKS            => ICACHE_NUM_BLOCKS,     -- i-cache: number of blocks (min 1), has to be a power of 2 | ||||
|     ICACHE_BLOCK_SIZE            => ICACHE_BLOCK_SIZE,     -- i-cache: block size in bytes (min 4), has to be a power of 2 | ||||
|     ICACHE_ASSOCIATIVITY         => ICACHE_ASSOCIATIVITY,  -- i-cache: associativity / number of sets (1=direct_mapped), has to be a power of 2 | ||||
|  | ||||
|     -- External memory interface -- | ||||
|     MEM_EXT_EN                   => false,       -- implement external memory bus interface? | ||||
|     MEM_EXT_TIMEOUT              => 0,           -- cycles after a pending bus access auto-terminates (0 = disabled) | ||||
|  | ||||
|     -- Processor peripherals -- | ||||
|     IO_GPIO_EN                   => false,         -- implement general purpose input/output port unit (GPIO)? | ||||
|     IO_MTIME_EN                  => IO_MTIME_EN,   -- implement machine system timer (MTIME)? | ||||
|     IO_UART0_EN                  => false,         -- implement primary universal asynchronous receiver/transmitter (UART0)? | ||||
|     IO_UART1_EN                  => false,         -- implement secondary universal asynchronous receiver/transmitter (UART1)? | ||||
|     IO_SPI_EN                    => false,         -- implement serial peripheral interface (SPI)? | ||||
|     IO_TWI_EN                    => false,         -- implement two-wire interface (TWI)? | ||||
|     IO_PWM_NUM_CH                => IO_PWM_NUM_CH, -- number of PWM channels to implement (0..60); 0 = disabled | ||||
|     IO_WDT_EN                    => IO_WDT_EN,     -- implement watch dog timer (WDT)? | ||||
|     IO_TRNG_EN                   => false,         -- implement true random number generator (TRNG)? | ||||
|     IO_CFS_EN                    => false,         -- implement custom functions subsystem (CFS)? | ||||
|     IO_CFS_CONFIG                => x"00000000",   -- custom CFS configuration generic | ||||
|     IO_CFS_IN_SIZE               => 32,            -- size of CFS input conduit in bits | ||||
|     IO_CFS_OUT_SIZE              => 32,            -- size of CFS output conduit in bits | ||||
|     IO_NEOLED_EN                 => false          -- implement NeoPixel-compatible smart LED interface (NEOLED)? | ||||
|   ) | ||||
|   port map ( | ||||
|     -- Global control -- | ||||
|     clk_i       => clk_i,                        -- global clock, rising edge | ||||
|     rstn_i      => rstn_i,                       -- global reset, low-active, async | ||||
|  | ||||
|     -- JTAG on-chip debugger interface (available if ON_CHIP_DEBUGGER_EN = true) -- | ||||
|     jtag_trst_i => '0',                          -- low-active TAP reset (optional) | ||||
|     jtag_tck_i  => '0',                          -- serial clock | ||||
|     jtag_tdi_i  => '0',                          -- serial data input | ||||
|     jtag_tdo_o  => open,                         -- serial data output | ||||
|     jtag_tms_i  => '0',                          -- mode select | ||||
|  | ||||
|     -- Wishbone bus interface (available if MEM_EXT_EN = true) -- | ||||
|     wb_tag_o    => open,                         -- request tag | ||||
|     wb_adr_o    => open,                         -- address | ||||
|     wb_dat_i    => (others => '0'),              -- read data | ||||
|     wb_dat_o    => open,                         -- write data | ||||
|     wb_we_o     => open,                         -- read/write | ||||
|     wb_sel_o    => open,                         -- byte enable | ||||
|     wb_stb_o    => open,                         -- strobe | ||||
|     wb_cyc_o    => open,                         -- valid cycle | ||||
|     wb_lock_o   => open,                         -- exclusive access request | ||||
|     wb_ack_i    => '0',                          -- transfer acknowledge | ||||
|     wb_err_i    => '0',                          -- transfer error | ||||
|  | ||||
|     -- Advanced memory control signals (available if MEM_EXT_EN = true) -- | ||||
|     fence_o     => open,                         -- indicates an executed FENCE operation | ||||
|     fencei_o    => open,                         -- indicates an executed FENCEI operation | ||||
|  | ||||
|     -- GPIO (available if IO_GPIO_EN = true) -- | ||||
|     gpio_o      => open,                         -- parallel output | ||||
|     gpio_i      => (others => '0'),              -- parallel input | ||||
|  | ||||
|     -- primary UART0 (available if IO_UART0_EN = true) -- | ||||
|     uart0_txd_o => open,                         -- UART0 send data | ||||
|     uart0_rxd_i => '0',                          -- UART0 receive data | ||||
|     uart0_rts_o => open,                         -- hw flow control: UART0.RX ready to receive ("RTR"), low-active, optional | ||||
|     uart0_cts_i => '0',                          -- hw flow control: UART0.TX allowed to transmit, low-active, optional | ||||
|  | ||||
|     -- secondary UART1 (available if IO_UART1_EN = true) -- | ||||
|     uart1_txd_o => open,                         -- UART1 send data | ||||
|     uart1_rxd_i => '0',                          -- UART1 receive data | ||||
|     uart1_rts_o => open,                         -- hw flow control: UART1.RX ready to receive ("RTR"), low-active, optional | ||||
|     uart1_cts_i => '0',                          -- hw flow control: UART1.TX allowed to transmit, low-active, optional | ||||
|  | ||||
|     -- SPI (available if IO_SPI_EN = true) -- | ||||
|     spi_sck_o   => open,                         -- SPI serial clock | ||||
|     spi_sdo_o   => open,                         -- controller data out, peripheral data in | ||||
|     spi_sdi_i   => '0',                          -- controller data in, peripheral data out | ||||
|     spi_csn_o   => open,                         -- SPI CS | ||||
|  | ||||
|     -- TWI (available if IO_TWI_EN = true) -- | ||||
|     twi_sda_io  => open,                         -- twi serial data line | ||||
|     twi_scl_io  => open,                         -- twi serial clock line | ||||
|  | ||||
|     -- PWM (available if IO_PWM_NUM_CH > 0) -- | ||||
|     pwm_o       => pwm_o,                        -- pwm channels | ||||
|  | ||||
|     -- Custom Functions Subsystem IO -- | ||||
|     cfs_in_i    => (others => '0'),              -- custom CFS inputs conduit | ||||
|     cfs_out_o   => open,                         -- custom CFS outputs conduit | ||||
|  | ||||
|     -- NeoPixel-compatible smart LED interface (available if IO_NEOLED_EN = true) -- | ||||
|     neoled_o    => open,                         -- async serial data line | ||||
|  | ||||
|     -- System time -- | ||||
|     mtime_i     => (others => '0'),              -- current system time from ext. MTIME (if IO_MTIME_EN = false) | ||||
|     mtime_o     => open,                         -- current system time from int. MTIME (if IO_MTIME_EN = true) | ||||
|  | ||||
|     -- Interrupts -- | ||||
|     mtime_irq_i => '0',                          -- machine timer interrupt, available if IO_MTIME_EN = false | ||||
|     msw_irq_i   => '0',                          -- machine software interrupt | ||||
|     mext_irq_i  => '0'                           -- machine external interrupt | ||||
|   ); | ||||
|  | ||||
| end architecture; | ||||
| @@ -0,0 +1,267 @@ | ||||
| -- ################################################################################################# | ||||
| -- # << NEORV32 - Minimal setup with the bootloader enabled >>                                     # | ||||
| -- # ********************************************************************************************* # | ||||
| -- # BSD 3-Clause License                                                                          # | ||||
| -- #                                                                                               # | ||||
| -- # Copyright (c) 2021, Stephan Nolting. All rights reserved.                                     # | ||||
| -- #                                                                                               # | ||||
| -- # Redistribution and use in source and binary forms, with or without modification, are          # | ||||
| -- # permitted provided that the following conditions are met:                                     # | ||||
| -- #                                                                                               # | ||||
| -- # 1. Redistributions of source code must retain the above copyright notice, this list of        # | ||||
| -- #    conditions and the following disclaimer.                                                   # | ||||
| -- #                                                                                               # | ||||
| -- # 2. Redistributions in binary form must reproduce the above copyright notice, this list of     # | ||||
| -- #    conditions and the following disclaimer in the documentation and/or other materials        # | ||||
| -- #    provided with the distribution.                                                            # | ||||
| -- #                                                                                               # | ||||
| -- # 3. Neither the name of the copyright holder nor the names of its contributors may be used to  # | ||||
| -- #    endorse or promote products derived from this software without specific prior written      # | ||||
| -- #    permission.                                                                                # | ||||
| -- #                                                                                               # | ||||
| -- # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS   # | ||||
| -- # OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF               # | ||||
| -- # MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE    # | ||||
| -- # COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,     # | ||||
| -- # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE # | ||||
| -- # GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED    # | ||||
| -- # AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING     # | ||||
| -- # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED  # | ||||
| -- # OF THE POSSIBILITY OF SUCH DAMAGE.                                                            # | ||||
| -- # ********************************************************************************************* # | ||||
| -- # The NEORV32 Processor - https://github.com/stnolting/neorv32              (c) Stephan Nolting # | ||||
| -- ################################################################################################# | ||||
|  | ||||
| library ieee; | ||||
| use ieee.std_logic_1164.all; | ||||
| use ieee.numeric_std.all; | ||||
|  | ||||
| library neorv32; | ||||
|  | ||||
| entity neorv32_ProcessorTop_MinimalBoot is | ||||
|   generic ( | ||||
|     CLOCK_FREQUENCY              : natural := 0;      -- clock frequency of clk_i in Hz | ||||
|     INT_BOOTLOADER_EN            : boolean := true;   -- boot configuration: true = boot explicit bootloader; false = boot from int/ext (I)MEM | ||||
|     HW_THREAD_ID                 : natural := 0;      -- hardware thread id (32-bit) | ||||
|  | ||||
|     -- RISC-V CPU Extensions -- | ||||
|     CPU_EXTENSION_RISCV_A        : boolean := true;   -- implement atomic extension? | ||||
|     CPU_EXTENSION_RISCV_C        : boolean := true;   -- implement compressed extension? | ||||
|     CPU_EXTENSION_RISCV_E        : boolean := false;  -- implement embedded RF extension? | ||||
|     CPU_EXTENSION_RISCV_M        : boolean := true;   -- implement mul/div extension? | ||||
|     CPU_EXTENSION_RISCV_U        : boolean := false;  -- implement user mode extension? | ||||
|     CPU_EXTENSION_RISCV_Zfinx    : boolean := false;  -- implement 32-bit floating-point extension (using INT regs!) | ||||
|     CPU_EXTENSION_RISCV_Zicsr    : boolean := true;   -- implement CSR system? | ||||
|     CPU_EXTENSION_RISCV_Zifencei : boolean := false;  -- implement instruction stream sync.? | ||||
|  | ||||
|     -- Extension Options -- | ||||
|     FAST_MUL_EN                  : boolean := false;  -- use DSPs for M extension's multiplier | ||||
|     FAST_SHIFT_EN                : boolean := false;  -- use barrel shifter for shift operations | ||||
|     CPU_CNT_WIDTH                : natural := 34;     -- total width of CPU cycle and instret counters (0..64) | ||||
|  | ||||
|     -- Physical Memory Protection (PMP) -- | ||||
|     PMP_NUM_REGIONS              : natural := 0;       -- number of regions (0..64) | ||||
|     PMP_MIN_GRANULARITY          : natural := 64*1024; -- minimal region granularity in bytes, has to be a power of 2, min 8 bytes | ||||
|  | ||||
|     -- Hardware Performance Monitors (HPM) -- | ||||
|     HPM_NUM_CNTS                 : natural := 0;       -- number of implemented HPM counters (0..29) | ||||
|     HPM_CNT_WIDTH                : natural := 40;      -- total size of HPM counters (0..64) | ||||
|  | ||||
|     -- Internal Instruction memory -- | ||||
|     MEM_INT_IMEM_EN              : boolean := true;    -- implement processor-internal instruction memory | ||||
|     MEM_INT_IMEM_SIZE            : natural := 64*1024; -- size of processor-internal instruction memory in bytes | ||||
|  | ||||
|     -- Internal Data memory -- | ||||
|     MEM_INT_DMEM_EN              : boolean := true;    -- implement processor-internal data memory | ||||
|     MEM_INT_DMEM_SIZE            : natural := 64*1024; -- size of processor-internal data memory in bytes | ||||
|  | ||||
|     -- Internal Cache memory -- | ||||
|     ICACHE_EN                    : boolean := false;  -- implement instruction cache | ||||
|     ICACHE_NUM_BLOCKS            : natural := 4;      -- i-cache: number of blocks (min 1), has to be a power of 2 | ||||
|     ICACHE_BLOCK_SIZE            : natural := 64;     -- i-cache: block size in bytes (min 4), has to be a power of 2 | ||||
|     ICACHE_ASSOCIATIVITY         : natural := 1;      -- i-cache: associativity / number of sets (1=direct_mapped), has to be a power of 2 | ||||
|  | ||||
|     -- Processor peripherals -- | ||||
|     IO_GPIO_EN                   : boolean := true;   -- implement general purpose input/output port unit (GPIO)? | ||||
|     IO_MTIME_EN                  : boolean := true;   -- implement machine system timer (MTIME)? | ||||
|     IO_UART0_EN                  : boolean := true;   -- implement primary universal asynchronous receiver/transmitter (UART0)? | ||||
|     IO_PWM_NUM_CH                : natural := 3;      -- number of PWM channels to implement (0..60); 0 = disabled | ||||
|     IO_WDT_EN                    : boolean := true    -- implement watch dog timer (WDT)? | ||||
|   ); | ||||
|   port ( | ||||
|     clk_i      : in  std_logic; | ||||
|     rstn_i     : in  std_logic; | ||||
|  | ||||
|     -- GPIO (available if IO_GPIO_EN = true) -- | ||||
|     gpio_o     : out std_ulogic_vector(3 downto 0); | ||||
|  | ||||
|     -- primary UART0 (available if IO_UART0_EN = true) -- | ||||
|     uart_txd_o : out std_ulogic; -- UART0 send data | ||||
|     uart_rxd_i : in  std_ulogic := '0'; -- UART0 receive data | ||||
|     uart_rts_o : out std_ulogic; -- hw flow control: UART0.RX ready to receive ("RTR"), low-active, optional | ||||
|     uart_cts_i : in  std_ulogic := '0'; -- hw flow control: UART0.TX allowed to transmit, low-active, optional | ||||
|  | ||||
|     -- PWM (available if IO_PWM_NUM_CH > 0) -- | ||||
|     pwm_o      : out std_ulogic_vector(IO_PWM_NUM_CH-1 downto 0) | ||||
|   ); | ||||
| end entity; | ||||
|  | ||||
| architecture neorv32_ProcessorTop_MinimalBoot_rtl of neorv32_ProcessorTop_MinimalBoot is | ||||
|  | ||||
|   -- internal IO connection -- | ||||
|   signal con_gpio_o : std_ulogic_vector(63 downto 0); | ||||
|  | ||||
| begin | ||||
|  | ||||
|   -- IO Connection -------------------------------------------------------------------------- | ||||
|   -- ------------------------------------------------------------------------------------------- | ||||
|  | ||||
|   -- GPIO -- | ||||
|   gpio_o <= con_gpio_o(3 downto 0); | ||||
|  | ||||
|   -- The core of the problem ---------------------------------------------------------------- | ||||
|   -- ------------------------------------------------------------------------------------------- | ||||
|   neorv32_inst: entity neorv32.neorv32_top | ||||
|   generic map ( | ||||
|     -- General -- | ||||
|     CLOCK_FREQUENCY              => CLOCK_FREQUENCY,  -- clock frequency of clk_i in Hz | ||||
|     INT_BOOTLOADER_EN            => INT_BOOTLOADER_EN,-- boot configuration: true = boot explicit bootloader; false = boot from int/ext (I)MEM | ||||
|     HW_THREAD_ID                 => HW_THREAD_ID,     -- hardware thread id (32-bit) | ||||
|  | ||||
|     -- On-Chip Debugger (OCD) -- | ||||
|     ON_CHIP_DEBUGGER_EN          => false,  -- implement on-chip debugger? | ||||
|  | ||||
|     -- RISC-V CPU Extensions -- | ||||
|     CPU_EXTENSION_RISCV_A        => CPU_EXTENSION_RISCV_A,         -- implement atomic extension? | ||||
|     CPU_EXTENSION_RISCV_C        => CPU_EXTENSION_RISCV_C,         -- implement compressed extension? | ||||
|     CPU_EXTENSION_RISCV_E        => CPU_EXTENSION_RISCV_E,         -- implement embedded RF extension? | ||||
|     CPU_EXTENSION_RISCV_M        => CPU_EXTENSION_RISCV_M,         -- implement mul/div extension? | ||||
|     CPU_EXTENSION_RISCV_U        => CPU_EXTENSION_RISCV_U,         -- implement user mode extension? | ||||
|     CPU_EXTENSION_RISCV_Zfinx    => CPU_EXTENSION_RISCV_Zfinx,     -- implement 32-bit floating-point extension (using INT regs!) | ||||
|     CPU_EXTENSION_RISCV_Zicsr    => CPU_EXTENSION_RISCV_Zicsr,     -- implement CSR system? | ||||
|     CPU_EXTENSION_RISCV_Zicntr   => true,                          -- implement base counters? | ||||
|     CPU_EXTENSION_RISCV_Zifencei => CPU_EXTENSION_RISCV_Zifencei,  -- implement instruction stream sync.? | ||||
|  | ||||
|     -- Extension Options -- | ||||
|     FAST_MUL_EN                  => FAST_MUL_EN,    -- use DSPs for M extension's multiplier | ||||
|     FAST_SHIFT_EN                => FAST_SHIFT_EN,  -- use barrel shifter for shift operations | ||||
|     CPU_CNT_WIDTH                => CPU_CNT_WIDTH,  -- total width of CPU cycle and instret counters (0..64) | ||||
|  | ||||
|     -- Physical Memory Protection (PMP) -- | ||||
|     PMP_NUM_REGIONS              => PMP_NUM_REGIONS,       -- number of regions (0..64) | ||||
|     PMP_MIN_GRANULARITY          => PMP_MIN_GRANULARITY,   -- minimal region granularity in bytes, has to be a power of 2, min 8 bytes | ||||
|  | ||||
|     -- Hardware Performance Monitors (HPM) -- | ||||
|     HPM_NUM_CNTS                 => HPM_NUM_CNTS,          -- number of implemented HPM counters (0..29) | ||||
|     HPM_CNT_WIDTH                => HPM_CNT_WIDTH,         -- total size of HPM counters (1..64) | ||||
|  | ||||
|     -- Internal Instruction memory -- | ||||
|     MEM_INT_IMEM_EN              => MEM_INT_IMEM_EN,       -- implement processor-internal instruction memory | ||||
|     MEM_INT_IMEM_SIZE            => MEM_INT_IMEM_SIZE,     -- size of processor-internal instruction memory in bytes | ||||
|  | ||||
|     -- Internal Data memory -- | ||||
|     MEM_INT_DMEM_EN              => MEM_INT_DMEM_EN,       -- implement processor-internal data memory | ||||
|     MEM_INT_DMEM_SIZE            => MEM_INT_DMEM_SIZE,     -- size of processor-internal data memory in bytes | ||||
|  | ||||
|     -- Internal Cache memory -- | ||||
|     ICACHE_EN                    => ICACHE_EN,             -- implement instruction cache | ||||
|     ICACHE_NUM_BLOCKS            => ICACHE_NUM_BLOCKS,     -- i-cache: number of blocks (min 1), has to be a power of 2 | ||||
|     ICACHE_BLOCK_SIZE            => ICACHE_BLOCK_SIZE,     -- i-cache: block size in bytes (min 4), has to be a power of 2 | ||||
|     ICACHE_ASSOCIATIVITY         => ICACHE_ASSOCIATIVITY,  -- i-cache: associativity / number of sets (1=direct_mapped), has to be a power of 2 | ||||
|  | ||||
|     -- External memory interface -- | ||||
|     MEM_EXT_EN                   => false,       -- implement external memory bus interface? | ||||
|     MEM_EXT_TIMEOUT              => 0,           -- cycles after a pending bus access auto-terminates (0 = disabled) | ||||
|  | ||||
|     -- Processor peripherals -- | ||||
|     IO_GPIO_EN                   => IO_GPIO_EN,    -- implement general purpose input/output port unit (GPIO)? | ||||
|     IO_MTIME_EN                  => IO_MTIME_EN,   -- implement machine system timer (MTIME)? | ||||
|     IO_UART0_EN                  => IO_UART0_EN,   -- implement primary universal asynchronous receiver/transmitter (UART0)? | ||||
|     IO_UART1_EN                  => false,         -- implement secondary universal asynchronous receiver/transmitter (UART1)? | ||||
|     IO_SPI_EN                    => false,         -- implement serial peripheral interface (SPI)? | ||||
|     IO_TWI_EN                    => false,         -- implement two-wire interface (TWI)? | ||||
|     IO_PWM_NUM_CH                => IO_PWM_NUM_CH, -- number of PWM channels to implement (0..60); 0 = disabled | ||||
|     IO_WDT_EN                    => IO_WDT_EN,     -- implement watch dog timer (WDT)? | ||||
|     IO_TRNG_EN                   => false,         -- implement true random number generator (TRNG)? | ||||
|     IO_CFS_EN                    => false,         -- implement custom functions subsystem (CFS)? | ||||
|     IO_CFS_CONFIG                => x"00000000",   -- custom CFS configuration generic | ||||
|     IO_CFS_IN_SIZE               => 32,            -- size of CFS input conduit in bits | ||||
|     IO_CFS_OUT_SIZE              => 32,            -- size of CFS output conduit in bits | ||||
|     IO_NEOLED_EN                 => false          -- implement NeoPixel-compatible smart LED interface (NEOLED)? | ||||
|   ) | ||||
|   port map ( | ||||
|     -- Global control -- | ||||
|     clk_i       => clk_i,                        -- global clock, rising edge | ||||
|     rstn_i      => rstn_i,                       -- global reset, low-active, async | ||||
|  | ||||
|     -- JTAG on-chip debugger interface (available if ON_CHIP_DEBUGGER_EN = true) -- | ||||
|     jtag_trst_i => '0',                          -- low-active TAP reset (optional) | ||||
|     jtag_tck_i  => '0',                          -- serial clock | ||||
|     jtag_tdi_i  => '0',                          -- serial data input | ||||
|     jtag_tdo_o  => open,                         -- serial data output | ||||
|     jtag_tms_i  => '0',                          -- mode select | ||||
|  | ||||
|     -- Wishbone bus interface (available if MEM_EXT_EN = true) -- | ||||
|     wb_tag_o    => open,                         -- request tag | ||||
|     wb_adr_o    => open,                         -- address | ||||
|     wb_dat_i    => (others => '0'),              -- read data | ||||
|     wb_dat_o    => open,                         -- write data | ||||
|     wb_we_o     => open,                         -- read/write | ||||
|     wb_sel_o    => open,                         -- byte enable | ||||
|     wb_stb_o    => open,                         -- strobe | ||||
|     wb_cyc_o    => open,                         -- valid cycle | ||||
|     wb_lock_o   => open,                         -- exclusive access request | ||||
|     wb_ack_i    => '0',                          -- transfer acknowledge | ||||
|     wb_err_i    => '0',                          -- transfer error | ||||
|  | ||||
|     -- Advanced memory control signals (available if MEM_EXT_EN = true) -- | ||||
|     fence_o     => open,                         -- indicates an executed FENCE operation | ||||
|     fencei_o    => open,                         -- indicates an executed FENCEI operation | ||||
|  | ||||
|     -- GPIO (available if IO_GPIO_EN = true) -- | ||||
|     gpio_o      => con_gpio_o,                   -- parallel output | ||||
|     gpio_i      => (others => '0'),              -- parallel input | ||||
|  | ||||
|     -- primary UART0 (available if IO_UART0_EN = true) -- | ||||
|     uart0_txd_o => uart_txd_o,                   -- UART0 send data | ||||
|     uart0_rxd_i => uart_rxd_i,                   -- UART0 receive data | ||||
|     uart0_rts_o => uart_rts_o,                   -- hw flow control: UART0.RX ready to receive ("RTR"), low-active, optional | ||||
|     uart0_cts_i => uart_cts_i,                   -- hw flow control: UART0.TX allowed to transmit, low-active, optional | ||||
|  | ||||
|     -- secondary UART1 (available if IO_UART1_EN = true) -- | ||||
|     uart1_txd_o => open,                         -- UART1 send data | ||||
|     uart1_rxd_i => '0',                          -- UART1 receive data | ||||
|     uart1_rts_o => open,                         -- hw flow control: UART1.RX ready to receive ("RTR"), low-active, optional | ||||
|     uart1_cts_i => '0',                          -- hw flow control: UART1.TX allowed to transmit, low-active, optional | ||||
|  | ||||
|     -- SPI (available if IO_SPI_EN = true) -- | ||||
|     spi_sck_o   => open,                         -- SPI serial clock | ||||
|     spi_sdo_o   => open,                         -- controller data out, peripheral data in | ||||
|     spi_sdi_i   => '0',                          -- controller data in, peripheral data out | ||||
|     spi_csn_o   => open,                         -- SPI CS | ||||
|  | ||||
|     -- TWI (available if IO_TWI_EN = true) -- | ||||
|     twi_sda_io  => open,                         -- twi serial data line | ||||
|     twi_scl_io  => open,                         -- twi serial clock line | ||||
|  | ||||
|     -- PWM (available if IO_PWM_NUM_CH > 0) -- | ||||
|     pwm_o       => pwm_o,                        -- pwm channels | ||||
|  | ||||
|     -- Custom Functions Subsystem IO -- | ||||
|     cfs_in_i    => (others => '0'),              -- custom CFS inputs conduit | ||||
|     cfs_out_o   => open,                         -- custom CFS outputs conduit | ||||
|  | ||||
|     -- NeoPixel-compatible smart LED interface (available if IO_NEOLED_EN = true) -- | ||||
|     neoled_o    => open,                         -- async serial data line | ||||
|  | ||||
|     -- System time -- | ||||
|     mtime_i     => (others => '0'),              -- current system time from ext. MTIME (if IO_MTIME_EN = false) | ||||
|     mtime_o     => open,                         -- current system time from int. MTIME (if IO_MTIME_EN = true) | ||||
|  | ||||
|     -- Interrupts -- | ||||
|     mtime_irq_i => '0',                          -- machine timer interrupt, available if IO_MTIME_EN = false | ||||
|     msw_irq_i   => '0',                          -- machine software interrupt | ||||
|     mext_irq_i  => '0'                           -- machine external interrupt | ||||
|   ); | ||||
|  | ||||
| end architecture; | ||||
| @@ -0,0 +1,307 @@ | ||||
| -- ################################################################################################# | ||||
| -- # << NEORV32 - Example setup for boards with UP5K devices >>                                    # | ||||
| -- # ********************************************************************************************* # | ||||
| -- # BSD 3-Clause License                                                                          # | ||||
| -- #                                                                                               # | ||||
| -- # Copyright (c) 2021, Stephan Nolting. All rights reserved.                                     # | ||||
| -- #                                                                                               # | ||||
| -- # Redistribution and use in source and binary forms, with or without modification, are          # | ||||
| -- # permitted provided that the following conditions are met:                                     # | ||||
| -- #                                                                                               # | ||||
| -- # 1. Redistributions of source code must retain the above copyright notice, this list of        # | ||||
| -- #    conditions and the following disclaimer.                                                   # | ||||
| -- #                                                                                               # | ||||
| -- # 2. Redistributions in binary form must reproduce the above copyright notice, this list of     # | ||||
| -- #    conditions and the following disclaimer in the documentation and/or other materials        # | ||||
| -- #    provided with the distribution.                                                            # | ||||
| -- #                                                                                               # | ||||
| -- # 3. Neither the name of the copyright holder nor the names of its contributors may be used to  # | ||||
| -- #    endorse or promote products derived from this software without specific prior written      # | ||||
| -- #    permission.                                                                                # | ||||
| -- #                                                                                               # | ||||
| -- # THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS   # | ||||
| -- # OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF               # | ||||
| -- # MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE    # | ||||
| -- # COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,     # | ||||
| -- # EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE # | ||||
| -- # GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED    # | ||||
| -- # AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING     # | ||||
| -- # NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED  # | ||||
| -- # OF THE POSSIBILITY OF SUCH DAMAGE.                                                            # | ||||
| -- # ********************************************************************************************* # | ||||
| -- # The NEORV32 Processor - https://github.com/stnolting/neorv32              (c) Stephan Nolting # | ||||
| -- ################################################################################################# | ||||
|  | ||||
| library ieee; | ||||
| use ieee.std_logic_1164.all; | ||||
| use ieee.numeric_std.all; | ||||
|  | ||||
| library neorv32; | ||||
|  | ||||
| entity neorv32_ProcessorTop_UP5KDemo is | ||||
|   generic ( | ||||
|     CLOCK_FREQUENCY              : natural := 0;      -- clock frequency of clk_i in Hz | ||||
|     HW_THREAD_ID                 : natural := 0;      -- hardware thread id (32-bit) | ||||
|  | ||||
|     -- On-Chip Debugger (OCD) -- | ||||
|     ON_CHIP_DEBUGGER_EN          : boolean := false;  -- implement on-chip debugger? | ||||
|  | ||||
|     -- RISC-V CPU Extensions -- | ||||
|     CPU_EXTENSION_RISCV_A        : boolean := true;   -- implement atomic extension? | ||||
|     CPU_EXTENSION_RISCV_C        : boolean := true;   -- implement compressed extension? | ||||
|     CPU_EXTENSION_RISCV_E        : boolean := false;  -- implement embedded RF extension? | ||||
|     CPU_EXTENSION_RISCV_M        : boolean := true;   -- implement mul/div extension? | ||||
|     CPU_EXTENSION_RISCV_U        : boolean := false;  -- implement user mode extension? | ||||
|     CPU_EXTENSION_RISCV_Zfinx    : boolean := false;  -- implement 32-bit floating-point extension (using INT regs!) | ||||
|     CPU_EXTENSION_RISCV_Zicsr    : boolean := true;   -- implement CSR system? | ||||
|     CPU_EXTENSION_RISCV_Zifencei : boolean := false;  -- implement instruction stream sync.? | ||||
|  | ||||
|     -- Extension Options -- | ||||
|     FAST_MUL_EN                  : boolean := false;  -- use DSPs for M extension's multiplier | ||||
|     FAST_SHIFT_EN                : boolean := false;  -- use barrel shifter for shift operations | ||||
|     CPU_CNT_WIDTH                : natural := 34;     -- total width of CPU cycle and instret counters (0..64) | ||||
|  | ||||
|     -- Physical Memory Protection (PMP) -- | ||||
|     PMP_NUM_REGIONS              : natural := 0;       -- number of regions (0..64) | ||||
|     PMP_MIN_GRANULARITY          : natural := 64*1024; -- minimal region granularity in bytes, has to be a power of 2, min 8 bytes | ||||
|  | ||||
|     -- Hardware Performance Monitors (HPM) -- | ||||
|     HPM_NUM_CNTS                 : natural := 0;       -- number of implemented HPM counters (0..29) | ||||
|     HPM_CNT_WIDTH                : natural := 40;      -- total size of HPM counters (0..64) | ||||
|  | ||||
|     -- Internal Instruction memory -- | ||||
|     MEM_INT_IMEM_EN              : boolean := true;    -- implement processor-internal instruction memory | ||||
|     MEM_INT_IMEM_SIZE            : natural := 64*1024; -- size of processor-internal instruction memory in bytes | ||||
|  | ||||
|     -- Internal Data memory -- | ||||
|     MEM_INT_DMEM_EN              : boolean := true;    -- implement processor-internal data memory | ||||
|     MEM_INT_DMEM_SIZE            : natural := 64*1024; -- size of processor-internal data memory in bytes | ||||
|  | ||||
|     -- Internal Cache memory -- | ||||
|     ICACHE_EN                    : boolean := false;  -- implement instruction cache | ||||
|     ICACHE_NUM_BLOCKS            : natural := 4;      -- i-cache: number of blocks (min 1), has to be a power of 2 | ||||
|     ICACHE_BLOCK_SIZE            : natural := 64;     -- i-cache: block size in bytes (min 4), has to be a power of 2 | ||||
|     ICACHE_ASSOCIATIVITY         : natural := 1;      -- i-cache: associativity / number of sets (1=direct_mapped), has to be a power of 2 | ||||
|  | ||||
|     -- Processor peripherals -- | ||||
|     IO_GPIO_EN                   : boolean := true;   -- implement general purpose input/output port unit (GPIO)? | ||||
|     IO_MTIME_EN                  : boolean := true;   -- implement machine system timer (MTIME)? | ||||
|     IO_UART0_EN                  : boolean := true;   -- implement primary universal asynchronous receiver/transmitter (UART0)? | ||||
|     IO_SPI_EN                    : boolean := true;   -- implement serial peripheral interface (SPI)? | ||||
|     IO_TWI_EN                    : boolean := true;   -- implement two-wire interface (TWI)? | ||||
|     IO_PWM_NUM_CH                : natural := 3;      -- number of PWM channels to implement (0..60); 0 = disabled | ||||
|     IO_WDT_EN                    : boolean := true    -- implement watch dog timer (WDT)? | ||||
|   ); | ||||
|   port ( | ||||
|     clk_i       : in  std_logic; | ||||
|     rstn_i      : in  std_logic; | ||||
|  | ||||
|     -- GPIO (available if IO_GPIO_EN = true) -- | ||||
|     gpio_i      : in  std_ulogic_vector(3 downto 0); | ||||
|     gpio_o      : out std_ulogic_vector(3 downto 0); | ||||
|  | ||||
|     -- primary UART0 (available if IO_UART0_EN = true) -- | ||||
|     uart_txd_o  : out std_ulogic; -- UART0 send data | ||||
|     uart_rxd_i  : in  std_ulogic := '0'; -- UART0 receive data | ||||
|     uart_rts_o  : out std_ulogic; -- hw flow control: UART0.RX ready to receive ("RTR"), low-active, optional | ||||
|     uart_cts_i  : in  std_ulogic := '0'; -- hw flow control: UART0.TX allowed to transmit, low-active, optional | ||||
|  | ||||
|     -- SPI to on-board flash -- | ||||
|     flash_sck_o : out std_ulogic; | ||||
|     flash_sdo_o : out std_ulogic; | ||||
|     flash_sdi_i : in  std_ulogic; | ||||
|     flash_csn_o : out std_ulogic; -- NEORV32.SPI_CS(0) | ||||
|  | ||||
|     -- SPI (available if IO_SPI_EN = true) -- | ||||
|     spi_sck_o   : out std_ulogic; | ||||
|     spi_sdo_o   : out std_ulogic; | ||||
|     spi_sdi_i   : in  std_ulogic; | ||||
|     spi_csn_o   : out std_ulogic; -- NEORV32.SPI_CS(1) | ||||
|  | ||||
|     -- TWI (available if IO_TWI_EN = true) -- | ||||
|     twi_sda_io  : inout std_logic; | ||||
|     twi_scl_io  : inout std_logic; | ||||
|  | ||||
|     -- PWM (available if IO_PWM_NUM_CH > 0) -- | ||||
|     pwm_o       : out std_ulogic_vector(IO_PWM_NUM_CH-1 downto 0) | ||||
|   ); | ||||
| end entity; | ||||
|  | ||||
| architecture neorv32_ProcessorTop_UP5KDemo_rtl of neorv32_ProcessorTop_UP5KDemo is | ||||
|  | ||||
|   -- internal IO connection -- | ||||
|   signal con_gpio_o   : std_ulogic_vector(63 downto 0); | ||||
|   signal con_gpio_i   : std_ulogic_vector(63 downto 0); | ||||
|   signal con_spi_sck  : std_ulogic; | ||||
|   signal con_spi_sdi  : std_ulogic; | ||||
|   signal con_spi_sdo  : std_ulogic; | ||||
|   signal con_spi_csn  : std_ulogic_vector(07 downto 0); | ||||
|  | ||||
| begin | ||||
|  | ||||
|   -- IO Connection -------------------------------------------------------------------------- | ||||
|   -- ------------------------------------------------------------------------------------------- | ||||
|  | ||||
|   -- SPI: on-board flash -- | ||||
|   flash_sck_o <= con_spi_sck; | ||||
|   flash_sdo_o <= con_spi_sdo; | ||||
|   flash_csn_o <= con_spi_csn(0); | ||||
|  | ||||
|   -- SPI: user port -- | ||||
|   spi_sck_o   <= con_spi_sck; | ||||
|   spi_sdo_o   <= con_spi_sdo; | ||||
|   spi_csn_o   <= con_spi_csn(1); | ||||
|  | ||||
|   con_spi_sdi <= flash_sdi_i when (con_spi_csn(0) = '0') else spi_sdi_i; | ||||
|  | ||||
|   -- GPIO -- | ||||
|   gpio_o <= con_gpio_o(3 downto 0); | ||||
|   con_gpio_i(03 downto 0) <= gpio_i; | ||||
|   con_gpio_i(63 downto 4) <= (others => '0'); | ||||
|  | ||||
|   -- The core of the problem ---------------------------------------------------------------- | ||||
|   -- ------------------------------------------------------------------------------------------- | ||||
|   neorv32_inst: entity neorv32.neorv32_top | ||||
|   generic map ( | ||||
|     -- General -- | ||||
|     CLOCK_FREQUENCY              => CLOCK_FREQUENCY,  -- clock frequency of clk_i in Hz | ||||
|     INT_BOOTLOADER_EN            => true,             -- boot configuration: true = boot explicit bootloader; false = boot from int/ext (I)MEM | ||||
|     HW_THREAD_ID                 => HW_THREAD_ID,     -- hardware thread id (32-bit) | ||||
|  | ||||
|     -- On-Chip Debugger (OCD) -- | ||||
|     ON_CHIP_DEBUGGER_EN          => ON_CHIP_DEBUGGER_EN,  -- implement on-chip debugger? | ||||
|  | ||||
|     -- RISC-V CPU Extensions -- | ||||
|     CPU_EXTENSION_RISCV_A        => CPU_EXTENSION_RISCV_A,         -- implement atomic extension? | ||||
|     CPU_EXTENSION_RISCV_C        => CPU_EXTENSION_RISCV_C,         -- implement compressed extension? | ||||
|     CPU_EXTENSION_RISCV_E        => CPU_EXTENSION_RISCV_E,         -- implement embedded RF extension? | ||||
|     CPU_EXTENSION_RISCV_M        => CPU_EXTENSION_RISCV_M,         -- implement mul/div extension? | ||||
|     CPU_EXTENSION_RISCV_U        => CPU_EXTENSION_RISCV_U,         -- implement user mode extension? | ||||
|     CPU_EXTENSION_RISCV_Zfinx    => CPU_EXTENSION_RISCV_Zfinx,     -- implement 32-bit floating-point extension (using INT regs!) | ||||
|     CPU_EXTENSION_RISCV_Zicsr    => CPU_EXTENSION_RISCV_Zicsr,     -- implement CSR system? | ||||
|     CPU_EXTENSION_RISCV_Zicntr   => true,                          -- implement base counters? | ||||
|     CPU_EXTENSION_RISCV_Zifencei => CPU_EXTENSION_RISCV_Zifencei,  -- implement instruction stream sync.? | ||||
|  | ||||
|     -- Extension Options -- | ||||
|     FAST_MUL_EN                  => FAST_MUL_EN,    -- use DSPs for M extension's multiplier | ||||
|     FAST_SHIFT_EN                => FAST_SHIFT_EN,  -- use barrel shifter for shift operations | ||||
|     CPU_CNT_WIDTH                => CPU_CNT_WIDTH,  -- total width of CPU cycle and instret counters (0..64) | ||||
|  | ||||
|     -- Physical Memory Protection (PMP) -- | ||||
|     PMP_NUM_REGIONS              => PMP_NUM_REGIONS,       -- number of regions (0..64) | ||||
|     PMP_MIN_GRANULARITY          => PMP_MIN_GRANULARITY,   -- minimal region granularity in bytes, has to be a power of 2, min 8 bytes | ||||
|  | ||||
|     -- Hardware Performance Monitors (HPM) -- | ||||
|     HPM_NUM_CNTS                 => HPM_NUM_CNTS,          -- number of implemented HPM counters (0..29) | ||||
|     HPM_CNT_WIDTH                => HPM_CNT_WIDTH,         -- total size of HPM counters (1..64) | ||||
|  | ||||
|     -- Internal Instruction memory -- | ||||
|     MEM_INT_IMEM_EN              => MEM_INT_IMEM_EN,       -- implement processor-internal instruction memory | ||||
|     MEM_INT_IMEM_SIZE            => MEM_INT_IMEM_SIZE,     -- size of processor-internal instruction memory in bytes | ||||
|  | ||||
|     -- Internal Data memory -- | ||||
|     MEM_INT_DMEM_EN              => MEM_INT_DMEM_EN,       -- implement processor-internal data memory | ||||
|     MEM_INT_DMEM_SIZE            => MEM_INT_DMEM_SIZE,     -- size of processor-internal data memory in bytes | ||||
|  | ||||
|     -- Internal Cache memory -- | ||||
|     ICACHE_EN                    => ICACHE_EN,             -- implement instruction cache | ||||
|     ICACHE_NUM_BLOCKS            => ICACHE_NUM_BLOCKS,     -- i-cache: number of blocks (min 1), has to be a power of 2 | ||||
|     ICACHE_BLOCK_SIZE            => ICACHE_BLOCK_SIZE,     -- i-cache: block size in bytes (min 4), has to be a power of 2 | ||||
|     ICACHE_ASSOCIATIVITY         => ICACHE_ASSOCIATIVITY,  -- i-cache: associativity / number of sets (1=direct_mapped), has to be a power of 2 | ||||
|  | ||||
|     -- External memory interface -- | ||||
|     MEM_EXT_EN                   => false,  -- implement external memory bus interface? | ||||
|     MEM_EXT_TIMEOUT              => 0,      -- cycles after a pending bus access auto-terminates (0 = disabled) | ||||
|  | ||||
|     -- Processor peripherals -- | ||||
|     IO_GPIO_EN                   => IO_GPIO_EN,     -- implement general purpose input/output port unit (GPIO)? | ||||
|     IO_MTIME_EN                  => IO_MTIME_EN,    -- implement machine system timer (MTIME)? | ||||
|     IO_UART0_EN                  => IO_UART0_EN,    -- implement primary universal asynchronous receiver/transmitter (UART0)? | ||||
|     IO_UART1_EN                  => false,          -- implement secondary universal asynchronous receiver/transmitter (UART1)? | ||||
|     IO_SPI_EN                    => IO_SPI_EN,      -- implement serial peripheral interface (SPI)? | ||||
|     IO_TWI_EN                    => IO_TWI_EN,      -- implement two-wire interface (TWI)? | ||||
|     IO_PWM_NUM_CH                => IO_PWM_NUM_CH,  -- number of PWM channels to implement (0..60); 0 = disabled | ||||
|     IO_WDT_EN                    => IO_WDT_EN,      -- implement watch dog timer (WDT)? | ||||
|     IO_TRNG_EN                   => false,          -- implement true random number generator (TRNG)? | ||||
|     IO_CFS_EN                    => false,          -- implement custom functions subsystem (CFS)? | ||||
|     IO_CFS_CONFIG                => x"00000000",    -- custom CFS configuration generic | ||||
|     IO_CFS_IN_SIZE               => 32,             -- size of CFS input conduit in bits | ||||
|     IO_CFS_OUT_SIZE              => 32,             -- size of CFS output conduit in bits | ||||
|     IO_NEOLED_EN                 => false           -- implement NeoPixel-compatible smart LED interface (NEOLED)? | ||||
|   ) | ||||
|   port map ( | ||||
|     -- Global control -- | ||||
|     clk_i       => clk_i,                        -- global clock, rising edge | ||||
|     rstn_i      => rstn_i,                       -- global reset, low-active, async | ||||
|  | ||||
|     -- JTAG on-chip debugger interface (available if ON_CHIP_DEBUGGER_EN = true) -- | ||||
|     jtag_trst_i => '0',                          -- low-active TAP reset (optional) | ||||
|     jtag_tck_i  => '0',                          -- serial clock | ||||
|     jtag_tdi_i  => '0',                          -- serial data input | ||||
|     jtag_tdo_o  => open,                         -- serial data output | ||||
|     jtag_tms_i  => '0',                          -- mode select | ||||
|  | ||||
|     -- Wishbone bus interface (available if MEM_EXT_EN = true) -- | ||||
|     wb_tag_o    => open,                         -- request tag | ||||
|     wb_adr_o    => open,                         -- address | ||||
|     wb_dat_i    => (others => '0'),              -- read data | ||||
|     wb_dat_o    => open,                         -- write data | ||||
|     wb_we_o     => open,                         -- read/write | ||||
|     wb_sel_o    => open,                         -- byte enable | ||||
|     wb_stb_o    => open,                         -- strobe | ||||
|     wb_cyc_o    => open,                         -- valid cycle | ||||
|     wb_lock_o   => open,                         -- exclusive access request | ||||
|     wb_ack_i    => '0',                          -- transfer acknowledge | ||||
|     wb_err_i    => '0',                          -- transfer error | ||||
|  | ||||
|     -- Advanced memory control signals (available if MEM_EXT_EN = true) -- | ||||
|     fence_o     => open,                         -- indicates an executed FENCE operation | ||||
|     fencei_o    => open,                         -- indicates an executed FENCEI operation | ||||
|  | ||||
|     -- GPIO (available if IO_GPIO_EN = true) -- | ||||
|     gpio_o      => con_gpio_o,                   -- parallel output | ||||
|     gpio_i      => con_gpio_i,                   -- parallel input | ||||
|  | ||||
|     -- primary UART0 (available if IO_UART0_EN = true) -- | ||||
|     uart0_txd_o => uart_txd_o,                   -- UART0 send data | ||||
|     uart0_rxd_i => uart_rxd_i,                   -- UART0 receive data | ||||
|     uart0_rts_o => uart_rts_o,                   -- hw flow control: UART0.RX ready to receive ("RTR"), low-active, optional | ||||
|     uart0_cts_i => uart_cts_i,                   -- hw flow control: UART0.TX allowed to transmit, low-active, optional | ||||
|  | ||||
|     -- secondary UART1 (available if IO_UART1_EN = true) -- | ||||
|     uart1_txd_o => open,                         -- UART1 send data | ||||
|     uart1_rxd_i => '0',                          -- UART1 receive data | ||||
|     uart1_rts_o => open,                         -- hw flow control: UART1.RX ready to receive ("RTR"), low-active, optional | ||||
|     uart1_cts_i => '0',                          -- hw flow control: UART1.TX allowed to transmit, low-active, optional | ||||
|  | ||||
|     -- SPI (available if IO_SPI_EN = true) -- | ||||
|     spi_sck_o   => con_spi_sck,                  -- SPI serial clock | ||||
|     spi_sdo_o   => con_spi_sdo,                  -- controller data out, peripheral data in | ||||
|     spi_sdi_i   => con_spi_sdi,                  -- controller data in, peripheral data out | ||||
|     spi_csn_o   => con_spi_csn,                  -- SPI CS | ||||
|  | ||||
|     -- TWI (available if IO_TWI_EN = true) -- | ||||
|     twi_sda_io  => twi_sda_io,                   -- twi serial data line | ||||
|     twi_scl_io  => twi_scl_io,                   -- twi serial clock line | ||||
|  | ||||
|     -- PWM (available if IO_PWM_NUM_CH > 0) -- | ||||
|     pwm_o       => pwm_o,                        -- pwm channels | ||||
|  | ||||
|     -- Custom Functions Subsystem IO -- | ||||
|     cfs_in_i    => (others => '0'),              -- custom CFS inputs conduit | ||||
|     cfs_out_o   => open,                         -- custom CFS outputs conduit | ||||
|  | ||||
|     -- NeoPixel-compatible smart LED interface (available if IO_NEOLED_EN = true) -- | ||||
|     neoled_o    => open,                         -- async serial data line | ||||
|  | ||||
|     -- System time -- | ||||
|     mtime_i     => (others => '0'),              -- current system time from ext. MTIME (if IO_MTIME_EN = false) | ||||
|     mtime_o     => open,                         -- current system time from int. MTIME (if IO_MTIME_EN = true) | ||||
|  | ||||
|     -- Interrupts -- | ||||
|     mtime_irq_i => '0',                          -- machine timer interrupt, available if IO_MTIME_EN = false | ||||
|     msw_irq_i   => '0',                          -- machine software interrupt | ||||
|     mext_irq_i  => '0'                           -- machine external interrupt | ||||
|   ); | ||||
|  | ||||
| end architecture; | ||||
		Reference in New Issue
	
	Block a user