Skip to content
Powerful macro (cross) assembler package for several CPUs
C Assembly CMake C++ Shell NSIS Other
Branch: master
Clone or download

Latest commit

Files

Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
.idea Update for idea May 14, 2019
.vscode Linker object read fixed Sep 9, 2019
build Updated version Feb 6, 2020
doc Don’t attempt to align fixed sections. Added new xasm option to selec… Feb 6, 2020
test Reworked comment handling. Jul 3, 2019
util @ abccd35 Added file's CRC32 to debug information Sep 10, 2019
xasm Don’t attempt to align fixed sections. Added new xasm option to selec… Feb 6, 2020
xlib C string safety improved Jul 24, 2019
xlink Linker object read fixed Sep 9, 2019
.gitattributes Avoid line ending issues Mar 8, 2019
.gitignore Fixed macro in literal handling May 13, 2019
.gitmodules Added util project as submodule Feb 24, 2019
.gitpod.yml Don’t attempt to align fixed sections. Added new xasm option to selec… Feb 6, 2020
CMakeLists.txt Don’t attempt to align fixed sections. Added new xasm option to selec… Feb 6, 2020
README.md Updated readme Jul 7, 2019
azure-pipelines.yml Specify build platform Mar 8, 2019
b.ps1 C string safety improved Jul 24, 2019
b.sh Fix scripts for CMake 3.10 Jul 24, 2019
bootstrap.sh Script updates Mar 13, 2019
init.ps1 C string safety improved Jul 24, 2019
init.sh Fix scripts for CMake 3.10 Jul 24, 2019
install.sh Improved version number setting Jul 23, 2019
test.sh Moved more tests Feb 24, 2019
ucm.cmake Static linking enabled Mar 2, 2019

README.md

ASMotor

ASMotor is a portable and generic assembler engine and development system written in ANSI C11 and licensed under the GNU Public License v3. The package consists of the assembler, the librarian and the linker. It can be used as either a cross or native development system.

The assembler syntax is based on the Motorola style macro language.

Currently supported CPUs are the 680x0 family, 6502, MIPS32, Z80, Game Boy, DCPU-16 and CHIP-8/SCHIP.

ASMotor is the spiritual successor to RGBDS, which was a fairly popular development package for the Game Boy. ASMotor is written by the original RGBDS author.

Installing

Building from source

Linux and macOS

A script (install.sh) is included that will install the compiled binaries into the $HOME/bin directory. This path should be added to your $PATH for easier use. This script will also accept the destination root (for instance /usr/local).

For even easier installation, provided you have the necessary prerequisites, git and cmake, installed, the latest version of ASMotor can be installed using

    curl https://raw.githubusercontent.com/asmotor/asmotor/master/bootstrap.sh | sh

If you want to install it globally, you can supply the installation prefix as a parameter:

    curl https://raw.githubusercontent.com/asmotor/asmotor/master/bootstrap.sh | sh -s /usr/local

To install git and cmake, it is suggested you use your distribution's package manager. For macOS, use brew or MacPorts.

Editing code

A VSCode extension that enables syntax highlighting is also available at https://marketplace.visualstudio.com/items?itemName=ASMotor.asmotor-syntax

Further reading

Dive into the documentation to learn more about:

Index and reference

You can’t perform that action at this time.