masson2013 / spinal-bootcamp

SpinalHDL-tutorial based on Jupyter Notebook

Spinal-bootcamp

This is SpinalHDL Tutorial, More important, it's a spinalHDL run-time environment.

Most of case come from SpinalDoc, In addition, we also introduced some advanced usage of Scala, which are very helpful to understand how spinalHDL works.

Why we do such a thing:

• Sometimes you just want to try a usage of a Spinal or Scala, but you don't want to create a new project.
• Practice is important for learning a new skill. So we did a lot of examples for you to try run.

Setup Jupyter-notebook enviroment

install follows first

• jupyter-notebook(Strongly recommend installing Python and Jupyter using the Anaconda)
• scala(Scala2.12 is recommended)
• almond(scala kernel for jupyter)

Usage

$: git clone https://github.com/jijingg/Spinal-bootcamp
$: cd Spinal-bootcamp
$: jupyter notebook &

Before the start

We assume you already have the basics knowledge of Scala，So there is no introduction to scala syntax here.
If you need to learn Scala, I would strongly recommend the book of "Programming in Scala" by Martin Odersky who is also the author of Scala. And just try them as many as you can on jupyter notebook env, This may be more efficient to help you master Scala than just reading a book without practice.

FAQ

1. scala version, almond version SpinalHDL have not release on Scala2.1.3 yet, so you need specify the almond version to 0.5.0 before isntall.

$ SCALA_VERSION=2.12.8 ALMOND_VERSION=0.5.0   //0.5.0 on scala 2.12.8