Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/ckormanyos/gcc-rl78-unknown-elf

gcc-rl78-unknown-elf built with shell and YAML
https://github.com/ckormanyos/gcc-rl78-unknown-elf

cross-compiler gcc gcc-cross-compiler gcc-rl78-elf rl78

Last synced: 24 days ago
JSON representation

gcc-rl78-unknown-elf built with shell and YAML

Host: GitHub
URL: https://github.com/ckormanyos/gcc-rl78-unknown-elf
Owner: ckormanyos
License: unlicense
Created: 2024-02-10T13:12:58.000Z (9 months ago)
Default Branch: main
Last Pushed: 2024-02-10T14:33:03.000Z (9 months ago)
Last Synced: 2024-04-28T03:19:37.827Z (6 months ago)
Topics: cross-compiler, gcc, gcc-cross-compiler, gcc-rl78-elf, rl78
Language: Shell
Homepage:
Size: 5.86 KB
Stars: 0
Watchers: 2
Forks: 0
Open Issues: 0
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

        ckormanyos/gcc-rl78-unknown-elf

==================



    

        

    

        

    

        

    

        



`ckormanyos/gcc-rl78-unknown-elf` provides shell and YAML scripts to build a modern `gcc-rl78-unknown-elf`.

Design goals:

  - Use shell and YAML scripts to build modern `gcc-rl78-unknown-elf` on-the-fly.

  - Build `gcc-rl78-unknown-elf` from up-to-date [gcc-releases](https://ftp.gnu.org/gnu/gcc).

  - Provide a non-trivial test of the newly-built toolchain(s) based on a real-world project.

  - Publish the build artifacts directly from the GHA Workflow-Run(s).

  - Occasionally create and publish versioned releases.

## Releases and Build Artifacts

Using released or CI-built artifacts can be convenient when you

do not actually want to nor need to manually build

`gcc-rl78-unknown-elf` toolchain.

Releases and build artifacts consisting of the

fully-built `gcc-rl78-unknown-elf` toolchain are occasionally created

and published for `x86_64-linux-gnu` (Linux) and

`x86_64-w64-mingw32` (Windows). These can be readily found

on the repo front page and in CI workflow-run download-areas

for immediate client use. The releases are permanent, whereby

the built artifacts are limited to three days after the

Workflow-Run(s).

## Workflow-Run

Workflow:

  - Use the shell script [gcc-rl78-unknown-elf-100.sh](./gcc-rl78-unknown-elf-100.sh) consistently in each of the Workflow-Run(s).

  - The Workflow-Run [build-ubuntu.yml](./.github/workflows/build-ubuntu.yml) builds `avr-gcc` for the _host_ `x86_64-linux-gnu`. The script is executed on a GHA `ubuntu-latest` runner.

  - The Workflow-Run [build-msys64.yml](./.github/workflows/build-msys64.yml) builds `avr-gcc` for the _host_ `x86_64-w64-mingw32`. The script is executed on a GHA `windows-latest` runner using `msys64`.

  - When building for `x86_64-w64-mingw32` on `msys64`, use a pre-built, dependency-free, statically linked `mingw` and host-compiler (see notes below). This separate `mingw` package is unpacked in a directory parallel to the runner workspace and its `bin` directory is added to the `PATH` variable.

  - GCC prerequisites including [GMP](https://gmplib.org), [MPFR](https://www.mpfr.org), [MPC](https://www.multiprecision.org), etc. are built on-the-fly in the Workflow-Run.

  - Build [`binutils`](https://www.gnu.org/software/binutils) and partially verify the build artifacts.

  - Then build `gcc-rl78-unknown-elf` and partially verify the build artifacts. Use [newlib](https://sourceware.org/newlib) and the `--with-newlib` configuration flag.

  - Test the complete, newly built `gcc-rl78-unknown-elf` toolchain with a non-trivial compiler test. In the compiler test, we build `ref_app` (the reference application) from [`ckormanyos/real-time-cpp`](https://github.com/ckormanyos). Verify the creation of key build results from `ref_app` including ELF-file, HEX-file, map files, etc.

## Additional Notes

Notes:

  - This project is distributed under [The Unlicense](./UNLICENSE).

  - This work is similar to the related project [`ckormanyos/avr-gcc-build`](https://github.com/ckormanyos/avr-gcc-build).

  - The pre-built, dependency-free, statically linked `mingw` and host-compiler system originate from Steven T. Lavavej's [`MinGW Distro`](https://nuwen.net/mingw.html).