Skip to content

README.md

Latest commit

 

History

History
93 lines (64 loc) · 2.96 KB

README.md

File metadata and controls

93 lines (64 loc) · 2.96 KB
Raw

vasm

This is a git repository clone of the vasm source code.

You can find the original at the vasm home.

About

vasm is a portable and retargetable assembler to create linkable objects in various formats or absolute code. Multiple CPU-, syntax and output-modules can be selected.

Many common directives/pseudo-opcodes are supported (depending on the syntax module) as well as CPU-specific extensions.

The assembler supports optimizations (e.g. choosing the shortest possible branch instruction or addressing mode) and relaxations (e.g. converting a branch to an absolute jump when necessary).

Most syntax modules support macros, include directives, repetitions, conditional assembly and local symbols.

Statement from the vasm creators about AI

vasm is human-made software, and at the moment it is our goal to preserve this characteristic. Please keep this in mind if you consider contributing (especially regarding use of generative AI). If your contribution might contain code not written by yourself, please consult us beforehand to check whether we consider it admissible.

This statement applies to submissions on the origin homepage of vasm (http://sun.hasenbraten.de/vasm), and we do not accept any pull requests here in this mirror repository of the project. All submissions here in this repository are done by the repository maintainer (@StarWolf3000) and, outside of the README, reflect changes 1:1 the provided latest stable source from the origin homepage. We distance ourselves from any forks which may use any content provided by large language models (LLMs).

Compilation Instructions

To compile vasm you can either use CMake, or choose a Makefile which fits for your host architecture.

The following Makefiles are available:

  • Makefile - standard Unix/gcc Makefile
  • Makefile.68k - makes AmigaOS 68020 executable with vbcc
  • Makefile.Haiku - gcc Makefile which doesn't link libm
  • Makefile.MiNT - makes Atari MiNT 68020 executable with vbcc
  • Makefile.MOS - makes MorphOS executable with vbcc
  • Makefile.OS4 - makes AmigaOS4 executable with vbcc
  • Makefile.PUp - makes PowerUp executable with vbcc
  • Makefile.TOS - makes Atari TOS 68000 executable with vbcc
  • Makefile.WOS - makes WarpOS executable with vbcc
  • Makefile.Win32 - makes Windows executable with MS-VSC++
  • Makefile.Win32FromLinux - makes Windows executable on Linux

Then select a CPU- and a syntax-module to compile.

The vasm-binary will be called: vasm<CPU>_<SYNTAX>[_<HOST>]

Building using CMake

Define VASM_CPU and VASM_SYNTAX when running cmake, e.g:

mkdir build
cd build
cmake -DVASM_CPU=m68k -DVASM_SYNTAX=mot ..
make

Building using make

Define CPU and SYNTAX when running make, e.g:

make CPU=m68k SYNTAX=mot

Available CPU modules

  • 6502
  • 6800
  • 6809
  • arm
  • c16x
  • jagrisc
  • m68k
  • pdp11
  • ppc
  • qnice
  • spc700
  • sweet16
  • test
  • tr3200
  • vidcore
  • x86
  • z80

Available Syntax modules

  • std
  • madmac
  • mot
  • oldstyle
  • test