ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
) i. n1 X/ {# I7 x$ ^' N7 q& M' e
0 c& s( D+ v2 V/ L( YARMIPS assembler作者是Kingcom,目前发展到0.9版本
* d% Y: [3 G2 Y$ H
Kingcom's website：http://aerie.wingdreams.net
3 r( v' H0 R- m& N' K
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
, k) g6 a2 `! \. p& W; ?
更新版本可去http://buildbot.orphis.net/armips获得

, c( e0 k# @7 d, F5 ~2 v/ zARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
, e: F' t/ T5 Z/ Z
ARMIPS命令行用法：

, I# g( W4 G7 T/ r. J, {Usage: armips [optional parameters] <FILE>

8 C' a+ z$ L2 Y. Q& ^Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
% o7 j/ b1 {' J/ h -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
# \5 ]: S& I& o4 _% h$ @. ?' w -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
& V! T1 f9 K. d( o6 u* X -erroronwarning      Treat all warnings like errors
1 B$ g4 A7 h! }! k% j1 F
$ T% T8 s8 c) C$ h. F' u" n% dFile arguments:
<FILE>               Main assembly code file
$ |" `" v1 e  p2 i0 t6 l) J# y
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
* h' `* o7 K* h& Q1 u-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
  z1 N8 o) l( _7 C1 {7 G-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
' u# m7 n8 ?- \4 `- r-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
2 q. o% \2 m5 L1 C! D
, D( [1 X, I+ C! P+ |<FILE>是汇编代码文件，可用记事本之类编辑

注释说明：
注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
  N+ b( F$ S% [$ i
例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

.close;/*关闭文件*/

  p* |, t2 h1 t+ t标签说明：
4 E- A* O$ t$ y标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
“0xA”和“0Ah”是16进制数值
5 B" P7 g4 k$ b& X“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
' P  B% h% X: X4 v
- |* p* _4 I: m! H4 b2 v: Cequ说明：
8 W) D; o) x: ]# e6 u6 c格式：text equ value
说明：用一个text代替value
3 n  F! m3 H; P6 l& ?- M7 x9 [例子：
8 A1 N0 n2 A2 W; i$ Aaddress1 equ 0x12345678
* @/ \! ?) Y# V" y6 gldr r0,=address1
.pool

0 L8 w/ R4 R& ?函数说明：

0 F: v4 k  l: ?  f* I9 V6 t! z.open函数：
9 |' q/ f8 h! f# B, e7 |格式：
8 F  n! L: @5 C; u, S+ p5 U! u.open "ROM FileName",offset
" s6 H% Y- R* Q2 G.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

. ?# k+ z9 {3 |5 F例子：
.open "1234.gba",0x08000000
5 H0 x5 r0 L. D
% M0 {) Z* G) L* U( E.close函数和.closefile函数：
% [1 o5 M: G, s格式：
3 H3 I; x9 r, s4 v1 m- b4 o.close
.closefile
说明：关闭文件。

( f) v' G" ]4 G3 M- |+ Z.org函数和.orga函数：
) D7 v& w' N4 H/ p) F% e" B! b格式：
( c9 A" |- [6 o* {.org RamAddress
# a3 z! u9 l/ G9 M8 A.orga FileAddress
; ?8 W* G, s6 T* W- E9 q0 c说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
: M" M5 a7 y* d' O/ W' X
& I5 _7 b" s! t0 S# _- S- k0 {* ~.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
7 Z5 l( b4 T, y+ M. U  ?格式：
: `" v( [. [0 }.create "FileName",offset
.createfile "FileName",offset
$ J& X" H7 k0 Q: e& M5 ?说明：创建一个文件，如果文件是存在，他会覆盖掉。
  B5 q/ l2 O$ \& z8 `; w& ~' ?  C
1 j; w6 s/ k6 ]  H! T.area函数
2 A) }3 f1 r" [5 J7 s  W, q! v格式：
9 W- q0 ]" Q) E3 F: _8 z8 t.area SizeEquation[,fill]
.endarea
* v, m$ H1 w5 d' a3 n说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

$ \& |+ r& K; Y8 S8 a2 c2 g6 M例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
" G4 M/ O- |! o
) I7 C1 |0 Z. Y$ g.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。
' I: }" q& l- ?9 a$ V& G
.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
0 _6 w1 z6 u' oldr r0,=0x12345678;
....
0 o, s; A* F! T+ `7 g.pool

2 H: q6 m1 ^$ g9 ^" Y+ y.fill函数
3 A( |1 U' \8 Y格式：
.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
9 }! Y! W6 z+ V2 k( M5 c
.skip函数：
. W0 k8 z& K# X( s4 S格式：.skip length
4 `/ C2 c! N' e说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
.byte value[,...]
.db value[,...]
.ascii value[,...]
( Q7 G+ F4 D' W3 Y" O.asciiz value[,...]
1 v5 m, n7 N) t% l; H1 d: Kdcb value[,...]

写双字节：
" O' Z" M1 J$ b# y9 m9 Z" P4 f5 @.halfword value[,...]
+ I' P3 y$ D& J3 \4 \0 u  s8 W.dh value[,...]
4 I- D; d6 _! Qdcw value[,...]

写四字节：
% \" U) z6 c5 m- W.word value[,...]
, X; P* P( c. E+ c0 _7 s! O& L.dw value[,...]
dcd value[,...]

写doublewords：
0 V% g- {8 g$ |.doubleword value[,...]
! ?9 L  [$ c6 |7 Y1 }3 U.dd value[,...]
dcq value[,...]
: q/ J+ E6 p' Y8 F" g, s6 b1 V
' v2 L+ i) v5 I$ _4 y8 |' l7 \6 p4 M写浮点数：
.float value[,...]
.double value[,...]

3 X, z/ L% X3 E" h- zARM的ARM模式和THUMB模式定义：
0 c0 _6 {3 x) Z/ D.arm|ARM模式
$ K3 E7 |5 d5 n0 [$ Q5 _2 Q5 ?.thumb|thumb模式

设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
5 P8 s' D1 D% y8 T( I.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
.arm.little|

% x9 r( F" n* _! n1 J) H$ c常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。