Add your own design

Step 1: Initialize the directory

Place yourself in your design’s directory, or any other directory.

Run the init command of Odatix to create configuration files.

odatix init

Step 2: Architecture folder

Create a folder named after your design in the odatix_userconfig/architectures folder.

Step 3: Architecture settings file

• Add a _settings.yml file to your newly created folder and fill it with one of the templates below

VHDL/Verilog/SystemVerilog

_setting.yml

---
rtl_path: "examples/alu_sv"

top_level_file: "alu_top.sv"
top_level_module: "alu_top"

clock_signal: "i_clk"
reset_signal: "i_rst"

# copy a file into synthesis directory?
file_copy_enable: "false"
file_copy_source: "/dev/null"
file_copy_dest: "/dev/null"

# delimiters for parameter files
use_parameters: "true"
start_delimiter: "#("
stop_delimiter: ")("

# target-specific options
xc7s25-csga225-1:
   fmax_synthesis:
      lower_bound: 100
      upper_bound: 450
   custom_freq_synthesis:
      # list definition
      list: [50, 100]
xc7a100t-csg324-1:
   fmax_synthesis:
      lower_bound: 150
      upper_bound: 800
   custom_freq_synthesis:
      # range definition
      lower_bound: 200
      upper_bound: 1800
      step: 200
...

Chisel/HLS

_setting.yml

---
# generate the rtl (from chisel for example)
generate_rtl: "true"
generate_command: "sbt 'runMain ALUTop --o=rtl'" # command for rtl generation

design_path: "examples/alu_chisel"
rtl_path: "examples/alu_chisel/rtl"

# generated design settings
top_level_file: "ALUTop.sv"
top_level_module: "ALUTop"
clock_signal: "clock"
reset_signal: "reset"

# copy a file into synthesis directory?
file_copy_enable: "false"
file_copy_source: "/dev/null"
file_copy_dest: "/dev/null"

# delimiters for parameter files
use_parameters: "true"
param_target_file: "src/main/scala/ALUTop.scala"
start_delimiter: "new ALUTop("
stop_delimiter: ")"

# target-specific options
xc7s25-csga225-1:
   fmax_synthesis:
      lower_bound: 100
      upper_bound: 450
   custom_freq_synthesis:
      # list definition
      list: [50, 100]
xc7a100t-csg324-1:
   fmax_synthesis:
      lower_bound: 150
      upper_bound: 800
   custom_freq_synthesis:
      # range definition
      lower_bound: 200
      upper_bound: 1800
      step: 200
...

• Edit the file, so it matches your design source files directory, top level filename, module name, and clock signal name.

• The rtl/design path can be both absolute or relative to the directory from where you start Odatix.

• Set start_delimiter and stop_delimiter, so it matches the delimiters of the parameter section in your top level source file.

• Add target-specific bounds for the binary search in fmax_synthesis.

• Add a list of frequencies, a range (lower and upper bounds and a step) or a combination of both in custom_freq_synthesis for custom frequency synthesis.

• A documentation of the keys for _settings.yml files can be found in section Settings

Step 4: Parameter files

Add parameter files to the folder. Parameter files should match the parameter section of your top-level source file with the desired values.

For instance, with the following Verilog module

alu_top.sv

module alu_top #(
   parameter BITS = 8
)(
   input  wire            i_clk,
   input  wire            i_rst,
   input  wire      [4:0] i_sel_op,
   input  wire [BITS-1:0] i_op_a,
   input  wire [BITS-1:0] i_op_b,
   output wire [BITS-1:0] o_res
);

One of the parameter file could contain:

16bits.txt

  parameter BITS = 16

Another parameter file could contain:

32bits.txt

  parameter BITS = 32

You can create as many parameter files as you wish, with different parameter values. There is no limit to the number of parameters in parameter files. The only constraint is the strict correspondence between the contents of the parameter files and the parameter section of the top-level in terms of numbers and names.

Step 5: Run your design configurations!

Follow the same steps as in section Fmax synthesis for Fmax synthesis or Custom Frequency synthesis for custom frequency synthesis.:

• Edit odatix_userconfig/fmax_synthesis_settings.yml to add your design’s configurations

• Edit odatix_userconfig/custom_freq_synthesis_settings.yml to add your design’s configurations

• Select the target device or technology in the yaml file corresponding to your EDA tool.

• Run the selected designs

• Visualize and explore the results