Root/m1/tools/README

1m1nor - Flash a file to M1 NOR partition selected by the file name
2==================================================================
3
4During software development, one often need to update only the
5content of a single partition. reflash_m1.sh is a bit unwieldy
6for this kind of task.
7
8I've written a small script called m1nor that selects the target
9partition based on the file name. E.g., m1nor flickernoise.fbi
10would update the regular Flickernoise partition.
11
12The matching algorithm checks the beginning of the file name,
13so names like flickernoise-test.fbi would also work. Furthermore,
14it checks the file extension, so if you try to flash flickernoise
15(ELF, for debugging) or flickernoise.bin (an intermediate form
16unsuitable for booting from NOR), it will politely refuse to do
17so.
18
19You need to have fjmem.bit somwehere. It searches for it under
20$HOME/.qi/milkymist/, where reflash_m1.sh caches it. You can also
21specify the location directly by setting the environment variable
22FJMEM_BIT.
23
24
25xdltap - Route nets from inside the FPGA to I/O pads
26====================================================
27
28xdltap adds routes from signals inside the FPGA to I/O pads. It
29does this by converting the .ncd file generated by synthesis
30
31xdltap signal=output ... [xdl-file]
32
33The path to the signal to be tapped has to be fully qualified.
34Note that not all signals are listed in the .pcf file. Some may
35only show up in .xdl
36
37The output is the name of a global net that has to be connected
38to an input (!) pad.
39
40Signal names containing < and > can be written with { and }, to
41avoid extra escaping for the shell.
42
43Since xdl chokes on its own .xdl files, xdlfixes applies a number
44of ugly hacks to either avoid errors or to propagate them to a
45later stage, where they can be ignored.
46
47Example:
48
49map ... foo.ngd # generates foo.ncd
50xdl -ncd2xdl foo.ncd # generates foo.xdl
51xdltap usb/sie/rx_pending=exp{8} foo.xdl | xdlfixes >foo-dbg.xdl
52xdl -xdl2ncd foo-dbg.xdl # generates foo-dbg.ncd
53par ... foo-dbg.ncd ...
54

Archive Download this file

Branches:
master



interactive