doc: yowasp

Author: sylefeb

GetStarted_Yowasp.md

@@ -0,0 +1,26 @@
+# Getting started with Silice using YoWASP (all platforms)
+
+## Install
+
+Silice is available as a [YoWASP](https://yowasp.org/) package. This is a great
+way to use Silice under any platform that supports python, as YoWASP runs
+WebAssembly compiled tools from python. Yes, this means no pain with compiling
+from tools or dealing with incompatible binaries!
+
+To install Silice with YoWASP, simply run [get_started_yowasp.sh](get_started_yowasp.sh), assuming you already have a working installation
+of `python` and `pip`. This will install all required YoWASP package.
+
+Then, head to a project, such as `projects/blinky` and run:
+
+```make yowasp-<BOARD>```
+
+where BOARD is the name of a [supported board](frameworks/board). For instance:
+
+```make yowasp-icebreaker```.
+
+
+
+## Sending the bitstream to your board
+
+
+

get_started_yowasp.sh

@@ -0,0 +1,26 @@
+#!/bin/bash
+echo "--------------------------------------------------------------------"
+echo "This script installs all necessary python packages"
+echo "Requirements: python and pip"
+echo ""
+echo "You may run into the error externally-managed-environment, in which"
+echo "case you can create a venv for local package installation."
+echo " https://docs.python.org/3/library/venv.html "
+# e.g. https://stackoverflow.com/questions/75602063/pip-install-r-requirements-txt-is-failing-this-environment-is-externally-mana
+echo ""
+echo "Please refer to the script source code to see the list of packages"
+echo "--------------------------------------------------------------------"
+
+read -p "Please type 'y' to go ahead, any other key to exit: " -n 1 -r
+if [[ ! $REPLY =~ ^[Yy]$ ]]
+then
+	echo
+	echo "Exiting."
+	exit
+fi
+
+pip install yowasp-yosys
+pip install yowasp-nextpnr-ice40
+pip install yowasp-nextpnr-ecp5
+pip install yowasp-silice
+pip install edalize