| Readme: | Short: Z80 cross assembler, very fast
Author: �douard Berg� (roudoudou)
Uploader: Lastic (lasticppc@gmail.com)
Type: dev/cross
Version: 3.3.2
Architecture: ppc-morphos
Requires: TCP/IP stack only for the API_SEND directive
URL: https://github.com/EdouardBERGE/rasm
License: MIT, see LICENSE_AND_CREDITS.txt
OVERVIEW
========
RASM is a command line Z80 cross assembler by �douard Berg�, made to
assemble very large projects very quickly. It is aimed mainly at the
Amstrad CPC and the ZX Spectrum and writes binaries, snapshots,
cartridges, EDSK disc images and tape files directly:
- crunched sections and INCBIN with on-the-fly crunching (LZ4, LZ48,
LZ49, ZX0, ZX7, Exomizer, AP-Ultra, LZSA1, LZSA2)
- CPC cartridges, CPC snapshots up to 4M, EDSK, CPC/ZX tape output,
binaries with or without AMSDOS/HOBETA header, ZX snapshots
- macros, loops, local labels, switch/case, structures, banks,
floating point and maths functions
- symbol, breakpoint and dependency export
- compatibility modes for old MAXAM, AS80, UZ80 and Pasmo sources
This archive holds RASM 3.3.2 for MorphOS, built with gcc 9.5
(libnix, -noixemul), together with its complete source code.
Compared with the upstream 3.3.2 source, this port:
- fixes the MorphOS build (version string, makefile flags and link
line)
- fixes keyword recognition on big-endian PowerPC CPUs (all 1976
internal tests of rasm -autotest pass)
- accepts Unix style relative paths in sources: "./x" and "../x"
(as in INCLUDE, INCBIN or SAVE) are read as "x" and "/x"
- makes the web API (API_SEND directive, -web_host and -web_port
options) work on MorphOS through bsdsocket.library, IPv4 only
This is an UNOFFICIAL port. It is not supported by the original
author, so please report problems with it to the porter, not to him.
It is provided "as is", without warranty of any kind.
REQUIREMENTS
============
- MorphOS on a PowerPC machine
- a running TCP/IP stack, only if your sources use API_SEND
INSTALLATION
============
Copy the rasm drawer wherever you like. To start rasm from any Shell
without typing its path, copy the program rasm to C:, or add its
drawer to the search path in S:User-Startup:
Path <where you put it>/rasm ADD
USING
=====
rasm is a Shell program, it has no GUI. Open a Shell, go to the
drawer with your source and assemble it:
rasm mysource.asm
Without other options the result is written to rasmoutput.bin. What
else is produced (snapshot, cartridge, EDSK, tape) is chosen with
directives in the source itself.
The Docs drawer has the upstream reference notes as Markdown text
(expressions, macros, file imports, EDSK, memory and breakpoints,
structures, ...). The full manual is online:
English: http://rasm.wikidot.com/english-index:home
French: http://rasm.wikidot.com/
COMMAND LINE
============
A few common options, rasm -h lists them all:
-ob <file> file name for the binary output
-o <name> common name for all output files
-oa output names taken from the source name
-s export symbols (see -h for the variants)
-I<path> add an include path (no space)
-web_host <ip> host for API_SEND (default 127.0.0.1)
-web_port <n> port for API_SEND (default 6128)
-n show all licences
-autotest run the internal tests
The version string can be shown with: Version rasm FULL
CONTENTS
========
rasm the assembler
rasm.readme this text
LICENSE_AND_CREDITS.txt credits and all licence texts
Docs/ upstream reference notes (Markdown)
src/ complete source code of this port
src/README.MorphOS how to build it, changes to upstream
CREDITS AND LICENCE
===================
RASM (c) 2017 �douard Berg� (roudoudou), MIT licence.
https://github.com/EdouardBERGE/rasm
RASM contains code by other authors under their own licences: LZ4
(Yann Collet, BSD 2-clause), ZX7 and ZX0 (Einar Saukas, BSD
3-clause), Exomizer (Magnus Lind), AP-Ultra, LZSA and salvador
(Emmanuel Marty, zlib), libdivsufsort (Yuta Mori, MIT), CDT export
(CNGSoft, GPL 2) and a Z80 emulator for the tests (Nicolas Allemand,
MIT). The full texts are in LICENSE_AND_CREDITS.txt.
Drawer icon: the RASM logo, courtesy of Barjack.
Previous MorphOS release (2.1.5): Philippe Rimauro.
MorphOS port by Lastic
(lasticppc@gmail.com),
made with the help of Claude Code (Anthropic's AI coding assistant).
Building, testing and guidance on real hardware by
Lastic
on a PowerBook G4 15" 1.5 GHz (A1106) and an iBook G4 12" 1.33 GHz
(A1133).
|
Ambient (151)
RASM_3.3.2.lha