ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

ARMIPS assembler作者是Kingcom,目前发展到0.9版本
1 X4 v; a& |: W6 Z/ S
Kingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

8 z2 m6 ^. Q7 Z/ n更新版本可去http://buildbot.orphis.net/armips获得

& c; _. j+ L8 ~) ?ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：
6 V% n. Z; p: E; Z2 ^; _$ ?
Usage: armips [optional parameters] <FILE>

Optional parameters:
2 o* I. k2 M' q# p# R: _ -temp <TEMP>         Output temporary assembly data to <TEMP> file
2 w! p& x4 h) C; v2 h: G- }" Z/ P -sym  <SYM>          Output symbol data in the sym format to <SYM> file
. ?0 ^: y6 G6 P  ~8 r- N -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
6 J# I# [  R! C -root <ROOT>         Use <ROOT> as working directory during execution
' K+ S: _( z6 w/ N( A8 F3 o -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
  |  o/ ?/ u; f) l6 B( _6 J -erroronwarning      Treat all warnings like errors

File arguments:
<FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
) t, x' h- w* r-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
& D2 ^7 c% k. O6 C-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
* o. Z4 a  [% i* i( V+ `3 `4 \-root <ROOT>参数是指定执行期间要使用的工作目录
/ h) v1 @, }9 M" N-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

' `0 F9 X  ^" b& V<FILE>是汇编代码文件，可用记事本之类编辑

$ K- q) T: U& B$ i注释说明：
9 J2 c1 t. ?. A& l1 b注释可在单行指令后面“;”和“//”添加
4 v9 f2 ~( }8 d: j. n* B“/* */”式也接受

6 i7 `; ]2 \$ O7 w& B0 d. u例子：
" ^2 i7 a, H1 J2 D0 F7 V* w% m.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

.close;/*关闭文件*/

标签说明：
. c; }7 ^7 ]3 n1 K( _/ O标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
0 N1 D7 h( s0 R! v4 a
equ说明：
格式：text equ value
3 d* f$ D; E5 u$ L, A& D( \( b说明：用一个text代替value
例子：
! S. b+ v3 B7 taddress1 equ 0x12345678
; t3 l+ s: j7 X* S/ p* ~ldr r0,=address1
.pool

* D, c2 u% s  i2 i函数说明：

.open函数：
格式：
9 ]* i/ _0 r% P% `2 K% r+ c& Y.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
) x" N$ g+ X; s  W# w2 b说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
. Q( W. ~, h' X5 ].open "1234.gba",0x08000000

.close函数和.closefile函数：
格式：
, }! a7 u! ?) G4 x.close
% j. V) \. f) S" o.closefile
6 Z5 w7 V' B+ `, r: G9 m说明：关闭文件。

1 S$ ?. ]8 V) G# G. t.org函数和.orga函数：
. ^8 @5 M3 I1 g) D4 O格式：
.org RamAddress
.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

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

.create函数和.createfile函数
格式：
.create "FileName",offset
4 B# H+ k" Y1 q. p+ Q. ]! x.createfile "FileName",offset
  i+ l3 q- G% t; P! B7 X说明：创建一个文件，如果文件是存在，他会覆盖掉。
* E9 G' d5 o& q# w1 \7 y5 h4 w
.area函数
格式：
.area SizeEquation[,fill]
" a& X8 e# ]+ @( U.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
. F$ I0 C( a; Q3 l: J) ]" {
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
0 L) u$ i, w& n' d: q' Q! lorg 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea

3 B( b* M2 A) D' o% n8 S1 q.align函数
格式：.align num
. h4 j, a4 j4 X说明：写零字节，num为零字节数量，用16进制表示。

.pool函数
( s- V0 y; P5 w0 i( X" p格式：.pool
6 f% [. M/ J1 E2 L' y* U& ?说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
* \# B4 A/ a) E例子：
ldr r0,=0x12345678;
; N4 h. [4 r9 a! m7 Q# A....
6 N8 S) {( L& y+ T7 s.pool
& L! k. M+ J; w( M8 s3 C4 r
.fill函数
格式：
.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
( h8 G; D' X/ K3 b
.skip函数：
格式：.skip length
4 p# b; M, r) N" n, |说明：跳过指定长度单字节数值，length用16进制表示。
4 C* u$ V2 T  V( j
写单字节：
.byte value[,...]
4 |8 Z# o/ g3 V+ e2 x.db value[,...]
.ascii value[,...]
6 S" D9 K& J. h: @.asciiz value[,...]
1 G7 n9 C1 C# n; P% adcb value[,...]
) V! k+ Q6 s6 |* B+ o1 p/ ?) i' Y0 l
写双字节：
( X) ?% R/ n8 I7 h.halfword value[,...]
.dh value[,...]
dcw value[,...]
, a( Z' U+ X' v
& m+ g: J+ c& P* X写四字节：
.word value[,...]
1 W) c  [% A5 h; ~.dw value[,...]
: J+ l) F0 A# r# N5 D/ M  l$ P+ zdcd value[,...]
; V2 M$ N' X  r. l! G4 }. P5 e  b$ V
写doublewords：
.doubleword value[,...]
.dd value[,...]
4 |/ @1 n6 G3 r* E, {dcq value[,...]
" W% b( [/ [& C  F. t
写浮点数：
.float value[,...]
.double value[,...]
, x) g. L; Y1 e9 X9 s: l, m
+ ~" P% |$ c, ^3 m* k6 l+ t/ p; ZARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式

( b: r% m, Q; V+ T$ |1 B设置架构：
* g" {" d; P& i0 Q7 L.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
. R$ z& n/ S; O- j& T.gba|GameBoy Advance(ARM7,默认是thumb模式)
* w7 ^6 ?4 n# O' ^7 V.nds|Nintendo DS(ARM9,默认是ARM模式)
6 H) ]( M* Q/ p.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
+ r8 Z5 x4 I% s" D2 e6 R" r4 c. ]2 ^