ARMIPS assembler使用说明

疾风之狼

) t. o3 i5 L+ S% j& d. i/ P; n9 nARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
* k1 N$ ]6 b6 w$ W* ^  m7 o
ARMIPS assembler作者是Kingcom,目前发展到0.9版本
% j( R  e% I5 l5 Q) M/ G4 O  r' V
$ i* V5 p7 _) k8 M' z$ m& SKingcom's website：http://aerie.wingdreams.net

* y. A3 g2 _% R- l4 b+ D2 zARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
; \9 s; @- E0 j# L; z+ q8 j
更新版本可去http://buildbot.orphis.net/armips获得

2 Y/ m& ~" `9 R* D6 hARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
+ Y- z; _4 ^- {9 o- q$ `
ARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>

Optional parameters:
8 L7 D- S% x. u/ `9 B5 x -temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
. k7 r) V# B) d -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
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors
8 h9 x+ v5 j6 ^
File arguments:
2 ], ]3 Y' [4 M0 _+ o <FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
8 J2 O* \5 S5 R" n% w% D-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
5 a5 C+ R0 ^8 X! O6 b9 ^-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
% Z3 c5 y8 T( b) O. \0 D) E. R
<FILE>是汇编代码文件，可用记事本之类编辑

. q* x. p" y" J; \6 P3 o注释说明：
. @- F+ e8 G, w% u7 S. \注释可在单行指令后面“;”和“//”添加
; A. o- f$ Y( l# z; _$ L* Y9 o“/* */”式也接受

1 `$ y/ h; e8 |9 G& r& y7 R例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

; T% p; ^% y: O" r3 w.close;/*关闭文件*/
5 H& v9 G( I4 b
标签说明：
& K/ w) O% H7 e$ ^, M! H7 L标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

8 m2 G# i& q8 s/ V) m" \6 k. ^/ w数值说明：
“0xA”和“0Ah”是16进制数值
2 l2 i8 Q; S/ I, }* z2 T2 _“0o12”和“12o”是8进制数值
9 a1 r" f% e1 [, r1 d“1010b”和“0b1010”是2进制数值
/ X" H& O" |, o6 l2 n' t; H- u
, `5 ]9 t. M3 v8 f1 Wequ说明：
" a; A$ }0 x9 _2 q格式：text equ value
说明：用一个text代替value
' w4 H* Q4 d. `; g例子：
address1 equ 0x12345678
8 E2 F- D0 S1 S& tldr r0,=address1
.pool
; x  A' o6 s2 X4 t
) {! n+ f: j4 _5 [6 ?" n5 M函数说明：

.open函数：
3 u/ G0 L, m" d; V& Q6 H& [格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
# \/ d3 b) J& M% U: C& Y3 Q0 R说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
! T$ n: N" ~0 l) ^
- D& g6 D; \% D$ T% P. y例子：
.open "1234.gba",0x08000000
% U+ H9 J+ a) q0 U, V
.close函数和.closefile函数：
格式：
" k7 m! z8 V3 R.close
.closefile
说明：关闭文件。
4 ?6 ~9 d7 Y5 \7 I( X1 b
.org函数和.orga函数：
格式：
- z3 n0 }9 g* J& Q8 {.org RamAddress
.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。
/ c0 t; g0 R( C! T2 b# b) D
  B9 b$ t% a2 @.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
& l6 b9 w5 }) c/ h6 @( X8 t/ A. Y1 h说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
格式：
9 N% N0 l3 \9 L$ ?) c1 ~.area SizeEquation[,fill]
  y( }/ I, z* L, Z. e1 o.endarea
: z* M+ C' D& W) G; `. J+ d说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
) Q9 y& e6 J. M/ ~/ w% v
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
. W" t) |* w- y8 ?( }7 \org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
, Q. ^4 n6 n  }, k4 e; M
2 O6 j7 V6 E; ^: w, D3 k! Z.align函数
- ~" J- d* E7 F7 |$ ]# A格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。

.pool函数
格式：.pool
% Q' Z. s! K' G; ]  ~: d说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
4 c& l* ^9 e, j- i% x例子：
" G* v3 ?9 r" F; D7 |1 }ldr r0,=0x12345678;
) o) e  t* |/ c....
( d" u$ o+ M  i  N.pool

.fill函数
格式：
.fill length[,value]
! ^* }! q; E, z& y' v' a$ _defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

' g* }, s/ h/ B* F9 y  m& N8 N.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

. }, Z. A9 `* k0 ^9 Q+ q4 v写单字节：
.byte value[,...]
- M4 B6 s/ {# d" k.db value[,...]
.ascii value[,...]
3 ~  l3 J' |+ F# w7 ?( l' l.asciiz value[,...]
5 o" \" W$ W! `6 ^5 y0 m( Tdcb value[,...]
* N. o1 Q+ A5 j5 z
写双字节：
.halfword value[,...]
.dh value[,...]
dcw value[,...]

写四字节：
# v; s* d- y. c+ s5 G  Q# q.word value[,...]
* ?- A2 [# h8 l6 {9 O& l+ m.dw value[,...]
dcd value[,...]
8 n% Z! E! y3 ]( _* J1 p4 q
0 r0 v0 G7 E' p+ ]写doublewords：
# t  m0 S' ?' `  P  O4 W6 u  b.doubleword value[,...]
0 i# O. I, S6 K8 f* [5 [0 h.dd value[,...]
- t+ M1 \3 o' A# o3 u, zdcq value[,...]

5 C; v3 ^- J, N) z1 F/ [6 K/ }写浮点数：
.float value[,...]
.double value[,...]
' u1 {1 ]- R3 N
' W: T' o$ m5 ?7 ~- C% U0 ]/ ?ARM的ARM模式和THUMB模式定义：
; P! g4 ]6 |2 s* C.arm|ARM模式
.thumb|thumb模式

设置架构：
.psx|PlayStation 1(MIPS R3000)
7 F/ y" @1 x2 E- _.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
5 h- b0 F. z; F3 v+ W$ j5 G* ], z.gba|GameBoy Advance(ARM7,默认是thumb模式)
2 A3 w( m- s  n, {) Y2 M.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
* p7 J0 j" I% b0 O/ M.arm.big|
.arm.little|
/ M  I5 |6 u& K, v9 S9 k4 o
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。