SpinalWorkshop: A Scala repository from andr01d-1

SpinalHDL labs

There is the list of RTL labs :

Counter : src/main/scala/workshop/counter
PWM with APB : src/main/scala/workshop/pwm
UART : src/main/scala/workshop/uart
Prime : src/main/scala/workshop/prime
Function : src/main/scala/workshop/function
Apb3Decoder : src/main/scala/workshop/apb3decoder
Timer with BusSlaveFactory : src/main/scala/workshop/timer
Blackbox and Clockdomain : src/main/scala/workshop/blackboxAndClock
Stream : src/main/scala/workshop/stream
Mandelbrot : src/main/scala/workshop/mandelbrot
UDP : src/main/scala/workshop/udp
WavePlayer : src/main/scala/workshop/waveplayer

In each labs, there is an assets folder which contain a starting template and a solution.
In each labs, there is an spec.md which give basics of the lab. (You can get the Intellij plugin to read it in the IDE)
In the case a lab specification isn't clear, you can find in waves.tar.gz the corresponding working waves.
Those labs make the assumption that you are already comfortable with standards HDL.

Generate your RTL

For each labs, you will find a scala main which will generate your RTL.

For example, to run the CounterMain by using SBT, you can do as following in the root folder of this repository :

sbt
runMain workshop.counter.CounterMain

# Run again
runMain workshop.counter.CounterMain

# Run again
runMain workshop.counter.CounterMain

Or in a single (But slower) command :

sbt "runMain workshop.counter.CounterMain"

All generated RTL will be in root_of_this_repository/rtl.

Test your RTL

For each labs, you will find an automated regression suite in src/test/scala/workshop/xxx

For example, to run the CounterTester regression by using SBT, you can do as following in the root folder of this repository :

sbt
testOnly *.CounterTester

# To test again
testOnly *.CounterTester

# To test again
testOnly *.CounterTester

Or in a single (But slower) command :

sbt "testOnly *.CounterTester"

Note : Each tester regenerate the hardware, you don't need to do it manualy.

All simulation waves files will be written in root_of_this_repository/waves in the VCD format.

SpinalSim labs

There is the list of SpinalSim labs :

SimCounter : src/main/python/workshop/simCounter
SimStreamJoinFork : src/main/python/workshop/simStreamJoinFork

In each labs, there is an assets folder which contain a starting template and a solution.
In each labs, there is an spec.md which give basics of the lab. (You can get the Intellij plugin to read it in the IDE)
For SpinalSim, the simulation waves are located in the simWorkspace folder.

Cocotb labs

There is the list of Cocotb labs :

Counter with cocotb : src/test/python/workshop/counter
FIFO with cocotb : src/test/python/workshop/fifo

To run cocotb labs, you have to run make in the testbench folder.

Minimum requirements

Those labs use various tools to generate and verify the hardware :

java 8
SBT
Verilator
Icarus Verilog
Cocotb (http://cocotb.readthedocs.io/en/latest/quickstart.html#installing-cocotb)
Cocotb path in the 'COCOTB' environment variable
GTKwave to open simulation waves (./waves/*.vcd)

For the first row of labs, you don't need cocotb/python stuffs.

There is how to setup by command line a Debian distribution :