ARMIPS assembler使用说明

疾风之狼

* o) O8 C( ]* v/ Y  s/ i# J5 P% ZARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
0 H; t1 j( P- k0 k  G9 ~
ARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

% w$ u5 y; g* t6 h更新版本可去http://buildbot.orphis.net/armips获得
6 t, I0 V5 A0 R) r
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：
* x" G  G2 Z, D3 y$ f* D9 x
/ o: @5 m$ t  B# u, XUsage: armips [optional parameters] <FILE>

! m$ x9 r4 b2 ~Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
-sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
* ~% d: ]+ B; P) B  |: P -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
% o9 Q! O  ]- w' {; Q3 ^0 ~  t -erroronwarning      Treat all warnings like errors
# I' ~! J$ g& Z
/ k: z3 N7 J2 P9 `7 m5 TFile arguments:
1 H1 P; j& y3 t; ` <FILE>               Main assembly code file

7 _$ l; g* ]) f8 d3 `9 ~: @-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
4 z6 O! ]! m' a  A3 E0 Y-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
/ O6 ~; E4 G. g7 B$ [1 p; C( F6 }-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
$ V; v1 o9 E; C3 A5 O! G  s7 \
<FILE>是汇编代码文件，可用记事本之类编辑
. ^1 M0 }3 H4 ?; j! u9 `. _
注释说明：
注释可在单行指令后面“;”和“//”添加
, o5 Z" ^$ P9 ~' g! k- X! Z“/* */”式也接受
( B* M$ W6 B3 {& R
例子：
8 M/ }7 [9 P3 f' r0 J8 C.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
0 N" e3 D* T; C$ |0 p7 n0 V$ c
5 y& F/ A7 X/ K.close;/*关闭文件*/

标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
/ l6 D6 c, N) A9 m
数值说明：
“0xA”和“0Ah”是16进制数值
, l3 D3 V7 f3 ?, a“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
5 S. w+ K* y+ y# u
equ说明：
/ z& ]- g) q" S+ U  _格式：text equ value
, m0 Q" Q2 I  I; X, `说明：用一个text代替value
例子：
1 z( ~) M% k0 u9 G, naddress1 equ 0x12345678
ldr r0,=address1
.pool

* M$ }( E% |9 c# ^函数说明：

.open函数：
- J1 w. R5 m( m" o/ y7 S9 a" p格式：
.open "ROM FileName",offset
* x. b0 f& }3 e.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
.open "1234.gba",0x08000000

.close函数和.closefile函数：
. E+ h6 v6 n& V7 D/ e, u格式：
; m" F" @( [! M1 @3 G.close
.closefile
9 Z6 H; f; h4 {0 B说明：关闭文件。
, @3 a8 y. `; T* ~
( V3 I7 }( Y. @.org函数和.orga函数：
格式：
' B' ~: ?8 R# n+ \.org RamAddress
2 h8 o# v& o6 R4 d) S.orga FileAddress
& i! K! b8 G( s2 s5 t. D) F说明：
7 E, [7 Q0 G& V4 z; n' j! d前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

8 J( E* |& d7 z5 F; q) ].orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
格式：
.create "FileName",offset
2 P. ~8 p* _6 `3 y* {.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
9 c( K2 A: }' K" b7 X3 ~0 ?
.area函数
# T& N6 o2 K7 I3 H, D格式：
! m+ T* {- Z' `0 @) k* A1 D% X.area SizeEquation[,fill]
3 o! d: x+ m6 P4 w.endarea
* X: ?1 b9 n% [说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
5 V3 g) M" B0 j
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
% O! {2 m; i) C.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
$ m# _2 O8 \0 E$ B* S9 I, |  p
.align函数
: g$ b$ ]4 ?( z! M7 n格式：.align num
0 y0 I* X6 D! y% @说明：写零字节，num为零字节数量，用16进制表示。

.pool函数
0 \6 c7 }  `, R5 ?格式：.pool
* ~% H( M5 t0 U8 L* c; E) Q说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
9 c- S5 V& ~1 c2 y例子：
5 ]* V, i: w! s/ `# Y; Oldr r0,=0x12345678;
% f4 X/ X+ q4 A, P% ?" ~5 c4 ~$ T8 k....
.pool
0 X" m  E, c/ C0 Q: r
.fill函数
& Q7 J- Q$ [; E4 q$ g格式：
1 ^! R+ n8 G; c1 A5 W.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
1 T: c/ n; ?7 G5 H9 s% c/ J
! z+ |8 [  U  O& j3 a/ Y写单字节：
3 l* G$ y$ M6 g) ].byte value[,...]
.db value[,...]
.ascii value[,...]
5 h6 X/ o& |; |: }.asciiz value[,...]
dcb value[,...]
6 I  a8 @! K2 M" i
写双字节：
.halfword value[,...]
3 H4 \* [  i* a5 ], D8 G+ ^+ [.dh value[,...]
) K( |* ~  e0 V& p# x) [dcw value[,...]
8 F5 ~" e$ b, ~/ Z  a) }2 g
写四字节：
* r" I% v$ z5 s! }, ]$ p) R$ W, z% n.word value[,...]
.dw value[,...]
( P' }1 @, ^3 cdcd value[,...]

: u9 |4 U! w- l写doublewords：
. x: _6 t% L( g; i2 `/ G* Y.doubleword value[,...]
.dd value[,...]
0 W! u2 i8 L" a" s4 I: c+ qdcq value[,...]

, n( |2 U8 u' v% |写浮点数：
6 q( x1 L* X0 W' o" ^' k.float value[,...]
: Q, s, Z: N1 O9 V$ D. o9 L+ t.double value[,...]
0 @4 z6 C. k% ~4 f6 y3 n
ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
; Z& F, j2 z+ b* G) a.thumb|thumb模式
+ v( y- ]( r$ S; j( V
设置架构：
7 H+ P+ \' J8 n$ U. z$ W.psx|PlayStation 1(MIPS R3000)
; W0 g7 t( s+ W4 O.ps2|PlayStation 2(EmotionEngine)
' |  o9 j% O. L4 L+ Q- G.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
" c1 p' O8 t% D' Q! v" T8 A- g.rsp|Nintendo 64(RSP)
7 r* P& E/ u& ~- S4 h0 _) _.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
/ H% e& S+ g" Q$ ?.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
: m4 x6 P- E1 M$ B, F& o.arm.little|

( v2 A: H+ ^. }( v. [! Z7 ]' K常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
& P" k$ h- z4 g5 c4 {9 n. D5 u