Update self-hosted runner setup instructions with notes on unattended builds of unix/windows/webassembly

Signed-off-by: Jos Verlinde <[email protected]>

Author: Josverl

selfhosted-runner.md

@@ -23,7 +23,9 @@ In order to allow the runner to run sudo commands without a password, add the fo
 
 ```bash
 # needed to allow deadsnakes/action to install python
-echo "runner ALL=(ALL:ALL) NOPASSWD:/usr/bin/add-apt-repository, /usr/bin/apt-get" | sudo tee /etc/sudoers.d/runner
+echo "runner ALL=(ALL:ALL) NOPASSWD:/usr/bin/add-apt-repository, /usr/bin/apt-get, /usr/bin/apt install" | sudo tee /etc/sudoers.d/runner
+
+echo "jos ALL=(ALL:ALL) NOPASSWD:/usr/bin/add-apt-repository, /usr/bin/apt-get, /usr/bin/apt install" | sudo tee /etc/sudoers.d/jos
 
 ```
 
@@ -37,7 +39,82 @@ pipx ensurepath
 
 # pmount - mount arbitrary hotpluggable devices as normal user
 # needed by mptool to mount UF2 devices
-sodo apt install pmount
+sudo apt install pmount
+```
+
+### STM32 
+
+The STM32 Cube Programmer CLI - X64 only
+needed to flash STM32 devices
+See : https://www.st.com/en/development-tools/stm32cubeprog.html
+install on linux x64
+```bash
+sudo apt install libusb-1.0.0-dev
+```
+
+STP32 udev rules are required to allow the runner to access the STM32 devices.
+Files to copy to /etc/udev/rules.d/ on Ubuntu ("sudo cp *.* /etc/udev/rules.d").
+
+Reload the rules with
+`sudo udevadm control --reload-rules && sudo udevadm trigger`
+
+# Build requirements
+If you want to build unix / windows / webassembly targets you need to install the following packages
+avoid apt install to ask for confirmation
+I assume the same is set on GH hosted runners
+```bash
+sudo nano /etc/apt/apt.conf.d/90_assume_yes
+APT::Get::Assume-Yes "true"
+$ cat /etc/apt/apt.conf.d/90_assume_yes
+```
+ref : https://superuser.com/questions/164553/automatically-answer-yes-when-using-apt-get-install
+
+
+## Build unix using ci scripts
+``` bash
+# requirements
+sudo apt install -y build-essential libffi-dev pkg-config
+# clean
+make -C ports/unix clean
+# build unix
+source tools/ci.sh && ci_unix_standard_build
+# copy build-standard/micropython to the runner user's home directory
+mkdir -p ~/builds/unix
+cp ports/unix/build-standard/micropython ~/builds/unix/micropython
+```
+
+# build webassembly
+```bash
+# requirements
+source tools/ci.sh && ci_webassembly_setup
+# clean
+make -C ports/webassembly clean
+# build webassembly
+source tools/ci.sh && ci_webassembly_build
+# copy 
+mkdir -p ~/builds/webassembly
+cp ports/webassembly/build/*.wasm ~/builds/webassembly/
+cp ports/webassembly/build/*.js ~/builds/webassembly/
+```
+
+
+
+## build windows 
+Note: The Windows port's dependencies are not installed silently and need `/etc/apt/apt.conf.d/90_assume_yes`
+to suppress the confirmation prompt.
+
+```bash
+# requirements
+source tools/ci.sh && ci_windows_setup
+# clean
+make -C ports/windows clean
+# build windows on linux
+source tools/ci.sh && ci_windows_build
+# copy 
+mkdir -p ~/builds/windows
+cp ports/windows/build-standard/*.exe ~/builds/windows/
+
+
 ```
 
 ### Remove conflicting packages