Subversion Repositories neo430

-- #################################################################################################

-- #  << NEO430 - Processor Package >>                                                             #

-- # ********************************************************************************************* #

-- # BSD 3-Clause License                                                                          #

-- #                                                                                               #

-- # Copyright (c) 2020, 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 NEO430 Processor - https://github.com/stnolting/neo430                                    #

-- #################################################################################################

library ieee;

use ieee.std_logic_1164.all;

use ieee.numeric_std.all;

package neo430_package is

  -- Processor Hardware Version -------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  constant hw_version_c : std_ulogic_vector(15 downto 0) := x"0407"; -- no touchy!

  -- Danger Zone (Advanced Hardware Configuration) ------------------------------------------

  -- -------------------------------------------------------------------------------------------

  constant use_dsp_mul_c    : boolean := false; -- use DSP blocks for MULDIV's multiplication core (default=false)

  constant use_xalu_c       : boolean := false; -- implement extended ALU function (default=false)

  constant low_power_mode_c : boolean := false; -- can reduce switching activity, but will also decrease f_max and might increase area (default=false)

  -- Internal Functions ---------------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  function index_size_f(input : natural) return natural;

  function is_power_of_two_f(num : natural; bit_width : natural) return boolean;

  function bit_reversal_f(input : std_ulogic_vector) return std_ulogic_vector;

  function set_bits_f(input : std_ulogic_vector) return natural;

  function leading_zeros_f(input : std_ulogic_vector) return natural;

  function cond_sel_natural_f(cond : boolean; val_t : natural; val_f : natural) return natural;

  function cond_sel_stdulogicvector_f(cond : boolean; val_t : std_ulogic_vector; val_f : std_ulogic_vector) return std_ulogic_vector;

  function bool_to_ulogic_f(cond : boolean) return std_ulogic;

  function bin_to_gray_f(input : std_ulogic_vector) return std_ulogic_vector;

  function gray_to_bin_f(input : std_ulogic_vector) return std_ulogic_vector;

  function int_to_hexchar_f(input : integer) return character;

  function or_all_f(a : std_ulogic_vector) return std_ulogic;

  function and_all_f(a : std_ulogic_vector) return std_ulogic;

  function xor_all_f(a : std_ulogic_vector) return std_ulogic;

  -- Address Space Layout (make sure this is always sync with neo430.h) ---------------------

  -- -------------------------------------------------------------------------------------------

  -- Main Memory: IMEM(ROM/RAM) --

  constant imem_base_c     : std_ulogic_vector(15 downto 0) := x"0000"; -- base address, fixed!

  constant imem_max_size_c : natural := 48*1024; -- bytes, fixed!

  -- Main Memory: DMEM(RAM) --

  constant dmem_base_c     : std_ulogic_vector(15 downto 0) := x"C000"; -- base address, fixed!

  constant dmem_max_size_c : natural := 12*1024; -- bytes, fixed!

  -- Boot ROM --

  constant boot_base_c     : std_ulogic_vector(15 downto 0) := x"F000"; -- bootloader base address, fixed!

  constant boot_size_c     : natural := 2*1024; -- bytes, max 2048 bytes!

  constant boot_max_size_c : natural := 2*1024; -- bytes, fixed!

  -- IO: Peripheral Devices ("IO") Area --

  -- Each device must use 2 bytes or a multiple of 2 bytes as address space!

  -- CONTROL register(s) (including the device enable) must be located at the base address of the device!

  constant io_base_c : std_ulogic_vector(15 downto 0) := x"FF80";

  constant io_size_c : natural := 128; -- bytes, fixed!

  -- IO: Multiplier/Divider Unit (MULDIV) --

  constant muldiv_base_c : std_ulogic_vector(15 downto 0) := x"FF80";

  constant muldiv_size_c : natural := 8; -- bytes

  constant muldiv_opa_resx_addr_c      : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(muldiv_base_c) + x"0000");

  constant muldiv_opb_umul_resy_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(muldiv_base_c) + x"0002");

  constant muldiv_opb_smul_addr_c      : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(muldiv_base_c) + x"0004");

  constant muldiv_opb_udiv_addr_c      : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(muldiv_base_c) + x"0006");

  -- IO: Frequency Generator (FREQ_GEN) --

  constant freq_gen_base_c : std_ulogic_vector(15 downto 0) := x"FF88";

  constant freq_gen_size_c : natural := 8; -- bytes

  constant freq_gen_ctrl_addr_c   : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(freq_gen_base_c) + x"0000");

  constant freq_gen_tw_ch0_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(freq_gen_base_c) + x"0002");

  constant freq_gen_tw_ch1_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(freq_gen_base_c) + x"0004");

  constant freq_gen_tw_ch2_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(freq_gen_base_c) + x"0006");

  -- IO: Wishbone32 Interface (WB32) --

  constant wb32_base_c : std_ulogic_vector(15 downto 0) := x"FF90";

  constant wb32_size_c : natural := 16; -- bytes

  constant wb32_ctrl_addr_c      : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(wb32_base_c) + x"0000");

  constant wb32_rd_adr_lo_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(wb32_base_c) + x"0002");

  constant wb32_rd_adr_hi_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(wb32_base_c) + x"0004");

  constant wb32_wr_adr_lo_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(wb32_base_c) + x"0006");

  constant wb32_wr_adr_hi_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(wb32_base_c) + x"0008");

  constant wb32_data_lo_addr_c   : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(wb32_base_c) + x"000A");

  constant wb32_data_hi_addr_c   : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(wb32_base_c) + x"000C");

--constant wb32_???_addr_c       : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(wb32_base_c) + x"000E");

  -- IO: Universal asynchronous receiver and transmitter (UART) --

  constant uart_base_c : std_ulogic_vector(15 downto 0) := x"FFA0";

  constant uart_size_c : natural := 4; -- bytes

  constant uart_ctrl_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(uart_base_c) + x"0000");

  constant uart_rtx_addr_c  : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(uart_base_c) + x"0002");

  -- IO: Serial Peripheral Interface (SPI) --

  constant spi_base_c : std_ulogic_vector(15 downto 0) := x"FFA4";

  constant spi_size_c : natural := 4; -- bytes

  constant spi_ctrl_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(spi_base_c) + x"0000");

  constant spi_rtx_addr_c  : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(spi_base_c) + x"0002");

  -- IO: General purpose input/output port (GPIO)  --

  constant gpio_base_c : std_ulogic_vector(15 downto 0) := x"FFA8";

  constant gpio_size_c : natural := 8; -- bytes

  constant gpio_irqmask_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(gpio_base_c) + x"0000");

  constant gpio_in_addr_c      : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(gpio_base_c) + x"0002");

  constant gpio_out_addr_c     : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(gpio_base_c) + x"0004");

--constant gpio_???_addr_c     : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(gpio_base_c) + x"0006");

  -- IO: High-Precision Timer (TIMER) --

  constant timer_base_c : std_ulogic_vector(15 downto 0) := x"FFB0";

  constant timer_size_c : natural := 8; -- bytes

  constant timer_ctrl_addr_c  : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(timer_base_c) + x"0000");

  constant timer_cnt_addr_c   : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(timer_base_c) + x"0002");

  constant timer_thres_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(timer_base_c) + x"0004");

--constant timer_???_addr_c   : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(timer_base_c) + x"0006");

  -- IO: Watchdog Timer (WDT) --

  constant wdt_base_c : std_ulogic_vector(15 downto 0) := x"FFB8";

  constant wdt_size_c : natural := 2; -- bytes

  constant wdt_ctrl_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(wdt_base_c) + x"0000");

  -- IO: Cyclic Redundancy Check (CRC) --

  constant crc_base_c : std_ulogic_vector(15 downto 0) := x"FFC0";

  constant crc_size_c : natural := 16; -- bytes

  constant crc_poly_lo_addr_c  : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(crc_base_c) + x"0000");

  constant crc_poly_hi_addr_c  : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(crc_base_c) + x"0002");

  constant crc_crc16_in_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(crc_base_c) + x"0004");

  constant crc_crc32_in_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(crc_base_c) + x"0006");

--constant crc_???_addr_c      : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(crc_base_c) + x"0008");

--constant crc_???_addr_c      : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(crc_base_c) + x"000A");

  constant crc_resx_addr_c     : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(crc_base_c) + x"000C");

  constant crc_resy_addr_c     : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(crc_base_c) + x"000E");

  -- IO: Custom Functions Unit (CFU) --

  constant cfu_base_c : std_ulogic_vector(15 downto 0) := x"FFD0";

  constant cfu_size_c : natural := 16; -- bytes

  constant cfu_reg0_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(cfu_base_c) + x"0000");

  constant cfu_reg1_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(cfu_base_c) + x"0002");

  constant cfu_reg2_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(cfu_base_c) + x"0004");

  constant cfu_reg3_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(cfu_base_c) + x"0006");

  constant cfu_reg4_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(cfu_base_c) + x"0008");

  constant cfu_reg5_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(cfu_base_c) + x"000A");

  constant cfu_reg6_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(cfu_base_c) + x"000C");

  constant cfu_reg7_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(cfu_base_c) + x"000E");

  -- IO: Pulse-Width Modulation Controller (PWM) --

  constant pwm_base_c : std_ulogic_vector(15 downto 0) := x"FFE0";

  constant pwm_size_c : natural := 8; -- bytes

  constant pwm_ctrl_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(pwm_base_c) + x"0000");

  constant pwm_ch10_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(pwm_base_c) + x"0002");

  constant pwm_ch32_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(pwm_base_c) + x"0004");

--constant pwm_???_addr_c  : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(pwm_base_c) + x"0006");

  -- IO: Two Wire Serial Interface (TWI) --

  constant twi_base_c : std_ulogic_vector(15 downto 0) := x"FFE8";

  constant twi_size_c : natural := 4; -- bytes

  constant twi_ctrl_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(twi_base_c) + x"0000");

  constant twi_rtx_addr_c  : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(twi_base_c) + x"0002");

  -- IO: True Random Number Generator (TRNG) --

  constant trng_base_c : std_ulogic_vector(15 downto 0) := x"FFEC";

  constant trng_size_c : natural := 2; -- bytes

  constant trng_ctrl_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(trng_base_c) + x"0000");

  -- IO: External Interrupts Controller (EXIRQ) --

  constant exirq_base_c : std_ulogic_vector(15 downto 0) := x"FFEE";

  constant exirq_size_c : natural := 2; -- bytes

  constant exirq_ctrl_addr_c : std_ulogic_vector(15 downto 0) := std_ulogic_vector(unsigned(exirq_base_c) + x"0000");

  -- IO: System Configuration (SYSCONFIG) --

  constant sysconfig_base_c : std_ulogic_vector(15 downto 0) := x"FFF0";

  constant sysconfig_size_c : natural := 16; -- bytes

  -- Clock Generator -------------------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  constant clk_div2_c    : natural := 0;

  constant clk_div4_c    : natural := 1;

  constant clk_div8_c    : natural := 2;

  constant clk_div64_c   : natural := 3;

  constant clk_div128_c  : natural := 4;

  constant clk_div1024_c : natural := 5;

  constant clk_div2048_c : natural := 6;

  constant clk_div4096_c : natural := 7;

  -- Register Addresses ---------------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  constant reg_pc_c : std_ulogic_vector(3 downto 0) := x"0"; -- program counter

  constant reg_sp_c : std_ulogic_vector(3 downto 0) := x"1"; -- stack pointer

  constant reg_sr_c : std_ulogic_vector(3 downto 0) := x"2"; -- status register

  constant reg_cg_c : std_ulogic_vector(3 downto 0) := x"3"; -- constant generator

  -- Status Register ------------------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  constant sreg_c_c : natural := 0;  -- r/w: carry flag

  constant sreg_z_c : natural := 1;  -- r/w: zero flag

  constant sreg_n_c : natural := 2;  -- r/w: negative flag

  constant sreg_i_c : natural := 3;  -- r/w: global interrupt enable

  constant sreg_s_c : natural := 4;  -- r/w: CPU sleep flag

  constant sreg_p_c : natural := 5;  -- r/w: parity flag

  constant sreg_v_c : natural := 8;  -- r/w: overflow flag

  constant sreg_q_c : natural := 14; -- -/w: clear pending IRQ buffer when set

  constant sreg_r_c : natural := 15; -- r/w: enable write access to IMEM (ROM) when set

  -- ALU Flag Bus ---------------------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  constant flag_c_c : natural := 0; -- carry flag

  constant flag_z_c : natural := 1; -- zero flag

  constant flag_n_c : natural := 2; -- negative flag

  constant flag_v_c : natural := 3; -- overflow flag

  constant flag_p_c : natural := 4; -- parity flag

  -- Main Control Bus -----------------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  -- register file --

  constant ctrl_rf_in_sel_c   : natural :=  0; -- input source

  constant ctrl_rf_adr0_c     : natural :=  1; -- source/destination register address bit 0

  constant ctrl_rf_adr1_c     : natural :=  2; -- source/destination register address bit 1

  constant ctrl_rf_adr2_c     : natural :=  3; -- source/destination register address bit 2

  constant ctrl_rf_adr3_c     : natural :=  4; -- source/destination register address bit 3

  constant ctrl_rf_as0_c      : natural :=  5; -- source addressing mode bit 0

  constant ctrl_rf_as1_c      : natural :=  6; -- source addressing mode bit 1

  constant ctrl_rf_fup_c      : natural :=  7; -- update ALU flags

  constant ctrl_rf_wb_en_c    : natural :=  8; -- enable RF write back

  constant ctrl_rf_dsleep_c   : natural :=  9; -- disable sleep mode

  constant ctrl_rf_dgie_c     : natural := 10; -- disable global interrupt enable

  constant ctrl_rf_boot_c     : natural := 11; -- inject PC boot address

  -- alu --

  constant ctrl_alu_in_sel_c  : natural := 12; -- ALU OP input select

  constant ctrl_alu_opa_wr_c  : natural := 13; -- write ALU operand A

  constant ctrl_alu_opb_wr_c  : natural := 14; -- write ALU operand B

  constant ctrl_alu_cmd0_c    : natural := 15; -- ALU command bit 0

  constant ctrl_alu_cmd1_c    : natural := 16; -- ALU command bit 1

  constant ctrl_alu_cmd2_c    : natural := 17; -- ALU command bit 2

  constant ctrl_alu_cmd3_c    : natural := 18; -- ALU command bit 3

  constant ctrl_alu_bw_c      : natural := 19; -- byte(1)/word(0) operation

  -- address generator --

  constant ctrl_adr_off0_c    : natural := 20; -- address offset selection bit 0

  constant ctrl_adr_off1_c    : natural := 21; -- address offset selection bit 1

  constant ctrl_adr_off2_c    : natural := 22; -- address offset selection bit 2

  constant ctrl_adr_mar_sel_c : natural := 23; -- select input for MAR

  constant ctrl_adr_bp_en_c   : natural := 24; -- mem addr output select, 0:MAR, 1:bypass

  constant ctrl_adr_ivec_oe_c : natural := 25; -- output IRQ if 1, else output PC

  constant ctrl_adr_mar_wr_c  : natural := 26; -- write MAR

  -- memory interface --

  constant ctrl_mem_wr_c      : natural := 27; -- write to memory

  constant ctrl_mem_rd_c      : natural := 28; -- read from memory

  -- bus size --

  constant ctrl_width_c       : natural := 29; -- control bus size

  -- Condition Codes ------------------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  constant cond_ne_c : std_ulogic_vector(2 downto 0) := "000"; -- not equal

  constant cond_eq_c : std_ulogic_vector(2 downto 0) := "001"; -- equal

  constant cond_lo_c : std_ulogic_vector(2 downto 0) := "010"; -- lower

  constant cond_hs_c : std_ulogic_vector(2 downto 0) := "011"; -- higher or same

  constant cond_mi_c : std_ulogic_vector(2 downto 0) := "100"; -- negative

  constant cond_ge_c : std_ulogic_vector(2 downto 0) := "101"; -- greater or equal

  constant cond_le_c : std_ulogic_vector(2 downto 0) := "110"; -- less

  constant cond_al_c : std_ulogic_vector(2 downto 0) := "111"; -- always

  -- ALU Function Codes ---------------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  constant alu_rrc_c  : std_ulogic_vector(3 downto 0) := "0000"; -- r <= a >>> 1, rotate right through carry

  constant alu_swap_c : std_ulogic_vector(3 downto 0) := "0001"; -- r <= swap bytes of a

  constant alu_rra_c  : std_ulogic_vector(3 downto 0) := "0010"; -- r <= a >>> 1, rotate right arithmetically

  constant alu_sxt_c  : std_ulogic_vector(3 downto 0) := "0011"; -- r <= a, sign extend byte

  constant alu_mov_c  : std_ulogic_vector(3 downto 0) := "0100"; -- r <= a

  constant alu_add_c  : std_ulogic_vector(3 downto 0) := "0101"; -- r <= a + b

  constant alu_addc_c : std_ulogic_vector(3 downto 0) := "0110"; -- r <= a + b + carry

  constant alu_subc_c : std_ulogic_vector(3 downto 0) := "0111"; -- r <= b - a - 1 + carry

  constant alu_sub_c  : std_ulogic_vector(3 downto 0) := "1000"; -- r <= b - a

  constant alu_cmp_c  : std_ulogic_vector(3 downto 0) := "1001"; -- b - a (no write back)

--constant alu_dadd_c : std_ulogic_vector(3 downto 0) := "1010"; -- r <= a + b (BCD) [NOT SUPPORTED!]

  constant alu_bit_c  : std_ulogic_vector(3 downto 0) := "1011"; -- a & b (no write back)

  constant alu_bic_c  : std_ulogic_vector(3 downto 0) := "1100"; -- r <= !a & b

  constant alu_bis_c  : std_ulogic_vector(3 downto 0) := "1101"; -- r <= a | b

  constant alu_xor_c  : std_ulogic_vector(3 downto 0) := "1110"; -- r <= a xor b

  constant alu_and_c  : std_ulogic_vector(3 downto 0) := "1111"; -- r <= a & b

  -- The Core of the Problem: NEO430 Processor Top Entity -----------------------------------

  -- -------------------------------------------------------------------------------------------

  component neo430_top

    generic (

      -- general configuration --

      CLOCK_SPEED  : natural := 100000000; -- main clock in Hz

      IMEM_SIZE    : natural := 4*1024; -- internal IMEM size in bytes, max 32kB (default=4kB)

      DMEM_SIZE    : natural := 2*1024; -- internal DMEM size in bytes, max 28kB (default=2kB)

      -- additional configuration --

      USER_CODE    : std_ulogic_vector(15 downto 0) := x"0000"; -- custom user code

      -- module configuration --

      MULDIV_USE   : boolean := true;  -- implement multiplier/divider unit? (default=true)

      WB32_USE     : boolean := true;  -- implement WB32 unit? (default=true)

      WDT_USE      : boolean := true;  -- implement WDT? (default=true)

      GPIO_USE     : boolean := true;  -- implement GPIO unit? (default=true)

      TIMER_USE    : boolean := true;  -- implement timer? (default=true)

      UART_USE     : boolean := true;  -- implement UART? (default=true)

      CRC_USE      : boolean := true;  -- implement CRC unit? (default=true)

      CFU_USE      : boolean := false; -- implement custom functions unit? (default=false)

      PWM_USE      : boolean := true;  -- implement PWM controller? (default=true)

      TWI_USE      : boolean := true;  -- implement two wire serial interface? (default=true)

      SPI_USE      : boolean := true;  -- implement SPI? (default=true)

      TRNG_USE     : boolean := false; -- implement TRNG? (default=false)

      EXIRQ_USE    : boolean := true;  -- implement EXIRQ? (default=true)

      FREQ_GEN_USE : boolean := true;  -- implement FREQ_GEN? (default=true)

      -- boot configuration --

      BOOTLD_USE   : boolean := true; -- implement and use bootloader? (default=true)

      IMEM_AS_ROM  : boolean := false -- implement IMEM as read-only memory? (default=false)

    );

    port (

      -- global control --

      clk_i      : in  std_ulogic; -- global clock, rising edge

      rst_i      : in  std_ulogic; -- global reset, async, low-active

      -- gpio --

      gpio_o     : out std_ulogic_vector(15 downto 0); -- parallel output

      gpio_i     : in  std_ulogic_vector(15 downto 0); -- parallel input

      -- pwm channels --

      pwm_o      : out std_ulogic_vector(03 downto 0); -- pwm channels

      -- arbitrary frequency generator --

      freq_gen_o : out std_ulogic_vector(02 downto 0); -- programmable frequency output

      -- serial com --

      uart_txd_o : out std_ulogic; -- UART send data

      uart_rxd_i : in  std_ulogic; -- UART receive data

      spi_sclk_o : out std_ulogic; -- serial clock line

      spi_mosi_o : out std_ulogic; -- serial data line out

      spi_miso_i : in  std_ulogic; -- serial data line in

      spi_cs_o   : out std_ulogic_vector(05 downto 0); -- SPI CS

      twi_sda_io : inout std_logic; -- twi serial data line

      twi_scl_io : inout std_logic; -- twi serial clock line

      -- 32-bit wishbone interface --

      wb_adr_o   : out std_ulogic_vector(31 downto 0); -- address

      wb_dat_i   : in  std_ulogic_vector(31 downto 0); -- read data

      wb_dat_o   : out std_ulogic_vector(31 downto 0); -- write data

      wb_we_o    : out std_ulogic; -- read/write

      wb_sel_o   : out std_ulogic_vector(03 downto 0); -- byte enable

      wb_stb_o   : out std_ulogic; -- strobe

      wb_cyc_o   : out std_ulogic; -- valid cycle

      wb_ack_i   : in  std_ulogic; -- transfer acknowledge

      -- external interrupts --

      ext_irq_i  : in  std_ulogic_vector(07 downto 0); -- external interrupt request lines

      ext_ack_o  : out std_ulogic_vector(07 downto 0)  -- external interrupt request acknowledges

    );

  end component;

  -- Component: CPU Control -----------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  component neo430_control

    port (

      -- global control --

      clk_i     : in  std_ulogic; -- global clock, rising edge

      rst_i     : in  std_ulogic; -- global reset, low-active, async

      -- memory interface --

      instr_i   : in  std_ulogic_vector(15 downto 0); -- instruction word from memory

      -- control --

      sreg_i    : in  std_ulogic_vector(15 downto 0); -- current status register

      ctrl_o    : out std_ulogic_vector(ctrl_width_c-1 downto 0); -- control signals

      irq_vec_o : out std_ulogic_vector(01 downto 0); -- irq channel address

      imm_o     : out std_ulogic_vector(15 downto 0); -- branch offset

      -- irq lines --

      irq_i     : in  std_ulogic_vector(03 downto 0)  -- IRQ lines

    );

  end component;

  -- Component: Register File ---------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  component neo430_reg_file

    generic (

      BOOTLD_USE  : boolean := true; -- implement and use bootloader?

      IMEM_AS_ROM : boolean := false -- implement IMEM as read-only memory?

    );

    port (

      -- global control --

      clk_i  : in  std_ulogic; -- global clock, rising edge

      rst_i  : in  std_ulogic; -- global reset, low-active, async

      -- data input --

      alu_i  : in  std_ulogic_vector(15 downto 0); -- data from alu

      addr_i : in  std_ulogic_vector(15 downto 0); -- data from addr unit

      flag_i : in  std_ulogic_vector(04 downto 0); -- new ALU flags

      -- control --

      ctrl_i : in  std_ulogic_vector(ctrl_width_c-1 downto 0);

      -- data output --

      data_o : out std_ulogic_vector(15 downto 0); -- read data

      sreg_o : out std_ulogic_vector(15 downto 0)  -- current SR

    );

  end component;

  -- Component: Data ALU --------------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  component neo430_alu

    port (

      -- global control --

      clk_i  : in  std_ulogic; -- global clock, rising edge

      -- operands --

      reg_i  : in  std_ulogic_vector(15 downto 0); -- data from reg file

      mem_i  : in  std_ulogic_vector(15 downto 0); -- data from memory

      sreg_i : in  std_ulogic_vector(15 downto 0); -- current SR

      -- control --

      ctrl_i : in  std_ulogic_vector(ctrl_width_c-1 downto 0);

      -- results --

      data_o : out std_ulogic_vector(15 downto 0); -- result

      flag_o : out std_ulogic_vector(04 downto 0)  -- new ALU flags

    );

  end component;

  -- Component: Address Generator -----------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  component neo430_addr_gen

    port (

      -- global control --

      clk_i      : in  std_ulogic; -- global clock, rising edge

      -- data input --

      reg_i      : in  std_ulogic_vector(15 downto 0); -- reg file input

      mem_i      : in  std_ulogic_vector(15 downto 0); -- memory input

      imm_i      : in  std_ulogic_vector(15 downto 0); -- branch offset

      irq_sel_i  : in  std_ulogic_vector(01 downto 0); -- IRQ vector

      -- control --

      ctrl_i     : in  std_ulogic_vector(ctrl_width_c-1 downto 0);

      -- data output --

      mem_addr_o : out std_ulogic_vector(15 downto 0); -- memory address

      dwb_o      : out std_ulogic_vector(15 downto 0)  -- data write back output

    );

  end component;

  -- Component: CPU core --------------------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  component neo430_cpu

    generic (

      BOOTLD_USE  : boolean := true; -- implement and use bootloader?

      IMEM_AS_ROM : boolean := false -- implement IMEM as read-only memory?

    );

    port(

      -- global control --

      clk_i      : in  std_ulogic; -- global clock, rising edge

      rst_i      : in  std_ulogic; -- global reset, low-active, async

      -- memory interface --

      mem_rd_o   : out std_ulogic; -- memory read

      mem_imwe_o : out std_ulogic; -- allow writing to IMEM

      mem_wr_o   : out std_ulogic_vector(01 downto 0); -- memory write

      mem_addr_o : out std_ulogic_vector(15 downto 0); -- address

      mem_data_o : out std_ulogic_vector(15 downto 0); -- write data

      mem_data_i : in  std_ulogic_vector(15 downto 0); -- read data

      -- interrupt system --

      irq_i      : in  std_ulogic_vector(03 downto 0)  -- interrupt requests

    );

  end component;

  -- Component: Instruction Memory RAM (IMEM) -----------------------------------------------

  -- -------------------------------------------------------------------------------------------

  component neo430_imem

    generic (

      IMEM_SIZE   : natural := 4*1024; -- internal IMEM size in bytes

      IMEM_AS_ROM : boolean := false;  -- implement IMEM as read-only memory?

      BOOTLD_USE  : boolean := true    -- implement and use bootloader?

    );

    port (

      clk_i  : in  std_ulogic; -- global clock line

      rden_i : in  std_ulogic; -- read enable

      wren_i : in  std_ulogic_vector(01 downto 0); -- write enable

      upen_i : in  std_ulogic; -- update enable

      addr_i : in  std_ulogic_vector(15 downto 0); -- address

      data_i : in  std_ulogic_vector(15 downto 0); -- data in

      data_o : out std_ulogic_vector(15 downto 0)  -- data out

    );

  end component;

  -- Component: Data Memory RAM (DMEM) ------------------------------------------------------

  -- -------------------------------------------------------------------------------------------

  component neo430_dmem

    generic (

      DMEM_SIZE : natural := 2*1024 -- internal DMEM size in bytes

    );

    port (

      clk_i  : in  std_ulogic; -- global clock line

      rden_i : in  std_ulogic; -- read enable

      wren_i : in  std_ulogic_vector(01 downto 0); -- write enable