Native 64-bit Linux port of EASy68K: Editor, Assembler, Simulator, and S-Record / Binary utility for Motorola 68000 microprocessors.
Ported and modernized to C++17 and Qt6 for Linux (x86_64) with zero WINE or Windows emulation dependencies.
easy68k-asm: Standalone native 68000 structured macro cross-assembler.easy68k-sim: Standalone native headless/CLI 68000 simulator withTRAP #15support, cycle counting, and instruction tracing.easybin: Standalone native Motorola S-Record (.s68) <-> Raw Binary (.bin) conversion utility.easy68k-gui: Native Qt6 graphical IDE featuring:- Syntax-highlighted 68000 assembly editor (
Edit68K) with line numbers, comment/uncomment tools, 68000 template generator, and integrated error navigation. - Classic
Sim68Ksimulator layout with non-snapping.L68listing view, clickable gutter breakpoint indicators, and separate execution trace log. - Horizontal editable registers panel (
D0..D7,A0..A7, 16-bit binarySR,US,SS,PC,Cycles) and dedicated 4-byteStackinspector. - Interactive click-to-edit
Memoryhex nybble & ASCII inspector withCopy,Fill, andSaverange operations. - Interactive
TRAP #15terminal console. - Simulated Hardware Panel: 8-digit 7-segment displays (
$E00000..$E0000E), 8 LED indicators ($E00010), 8 interactive toggle switches ($E00012), 8 pushbuttons ($E00014), manual & auto-intervalIRQ 1..7interrupt generator, andMemory Map(ROM,Read Only,Protected,Invalid) enforcement. - 2D Graphics Canvas: 640x480 interactive drawing canvas supporting
TRAP #15Tasks 80–96 (pixel, line, rectangle, ellipse, flood fill, text, mouse, and pen/brush colors). - Integrated EASyBIN Converter: GUI for S-Record inspection and
.s68<->.binmulti-format splitting and conversion. - Integrated Help & Reference Browser: Full offline HTML documentation and Motorola 68000 Quick Reference PDF browser (
F1). - Integrated Auto-Updater: Built-in GitHub release checker (
Help -> Check for Updates...) with SHA-256 verification and automatic startup check (Help -> Check for Updates on Startup).
- Syntax-highlighted 68000 assembly editor (
EASy68K Linux supports three automatic update channels:
Install and enable automatic updates via apt upgrade:
curl -fsSL https://sebo1411.github.io/EASy68KLinux/setup-apt.sh | sudo bashInstall and enable automatic updates via dnf upgrade or zypper up:
curl -fsSL https://sebo1411.github.io/EASy68KLinux/setup-rpm.sh | sudo bashDownload easy68k-linux-5.17.0-x86_64.AppImage from GitHub Releases:
chmod +x easy68k-linux-5.17.0-x86_64.AppImage
./easy68k-linux-5.17.0-x86_64.AppImage- In-App GUI Auto-Updater: Open Help -> Check for Updates... inside
easy68k-guito verifySHA256SUMS.txt, download the newest release, atomically replace the.AppImage(or install.deb/.rpmviapkexec), and restart. AppImageUpdate(zsync): Every.AppImageembedsgh-releases-zsync|Sebo1411|EASy68KLinux|latest|easy68k-linux-*x86_64.AppImage.zsyncmetadata for binary delta updates with AppImageUpdate, Gear Lever, or AppImageLauncher.
Requires a C++17 compiler (g++ or clang++), CMake (>= 3.16), and Qt6 (Core, Gui, Widgets, Network, Test, and Multimedia optional for TRAP #15 sound):
mkdir -p build && cd build
cmake ..
cmake --build . -j$(nproc)The build enforces strict compiler flags (-std=c++17 -Wall -Wextra -Werror).
./build/easy68k-asm [options] <source.x68>
# Example:
./build/easy68k-asm examples/hello.x68 -o examples/hello.s68 --listing examples/hello.l68./build/easy68k-sim [options] <s68_file>
# Options:
# -t, --trace Enable instruction-level tracing
# -m, --max-cycles <N> Maximum cycle count limit
# -q, --quiet Quiet mode (suppress register dump)
# Example:
./build/easy68k-sim examples/hello.s68# Inspect an S-Record file:
./build/easybin -i examples/hello.s68
# Convert S-Record to raw binary:
./build/easybin -s2b examples/hello.s68 examples/hello.bin
# Convert raw binary to S-Record:
./build/easybin -b2s examples/hello.bin examples/hello.s68 --addr 0x1000 --entry 0x1000./build/easy68k-guiRun the automated native and GUI regression suites:
cd build
QT_QPA_PLATFORM=offscreen ctest --output-on-failure -VOr directly via the runner script:
./tests/run_tests.shGenerate native distribution packages using CPack and the helper scripts:
cd build
cpack -G "TGZ;DEB;RPM"
# Build standalone AppImage + .zsync metadata:
cd ..
./scripts/build_appimage.sh build dist 5.17.0 Sebo1411 EASy68KLinux
# Generate static APT & RPM repository metadata:
./scripts/generate_repos.sh dist gh-pages-root- Original Assembler code: Paul McKee, modified by Charles Kelly.
- Original Simulator code: Paul McKee, modified by Charles Kelly and Eric Nelson.
- EASyBIN utility: Charles Kelly.
- Distributed under GNU General Public License.