Annotation of nono/util/iasm/README.txt, revision 1.1.1.1

1.1       root        1: 名称
                      2:        iasm -- 超簡易 m68k アセンブラ
                      3: 
                      4: 書式
                      5:        iasm [<options>] <input.iasm> [<output.cpp>]
                      6: 
                      7: 解説
                      8:        iasm は m68k アセンブラです。
                      9:        入力はアセンブラソースですが、出力はオブジェクトファイルではなく
                     10:        C++ ソースです。
                     11:        <input.iasm> は入力ファイル、<output.cpp> は出力ファイルを指定
                     12:        します。出力ファイル名を省略した場合は標準出力に出力します。
                     13: 
                     14:        以下のオプションがあります。
                     15: 
                     16:          -f <fmt>
                     17:                以下のいずれかの出力形式を指定します。デフォルトは c です。
                     18:                  c        C ソースを出力します。
                     19:                  binary   生バイナリを出力します。
                     20: 
                     21: 文法(全般)
                     22:        iasm ソースは has.x の下位互換を目指していますが、手抜き上あるいは
                     23:        目的の性質上異なるところは多々あります。
                     24:        以下に文法を示します。
                     25: 
                     26:        行中の ';'(セミコロン)以降行末まではコメントとして無視します。
                     27: 
                     28:        通常のアセンブラ同様、行頭に1個以上の空白かタブ (以降単に空白) が
                     29:        あると命令とし、行頭が空白以外から始まるとラベルとみなします。
                     30:        ラベルには続けて ':'(コロン) を置くことが出来ます(なくても構いません)。
                     31:        ラベル(と ':')に続けて空白をおいてから同じ行に命令を記述することも
                     32:        出来ます。
                     33: 
                     34:        命令はオペコードとオペランドを空白で区切って記述します。
                     35:        オペコードは必ず1つ。オペランドは 0個以上で、オペコードにより必要な
                     36:        あるいは許される個数は異なります。
                     37:        オペランドは ','(カンマ) で区切ります。この処理はオペランドの解析
                     38:        よりも先に行いますのでオペランド中に ',' を書くことは出来ません。
                     39:        例えば moveq.l #',',d0 のような文はエラーになります。
                     40: 
                     41: 文法(擬似命令)
                     42:        iasm では、以下の擬似命令をサポートしています。
                     43: 
                     44:          .cinclude <header>
                     45:                C/C++ のヘッダファイル <header> を出力します。
                     46:                出力形式が c 以外であれば何も行いません。
                     47:                例: .cinclude "xm6.h"
                     48:                     .cinclude <stdio.h>
                     49: 
                     50:          .start <varname>
                     51:                ソースブロックを開始します。<varname> は出力の際の変数名です。
                     52:                アセンブルされたオブジェクトは const BYTE <varname>[] 変数の
                     53:                初期値として出力されます。また const int <varname>_size には
                     54:                このオブジェクト列の大きさが入ります。
                     55:                例: .start Pluto::rom
                     56: 
                     57:          .end
                     58:                ブロックを終了します。.start からここまでのオブジェクトを
                     59:                アセンブルして出力します。出力サイズが奇数の場合はワード境界に
                     60:                切り上げて出力します。
                     61: 
                     62:          .org <address>
                     63:                開始アドレスを指定します。
                     64: 
                     65:          .dc.b <data>|"<string>", ...
                     66:                指定のデータをバイト単位で配置します。
                     67: 
                     68:                .dc.b の引数が '"'(ダブルクォート) で囲ってある場合は文字列
                     69:                とみなして展開します。手抜き処理順の都合により、例によって
                     70:                セミコロンとカンマを文字列に含めることは出来ません。
                     71:                エスケープシーケンスは "\n"、"\t" を認識します。
                     72:                文字列中の日本語は (UTF-8 を) Shift_JIS に変換します。
                     73: 
                     74:          .dc.w <expr>, <expr>, ...
                     75:          .dc.l <expr>, <expr>, ...
                     76:                指定のデータをワード単位、ロングワード単位で配置します。
                     77:                <expr> にはラベルだけでなく、ラベルを用いた式を書くことが
                     78:                できます。四則演算 '+' '-' '*' '/' および括弧 '(' ')' が
                     79:                使えます。
                     80:                例:
                     81:                  .dc.l (TEXTEND - TEXTSTART) * 2
                     82: 
                     83:          .ds.b <size>, <size>, ...
                     84:          .ds.w <size>, <size>, ...
                     85:          .ds.l <size>, <size>, ...
                     86:                指定のサイズをゼロで埋めて領域を確保します。
                     87: 
                     88:          .equ <value>
                     89:                この行のラベルの値を <value> と定義します。
                     90: 
                     91:          .even
                     92:                出力位置をワード境界に切り上げます。
                     93:                なお .end 擬似命令でも内部で自動的にワード境界に切り上げます。
                     94: 
                     95:          .rept <expr>
                     96:          .endrept
                     97:                .rept から .endrept で挟まれている命令を <expr> 回繰り返します。
                     98:                <expr> はこの時点で解決できる定数式でなければなりません。
                     99: 
                    100:          IOCS #<number>
                    101:                IOCS コールを発行する内蔵マクロです。
                    102:                #<number> に直接数値を書く代わりに内蔵している IOCS コール名も
                    103:                使用できます。ニーモニックは「ぷにぐらま〜ずまにゅある」の
                    104:                iocscall.man のものです。
                    105: 
                    106: 文法(アドレッシングモード)
                    107:        以下のアドレッシングモードが使用可能です。
                    108:        大文字小文字は区別しません。
                    109: 
                    110:          Dn
                    111:          An
                    112:          (An)
                    113:          -(An)
                    114:          (An)+
                    115:          abs.w
                    116:          abs.l
                    117:                たぶんそのまま使えます。
                    118: 
                    119:          d16(PC)
                    120:                PC 相対です。たぶん普通に使えると思います。
                    121: 
                    122:          #imm
                    123:                即値です。'$'から始まると16進数とみなします。'x' で1文字の
                    124:                文字コードを表現できます。数値から始まると10進数とみなします。
                    125:                0 から始まっても10進数とします。以下の例はいずれも同じ意味
                    126:                になります。
                    127:                例:#48
                    128:                    #$30
                    129:                    #'0'
                    130: 
                    131:        d16(An)、d8(An,IX)、d8(PC,IX) は未実装です。特にインデックス付きは
                    132:        パーサを改良するかカンマを含まない書式に変える必要があるかも。
                    133: 
                    134: 文法(命令)
                    135:        以下の命令をサポートしています。大文字小文字は区別しません。
                    136:        サイズサフィックスは moveq や lea のような省略形式にも対応しています。
                    137:        bra、bcc 命令については .s を .b と同様に扱います。
                    138:        それ以外特に注意のない限り書式は HAS.X と同様です。
                    139: 
                    140:          bra.b
                    141:          clr
                    142:          dbra
                    143:          jmp
                    144:          lea
                    145:          move
                    146:          moveq
                    147:          nop
                    148:          reset
                    149:          rte
                    150:          rtd
                    151:          rts
                    152:          rtr
                    153:          trap
                    154:          trapv
                    155: 
                    156:        Bcc 命令はニーモニックを変えています。B<cc>.B のように分岐条件
                    157:        <cc> を命令語の一部とせず第1オペランドにし、分岐先ラベルは第2
                    158:        オペランドにしています。Z80 の JP 命令みたいな感じです。
                    159: 
                    160:          bcc.b <cc>,<label>
                    161:          bcc.w <cc>,<label>
                    162: 
                    163:        例えば HAS の bcs.b <label> は iasm では bcc.b cs,<label>、
                    164:        bcc.w <label> は iasm では bcc.w cc,<label> となります。
                    165:        条件コード <cc> はモトローラニーモニックのものです。
                    166: 
                    167: 
                    168: 手抜き
                    169:        たくさん手抜きしてあります。必要に迫られたらその都度実装してね。
                    170: 
                    171:        o オペランドの分割処理がてきとーすぎるためオペランド中に ',' を書く
                    172:          ことができません。
                    173:        o 命令語は新しいのに出会い次第増やしていくことになると思います。
                    174:        o Bcc を正しくサポートしたい。
                    175:        o オペランドのエラーチェックはほぼ行っていません。したほうがいいね。

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.