From 770b5bd4c6e9383e840319c69a64dfb47be833d4 Mon Sep 17 00:00:00 2001 From: Austin Seipp Date: Fri, 11 Jan 2019 15:55:56 -0600 Subject: [PATCH] scripts/icestorm: add readme Notes about how to build proper simulation vs hardware bitstreams. Signed-off-by: Austin Seipp --- scripts/icestorm/readme.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) create mode 100644 scripts/icestorm/readme.md diff --git a/scripts/icestorm/readme.md b/scripts/icestorm/readme.md new file mode 100644 index 0000000..101391f --- /dev/null +++ b/scripts/icestorm/readme.md @@ -0,0 +1,12 @@ +To build the example LED-blinking firmware for an HX8K Breakout Board and get +a timing report (checked against the default 12MHz oscillator): + + $ make clean example.bin timing + +To run all the simulation tests: + + $ make clean example_sim synth_sim route_sim FIRMWARE_COUNTER_BITS=4 + +(You must run the `clean` target to rebuild the firmware with the updated +`FIRMWARE_COUNTER_BITS` parameter; the firmware source must be recompiled for +simulation vs hardware, but this is not tracked as a Makefile dependency.)