toolchain68k

Main Goal: Build a toolchain for 68k, avr and cortex-m3 and cortex-m4 cross developement using recent compilers and libraries.

This supports development for various m68k boards, Arduinos and STM32 Boards (STM32F411 Nucleo, 32F411EDiscovery, Blue Pill )

The used toolchain versions are

• gcc 13.2.0
• binutils 2.42 (with the ususal avr size patch, see avr_binutils.patch)
• gdb 14.2
• newlib 4.4.0.20231231 (with a patch to libgloss write() and read() functions, see newlib.patch)
• avr-libc 2.1.0

The build script can build for the following target architectures

• m68k-elf
• avr
• arm-none-eabi

The script works on Windows 10 with MSYS2 and on Ubuntu 23.10 (mantic). It may work on other platforms but i dont run any tests.

The toolchains are packaged into archives suitable for the platformio development environment (https://platformio.org). The archives can be used with eclipse or with make files as well - just unpack them.

The releases section of this git repo contains prebuilt toolchains. This can be used as package repository for platformio and there is a platform definition referencing the toolchain packages for platformio use.

The Platform URL to be used for platformio projects are

• https://github.com/haarer/platform-atmelavr.git
• https://github.com/haarer/platform-m68k.git
• https://github.com/haarer/platform-ststm32.git

There are example projects for m68k avr and arm-none-eabi

Prepare Build Environment for Windows and MSYS

all commands are to be typed into the msys shell

Installation of MSYS2 Base System and needed packages

• download the MSYS2 Installer from the MSYS Home Page, use the 64 Bit Version
• execute installer and chose the installation path according to the following criteria
  • best performance will be on a SSD
  • it will need approx 4 GB space
  • exclude it from the virus scanner
  • exclude it form the windows index service
  • use a short path without spaces
  • do not put it on a FAT Filesystem
  • i use C:\Tools\msys64
• update the base system as described on the MSYS Home Page
  • pacman -Syu
  • ok the questions, close window when ready
  • open MSYS Shell again(start menu, use 64bit version)
  • pacman -Su
• install git
  • pacman -S git

Now clone the git repository.

git clone https://github.com/haarer/toolchain68k.git

Install the required packages for msys

cd toolchain68k
sh install_req_pkg_windows-latest.sh

Prepare Build Environment for Debian 8

First install git.

sudo apt-get install git

Now clone the git repository.

git clone https://github.com/haarer/toolchain68k.git

Install the required packages for msys.

cd toolchain68k
bash install_req_pkg_ubuntu-latest.sh

Prepare Build Environment for Fedora

First install git.

sudo yum install git

Now clone the git repository.

git clone https://github.com/haarer/toolchain68k.git

Install the required packages for fedora.

sh install_req_pkg_fedora.sh

Building and Installing of the Toolchain

Set the wanted target architecture by passing it to the build script as second parameter. In order to change or add target specific build options, see the arm-none-eabi target in the script how to do this.

bash buildtoolchain.sh linux m68k-elf

The script obtains the sources, unpacks them and builds the tools of the toolchain.

The progress of the build is written to a logfile: buildlog.txt

Note that the toolchain script does not install the toolchain, it always creates platformio toolchain packages.

Testing the Toolchain

Add the path to the binaries and run gcc

export PATH=$PATH:<your toolchain dir>/bin:
<architecture>-gcc --version

for example

export PATH=$PATH://home/mac/toolchain68k/toolchain-avr-current/bin/bin:
avr-gcc --version

compile one of the 68k toolchain examples

see the linker scripts called for the make file. One example uses toolchain provided startup files and linkerscript (m68k-example2), the other one uses custom linker scripts and own startup files (m68k-example)

cd examples/m68k-example
make 

compile the simple avr toolchain example

This example assumes an arduino mega connected to usb (see makefile and change com port accordingly) and is a simple led blink example.

cd examples/avr-example-example
make 
make flash

compile the simple arm-none-eabi toolchain example

This example assumes blue pill STM32F103C8 board connected via a STLINK-2 adapter to usb (see makefile ) and is a simple led blink example. It requires the ST Microelectronics Std_Peripheral Lib unpacked into the example directory

cd examples/arm-none-eabi
make 
make flash