Command line options

File options:

Path option

-I<path>

Specify a path in order to read files RASM wont find in the current directory. It's possible to add any number of additional paths, using the option multiple times. RASM will search in the path declaration order.

File naming options

-oa

RASM will use the radix of the input file to generate all filenames

-o <radix>

Set a radix filename for all files (i mean, without extension)

-or <radix>

Set a radix filename for ROM output

Dedicated filename options

-ob <full filename>

Set a filename for the default binary output

-oc <full filename>

Set a filename for the cartridge file output

-oi <full filename>

Set a filename for the snapshot file output

-os <full filename>

Set a filename for symbol file output

-ot <full filename>

Set a filename for tape file output

-ok <full filename>

Set a filename for breakpoint file output

-ol <nom complet>

Set a filename for ROM label file output

Special option

-no

disable all file output

Dependancy options:

-depend=make

produce dependancies on a single line, in order to use in a makefile

-depend=list

produce dependancies as a list

Symbol export and breakpoint options

-wu

Warn if declared symbols were not used

-s

Symbol export in RASM format (label, address, bank)

LABEL1 #100 B0
LABEL2 #4378 B2

-sp

Symbol export in Pasmo format

LABEL1 EQU 00100H
LABEL2 EQU 04378H

-sw

Symbol export in Winape format

LABEL1 #100
LABEL2 #1234

-er

Export ROM labels, assigned with NAMEBANK directive.
Default filename extension is ".romlabel"

0: ROM 0 wording
1: ROM 1 wording

-eb

Export breakpoints

-ec

Export label with original case

-sm

Export symbol with one file per BANK

-ss

Export symbols in snapshots (SYMB chunk for ACE emulator)

-sc <format>

Export symbol with a dedicated format. The format must have 2 data fields. First field is always %s then the second field must be numeric (%d, %x, …). Use with caution

Note

It's possible de define code blocks with symbol export deactivated

Compatibility option

-m

RASM will do calculations like Maxam or Dams: values will be truncated, unsigned, 16 bits and no priority for operators (shame! shame!)

-dams

Use Dams naming convention

-amper

Convert all & char to # char before assembling. Mostly use to assemble Dams source

-ass

Mimic AS80 assembler

-uz

Mimic UZ80 assembler

-pasmo

Mimic old version of Pasmo (do not use this to compile modern Pasma sources… Use Rasm instead!)

-msep <separateur>

Choose separator for module naming concatenation

-utf8

Use this option to convert UTF8 symbols ¿ ¡ ù é è ç à Ñ ñ you can find on french or spanish keyboards with their respective Locomotive Basic ASCII value.
As a consequence, you cannot anymore use any UTF8 symbol between quotes except if you use -fq option (described below)

à = 64 ou @
ç = 92 ou
é = 123 ou {
ù = 124 ou |
è = 125 ou }
Ñ = 161
ñ = 171
¿ = 174
¡ = 175

-fq

Allow any UTF8 symbol in strings

Uncategorised options

-quick

Use fast ZX0 compression

-cprquiet

Do not output cartridge ROM listing

-map

Verbose assembling with listing, addresses and byte opcodes. Immediate values are zeroed due to RASM unique-pass behaviour.

Bnk|Real|Logic  Bytecode  [Time] Assembly
-----------------------------------------
 IX EQU 0 ; alias definition
 IY EQU 0 ; alias definition
000|0000     |                 LZ4_DECOMPRESS_RAW:
000|0000     | D5          [04]     PUSH DE   (L4:decrunch/lz4_docent.asm)
000|0001     | E5          [04]     PUSH HL   (L5:decrunch/lz4_docent.asm)
000|0002     | 09          [03]     ADD HL,BC   (L6:decrunch/lz4_docent.asm)
000|0003     | 44          [01]     LD B,H   (L7:decrunch/lz4_docent.asm)
000|0004     | 4D          [01]     LD C,L   (L8:decrunch/lz4_docent.asm)
000|0005     | E1          [03]     POP HL   (L9:decrunch/lz4_docent.asm)
000|0006     | C5          [04]     PUSH BC   (L10:decrunch/lz4_docent.asm)
000|0007     | 06 00       [02]     LD B,0   (L12:decrunch/lz4_docent.asm)
000|0009     |                 LZ4_GETTOKEN:
000|0009     | AF          [01]     XOR A   (L16:decrunch/lz4_docent.asm)
000|000A     | 7E          [02]     LD A,(HL)   (L17:decrunch/lz4_docent.asm)
000|000B     | 23          [02]     INC HL   (L18:decrunch/lz4_docent.asm)

-eo

Overwrite files on floppy disk images if there is already files with the same name

Snapshot options

-sb

Export breakpoints (BRKS, BRKC chunks for Winape and ACE)

-ss

Export symbols (SYMB chunk for ACE)

-v2

Export snapshot v2 instead of v3, to use with M4 board

Analysis option

-me <value>

Define error max output. Set zero for unlimited error number.

-twe

Warnings as errors

-xr

Extended error message, with line source

-w

Disable warnings

-void

Enforce (void) parameter usage with macro without parameter (recommended option!)

-mml

Allow macro calls with parameters on many lines

_COPY   Scanline_RAM_End-Scanline_RAM_Begin, 
        ROM_BonusStage, 
        ROM_BonusStageAnimFrames, 
        #E000, 
        RAM_BonusStage_ScanlineRoutines
Sauf mention contraire, le contenu de cette page est protégé par la licence Creative Commons Attribution-ShareAlike 3.0 License