ApolloCrossDev is intended to help (future) Amiga/Apollo developers to setup a Cross Compiler in Ubuntu Linux (x64) or MacOS (Silicon).
ApolloCrossDev is based on the excellent Amiga-GCC repositories by Stefan -Bebbo- Franke
- BinUtils (ar=archiver | as=GNU ASM | ld=linker | nm=symbols | objdump=objects | ranlib=libindex)
- GNU-GCC Compilers for C and C++ (6.50-Stable | 6.50-Dev (recommended) | 13.1/2/3 Beta | 15.2 Beta)
- VASM Assembler (Apollo optimised Assembler from Dr. Volker Barthelsmann & Frank Wille)
- Amiga OS Native Development Kits (1.3, 3.9 and 3.2 = default)
- Libraries/Includes (MUI5, SDL-Base+Mixer+TTF+Image, Vorbis, Ogg, GL, FreeType, Timidity, ZLib, JPeg, PNG)
- C/C++/ASM Source-Code examples with automated Build from Makefiles
- Apollo Sourcecode collection with some basic Apollo C++ and ASM routines, including Debug on Serial Output (TTY)
- Linux:
- Ubuntu 24.04.3 LTS amd64 (Intel) is the supported Linux (other Linux distro may fail unless you downgrade gcc to 12)
- Intel or AMD X64 processor 8Gb+ RAM | 50Gb+ HD | 4+ Cores (VM and Docker ae supported)
- MacOS:
- MacOS Sequoia, Tahoe or Golden Gate running on Mac Silicon M1-M2-M3-M4 hardware (Intel x64 is not tested/supported)
- Git tools installed from CLI: open terminal and type: sudo apt install git (Linux) or xcode-select --install (MacOS)
- Microsoft Visual Studio Code (VS-Code) downloaded and installed (https://code.visualstudio.com)
- Microsoft Visual Studio Code Extensions:
- Microsoft C/C++ (Intellisense, debugging and code browsing)
- Microsoft C/C++ Themes (UI Theme Pack - high contrast recommeded)
- Microsoft C/C++ Extension Pack (collection of popular extensions)
- Microsoft Makefile Tools (support for C/C++ Makefiles)
- Open VS-Code Click "View" and select "Open Command Palette" (or press CTRL+Shift+P)
- In drop-down list Select "git clone" and type https://github.com/WDrijver/ApolloCrossDev
- After download Click "Open" and accept "trust the authors" and Click "Open Workspace" in the right corner popup window
- Select "Terminal" in the menu and then "New Terminal"
- In the terminal windows type ./GCC-6.50-Dev-Linux.sh or ./GCC-6.50-Dev-MacOS.sh to install the latest ApolloCrossDev Toolchain (*)
- After the installation is finished type nano ~/.bashrc (on MacOS: nano ~/.zshrc)
- At the end of the file add: export APOLLOCROSSDEV="" (for example: export APOLLOCROSSDEV="$HOME/ApolloCrossDev") and save, so projects outside the Projects folder find the toolchain
(*) GCC-6.50-Base = Original Baseline (Nov 2024) | GCC-6.50-Stable = Fallback if you have any issues with GCC-6.50-Dev
- Click "Terminal" in menu and select "Run Build Task" (or press CTRL-Shift-B)
- Select "Build ApolloDemo" from the drop-down List
- Watch ApolloCrossDev Compile (Step #1) + Link (Step #2) the ApolloDemo Project
- Copy the ApolloDemo executable (and its Data folder) from Projects/ApolloDemo to your Apollo V4 and doubleclick ApolloDemo to experience Apollo V4 power
(NOTE: Serial Debug requires PL2303 USB to Serial cable + TTY Terminal Program | Settings: 115200-8-1-N)
- Right-Click Projects Folder and select "New Folder..." to create a new Folder
- Right-Click Folder and select "New File..." to create .c .cpp and .s source files
- Copy Makefile template from Projects/_makefiles to Folder
- Change the Project/ line and make other customizations to Makefile if needed
- Create your C and/or Assembler code using .c for C, .cpp for C++ and .s for ASM
- Right-Click Folder and select "Open in integrated Terminal"
- Type "make" to Compile and Link, then copy the executable to your Apollo V4
A project can also live in its own folder or git repository outside ApolloCrossDev: copy the Makefile template there and set APOLLOCROSSDEV (Installation step 7).
TIP: The Makefile template contains additional information on Compiler Options please take you time to read this information carefully if your new to GCC/Amiga
- Docs folder containing a collection of Amiga and Apollo Reference Manuals (PDF), including the AmigaDOS Reference Manual for AmigaOS 3.2 (Thomas Richter, 2024, freely distributable unmodified) and the exFAT File System Specification (Microsoft, CC BY 4.0) in Docs/exFAT
- Apollo 68080 AMMX/SAGA Basic Coding Documentation : http://apollo-core.com/index.htm?page=coding
- ApolloOS - Apollo V4 Open Source OS Distro Image : http://www.apollo-computer.com/downloads.php
GCC-6.50-Patched Compiler opcode support for Apollo 68080 : cmpiw.l + addiw.l + dbra.l Assembler only (vasm), not generated by GCC : moviw.l + bcc.s+ Roadmap for future Compiler opcode support for Apollo 68080 : move2.b Not planned (LineA, only on cores 10280-10904) : mov3q + clr.q + movs.b/w + movz.b/w Use the fused pairs instead: moveq #0 + move.b/w (= movz), move.w + ext.l (= movs.w)