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

Draft quick notes guide.

Ben V. Brown
2020-04-23 22:31:51 +10:00
parent 5d3a9b2b64
commit df02998007
1 changed files with 44 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files

44
Building.md Normal file

@@ -0,0 +1,44 @@
# Building the firmware
To build this ts100 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 `./workspace/TS100` 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 use the `build.sh` script in the root of this repo to create a docker image, build the firmware, and output all the files in the `ci/artifacts` folder
### Dev
If you use the `./start_dev.sh` script, it will instead load you into the docker image, which is useful if you plan to run many builds to test ideas and dont 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