2013-11-09 09:27:32 -05:00
|
|
|
[> MiSoC system-on-chip
|
2012-02-14 09:43:09 -05:00
|
|
|
------------------------------
|
|
|
|
|
|
2014-02-16 08:51:52 -05:00
|
|
|
A high performance and small footprint system-on-chip design based on Migen.
|
2012-02-14 09:43:09 -05:00
|
|
|
|
2013-11-09 09:27:32 -05:00
|
|
|
MiSoC supports the Mixxeo and the Milkymist One.
|
2014-02-16 08:51:52 -05:00
|
|
|
Obtain your development system at http://m-labs.hk
|
2012-02-14 09:43:09 -05:00
|
|
|
|
2012-06-03 16:17:34 -04:00
|
|
|
[> Instructions (software)
|
|
|
|
|
--------------------------
|
|
|
|
|
1. Compile and install binutils. Take the latest version from GNU.
|
2013-02-16 17:41:42 -05:00
|
|
|
mkdir build && cd build
|
|
|
|
|
../configure --target=lm32-elf
|
2012-06-03 16:17:34 -04:00
|
|
|
make
|
|
|
|
|
make install
|
|
|
|
|
|
2013-02-16 17:41:42 -05:00
|
|
|
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
|
2012-06-03 16:17:34 -04:00
|
|
|
make
|
|
|
|
|
make install
|
|
|
|
|
|
2013-01-10 11:59:00 -05:00
|
|
|
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
|
2012-06-03 16:17:34 -04:00
|
|
|
|
2013-01-10 11:59:00 -05:00
|
|
|
4. Build and flash the BIOS (part of this source distribution).
|
2012-06-03 16:17:34 -04:00
|
|
|
cd software/bios
|
|
|
|
|
make
|
|
|
|
|
make flash
|
|
|
|
|
|
2013-07-31 17:29:26 -04:00
|
|
|
The second command requires m1nor-ng, FJMEM and UrJTAG.
|
2013-02-16 17:41:42 -05:00
|
|
|
These tools can be found at:
|
2013-11-23 05:29:20 -05:00
|
|
|
https://github.com/m-labs/fjmem-m1
|
2012-06-03 16:20:50 -04:00
|
|
|
http://urjtag.org
|
2012-06-03 16:17:34 -04:00
|
|
|
|
|
|
|
|
[> Instructions (gateware)
|
|
|
|
|
--------------------------
|
2012-02-14 09:43:09 -05:00
|
|
|
First, download and install Migen from:
|
2013-11-23 05:29:20 -05:00
|
|
|
https://github.com/m-labs/migen
|
2012-02-14 09:43:09 -05:00
|
|
|
|
|
|
|
|
Once this is done, build the bitstream with:
|
2013-07-04 13:19:39 -04:00
|
|
|
./make.py [-p <platform>] -l
|
|
|
|
|
This will generate the build/soc-<platform>.bit programming file
|
|
|
|
|
and load it with UrJTAG.
|
2012-02-14 09:43:09 -05:00
|
|
|
|
2013-11-09 09:27:32 -05:00
|
|
|
A new BIOS needs to be built and flashed for MiSoC.
|
|
|
|
|
There is no compatibility with Milkymist SoC.
|
2012-02-14 09:43:09 -05:00
|
|
|
|
|
|
|
|
Enjoy!
|
|
|
|
|
|
|
|
|
|
[> Misc
|
|
|
|
|
-------
|
|
|
|
|
Code repository:
|
2013-11-23 05:29:20 -05:00
|
|
|
https://github.com/m-labs/misoc
|
2012-02-14 09:43:09 -05:00
|
|
|
|
2013-11-09 09:27:32 -05:00
|
|
|
MiSoC is released under the very permissive two-clause BSD license. Under
|
|
|
|
|
the terms of this license, you are authorized to use MiSoC for
|
2013-07-31 17:20:32 -04:00
|
|
|
closed-source proprietary designs.
|
|
|
|
|
Even though we do not require you to do so, those things are awesome, so please
|
|
|
|
|
do them if possible:
|
2013-11-09 09:27:32 -05:00
|
|
|
* tell us that you are using MiSoC
|
|
|
|
|
* cite MiSoC in publications related to research it has helped
|
2013-07-31 17:20:32 -04:00
|
|
|
* send us feedback and suggestions for improvements
|
|
|
|
|
* send us bug reports when something goes wrong
|
2013-11-09 09:27:32 -05:00
|
|
|
* send us the modifications and improvements you have done to MiSoC.
|
2013-07-31 17:20:32 -04:00
|
|
|
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
|
2013-11-23 05:29:20 -05:00
|
|
|
the mailing list or IRC (#m-labs on Freenode) beforehand.
|
2012-02-14 09:43:09 -05:00
|
|
|
|
2013-07-31 17:20:32 -04:00
|
|
|
See LICENSE file for full copyright and license info. You can contact us on the
|
2014-02-16 08:51:52 -05:00
|
|
|
public mailing list devel [AT] lists.m-labs.hk.
|
