ARMIPS assembler使用说明

疾风之狼

5 U% s) J! }! q1 I$ eARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

' {1 n5 j% u8 W, \* P3 rARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net
1 i3 L4 l- @# I7 L3 Q3 `7 }
, P6 p* G: J+ Y1 ~& s' ?. u  oARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
9 `( h+ f' p$ p1 J: X' ?
更新版本可去http://buildbot.orphis.net/armips获得
& P( r8 u) \* T4 D' Q: M
! e& ?5 W' v$ I- q/ ^ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：

7 z9 n' X; Y8 N3 ]Usage: armips [optional parameters] <FILE>
! s$ s0 S5 U, O8 e" i" F$ P$ [
$ n* w( L' O# _# n* L$ pOptional parameters:
* l1 Z5 |3 I$ q" p& f -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
-root <ROOT>         Use <ROOT> as working directory during execution
3 o7 f. S6 k, b1 x/ |  s -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
( `4 R7 U/ ?  c5 ~" ` -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors

File arguments:
8 W) u+ b$ D9 w1 O. Q0 u% z8 m <FILE>               Main assembly code file
% O/ K; a* j2 @. f1 W7 ?
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
3 l. s- r! D; b  L! @% a; S-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
# v, f# f9 C8 i; G6 _: G! Q-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
  x9 [- }! v* q0 ~-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
- B' T5 y3 H6 ]) `7 `-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑
7 C5 L) ]1 j% ~) g2 a" y
# A8 h: H# K; m0 w0 K注释说明：
注释可在单行指令后面“;”和“//”添加
  c# A7 y( C" j) K  c/ ]( ^  V“/* */”式也接受
! B  |+ x5 S2 c, P) A4 |
例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

/ P$ R% y, \+ O2 C$ `.close;/*关闭文件*/

( r" Q: w5 ^3 |4 ~5 B$ U- {' ~& s标签说明：
0 i( b  j8 V6 \7 h标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

7 H  @  `. x* U' i- J$ I+ t( z5 q数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
, _" X4 }+ I0 f# o1 H# W“1010b”和“0b1010”是2进制数值

, E4 g6 M/ P# Z5 s. \8 X# i7 Fequ说明：
格式：text equ value
3 r& Q- X1 j, y, h! N! m说明：用一个text代替value
7 E5 [0 D& r1 X  B5 t8 ?! h例子：
address1 equ 0x12345678
ldr r0,=address1
.pool
- D  a5 z; D5 ~, y9 R1 W9 \
' d% {  y! ^* U函数说明：

. u2 X; [0 H5 x5 m% ^# U" A+ ?4 n.open函数：
( h1 e  `9 A) ^* e; R4 r) Y+ c3 L: ^格式：
3 s) c: b2 `& M0 q1 j4 H.open "ROM FileName",offset
& Y6 `5 p3 S" K' R* U/ J2 p7 z.open "Old FileName","New FileName",offset
* l# A& V! }( f$ C. }. k% I说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

: A, R/ C- \/ F8 F例子：
$ A* N/ _+ f4 D4 c" u6 k.open "1234.gba",0x08000000

. x3 S( [0 _5 O( U/ [* ?.close函数和.closefile函数：
$ h& `5 _- S, j. l% b格式：
.close
.closefile
. V$ {/ B4 l7 X- \# e说明：关闭文件。
3 T; z4 Y+ l0 @% Z
.org函数和.orga函数：
格式：
. B! }3 m) t! o/ N.org RamAddress
.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

6 Q+ [) w# `' \: M8 e4 }.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
4 i/ ]( b: Q" W6 _  B6 l说明：创建一个文件，如果文件是存在，他会覆盖掉。
9 }' l2 K1 y' x( P; d/ i
. g. P1 G6 {9 b: b.area函数
3 g2 c; n# G: f7 X; h* ?. v: j格式：
.area SizeEquation[,fill]
8 o6 i: w# L( d" q! v$ i.endarea
, S3 K7 s& ?7 q$ y! D说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
3 r$ `# |! f! A+ K: u' Y# T# o
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
! o# y1 Y5 r6 ?0 u( p+ v/ qorg 0x100
5 k3 v6 Y) m$ u! g.area 0x8
# d! j3 ?! b+ A" r# h1 Z' gbyte 0x5,0x6,0x7,0x8
.endarea
" U) }* j) c  \$ E+ c& b; x
.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。

8 @! ]  Z* t7 f3 Z.pool函数
+ Q+ `) S2 \* \) f# g6 L6 e格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
8 u- U) @; J2 B% s! i# ]例子：
ldr r0,=0x12345678;
# h* A* A1 m) M5 C: F....
.pool

$ x) A8 C5 z* Z.fill函数
格式：
.fill length[,value]
defs length[,value]
2 T) P' `$ l9 Z: P; G$ ]* v  \6 ^说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
7 k- F2 @5 M8 ^% J( F: `( g1 _
# }  }2 ?( w2 r: F0 ^.skip函数：
格式：.skip length
5 p5 `9 S1 O' T/ @, S说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
.byte value[,...]
% G, {2 G# H+ @1 k/ S.db value[,...]
2 m0 F/ u1 N4 r2 I.ascii value[,...]
.asciiz value[,...]
! M# b5 \. C$ o" Ydcb value[,...]
6 T; _/ C: m1 L* c9 n
: K; p# _7 w# J4 n0 P& I- W9 u% v写双字节：
.halfword value[,...]
.dh value[,...]
dcw value[,...]

写四字节：
.word value[,...]
' Q( O  B9 n: {.dw value[,...]
dcd value[,...]

2 L& f& r% K# p% l1 O写doublewords：
.doubleword value[,...]
' ~/ A6 S! }+ R  A1 E7 V% f- r# C.dd value[,...]
& [* y6 v# `, o7 _" jdcq value[,...]

写浮点数：
.float value[,...]
7 P' Q4 h8 ^7 S- d! E/ b7 K5 X* Z.double value[,...]

ARM的ARM模式和THUMB模式定义：
2 W1 K0 }2 N. E$ g2 G. ?.arm|ARM模式
.thumb|thumb模式

设置架构：
$ d: p0 X! O3 n4 }/ b+ s1 ]( o5 U.psx|PlayStation 1(MIPS R3000)
' h. W7 `* [; M4 b+ d" o9 ?8 Q.ps2|PlayStation 2(EmotionEngine)
" ^/ k4 O1 e) _* E' V.psp|PlayStation Portable(Allegrex)
! F" q: ]# |$ L! F9 B$ t# ?.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
- M3 G9 A7 Q% |.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
! H# `" m; l( l7 \  Z.arm.little|
0 W$ P; v4 D0 [; K  x5 U) O
7 s8 [$ `2 U- F) `常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
. I3 G# b! u$ J" W6 e