Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Update Toolchain.md #468

Merged
merged 1 commit into from
Nov 24, 2024
Merged

Update Toolchain.md #468

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
30 changes: 27 additions & 3 deletions code/Toolchain.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,21 +10,45 @@ toolchain with the following commands:

```bash
brew tap rosco-m68k/toolchain
brew install rosco-m68k-toolchain@13.rb srecord minipro
brew install rosco-m68k-toolchain@13 srecord minipro
```

This will automatically download, build and install all the dependencies that
you _would have_ built if you'd followed the instructions in part two.

It'll take a few minutes, as it builds binutils and GCC from source. Once it's
done, you're ready to rock.
It may take a few minutes, as on some systems it builds binutils and GCC from source.
Once it's done, you're ready to rock.

> [!NOTE]
> Depending on what other software you have installed via brew, it's possible for
> the toolchain install to succeed, but the link to fail. If this happens, you'll
> still see `m68k-elf-rosco-gcc: no such file or directory` or similar when trying
> to build.
>
> Should this happen, it can be fixed with the following command:
>
> ```bash
> brew link --overwrite rosco-m68k-toolchain@13
> ```
## The Slightly-Less Easy Way - Building the Toolchain
See https://github.com/rosco-m68k/newlib-rosco-build/blob/main/README.md
## The Old Way - Building the Bare Metal Toolchain (advanced users)
> [!WARNING]
> You almost certainly **do not want to do this**.
>
> The bare-metal toolchain is no longer used by the rosco_m68k project
> after firmware version 2.42, and is maintained primarily as a convenience
> for the non-rosco Motorola 68k community.
>
> Unless you are building for a release branch (2.42 or earlier), following the
> instructions here **will not result in a compiler that can build our firmware
> or examples**.
0. Configure build environment (Linux only)
> Note: You may be able to skip this step, as the GCC we're building doesn't
Expand Down