Build your hardware, easily!
Go to file
Sebastien Bourdeauducq 4ba796417d software: do not attempt to build network/sdram drivers when cores are not present 2013-11-24 23:50:09 +01:00
build Initial import 2011-12-13 17:33:12 +01:00
common use git commit id as version 2013-11-09 16:38:44 +01:00
misoclib rename create_sdram_modules and add register_rom 2013-11-24 20:16:19 +01:00
software software: do not attempt to build network/sdram drivers when cores are not present 2013-11-24 23:50:09 +01:00
targets rename create_sdram_modules and add register_rom 2013-11-24 20:16:19 +01:00
tb use new lasmibus.Crossbar master API 2013-11-23 17:51:41 +01:00
tools rename milkymist-ng to MiSoC 2013-11-09 15:27:32 +01:00
verilog use git commit id as version 2013-11-09 16:38:44 +01:00
.gitignore generate linker memory map, move all generated files into the same folder 2013-11-24 19:50:17 +01:00
.gitmodules lm32: use submodule 2013-02-24 15:57:19 +01:00
LICENSE rename milkymist-ng to MiSoC 2013-11-09 15:27:32 +01:00
README update pointers 2013-11-23 11:29:20 +01:00
jtag.py Mixxeo support 2013-07-04 19:19:39 +02:00
make.py allow BIOS data to be passed to design 2013-11-24 22:14:46 +01:00

README

[> MiSoC system-on-chip
------------------------------

A high performance system-on-chip design based on Migen.

MiSoC supports the Mixxeo and the Milkymist One.
Obtain your development system at http://milkymist.org

[> Instructions (software)
--------------------------
1. Compile and install binutils. Take the latest version from GNU.
  mkdir build && cd build
  ../configure --target=lm32-elf
  make
  make install
  
2. Compile and install GCC 4.5. Take gcc-core and gcc-g++ from GNU.
  rm -rf libstdc++-v3
  mkdir build && cd build
  ../configure --target=lm32-elf --enable-languages="c,c++" --disable-libgcc --disable-libssp
  make
  make install

3. Obtain compiler-rt and set the CRTDIR environment variable to the root of 
   its source tree.
  svn co http://llvm.org/svn/llvm-project/compiler-rt/trunk compiler-rt
  export CRTDIR=/path_to/compiler-rt

4. Build and flash the BIOS (part of this source distribution).
  cd software/bios
  make
  make flash

The second command requires m1nor-ng, FJMEM and UrJTAG.
These tools can be found at:
  https://github.com/m-labs/fjmem-m1
  http://urjtag.org
  
[> Instructions (gateware)
--------------------------
First, download and install Migen from:
  https://github.com/m-labs/migen

Once this is done, build the bitstream with:
  ./make.py [-p <platform>] -l
This will generate the build/soc-<platform>.bit programming file
and load it with UrJTAG.

A new BIOS needs to be built and flashed for MiSoC.
There is no compatibility with Milkymist SoC.

Enjoy!

[> Misc
-------
Code repository:
  https://github.com/m-labs/misoc

MiSoC is released under the very permissive two-clause BSD license. Under
the terms of this license, you are authorized to use MiSoC for
closed-source proprietary designs.
Even though we do not require you to do so, those things are awesome, so please
do them if possible:
 * tell us that you are using MiSoC
 * cite MiSoC in publications related to research it has helped
 * send us feedback and suggestions for improvements
 * send us bug reports when something goes wrong
 * send us the modifications and improvements you have done to MiSoC.
   The use of "git format-patch" is recommended. If your submission is large and
   complex and/or you are not sure how to proceed, feel free to discuss it on
   the mailing list or IRC (#m-labs on Freenode) beforehand.

See LICENSE file for full copyright and license info. You can contact us on the
public mailing list devel [AT] lists.milkymist.org.