------------------------------------------------
|
------------------------------------------------
|
--! @file
|
--! @file
|
--! @brief Entidad top del RtEngine \nRtEngine's top hierarchy.
|
--! @brief Entidad top del Rt Engine \n Rt Engine's top hierarchy.
|
--------------------------------------------------
|
--------------------------------------------------
|
|
|
|
|
-- RAYTRAC
|
-- RAYTRAC
|
-- Author Julian Andres Guarin
|
-- Author Julian Andres Guarin
|
-- raytrac.vhd
|
-- raytrac.vhd
|
-- This file is part of raytrac.
|
-- This file is part of raytrac.
|
--
|
--
|
-- raytrac is free software: you can redistribute it and/or modify
|
-- raytrac is free software: you can redistribute it and/or modify
|
-- it under the terms of the GNU General Public License as published by
|
-- it under the terms of the GNU General Public License as published by
|
-- the Free Software Foundation, either version 3 of the License, or
|
-- the Free Software Foundation, either version 3 of the License, or
|
-- (at your option) any later version.
|
-- (at your option) any later version.
|
--
|
--
|
-- raytrac is distributed in the hope that it will be useful,
|
-- raytrac is distributed in the hope that it will be useful,
|
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
|
-- but WITHOUT ANY WARRANTY; without even the implied warranty of
|
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
-- MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
-- GNU General Public License for more details.
|
-- GNU General Public License for more details.
|
--
|
--
|
-- You should have received a copy of the GNU General Public License
|
-- You should have received a copy of the GNU General Public License
|
-- along with raytrac. If not, see <http://www.gnu.org/licenses/>
|
-- along with raytrac. If not, see <http://www.gnu.org/licenses/>
|
|
|
--! Libreria de definicion de senales y tipos estandares, comportamiento de operadores aritmeticos y logicos.\nSignal and types definition library. This library also defines
|
--! Libreria de definicion de senales y tipos estandares, comportamiento de operadores aritmeticos y logicos.\n Signal and types definition library. This library also defines
|
library ieee;
|
library ieee;
|
--! Paquete de definicion estandard de logica. Standard logic definition pack.
|
--! Paquete de definicion estandard de logica. Standard logic definition pack.
|
use ieee.std_logic_1164.all;
|
use ieee.std_logic_1164.all;
|
|
|
--! Se usaran en esta descripcion los componentes del package arithpack.vhd.\nIt will be used in this description the components on the arithpack.vhd package.
|
--! Se usaran en esta descripcion los componentes del package arithpack.vhd.\n It will be used in this description the components on the arithpack.vhd package.
|
use work.arithpack.all;
|
use work.arithpack.all;
|
|
|
--! La entidad raytrac es la top en la jerarquia de descripcion del RtEngine.\nRaytrac entity is the top one on the RtEngine description hierarchy.
|
--! La entidad raytrac es la top en la jerarquia de descripcion del Rt Engine.\n Raytrac entity is the top one on the Rt Engine description hierarchy.
|
|
|
--! RayTrac es basicamente una entidad que toma las entradas de cuatro vectores: A,B,C,D y las entradas opcode y addcode.
|
--! RayTrac es basicamente una entidad que toma las entradas de cuatro vectores: A,B,C,D y las entradas opcode y addcode.
|
--! En el momento de la carga se llevaran a cabo las siguientes operaciones:
|
--! En el momento de la carga se llevaran a cabo las siguientes operaciones: \n
|
--! \n\tProducto Punto => Si opcode es 0:\n\n\tA.B y C.D, los valores apareceran en las salidas DP0 y DP1. El tiempo transcurrido desde la carga de las entradas hasta la salida del resultado sera 4 clocks.
|
--! - Producto Cruz (opcode = 1):
|
--! \n\tProducto Cruz => Si opcode es 1:\n\n\tAxB si addcode es 0, CxD si addcode es 1, las componentes del vector resultante apareceran en CPX,CPY,CPZ 3 clocks, despues de la carga.
|
--! - Cross Product (opcode = 1):
|
|
--! \n\n
|
|
--! \t Los resultados apareceran 3 clocks despues de la carga de los operadores y el codigo operacion
|
|
--! \n\n
|
|
--! <table>
|
|
--! <tr>
|
|
--! <th></th>
|
|
--! <th></th><th>addcode=0</th><th></th>
|
|
--! </tr>
|
|
--! <tr>
|
|
--! <th>Opcode 1</th>
|
|
--! <td>CPX <= AxB<B> i</B></td>
|
|
--! <td>CPY <= AxB<B> j</B></td>
|
|
--! <td>CPZ <= AxB<B> k</B></td>
|
|
--! </tr>
|
|
--! </table>
|
|
--! \n
|
|
--! <table>
|
|
--! <tr>
|
|
--! <th></th>
|
|
--! <th></th><th>addcode=1</th><th></th>
|
|
--! </tr>
|
|
--! <tr>
|
|
--! <th>Opcode 1</th>
|
|
--! <td>CPX <= CxD<B> i</B></td>
|
|
--! <td>CPY <= CxD<B> j</B></td>
|
|
--! <td>CPZ <= CxD<B> k</B></td>
|
|
--! </tr>
|
|
--! </table>
|
|
--! \n
|
|
--! - Producto Punto (opcode = 0):
|
|
--! - Dot Product (opcode = 0):
|
|
--! \n\n
|
|
--! \t Los resultados se encontraran en DP0 y DP1 4 clocks despues de la carga.
|
|
--! <table>
|
|
--! <tr>
|
|
--! <th></th><th>addcode, ignorar</th>
|
|
--! </tr>
|
|
--! <tr>
|
|
--! <th>opcode=0</th><td> DP0 = A.B, DP1 = C.D</td>
|
|
--! </tr>
|
|
--! </table>
|
|
|
|
|
|
--! - Producto Cruz => Si opcode es 1:
|
|
--! - AxB si addcode es 0, CxD si addcode es 1, las componentes del vector resultante apareceran en CPX,CPY,CPZ 3 clocks, despues de la carga. \n
|
--! \n\nLos componentes instanciados en la descripcion conforman un pipeline de hasta 4 etapas. Por lo tanto es posible cargar vectores (A,B,C,D) y codigos de operacion (opcode y addcode) clock tras clock.
|
--! \n\nLos componentes instanciados en la descripcion conforman un pipeline de hasta 4 etapas. Por lo tanto es posible cargar vectores (A,B,C,D) y codigos de operacion (opcode y addcode) clock tras clock.
|
--! \n The RayTrac entity basically takes the inputs of 4 vectors: A,B,C,D and the opcode and addcode inputs.
|
--! \n The RayTrac entity basically takes the inputs of 4 vectors: A,B,C,D and the opcode and addcode inputs.
|
--! When this inputs are loaded, it will take place the following operations:
|
--! When this inputs are loaded, it will take place the following operations:
|
--! \n\tDot Product => If opcode is 0:\n\n\tA.B and C.D, the resulting values will appear in the DP0 and DP1 outputs. The time taken once the inputs are loaded to the output of the results will be of 4 clocks.
|
--! \n\t Dot Product => If opcode is 0:\n\n\t A.B and C.D, the resulting values will appear in the DP0 and DP1 outputs. The time taken once the inputs are loaded to the output of the results will be of 4 clocks.
|
--! \n\tCross Product => If opcode is 1:\n\n\tAxB if addcode is 0, CxD if addcode es 1. The components of the resulting vector will appear in CPX,CPY,CPZ 3 clocks, after the input loading.
|
--! \n\t Cross Product => If opcode is 1:\n\n\t AxB if addcode is 0, CxD if addcode es 1. The components of the resulting vector will appear in CPX,CPY,CPZ 3 clocks, after the input loading.
|
--! \n\nThe instantiated components in the description
|
--! \n\n The instantiated components in the description
|
entity raytrac is
|
entity raytrac is
|
generic (
|
generic (
|
registered : string := "YES"
|
registered : string := "YES"
|
);
|
);
|
port (
|
port (
|
A,B,C,D : in std_logic_vector(18*3-1 downto 0); -- Vectores de entrada A,B,C,D, cada uno de tamano fijo: 3 componentes x 18 bits. \n Input vectors A,B,C,D, each one of fixed size: 3 components x 18 bits.
|
A,B,C,D : in std_logic_vector(18*3-1 downto 0); -- Vectores de entrada A,B,C,D, cada uno de tamano fijo: 3 componentes x 18 bits. \n Input vectors A,B,C,D, each one of fixed size: 3 components x 18 bits.
|
opcode,addcode : in std_logic; -- Opcode and addcode input bits, opcode selects what operation is going to perform one of the entities included in the design and addcode what operands are going to be involved in such. \n Opcode & addcode, opcode selecciona que operacion se va a llevar a cabo dentro de una de las entidades referenciadas dentro de la descripcion, mientras que addcode decide cuales van a ser los operandos que realizaran tal.
|
opcode,addcode : in std_logic; -- Opcode and addcode input bits, opcode selects what operation is going to perform one of the entities included in the design and addcode what operands are going to be involved in such. \n Opcode & addcode, opcode selecciona que operacion se va a llevar a cabo dentro de una de las entidades referenciadas dentro de la descripcion, mientras que addcode decide cuales van a ser los operandos que realizaran tal.
|
clk,rst,ena : in std_logic; -- Las senales de control usual. The usual control signals.
|
clk,rst,ena : in std_logic; -- Las senales de control usual. The usual control signals.
|
CPX,CPY,CPZ,DP0,DP1 : out std_logic_vector(31 downto 0) -- Salidas que representan los resultados del RayTrac: pueden ser dos resultados, de dos operaciones de producto punto, o un producto cruz. Por favor revisar el documento de especificacion del dispositivo para tener mas claridad.\n Outputs representing the result of the RayTrac entity: can be the results of two parallel dot product operations or the result of a single cross product, in order to clarify refere to the entity specification documentation.
|
CPX,CPY,CPZ,DP0,DP1 : out std_logic_vector(31 downto 0) -- Salidas que representan los resultados del RayTrac: pueden ser dos resultados, de dos operaciones de producto punto, o un producto cruz. Por favor revisar el documento de especificacion del dispositivo para tener mas claridad.\n Outputs representing the result of the RayTrac entity: can be the results of two parallel dot product operations or the result of a single cross product, in order to clarify refere to the entity specification documentation.
|
|
|
|
|
);
|
);
|
end raytrac;
|
end raytrac;
|
|
|
|
--! Arquitectura general del RayTrac. \n RayTrac general architecture.
|
|
|
|
--! La Arquitectura general de RayTrac se consiste en 3 componentes esenciales:
|
|
--! - Etapa de registros para la carga de los operadores y el codigo de operacion.
|
|
--! - Etapa combinatoria para la seleccion de operadores, dependiendo del codigo de operacion.
|
|
--! - Etapa aritmetica del calculo del producto punto o el producto cruz segun el caso.
|
|
|
architecture raytrac_arch of raytrac is
|
architecture raytrac_arch of raytrac is
|
signal SA,SB,SC,SD : std_logic_vector(18*3-1 downto 0);
|
signal SA,SB,SC,SD : std_logic_vector(18*3-1 downto 0);
|
signal sopcode,saddcode : std_logic;
|
signal sopcode,saddcode : std_logic;
|
signal smf00,smf01,smf10,smf11,smf20,smf21,smf30,smf31,smf40,smf41,smf50,smf51 : std_logic_vector(17 downto 0);
|
signal smf00,smf01,smf10,smf11,smf20,smf21,smf30,smf31,smf40,smf41,smf50,smf51 : std_logic_vector(17 downto 0);
|
|
|
begin
|
begin
|
|
|
-- Registered or unregistered inputs?
|
-- Registered or unregistered inputs?
|
notreg:
|
notreg:
|
if registered="NO" generate
|
if registered="NO" generate
|
SA <= A;
|
SA <= A;
|
SB <= B;
|
SB <= B;
|
SC <= C;
|
SC <= C;
|
SD <= D;
|
SD <= D;
|
sopcode <= opcode;
|
sopcode <= opcode;
|
saddcode <= addcode;
|
saddcode <= addcode;
|
end generate notreg;
|
end generate notreg;
|
reg:
|
reg:
|
if registered="YES" generate
|
if registered="YES" generate
|
procReg:
|
procReg:
|
process(clk,rst)
|
process(clk,rst)
|
begin
|
begin
|
if rst=rstMasterValue then
|
if rst=rstMasterValue then
|
SA <= (others => '0');
|
SA <= (others => '0');
|
SB <= (others => '0');
|
SB <= (others => '0');
|
SC <= (others => '0');
|
SC <= (others => '0');
|
SD <= (others => '0');
|
SD <= (others => '0');
|
sopcode <= '0';
|
sopcode <= '0';
|
saddcode <= '0';
|
saddcode <= '0';
|
elsif clk'event and clk='1' then
|
elsif clk'event and clk='1' then
|
if ena <= '1' then
|
if ena <= '1' then
|
SA <= A;
|
SA <= A;
|
SB <= B;
|
SB <= B;
|
SC <= C;
|
SC <= C;
|
SD <= D;
|
SD <= D;
|
sopcode <= opcode;
|
sopcode <= opcode;
|
saddcode <= addcode;
|
saddcode <= addcode;
|
end if;
|
end if;
|
end if;
|
end if;
|
end process procReg;
|
end process procReg;
|
end generate reg;
|
end generate reg;
|
-- Instantiate Opcoder
|
-- Instantiate Opcoder
|
opcdr : opcoder
|
opcdr : opcoder
|
port map (
|
port map (
|
SA(17 downto 0),SB(17 downto 0),SC(17 downto 0),SD(17 downto 0),SA(35 downto 18),SB(35 downto 18),SC(35 downto 18),SD(35 downto 18),SA(53 downto 36),SB(53 downto 36),SC(53 downto 36),SD(53 downto 36),
|
SA(17 downto 0),SB(17 downto 0),SC(17 downto 0),SD(17 downto 0),SA(35 downto 18),SB(35 downto 18),SC(35 downto 18),SD(35 downto 18),SA(53 downto 36),SB(53 downto 36),SC(53 downto 36),SD(53 downto 36),
|
smf00,smf01,smf10,smf11,smf20,smf21,smf30,smf31,smf40,smf41,smf50,smf51,
|
smf00,smf01,smf10,smf11,smf20,smf21,smf30,smf31,smf40,smf41,smf50,smf51,
|
sopcode,saddcode
|
sopcode,saddcode
|
);
|
);
|
-- Instantiate uf, cross product and dot product functional unit.
|
-- Instantiate uf, cross product and dot product functional unit.
|
uf0 : uf
|
uf0 : uf
|
port map (
|
port map (
|
sopcode,
|
sopcode,
|
smf00,smf01,smf10,smf11,smf20,smf21,smf30,smf31,smf40,smf41,smf50,smf51,
|
smf00,smf01,smf10,smf11,smf20,smf21,smf30,smf31,smf40,smf41,smf50,smf51,
|
CPX,CPY,CPZ,DP0,DP1,
|
CPX,CPY,CPZ,DP0,DP1,
|
clk,rst
|
clk,rst
|
);
|
);
|
|
|
end raytrac_arch;
|
end raytrac_arch;
|
|
|
|
|
|
|
