URL
https://opencores.org/ocsvn/openrisc_2011-10-31/openrisc_2011-10-31/trunk
Subversion Repositories openrisc_2011-10-31
Compare Revisions
- This comparison shows the changes necessary to convert path
/
- from Rev 563 to Rev 564
- ↔ Reverse comparison
Rev 563 → Rev 564
/openrisc/trunk/orpsocv2/doc/orpsoc.texi
164,7 → 164,7
|
Typically, a board-targeted design will wish to reuse common components (processor, debug interface, Wishbone arbiters, UART etc.) |
|
The project has been configured so a board build will use modules in the ``common'' RTL path (@code{rtl/verilog/}) @emph{unless} there is a copy in the board's ``local'' RTL path ( @code{boards/vendor/boardname/rtl/verilog}). |
The project has been configured so a board build will use modules in the ``common'' RTL path (@code{rtl/verilog/}) @emph{unless} there is a copy in the board's ``local'' RTL path ( @code{boards/vendor/boardname/rtl/verilog}) or the board includes an external module in @code{boards/vendor/boardname/modules}. |
|
For example, in the event that modification to a module in the common RTL set is required for it to function correctly in a board build, it's advisable to copy that module to the board's @emph{local} RTL path and modify it there. Simulation and backend scripts should then use this board-specific version instead of the one in the common RTL path. |
|
288,6 → 288,8
|
The directory structure consists of an @code{rtl} directory in the root, and a @code{verilog} path under that. Within the @code{rtl/verilog} path, each module has its own directory. |
|
External modules using the OpenCores structure can be put under each boards @code{modules} directory. The scripts will the look for verilog files under @code{modules/<module_name>/rtl/verilog}. |
|
A common Verilog include path, @code{rtl/verilog/include} directory is used. The Verilog HDL include files for each module should be moved here. This allows each @value{ORPSOC} implementation (board design) to maintain their own include path, and thus configure the modules for their specific implementation. |
|
@node Reference Design Software |
883,8 → 885,10
@itemize @bullet |
@item RTL Files |
|
Create a directory under the board's @code{rtl/verilog} directory, and name it the same as the top level of the module. |
Create a directory under the board's @code{rtl/verilog} directory, and name it the same as the top level of the module. |
|
|
|
Ensure the module's top level file and actual name of the module when it will be instantiated are @emph{all the same}. |
|
Place any include files into the board's @code{rtl/verilog/include} path. |
1310,12 → 1314,17
@itemize @bullet |
@item RTL Files |
|
Create a directory under the board's @code{rtl/verilog} directory, and name it the same as the top level of the module. |
@itemize @bullet |
@item Create a directory under the board's @code{rtl/verilog} directory, and name it the same as the top level of the module. |
|
Ensure the module's top level file and actual name of the module when it will be instantiated are @emph{all the same}. |
@emph{or} |
|
Place any include files into the board's @code{rtl/verilog/include} path. |
Create a directory under the board's @code{modules} directory, containing a @code{rtl/verilog} directory, and name it the same as the top level of the module |
|
@item Ensure the module's top level file and actual name of the module when it will be instantiated are @emph{all the same}. |
|
@item Place any include files into the board's @code{rtl/verilog/include} path. |
@end itemize |
@item Instantiate in ORPSoC Top Level File |
|
Instantiate the module in the ORPSoC top level file, @code{rtl/verilog/orpsoc_top/orpsoc_top.v}, and be sure to take care of the following. |