ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
# r& B5 ~+ Z7 c! C" {
1 U& \! {0 l. R3 X# Z- e' UARMIPS assembler作者是Kingcom,目前发展到0.9版本

5 L# \1 i' O# U$ h1 {/ I; CKingcom's website：http://aerie.wingdreams.net

7 N# A6 ~) O1 o; `6 FARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

更新版本可去http://buildbot.orphis.net/armips获得

1 N8 g2 i! t4 tARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：
* W/ W; y. W! b' H4 E1 Q
% C) U3 A" G: c) Z- O6 L- R. g' IUsage: armips [optional parameters] <FILE>
6 M' z, N% w) G6 ?3 Z
- M0 Y' j" e0 P* YOptional parameters:
2 H. o* c6 Y- A -temp <TEMP>         Output temporary assembly data to <TEMP> file
  O  M4 b3 |2 Y" |- N) P -sym  <SYM>          Output symbol data in the sym format to <SYM> file
- p3 x0 q# f% w- s; A3 W  Y -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
# t' j9 d, p* F' s -root <ROOT>         Use <ROOT> as working directory during execution
: b9 W0 Z2 M, Z) R6 V8 p -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

/ f* q+ B/ p1 y9 A* y" G5 gFile arguments:
<FILE>               Main assembly code file
% Y4 d. w0 V* x+ n+ p# d5 `9 E% e6 c
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
4 c% N( G( V2 s7 ]+ _8 e; o) s-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
4 n: v/ c, H& k$ X$ a0 z  u-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
, N# p* t" W0 X1 Z; |1 `  A  M4 Q: H
<FILE>是汇编代码文件，可用记事本之类编辑
' i/ d- N9 L- c) `
注释说明：
& \: O3 \/ Q: L+ H( w& V注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
5 o) _+ k. N2 V$ J
9 m( x, T* H. z2 B例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

% \7 P+ r( n. t.close;/*关闭文件*/

0 t$ g& ~# ?! k' }, P$ V标签说明：
% S/ m* p* y4 B标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
( I" h" S3 w! i% g+ \! h  U$ N
7 M, h& E1 k" E! H+ o数值说明：
" t4 w0 N: M$ Z2 }) y“0xA”和“0Ah”是16进制数值
( `$ y4 A0 s$ @3 ~2 C“0o12”和“12o”是8进制数值
: c1 {9 T" q$ t$ ^( |/ }& S" r) m“1010b”和“0b1010”是2进制数值

equ说明：
格式：text equ value
. _8 R  |4 T- f8 e# V* A3 _: X说明：用一个text代替value
/ ^9 I3 y1 k8 C0 r" k例子：
address1 equ 0x12345678
ldr r0,=address1
+ h* g- R4 J2 ^3 Y.pool
: d6 G  D, L# b
函数说明：

6 d2 _3 Z# l5 h; U.open函数：
; v: }& Z2 R# |. e: `( E8 K2 ]+ R2 L格式：
.open "ROM FileName",offset
+ v* j9 i3 ^  F.open "Old FileName","New FileName",offset
1 j/ I# z3 M5 X. o. d, ]5 f说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
/ {8 t( q) Q/ W6 @2 ^# x+ ~' @.open "1234.gba",0x08000000

.close函数和.closefile函数：
格式：
.close
.closefile
7 }2 W! T# b3 f2 z" H. I说明：关闭文件。

2 }2 T! K# d* R* Q.org函数和.orga函数：
格式：
.org RamAddress
: P7 H$ P( k8 ^3 h2 Y.orga FileAddress
4 {5 K1 [) w5 O' [- y* L说明：
1 C, C' t& A; t$ i& ~前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
格式：
/ O) Z8 t6 J. B( n' i" {3 y4 U% d0 t0 N.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。

7 t/ Z* j; B; K.area函数
格式：
.area SizeEquation[,fill]
.endarea
$ A! e) `! {' C8 G+ |+ e说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
- A' x$ G2 V! X: E" O* `. }8 d7 `- d
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
$ C3 s( @; D5 C6 J/ s.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
( H* L& P# q6 o3 g2 E. N
.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。

+ O+ A2 V/ Z9 k8 V9 O.pool函数
格式：.pool
+ X5 i& d5 k8 v% a; s) F5 _# L9 o; w; S说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
7 \2 ?2 {' o. J+ e6 L例子：
( }; N# ^6 V( w$ q# u7 V& `ldr r0,=0x12345678;
' C; S  r% f6 d+ b0 J* l6 O4 t....
.pool

& H! n- e$ ?0 S- r- G.fill函数
, J5 H: p9 [& f9 l/ n格式：
" A5 R' [3 R  N, P( e.fill length[,value]
+ C! T* d8 B9 edefs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
% _8 a7 r' @% M4 S6 Q# ?
.skip函数：
4 O8 U0 L7 G* ?: U7 v格式：.skip length
# q+ m) c% l5 {. n说明：跳过指定长度单字节数值，length用16进制表示。
1 u+ n' U$ r" @5 I$ G* U
写单字节：
.byte value[,...]
- v. x& k2 c9 A' G.db value[,...]
.ascii value[,...]
.asciiz value[,...]
dcb value[,...]

写双字节：
.halfword value[,...]
' Y( H. A5 m; A9 P* F9 e! p.dh value[,...]
dcw value[,...]

8 Q- M/ p8 V8 s' g: o- i写四字节：
8 _: l, {; I  `+ @5 Q' k.word value[,...]
0 p# j/ K2 @7 r3 b% m$ m.dw value[,...]
8 P( e8 M" }$ l. v, |0 @; ddcd value[,...]
- k2 s. L# l4 }# M! f5 a% A- g
/ @; B- ~: l9 x' J( d写doublewords：
; z6 I# c; |; F6 ~; a' K.doubleword value[,...]
.dd value[,...]
: H5 L, s; y# @+ tdcq value[,...]
6 Y3 {6 c3 O& M) a3 M9 m
写浮点数：
- f: l* m7 z9 v9 y+ A2 p.float value[,...]
* `6 G: h1 X. L: A; Q6 H.double value[,...]
) y9 m- X$ G5 a2 I
) }# o7 D9 M3 @  I% EARM的ARM模式和THUMB模式定义：
.arm|ARM模式
1 i6 |) A# E8 y5 b; a.thumb|thumb模式

设置架构：
6 X* e3 U6 C" ?. \+ l- R7 D8 e4 c.psx|PlayStation 1(MIPS R3000)
( c0 B% G% x& R& _, ?% S.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
& U; f# m2 s, z+ J% j.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
# Z2 t+ G* t" ]5 Z* G( ~