X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=index.mdwn;h=196d7d88c7e085c00db7a6b0a0ba627adf4322cd;hb=407c6e304055e132b58c14aa853945abe4984815;hp=4852f8a6fb91822c780836d474f88e9b239ca2ed;hpb=2c5fa07ef7631082630dabc257ba667bc9e828e0;p=libreriscv.git

diff --git a/index.mdwn b/index.mdwn
index 4852f8a6f..196d7d88c 100644
--- a/index.mdwn
+++ b/index.mdwn
@@ -1,52 +1,49 @@
 <div class="jumbotron">
-  <h1 class="display-4">Welcome to Libre-SOC</h1>
+  <h1 class="display-5">Welcome to Libre-SOC</h1>
 <blockquote>
   <p>We're building a chip. A fast chip. A safe chip. A trusted chip.</p>
-  
+
   <p>A chip with lots of peripherals. And a VPU.  And a 3D GPU...</p>
-  
+
   <p>Oh and here, have the <a href="http://git.libre-riscv.org">source code</a>...</p>
 </blockquote>
   <hr class="my-4">
 
-<h2 class="display-4">Why should I care?</h2>
+<h2 class="display-5">Why should I care?</h2>
 
-With LibreSOC, you can take complex algorithms usually intended for power 
+With LibreSOC, you can take complex algorithms usually intended for
+power hungry servers with big fat GPUs, and run them on tiny devices
+like smartwatches, cellphones, and pocket drones without changing your
+code at all.
 
-hungry servers with big fat GPUs, and run them on tiny devices like smartwatches, 
-
-cellphones, and pocket drones without changing your code at all.
   <hr class="my-4">
 
-<h2 class="display-4">Hasn't Somebody Already Done This?</h2>
-
-To the best of our knowledge, no. The closest systems would be ARM Cortex devices 
+<h2 class="display-5">Hasn't Somebody Already Done This?</h2>
 
-which currently offer mediocre GPU and OpenCL support. Often times, it is quite 
-
-diffcult for customers to get their hands on the drivers and install them due to 
-
-their locked down nature. LibreSOC is providing our own Free/Libre drivers. Easy as 
-1, 2, 3!
+To the best of our knowledge, no. The closest systems would be ARM Cortex
+devices which currently offer mediocre GPU and OpenCL support. Often
+times, it is quite diffcult for customers to get their hands on the
+drivers and install them due to their locked down nature. LibreSOC is
+providing our own Free/Libre drivers. Easy as 1, 2, 3!
 
   <hr class="my-4">
 
-<h2 class="display-4">Does Open Hardware Really Work?</h2>
+<h2 class="display-5">Does Open Hardware Really Work?</h2>
 <p>A few names come to mind:</p>
 
 <ul>
 <li><a href="https://www.raspberrypi.org">Raspberry Pi</a></li>
 <li><a href="https://www.arduino.cc">Arduino</a></li>
 <li><a href="https://www.raptorcs.com">Raptor Computing Systems</a></li>
+<li><a href="https://www.bitcraze.io">CrazyFlie</a></li>
 <li><a href="https://www.scopefun.com">ScopeFun</a></li>
 </ul>
 
   <p class="lead">
     <a class="btn btn-primary btn-lg" href="https://libre-soc.org/why_a_libresoc/" role="button">Learn more</a>
-  </p>
 
 </div>
-</div>
+
 
 
 # Our Team
@@ -67,7 +64,10 @@ funding and always appreciate more!  If you are a Corporation or an
 individual you can donate tax-free to NLNet, and they can in turn gift
 our developers.  Contact lkcl@lkcl.net for more information.
 
-If you want to write code with us, keep reading.  If you want to *learn* so that you can write code with us, see below.  If there is anything else, just get in touch on the list, there is plenty to do.
+If you want to write code with us (and receive donations from NLNet
+for doing so), keep reading.  If you want to *learn*
+so that you can write code with us, see below.  If there is anything else,
+just get in touch on the list, there is plenty to do.
 
 1. First, join the
 [mailing list](http://lists.libre-riscv.org/mailman/listinfo/libre-riscv-dev),
@@ -78,27 +78,66 @@ happy with it and agree to it.
 2. The next thing you should do is read through the [bugs
 list](http://bugs.libre-riscv.org) and see if there are any bugs that
 pique your interest.
-3. After that, go ahead and take a look at the
-   [git repositories](https://git.libre-riscv.org).
-Try and clone a repository with
-``git clone https://git.libre-riscv.org/git/repositoryname.git``
+3. After that, go ahead and take a look at the    [git repositories](https://git.libre-riscv.org).
+
+<div class="jumbotron">
+<p>pip3 install virtualenv requests
+</p>
+<p>mkdir ~/.virtualenvs && cd ~/.virtualenvs
+</p>
+<p>python3 -m venv libresoc
+</p>
+<p>source ~/.virtualenvs/bin/activate
+</p>
+<p>
+</p>
+<p>cd ~; mkdir libresoc; cd libresoc
+</p>
+<p>git clone https://git.libre-riscv.org/git/nmutil.git
+</p>
+<p>git clone https://git.libre-riscv.org/git/ieee754fpu.git
+</p>
+<p>git clone https://git.libre-riscv.org/git/soc.git
+</p>
+<p>
+</p>
+<p>cd nmutil; pip3 install -e .; cd ..
+</p>
+<p>cd ieee754fpu; pip3 install -e .; cd ..
+</p>
+<p>cd soc; pip3 install -e .; cd ..
+</p>
+<p>
+</p>
+<p>#play with the decoder
+</p>
+<p>python3 soc/src/soc/decoder/power_decoder.py
+</div>
+
+
 4. If you plan to do HDL work, you should familiarize yourself with our
    [[HDL_workflow]].
 5. We do have funding available (see [[nlnet]]) upon completion of issues -
 we are also working on procuring more funding which gets the project to
 nanometre scale tapeout.
-6. After all this, if you feel that Libre-SOC is a something that
-you would like to contribute to, add yourself to the [current_members](about_us)
-page, fill in some information about yourself, and join the mailing list
-and say hello.
+6. After all this, if you feel that Libre-SOC is a something
+   that you would like to contribute to, add yourself to the
+   [current_members](about_us) page, fill in some information about yourself,
+   and join the mailing list and say hello.
 
 Also note that you can edit this wiki.  You can experiment in the [[Sandbox]].
 
 ## How can I learn?
 
-The whole purpose of this project is to be a learning environment as well as an actual business.  If you want to learn how to do ASIC design, with a view to contributing or starting your own ASIC business, start here: [[3d_gpu/tutorial]]. Yes, really: do not let anyone tell you that you can't learn this stuff too.
+The whole purpose of this project is to be a learning environment as well
+as an actual business.  If you want to learn how to do ASIC design, with
+a view to contributing or starting your own ASIC business, start here:
+[[3d_gpu/tutorial]]. Yes, really: do not let anyone tell you that you
+can't learn this stuff too.
 
-Along the way, if you find any [[resources]] or links that you found particularly helpful, please add them to that page so that other people can also benefit (and you have a place to remember them, too).
+Along the way, if you find any [[resources]] or links that you found
+particularly helpful, please add them to that page so that other people
+can also benefit (and you have a place to remember them, too).
 
 ## Needed Skills
 
@@ -119,4 +158,3 @@ design. See [[HDL_workflow]]
 
 Also, individuals with experience in formal mathematical verification
 are quite welcome.
-