ARMIPS assembler使用说明

疾风之狼

) A* {. x5 u. f. u1 L4 aARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

ARMIPS assembler作者是Kingcom,目前发展到0.9版本
/ _- ]* x6 V' A+ d% A, x& O) \& H* Z* x
Kingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
# M  J* H% e# [/ Z. ?* P% S
更新版本可去http://buildbot.orphis.net/armips获得
" v& @& V7 X2 r, t; E
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
4 j+ a/ W. K* {
ARMIPS命令行用法：
  K7 i; g' f( r' v# |0 ]
Usage: armips [optional parameters] <FILE>

Optional parameters:
3 M5 p- K& p2 f& L! s. m" P -temp <TEMP>         Output temporary assembly data to <TEMP> file
6 b, ^- e3 o7 _) f( q9 D1 b2 E -sym  <SYM>          Output symbol data in the sym format to <SYM> file
; S  w' H% l+ ^) h/ v/ t0 {* m -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
-root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
* u# v" \2 c1 Q -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors
! n  i, O! P* o9 J1 ?) i
* v/ Z3 w- F2 i0 mFile arguments:
<FILE>               Main assembly code file

6 `/ S* R9 Y* B/ K3 q$ |-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
& O( p1 }  V+ z5 f-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
5 E- [8 s/ P7 N, Q-equ <NAME> <VAL>参数用法不明
+ v4 r% e( d- U; b$ G, P6 E-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑
+ ]1 Y+ x: }, s8 S: p2 b
7 V: v/ t0 |0 t/ ]0 X# c注释说明：
注释可在单行指令后面“;”和“//”添加
3 P5 D; @- p+ A/ D  Q“/* */”式也接受
* [) b, \) s, m* I
  Y& ]" Z1 ], i9 r, J例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

.close;/*关闭文件*/

$ p" A2 C" U0 r4 a标签说明：
4 d% O+ z, M* n3 B' t标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
/ S- t6 T/ k, b" d% a/ E' b5 K, x“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
( W; l4 N) g/ ~9 G" ?1 }
equ说明：
& E  \# p+ X- ~9 o格式：text equ value
说明：用一个text代替value
% ^4 n9 s6 n2 N! K5 ~7 d3 K例子：
4 V7 M' t+ A( ~' b$ Y: @4 Waddress1 equ 0x12345678
ldr r0,=address1
.pool
6 v. Q8 t# J2 E: z7 p* `/ z
函数说明：

3 c; v) R# M" w3 q/ |+ F. Q( A.open函数：
格式：
.open "ROM FileName",offset
' l/ E) }5 Y$ b.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
7 Q+ O1 p, u2 U4 A
) |1 n( ^3 R6 L( [9 L例子：
.open "1234.gba",0x08000000
5 N- J3 o0 A' @8 m; p) D3 r% Q
.close函数和.closefile函数：
格式：
/ B  P7 _8 f; {! X* q.close
.closefile
说明：关闭文件。

9 s3 v8 p) ?$ H& P  l' ~.org函数和.orga函数：
格式：
.org RamAddress
7 @# Z0 [% T: u' B3 d, ~  i.orga FileAddress
: B4 s4 }' v0 X& D& U$ C说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
; O1 |7 ~2 x, j: ^( n  m  U
.orga函数可指定ROM文件的输出地址。
, x; D- O( B; v. i/ |8 ?1 N
3 ^9 i5 \6 _1 H( \.create函数和.createfile函数
格式：
.create "FileName",offset
" t: m& Z  r2 s  _' c9 t9 M.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
; ~* y  R% V3 k4 ~" L
. g- ]; f- q$ w4 T7 P! {8 K' G5 Q.area函数
" X! m  }" x2 Q- |0 ]格式：
5 U, R+ p/ L0 W2 t.area SizeEquation[,fill]
7 N9 b$ w# z* ~% V7 @8 L  Y.endarea
7 \! N. y) A2 i: p- a说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
# T1 F" [' _- ]2 m) b5 t.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
8 w8 y* k- e" ^
.align函数
格式：.align num
, t7 t7 v( Q. B5 g+ z说明：写零字节，num为零字节数量，用16进制表示。
( a. G8 q* G" m: {' d  h
5 x2 K8 Z& o$ e" J9 l# W.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
9 w2 K. `' ~7 h! X( R4 x....
! F; S( ?; u4 d! P/ ?) n: W.pool
! E' e- \; J" c7 _0 u' L  l4 i9 y
0 G% G7 m& X# H4 a; a.fill函数
: y' z+ Z' n8 x; n" r! o, A格式：
. o7 y2 w( M( C$ x/ u3 `.fill length[,value]
defs length[,value]
" ?) w) w- }, G! A9 d! |说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
- B1 r2 c6 Q1 v' f格式：.skip length
( J/ a+ B+ T/ x) }" s说明：跳过指定长度单字节数值，length用16进制表示。

! }; f9 p+ ?9 M# y写单字节：
.byte value[,...]
.db value[,...]
.ascii value[,...]
6 |. U8 j6 P% H! e! o# s.asciiz value[,...]
7 w5 v- l/ |0 Edcb value[,...]
! _! I7 A5 d/ _/ G
; o- A# Z( u8 x0 z+ I- ?; A1 C3 A写双字节：
.halfword value[,...]
.dh value[,...]
% V  x8 v! U6 w7 m2 _  W) j. A% O' Q& S" |dcw value[,...]
" z% H8 o5 d, w/ X: a0 k  I
) B- h2 P3 [- \/ H! F7 V. O写四字节：
.word value[,...]
/ U3 F3 h3 c, R7 w.dw value[,...]
9 I  T: `# f8 e$ adcd value[,...]

写doublewords：
.doubleword value[,...]
.dd value[,...]
dcq value[,...]

+ N( d7 d, m2 I6 I* n: _: v  S写浮点数：
& n2 b. @0 y7 t+ T.float value[,...]
.double value[,...]

ARM的ARM模式和THUMB模式定义：
3 L& c. G  p) ^! E5 U* `  q! u1 f.arm|ARM模式
4 y3 }4 d, z9 q.thumb|thumb模式
6 h! a" g# y) p) Y- ~6 w
% w, b% R7 K7 m9 c3 P设置架构：
.psx|PlayStation 1(MIPS R3000)
# e+ k0 i" f8 v2 U4 N.ps2|PlayStation 2(EmotionEngine)
# e" c9 v, S% }" \: j.psp|PlayStation Portable(Allegrex)
/ F. t6 @7 Y9 n! g% [.n64|Nintendo 64(MIPS R4000)
! O. J) \! L$ P.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
$ [4 X$ m& J# s1 @  L.nds|Nintendo DS(ARM9,默认是ARM模式)
. S$ v! a) j4 r% v) @6 k2 Q.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
: c2 [3 b7 ?- g6 r6 w.arm.big|
+ Z& Q& X6 |% B.arm.little|
6 z; j0 P# m; s
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。