... | @@ -5,6 +5,7 @@ To setup the development environment on Windows you will need the following comp |
... | @@ -5,6 +5,7 @@ To setup the development environment on Windows you will need the following comp |
|
* [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/install)
|
|
* [Windows Subsystem for Linux](https://docs.microsoft.com/en-us/windows/wsl/install)
|
|
* [ST-Link Utility](https://www.st.com/en/development-tools/stsw-link004.html)
|
|
* [ST-Link Utility](https://www.st.com/en/development-tools/stsw-link004.html)
|
|
* [Visual Studio Code](https://code.visualstudio.com/)
|
|
* [Visual Studio Code](https://code.visualstudio.com/)
|
|
|
|
* [Tera Term ](https://ttssh2.osdn.jp/index.html.en)(or any other serial monitor)
|
|
|
|
|
|
<span dir="">Windows Subsystem for Linux is a compatibility layer built by Microsoft for running Linux executables natively on Windows</span>. In simplier terms, WSL is a sort of virtual machine. With WSL you can install different Linux distributions and access then through command line interface. Since the Skyward Build System is developd on Unix, WSL is need to compile the code easily.
|
|
<span dir="">Windows Subsystem for Linux is a compatibility layer built by Microsoft for running Linux executables natively on Windows</span>. In simplier terms, WSL is a sort of virtual machine. With WSL you can install different Linux distributions and access then through command line interface. Since the Skyward Build System is developd on Unix, WSL is need to compile the code easily.
|
|
|
|
|
... | @@ -24,7 +25,8 @@ To install the Miosix compiler ([here](https://miosix.org/wiki/index.php?title=L |
... | @@ -24,7 +25,8 @@ To install the Miosix compiler ([here](https://miosix.org/wiki/index.php?title=L |
|
```shell
|
|
```shell
|
|
wget https://miosix.org/toolchain/MiosixToolchainInstaller.run
|
|
wget https://miosix.org/toolchain/MiosixToolchainInstaller.run
|
|
sh MiosixToolchainInstaller.run
|
|
sh MiosixToolchainInstaller.run
|
|
sudo apt install make cmake ninja-build ccache cppcheck clang-format clang-tidy -y
|
|
sudo apt update
|
|
|
|
sudo apt install make cmake ninja-build ccache cppcheck clang-format clang-tidy python-is-python3 -y
|
|
```
|
|
```
|
|
|
|
|
|
After this packages are installed, WSL is setup.
|
|
After this packages are installed, WSL is setup.
|
... | @@ -37,11 +39,23 @@ To program an STM32 microcontroller you need an ST-Link programmer which interfa |
... | @@ -37,11 +39,23 @@ To program an STM32 microcontroller you need an ST-Link programmer which interfa |
|
|
|
|
|
If you don't have it already, just download VS-Code from [code.visualstudio.com](http://code.visualstudio.com). After the installation has completed and you have open an instance of VS-Code, you need to install the [Remote - WSL](vscode:extension/ms-vscode-remote.remote-wsl) extension. At this point you should be able to select the "Remote explorer" tab on the left side, here you can connect to the Ubuntu virtual machine.
|
|
If you don't have it already, just download VS-Code from [code.visualstudio.com](http://code.visualstudio.com). After the installation has completed and you have open an instance of VS-Code, you need to install the [Remote - WSL](vscode:extension/ms-vscode-remote.remote-wsl) extension. At this point you should be able to select the "Remote explorer" tab on the left side, here you can connect to the Ubuntu virtual machine.
|
|
|
|
|
|
|
|

|
|
|
|
|
|
At this point you are ready to start programming!
|
|
At this point you are ready to start programming!
|
|
|
|
|
|
|
|
## Tera Term
|
|
|
|
|
|
|
|
To view the ouput from you development board, a serial monitor is required. A really simple program is [Tera Term ](https://ttssh2.osdn.jp/index.html.en)which you can download [here](https://osdn.net/projects/ttssh2/releases/).
|
|
|
|
|
|
|
|
When you first start Tera Term, you will be asked to select the connection. Choose "Serial" and the port of you device as shown:
|
|
|
|
|
|
|
|

|
|
|
|
|
|
|
|
At this point you need to go to `Setup` > `Serial Port` and select `19200` as the speed. You can also save the current configuration as the default one by clicking Setup > Save setup ... and then save by overriding. The next time you will open Tera Term, you will immediately see the device output.
|
|
|
|
|
|
## Development environment test
|
|
## Development environment test
|
|
|
|
|
|
To ensure that everything is working you can clone the Boardcore repository and compile the code whit the following commands
|
|
To ensure that everything is working you can clone the Boardcore repository and compile the code. To clone the repository you will need to have an ssh key configured, check [here ](https://git.skywarder.eu/help/ssh/index.md)how to do it.
|
|
|
|
|
|
```shell
|
|
```shell
|
|
git clone --recursive git@git.skywarder.eu:scs/skyward-boardcore
|
|
git clone --recursive git@git.skywarder.eu:scs/skyward-boardcore
|
... | | ... | |