ARMIPS assembler使用说明

疾风之狼

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

ARMIPS assembler作者是Kingcom,目前发展到0.9版本
6 Q* l4 v0 t% S& c$ U  f$ e
Kingcom's website：http://aerie.wingdreams.net
8 X9 I2 k! f) z7 Z1 Y* o
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
9 w; X1 y  D5 V. J# k' r8 G
; m% a: T9 N% {: d) Z更新版本可去http://buildbot.orphis.net/armips获得

ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
& ~( K0 l  ^" [" @( B
ARMIPS命令行用法：
; u! d! ~. z( y0 h! S2 D. R
. M$ D9 X3 y2 F6 z' s4 O' c; IUsage: armips [optional parameters] <FILE>

; Z' l5 G6 C$ e' d' bOptional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
-sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
# p" L1 P2 Z+ g -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
+ d4 X) s. v$ Y1 X -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
. {# j: u7 T& J3 K! l% F' A -erroronwarning      Treat all warnings like errors
1 j( W) E7 |' p+ w/ }' r7 ^& h
3 _- d6 W% t* a+ x' ]" A: {% h* kFile arguments:
<FILE>               Main assembly code file

. {* L4 w8 v/ @3 ~2 V-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
, o. N8 {% ?* n-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
* |1 Z& P3 F& d: _" p1 Z" I-root <ROOT>参数是指定执行期间要使用的工作目录
- S  ~- Y! z- `0 {  w& @2 K; U4 B4 m-equ <NAME> <VAL>参数用法不明
5 K1 S$ R* {2 T& e% T. }1 u+ x' U-strequ <NAME> <VAL>参数用法不明
! T6 t5 E& ^8 v% S-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

' k. w7 l: a5 o/ r* w, a<FILE>是汇编代码文件，可用记事本之类编辑

0 D+ f9 E3 x* R% G) N9 Y) J注释说明：
注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
( _! A" K# K- U8 m8 P2 H
例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
6 S4 `' f8 p% \+ U! d& g
5 t: B1 C+ P0 t.close;/*关闭文件*/

标签说明：
7 E+ O3 i6 {; v) Q5 m标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
, s& \3 M: w7 K3 o5 J3 w. ^
数值说明：
“0xA”和“0Ah”是16进制数值
# |/ s) I/ o5 H9 x“0o12”和“12o”是8进制数值
# n/ ^8 c1 A8 w- u6 [“1010b”和“0b1010”是2进制数值
1 u1 O1 c! D+ z6 G/ _$ I
" R  e0 N: _7 Uequ说明：
格式：text equ value
) c+ ]$ P8 `& N0 Z" Z8 p1 K- {( ^说明：用一个text代替value
+ M; A& D( ^  C, X例子：
5 F4 M! Z7 t* qaddress1 equ 0x12345678
ldr r0,=address1
.pool
6 o5 i; F/ ~; f( O0 B
' j$ a6 L7 T- _1 q/ r5 ?函数说明：

.open函数：
& s# a. o0 ^9 f+ N1 f5 H3 _格式：
.open "ROM FileName",offset
5 @# p, z7 M. x, W- c0 M  C8 Z. D.open "Old FileName","New FileName",offset
1 H& N& w; p# Y6 V0 r- `( M. L0 D' }说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
.open "1234.gba",0x08000000

.close函数和.closefile函数：
格式：
.close
.closefile
1 w" U* _! ?1 b0 B  M; U说明：关闭文件。
- W$ ]6 g# ?9 Z2 h" M6 M
.org函数和.orga函数：
* [  [3 \) e& O格式：
.org RamAddress
% r) _6 s) Z! u, D) A.orga FileAddress
9 z' Z3 i) w# C# C: \% a1 t0 R说明：
) k8 r6 M  l' V, N8 }前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

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

.create函数和.createfile函数
& `+ A6 T) H$ B- ?格式：
: @% g$ J! _) p.create "FileName",offset
7 W0 H2 u/ }: X: c7 v+ [6 o2 J.createfile "FileName",offset
) a1 y  f7 ~) M" |. x0 Y8 s说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
" {/ d. i( D7 [  _! k/ W格式：
.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
! v( j" b8 {) A! @4 y
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
! k5 R4 S& L7 r% Y$ s2 d% k' Y) o" borg 0x100
.area 0x8
% K" y7 Y+ ]9 Sbyte 0x5,0x6,0x7,0x8
.endarea

, w; @9 }1 Y# \2 u.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。

1 s' E* l0 }" h7 A+ A.pool函数
格式：.pool
: ^; U3 [" d/ c6 u, _9 T说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
$ \0 h, ^! a. `6 K5 L1 ^....
.pool
( M, o/ ]4 z; a: h  v& C
.fill函数
1 B$ `7 v0 N0 Z# A3 H格式：
+ C) p, E+ c; _9 q  N+ x) r3 b.fill length[,value]
defs length[,value]
% N6 L  h6 a% m( ]+ K说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

4 s' q. M7 u5 T- G3 S" \% E.skip函数：
格式：.skip length
: P% L1 e. o# M- s4 ]说明：跳过指定长度单字节数值，length用16进制表示。
: n* @% a, {. L* n* y6 |; d2 C$ ~
写单字节：
' t- X. D; J- \.byte value[,...]
.db value[,...]
+ U3 O6 I3 D+ {. n  J.ascii value[,...]
.asciiz value[,...]
dcb value[,...]

写双字节：
5 o7 s" Z* |) E4 S. [- N/ c+ R.halfword value[,...]
/ O1 X. x/ r1 e6 o# Q. Y% ^.dh value[,...]
dcw value[,...]

! ~+ n1 V' L$ p& V写四字节：
.word value[,...]
.dw value[,...]
/ r( K/ u# e* f8 U& Idcd value[,...]
( I8 e: B# n2 y3 y
写doublewords：
.doubleword value[,...]
.dd value[,...]
dcq value[,...]

, c( _7 z8 W$ f* S& x) u0 g写浮点数：
2 W2 _* m7 V$ J. c7 k8 h" J8 G.float value[,...]
.double value[,...]
! `( Q/ e- J7 @
0 W) _; C8 n; o8 k6 `ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
3 o% U1 ~9 X0 x. \& J2 @8 `.thumb|thumb模式
; t, X$ E' @0 B  x* k
设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
: V, W( v  n3 `$ j" Y5 W, G# Y.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
9 c( j/ r2 w+ r: K6 N$ h# Y' X! G.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
3 l0 u5 g' b8 C$ a! P! E% ?.nds|Nintendo DS(ARM9,默认是ARM模式)
. \/ S7 c2 `+ c" z& f.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
( n# r3 o+ K( }3 |7 |.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。