Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/jijingg/Spinal-bootcamp
SpinalHDL-tutorial based on Jupyter Notebook
https://github.com/jijingg/Spinal-bootcamp
Last synced: 3 months ago
JSON representation
SpinalHDL-tutorial based on Jupyter Notebook
- Host: GitHub
- URL: https://github.com/jijingg/Spinal-bootcamp
- Owner: jijingg
- Created: 2019-11-19T09:37:58.000Z (about 5 years ago)
- Default Branch: dev
- Last Pushed: 2024-06-14T01:50:58.000Z (7 months ago)
- Last Synced: 2024-08-01T16:27:17.432Z (6 months ago)
- Language: Jupyter Notebook
- Size: 2.26 MB
- Stars: 122
- Watchers: 8
- Forks: 46
- Open Issues: 9
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Spinal-bootcamp [](https://mybinder.org/v2/gh/jijingg/Spinal-bootcamp/binder)
This is SpinalHDL Tutorial, More important, it's a spinalHDL run-time environment.
Most of case come from [SpinalDoc](https://spinalhdl.github.io/SpinalDoc-RTD/index.html),
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.
## Usage
There are two ways, you can run online or locally
### Online
click [](https://mybinder.org/v2/gh/jijingg/Spinal-bootcamp/binder) and start
### Local
```shell
$: git clone https://github.com/jijingg/Spinal-bootcamp
$: cd Spinal-bootcamp
$: jupyter notebook &
```
## Setup Jupyter-notebook enviroment
if you want run locally, install follows first
- [jupyter-notebook](https://jupyter.org/install)(Strongly recommend installing Python and Jupyter using the [Anaconda](https://www.anaconda.com/distribution/))
- scala(Scala2.12 is recommended)
- [almond](https://almond.sh/)(scala kernel for jupyter)
### Setup on Windows10 and higher
[WSL](https://docs.microsoft.com/en-us/windows/wsl/) and [VS Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-wsl) is recommended.
1. Clone this repository and open a **WSL terminal** here.
2. Confirm your java and jupyter installation like this
```
~# java -version
openjdk version "1.8.0_312"
OpenJDK Runtime Environment (build 1.8.0_312-8u312-b07-0ubuntu1~20.04-b07)
OpenJDK 64-Bit Server VM (build 25.312-b07, mixed mode)
~# echo $JAVA_HOME
/usr/lib/jvm/java-8-openjdk-amd64
~# pip list
```
3. Install [almond](https://almond.sh/) for WSL (the same as Linux)
```
~# cd source
~# chmod +x coursier
~# ./coursier launch --fork almond -- --install
```
4. Open the folder with [VS Code](https://marketplace.visualstudio.com/items?itemName=ms-toolsai.jupyter) or jupyter
`~# cd ..`
| VS Code | jupyter lab | jupyter notebook |
| :------: | :-----------: | :--------------: |
| `code .` | `jupyter-lab` | `jupyter notebook --allow-root &` |
- If you don't use VS Code, you would change the default browser of jupyter in WSL.
## 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"](https://www.oreilly.com/library/view/programming-in-scala/9780981531687/)** 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. Make sure the right version have been installed.
- Java Version jdk1.8 (java11 not supported yet)
- Scala Version 2.12.x (2.13.x not supported yet)
- Almond Version 0.5.0 is recommended
install Almond on MacOs
```shell
brew install coursier/formulas/coursier
cs launch --fork almond:0.5.0 --scala 2.11.12 -- --install --force
```