one more space reduction
[libreriscv.git] / index.mdwn
index e9496b00bab8faaec0df592f70d2d0f19e525c98..0a51220b6187054c517af8158a776a6f37f15635 100644 (file)
@@ -1,11 +1,15 @@
 <div class="jumbotron">
   <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>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>A chip with lots of peripherals. And it's a VPU.  And it's a 3D GPU...
+  </p>
 
-  <p>Oh and here, have the <a href="http://git.libre-riscv.org">source code</a>...</p>
+  <p>Oh and here, have the
+     <a href="http://git.libre-soc.org">Libre-SOC source code</a>...
+   </p>
 </blockquote>
   <hr class="my-4">
 
@@ -32,7 +36,6 @@ providing our own Free/Libre drivers. Easy as 1, 2, 3!
 <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>
@@ -44,14 +47,21 @@ providing our own Free/Libre drivers. Easy as 1, 2, 3!
 
 </div>
 
-
-
 # Our Team
 
-We are proud of our talented and diverse [team](about_us).
+We are proud of our talented and diverse [team](about_us)
+located all across the world: UK US Canada Germany Greece India
+Kuwait.
 
 # Our sponsors and partners
 
+* [NLnet](https://nlnet.nl) who have very kindly sponsored us with
+  over EUR 550,000 in various separate grants.
+* [NGI POINTER](https://www.ngi.eu/ngi-projects/ngi-pointer/) who have
+  sponsored us with a EUR 200,000 Horizon 2020 Grant.
+* [Mythic Beasts](http://mythic-beasts.com) who don't overcommit on
+  their VPS allocations (no memory ballooning), and put servers on
+  the fastest backbone Internet points.
 * [Purism](http://puri.sm) donates to us through [NLNet](nlnet)
   charitable gifting
 * [Raptor CS](http://raptorcs.com) has given us access to a powerful
@@ -61,8 +71,10 @@ We are proud of our talented and diverse [team](about_us).
   interface (more to come)
 * [MarketNext](http://marketnext.org) is helping us connect to developer
   resources in Emerging markets, for completion of NLNet-funded tasks.
-  See the upcoming [Hackathon](https://www.youtube.com/embed/Px6eakWja3Q"),
-  deadline May 15th
+* The [[PowerPC Notebook]] Project
+* [RED Semiconductor](http://redsemiconductor.com) is the commercial realisation of Libre-SOC technology that respects and actively supports Libre principles in its business objectives.
+* [[fed4fire]] for supercomputer access for verilator simulations,
+  with thanks to Ghent University / IMEC.
 
 # How Can I Help?
 
@@ -71,7 +83,7 @@ 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.
 
-# How Can I Help as a Developer?
+# How Can I Help as a Developer? <a name="help_as_developer"></a>
 
 If you want to write code with us (and receive donations from NLNet
 for doing so), keep reading.  If you want to *learn*
@@ -80,52 +92,49 @@ 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),
-introduce yourself (people will happily say "hello" back"). Read through
-[recent posts](http://lists.libre-riscv.org/pipermail/libre-riscv-dev/)
-and the [[charter]], and let everyone know, on the list that you're
-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.  A fascinating way to do that is to view the
-[dependency graph](https://bugs.libre-soc.org/showdependencygraph.cgi?id=1&display=web&rankdir=LR)
-3. After that, go ahead and take a look at the    [git repositories](https://git.libre-riscv.org).
-
+  [mailing list](http://lists.libre-soc.org/mailman/listinfo/libre-soc-dev),
+  introduce yourself (people will happily say "hello" back) and
+  the Libera IRC channel
+  (#libre-soc at irc.libera.chat port 6697, see
+https://libera.chat/guides/connect),
+  it's also accessible via Libera.Chat's Matrix Bridge
+  (`#libre-soc:libera.chat`)
+  [logs here](https://libre-soc.org/irclog/latest.log.html).
+  Read through
+  [recent posts](http://lists.libre-soc.org/pipermail/libre-soc-dev/)
+  and the [[charter]], ask questions if you have any and let everyone know,
+  on the list that you're happy with it and agree to it.
+2. The next thing you should do is read through the
+  [bugs list](http://bugs.libre-soc.org) and
+  see if there are any bugs that pique your interest.
+  A fascinating way to do that is to view the
+  [dependency graph](https://bugs.libre-soc.org/showdependencygraph.cgi?id=1&display=web&rankdir=LR)
+3. After that, go ahead and take a look at the
+   [git repositories](https://git.libre-soc.org).
 4. If you plan to do HDL work, you should familiarize yourself with our
-   [[HDL_workflow]].  If you would like to help with the ASIC layout,
-   see [[HDL_workflow/coriolis2]]
+  [[HDL_workflow]].  If you would like to help with the ASIC layout,
+  see [[HDL_workflow/coriolis2]]
 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.
+  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.
+  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]].
 
 ## Quick peek at the code
 
-Here is an example process of how to play with the soc code:
-
-    pip3 install virtualenv requests
-    mkdir ~/.virtualenvs && cd ~/.virtualenvs
-    python3 -m venv libresoc
-    source ~/.virtualenvs/libresoc/bin/activate
-    
-    cd ~; mkdir libresoc; cd libresoc
-    git clone https://git.libre-riscv.org/git/nmutil.git
-    git clone https://git.libre-riscv.org/git/ieee754fpu.git
-    git clone https://git.libre-riscv.org/git/soc.git
-    
-    cd nmutil; pip3 install -e .; cd ..
-    cd ieee754fpu; pip3 install -e .; cd ..
-    cd soc; git submodule init; git submodule update; pip3 install -e .; cd ..
-    
-    python3 soc/src/soc/decoder/power_decoder.py
-    yosys -p "read_ilang decoder.il; show dec31" 
+The full install process may be automated using scripts found
+here: <https://git.libre-soc.org/?p=dev-env-setup.git;a=summary>
+which you can clone with:
 
+    git clone https://git.libre-soc.org/git/dev-env-setup.git
 
+A convenient page which gives easy step-by-step instructions is: 
+[[HDL_workflow/devscripts]], and you can get started with a
+[[docs/firststeps]] tutorial.
 
 ## How can I learn?
 
@@ -154,10 +163,22 @@ design. See [[HDL_workflow]]
 
 We also need to find a c++ engineer with compiler experience to work on
 a MESA 3D driver. This will begin life similar to SwiftShader however
-retaining the vectorisation and predication intrinsics as well as hardware
-accelerated opcodes (all of which SwiftShader lacks)
+retaining the vectorisation and predication intrinsics then adding
+hardware accelerated opcodes (all of which SwiftShader lacks)
 
 Also, individuals with experience in formal mathematical verification
 are quite welcome.
 
-# [Documentation](Documentation/SOC/index)
+# Documentation
+
+ - [Source Code](/docs/)
+ - [Architecture](3d_gpu/architecture)
+
+# Autism and Asperger's
+
+A number of our team have Autism, specifically a variant called Asperger's.
+Please be mindful and aware when interacting with us.  More information
+may be found here:
+
+* <https://foodforthebrain.org/autism/>
+* <https://m.youtube.com/watch?v=Grrbekq-6kw>