Partial Walkthrough: from HDL to binary config, using iCEcube2

A project log for DIPSY

DIY System on Chip based on FPGA, priced below 5 USD

ChristophChristoph 08/29/2015 at 12:360 Comments

We want to pick you up right where you are, and that's probably in some cozy arduino environment. Or in your garden (this seems to be a popular place in this year's prize). Let's take a piece of Verilog and compile it into a binary!

After you started iCECube2 you should see a simple main window with menus, a project property tree and an inactive editor area:

In the project tree, double-click "New Project". The project and device setup dialog appears:

The project wizard now asks for "Files to add" - we can now add HDL files, both VHDL and Verilog are ok. One quirk is that we can't create new files in this dialog, so we have to create a new file externally. Open your favourite editor and add the following magic:

module top (
// input:
// outputs:

output ledout;

wire hfosc_clk;
wire led;
wire ledout;

) /* synthesis ROUTE_THROUGH_FABRIC= [0] */; // don't know the implications of this, sorry
defparam OSCInst0.CLKHF_DIV = "0b00"; // divide by 1; 48 MHz output

defparam RGBA_DRIVER.CURRENT_MODE = "0b0";
defparam RGBA_DRIVER.RGB0_CURRENT = "0b1";
defparam RGBA_DRIVER.RGB1_CURRENT = "0b1";
defparam RGBA_DRIVER.RGB2_CURRENT = "0b1";

reg[31:0] cnt = 0;
reg[31:0] factor = 48000000; // divide clock down to 1 Hz

reg divout = 1'b0;
assign led = divout;

always @(posedge hfosc_clk)
  if(factor != 0)
    cnt = cnt + 1;
  if (cnt == factor)
      cnt = 0;
      divout = ~divout;

Save the file wherever you want to, but please pick a place you can find again!

Add the file to you project:

make sure to not only select your files, but to move them into the right part of the window by double-clicking the file or by selecting it/them and clicking ">>". Click "Finish".

Before we can synthesize out design we need to pick the correct synthesis tool. Right-click the respective tree item:

Select "Lattice LSE" in the dialog that pops up.

Now, to synthesize, go to Tool -> Run All. If everything is fine, iCEcube2 will do all synthesis, place & route or whatever else is needed (I have no clue, to be honest) and give you a binary file that you can use to configure a dipsy.