me/IronOS
1
0
Fork 1
mirror of https://github.com/Ralim/IronOS.git synced 2025-02-26 07:53:55 +00:00
Code Issues Actions Packages Projects Releases Wiki Activity

Destroyed Building (markdown)

Ben V. Brown
2023-07-20 11:56:26 +10:00
parent 63d30f73dd
commit 9c49deceb7
1 changed files with 0 additions and 59 deletions
Download Patch File Download Diff File Expand all files Collapse all files

59
Building.md

@@ -1,59 +0,0 @@
# Building the firmware
To build IronOS firmware, there are quite a few different means to build this firmware
## Using arm compilers under Linux/Mac/WSL
1. Download and install the arm compilers (currently `gcc-arm-none-eabi-9-2019-q4-major`)
2. Install the arm compilers as appropriate
3. In a terminal change to the `./source` folder
4. run `./build.sh` to build all of the firmwares
5. Alternatively run `make` with arguments to pick your device / language
## Using docker
If your machine has docker installed, you can call the script from the root of this repo:
```
$ scripts/deploy.sh build
```
This create a docker image, build the firmware, and output all the files in the `scripts/ci/artifacts` folder.
### Dev
The script can be called without any sub-commands as well:
```
$ scripts/deploy.sh
```
It will load you into the docker image, which is useful if you plan to run many builds to test ideas and don't want to wait for the spin up/down of the docker image.
## Using STMCubeIDE
If you have STMCubeIDE installed on your machine, you can use it as an IDE and build environment. Note it will use its own compilers and as such will not be reproducible builds compared to the ones uses here.
1. Open STMCubeIDE
2. Set the workspace path to `./workspace` in this repo if you want
3. Close the welcome page
4. In the left hand menu, right click
5. Select Import -> General -> Existing projects into workspace
6. In the top directory option, select the `./workspace` folder
7. Only tick the `TS100` Option
8. The firmware should now be loaded and you can right click -> build on it in the left menu
## Using Atollic
If you have Atollic installed on your machine, you can use it as an IDE and build environment. Note it will use its own compilers and as such will not be reproducible builds compared to the ones uses here.
1. Open Atollic
2. Set the workspace path to `./workspace` in this repo if you want
3. Close the welcome page
4. In the left hand menu, right click
5. Select Import -> General -> Existing projects into workspace
6. In the top directory option, select the `./workspace` folder
7. Only tick the `TS100A` Option
8. The firmware should now be loaded and you can right click -> build on it in the left menu