------------------------------------------------
|
------------------------------------------------
|
--! @file
|
--! @file
|
--! @brief Entidad top del Rt Engine \n Rt Engine's top hierarchy.
|
--! @brief Entidad top del Rt Engine \n Rt Engine's top hierarchy.
|
--! @author Julián Andrés Guarín Reyes
|
--! @author Julián Andrés Guarín Reyes
|
--------------------------------------------------
|
--------------------------------------------------
|
|
|
|
|
-- 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.\n Signal 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;
|
use ieee.std_logic_signed.all;
|
use ieee.std_logic_signed.all;
|
|
|
|
|
|
|
--! 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.
|
--! 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 Rt Engine.\n Raytrac entity is the top one on the Rt Engine 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: \n
|
--! En el momento de la carga se llevaran a cabo las siguientes operaciones: \n
|
--! - Producto Cruz (opcode = 1):
|
--! - Producto Cruz (opcode = 1):
|
--! - Producto Punto (opcode = 0):
|
--! - Producto Punto (opcode = 0):
|
--! \n\n
|
--! \n\n
|
--! \t Los resultados apareceran 3 clocks despues de la carga de los operadores y el codigo operacion
|
--! \t Los resultados apareceran 3 clocks despues de la carga de los operadores y el codigo operacion
|
--! \n\n
|
--! \n\n
|
--! <table>
|
--! <table>
|
--! <tr>
|
--! <tr>
|
--! <th></th>
|
--! <th></th>
|
--! <th></th><th>addcode=0</th><th></th>
|
--! <th></th><th>addcode=0</th><th></th>
|
--! </tr>
|
--! </tr>
|
--! <tr>
|
--! <tr>
|
--! <th>Opcode 1</th>
|
--! <th>Opcode 1</th>
|
--! <td>CPX <= AxB<B> i</B></td>
|
--! <td>CPX <= AxB<B> i</B></td>
|
--! <td>CPY <= AxB<B> j</B></td>
|
--! <td>CPY <= AxB<B> j</B></td>
|
--! <td>CPZ <= AxB<B> k</B></td>
|
--! <td>CPZ <= AxB<B> k</B></td>
|
--! </tr>
|
--! </tr>
|
--! </table>
|
--! </table>
|
--! \n
|
--! \n
|
--! <table>
|
--! <table>
|
--! <tr>
|
--! <tr>
|
--! <th></th>
|
--! <th></th>
|
--! <th></th><th>addcode=1</th><th></th>
|
--! <th></th><th>addcode=1</th><th></th>
|
--! </tr>
|
--! </tr>
|
--! <tr>
|
--! <tr>
|
--! <th>Opcode 1</th>
|
--! <th>Opcode 1</th>
|
--! <td>CPX <= CxD<B> i</B></td>
|
--! <td>CPX <= CxD<B> i</B></td>
|
--! <td>CPY <= CxD<B> j</B></td>
|
--! <td>CPY <= CxD<B> j</B></td>
|
--! <td>CPZ <= CxD<B> k</B></td>
|
--! <td>CPZ <= CxD<B> k</B></td>
|
--! </tr>
|
--! </tr>
|
--! </table>
|
--! </table>
|
--! \n
|
--! \n
|
--! - Producto Punto (opcode = 0):
|
--! - Producto Punto (opcode = 0):
|
--! - Dot Product (opcode = 0):
|
--! - Dot Product (opcode = 0):
|
--! \n\n
|
--! \n\n
|
--! \t Los resultados se encontraran en DP0 y DP1 4 clocks despues de la carga.
|
--! \t Los resultados se encontraran en DP0 y DP1 4 clocks despues de la carga.
|
--! \n\n
|
--! \n\n
|
--! <table>
|
--! <table>
|
--! <tr>
|
--! <tr>
|
--! <th></th><th>addcode, ignorar</th>
|
--! <th></th><th>addcode, ignorar</th>
|
--! </tr>
|
--! </tr>
|
--! <tr>
|
--! <tr>
|
--! <th>opcode=0</th><td> DP0 = A.B, DP1 = C.D</td>
|
--! <th>opcode=0</th><td> DP0 = A.B, DP1 = C.D</td>
|
--! </tr>
|
--! </tr>
|
--! </table>
|
--! </table>
|
--! \n\n
|
--! \n\n
|
--! A partir de la revision 77 (30 de Mayo de 2011) se defini'o funcionalidad extra que le añade las operaciones de suma de vectores y la posibilidad de tener en la salida los valores de los multiplicadores de la etapa M del UF. Esta funcionalidad extra se puede usar sin necesidad de usar las señales opcode y addcode.
|
--! A partir de la revision 77 (30 de Mayo de 2011) se defini'o funcionalidad extra que le añade las operaciones de suma de vectores y la posibilidad de tener en la salida los valores de los multiplicadores de la etapa M del UF. Esta funcionalidad extra se puede usar sin necesidad de usar las señales opcode y addcode.
|
--! \n\n
|
--! \n\n
|
--! Suma de vectores: Las salidas addAB y addCD, son los valores que contienen el resultado de las operaciones vectoriales A+B y C+D respectivamente. Este valor aparecer'a un periodo de reloj despu'es de que se registran los operandos y su representaci'on en punto fijo es A(7,10).
|
--! Suma de vectores: Las salidas addAB y addCD, son los valores que contienen el resultado de las operaciones vectoriales A+B y C+D respectivamente. Este valor aparecer'a un periodo de reloj despu'es de que se registran los operandos y su representaci'on en punto fijo es A(7,10).
|
--! \n\n
|
--! \n\n
|
--! Valor de los productos de los multiplicadores: La utilidad principal de esta salida es multiplicar un vector por un escalar. Para ello la unidad se debe programar en modo producto punto (opcode=0) y uno de los vectores -A 'o B y C 'o D- debe tener todos sus componentes con el valor escalar por el cual se desea multiplicar.
|
--! Valor de los productos de los multiplicadores: La utilidad principal de esta salida es multiplicar un vector por un escalar. Para ello la unidad se debe programar en modo producto punto (opcode=0) y uno de los vectores -A 'o B y C 'o D- debe tener todos sus componentes con el valor escalar por el cual se desea multiplicar.
|
|
|
entity raytrac is
|
entity raytrac is
|
generic (
|
generic (
|
testbench_generation : string := "NO";
|
testbench_generation : string := "NO";
|
registered : string := "NO" --! Este parametro, por defecto "YES", indica si se registran o cargan en registros los vectores A,B,C,D y los codigos de operacion opcode y addcode en vez de ser conectados directamente al circuito combinatorio. \n This parameter, by default "YES", indicates if vectors A,B,C,D and operation code inputs opcode are to be loaded into a register at the beginning of the pipe rather than just connecting them to the operations decoder (opcoder).
|
registered : string := "NO" --! Este parametro, por defecto "YES", indica si se registran o cargan en registros los vectores A,B,C,D y los codigos de operacion opcode y addcode en vez de ser conectados directamente al circuito combinatorio. \n This parameter, by default "YES", indicates if vectors A,B,C,D and operation code inputs opcode are to be loaded into a register at the beginning of the pipe rather than just connecting them to the operations decoder (opcoder).
|
);
|
);
|
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.
|
|
sqrt0,sqrt1 : out std_logic_vector(17 downto 0);
|
addABx,addABy,addABz,addCDx,addCDy,addCDz : out std_logic_vector(17 downto 0);--! Suma de vectores.
|
addABx,addABy,addABz,addCDx,addCDy,addCDz : out std_logic_vector(17 downto 0);--! Suma de vectores.
|
subABx,subABy,subABz,subCDx,subCDy,subCDz : out std_logic_vector(17 downto 0);--! Suma de vectores.
|
subABx,subABy,subABz,subCDx,subCDy,subCDz : out std_logic_vector(17 downto 0);--! Suma de vectores.
|
CPX,CPY,CPZ,DP0,DP1,kvx0,kvy0,kvz0,kvx1,kvy1,kvz1 : 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,kvx0,kvy0,kvz0,kvx1,kvy1,kvz1 : 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.
|
--! Arquitectura general del RayTrac. \n RayTrac general architecture.
|
|
|
--! La Arquitectura general de RayTrac se consiste en 3 componentes esenciales:
|
--! 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 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 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.
|
--! - Etapa aritmetica del calculo del producto punto o el producto cruz segun el caso.
|
--! \n\n
|
--! \n\n
|
--! Las senales referidas en la arquitectura simplemente son conectores asignadas en la instanciación de los componentes y en la asignacion entre ellas mismas en los procesos explicitos.
|
--! Las senales referidas en la arquitectura simplemente son conectores asignadas en la instanciación de los componentes y en la asignacion entre ellas mismas en los procesos explicitos.
|
--! \n\n
|
--! \n\n
|
--! RayTrac general architecture is made of 3 essential components:
|
--! RayTrac general architecture is made of 3 essential components:
|
--! - Register stage to load operation code and operators.
|
--! - Register stage to load operation code and operators.
|
--! - Combinatory Stage to operator selection, depending on the operation code.
|
--! - Combinatory Stage to operator selection, depending on the operation code.
|
--! - Arithmetic stage to calculate dot product or cross product, depending on the case.
|
--! - Arithmetic stage to calculate dot product or cross product, depending on the case.
|
--! \n\n
|
--! \n\n
|
--! Referred signals in the architecture are simple connectors assigned in the components intantiation and in the assignation among them in explicit processes.
|
--! Referred signals in the architecture are simple connectors assigned in the components intantiation and in the assignation among them in explicit processes.
|
|
|
|
|
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 to register or bypass the vector inputs.
|
signal SA,SB,SC,SD : std_logic_vector(18*3-1 downto 0); --! Signal to register or bypass the vector inputs.
|
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
|
|
|
reg:
|
reg:
|
if registered="YES" generate
|
if registered="YES" generate
|
|
|
--! By default: the inputs are going to be registered or loaded. This process describes how the register loading is to be make. \n Por defecto: las entradas se van a registrar o cargar. Este proceso describe como la carga de los registros con los valores de las entradas se va a realizar.
|
--! By default: the inputs are going to be registered or loaded. This process describes how the register loading is to be make. \n Por defecto: las entradas se van a registrar o cargar. Este proceso describe como la carga de los registros con los valores de las entradas se va a realizar.
|
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;
|
|
|
notreg:
|
notreg:
|
if registered="NO" generate
|
if registered="NO" generate
|
--! Just bypass or connect the inputs to the opcoder.
|
--! Just bypass or connect the inputs to the opcoder.
|
procNotReg:
|
procNotReg:
|
process (A,B,C,D,opcode,addcode)
|
process (A,B,C,D,opcode,addcode)
|
begin
|
begin
|
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 process procNotReg;
|
end process procNotReg;
|
end generate notreg;
|
end generate notreg;
|
--! El siguiente sumador es un sumador de 18 bits por lo tanto no se utiliza el sumador de 32 bits en la etapa SR del UF.
|
--! El siguiente sumador es un sumador de 18 bits por lo tanto no se utiliza el sumador de 32 bits en la etapa SR del UF.
|
|
|
|
procaddsub:
|
|
process (clk,rst,SA,SB,SC,SD)
|
|
begin
|
|
|
|
if rst=rstMasterValue then
|
|
addABx <= (others => '0');
|
|
addABy <= (others => '0');
|
|
addABz <= (others => '0');
|
|
subABx <= (others => '0');
|
|
subABy <= (others => '0');
|
|
subABz <= (others => '0');
|
|
elsif clk'event and clk='1' then
|
addABx <= SA(17 downto 0) + SB(17 downto 0);
|
addABx <= SA(17 downto 0) + SB(17 downto 0);
|
addABy <= SA(35 downto 18) + SB(35 downto 18);
|
addABy <= SA(35 downto 18) + SB(35 downto 18);
|
addABz <= SA(53 downto 36) + SB(53 downto 36);
|
addABz <= SA(53 downto 36) + SB(53 downto 36);
|
addCDx <= SC(17 downto 0) + SD(17 downto 0);
|
addCDx <= SC(17 downto 0) + SD(17 downto 0);
|
addCDy <= SC(35 downto 18) + SD(35 downto 18);
|
addCDy <= SC(35 downto 18) + SD(35 downto 18);
|
addCDz <= SC(53 downto 36) + SD(53 downto 36);
|
addCDz <= SC(53 downto 36) + SD(53 downto 36);
|
subABx <= SA(17 downto 0) - SB(17 downto 0);
|
subABx <= SA(17 downto 0) - SB(17 downto 0);
|
subABy <= SA(35 downto 18) - SB(35 downto 18);
|
subABy <= SA(35 downto 18) - SB(35 downto 18);
|
subABz <= SA(53 downto 36) - SB(53 downto 36);
|
subABz <= SA(53 downto 36) - SB(53 downto 36);
|
subCDx <= SC(17 downto 0) - SD(17 downto 0);
|
subCDx <= SC(17 downto 0) - SD(17 downto 0);
|
subCDy <= SC(35 downto 18) - SD(35 downto 18);
|
subCDy <= SC(35 downto 18) - SD(35 downto 18);
|
subCDz <= SC(53 downto 36) - SD(53 downto 36);
|
subCDz <= SC(53 downto 36) - SD(53 downto 36);
|
|
end if;
|
|
|
|
end process procaddsub;
|
|
|
--! 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
|
generic map ("YES",testbench_generation,"RCA")
|
generic map ("YES",testbench_generation,"RCA")
|
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,kvx0,kvy0,kvz0,kvx1,kvy1,kvz1
|
CPX,CPY,CPZ,DP0,DP1,kvx0,kvy0,kvz0,kvx1,kvy1,kvz1
|
clk,rst
|
clk,rst
|
);
|
);
|
|
|
end raytrac_arch;
|
end raytrac_arch;
|
|
|
|
|
|
|
