ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
; ?: i6 s7 a; z
ARMIPS assembler作者是Kingcom,目前发展到0.9版本
. [, s1 d! a7 ^
/ T3 ^# g8 D4 W/ m+ M+ P# bKingcom's website：http://aerie.wingdreams.net

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

1 V. {  w# N  C+ X) N1 p更新版本可去http://buildbot.orphis.net/armips获得

2 b) f, z  F; r# u1 TARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
: O  U  X+ P% e5 C% J& C
3 e) ]+ z/ i0 D; D0 uARMIPS命令行用法：
  X0 B+ E( K8 D/ G6 K4 W# \- k8 \
5 q2 l( z4 f9 a; {7 S8 [Usage: armips [optional parameters] <FILE>
. x3 X7 I" k1 j( m7 G
Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
" s5 p7 \/ s% [2 i. ~! L& C -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
+ Q8 n0 l9 R+ Y% E -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
8 s: Z8 v1 J9 P9 C8 K6 G -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors

9 W  V7 u, `2 u! NFile arguments:
1 p) p8 ~/ g- Z# ^6 u1 `6 X3 p2 u <FILE>               Main assembly code file
* f  ^' q6 a) H$ ~" v* o8 i9 l& F* |
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
/ S3 Y( G/ J  E& n, D7 j-equ <NAME> <VAL>参数用法不明
1 A4 z/ O+ i7 ?( p+ s-strequ <NAME> <VAL>参数用法不明
8 D4 S- f7 X  {1 x: T5 R+ }-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑
# G4 n* l, h: u
4 |  I( r( a! c$ |- d5 V7 f注释说明：
* ]: H2 f# |  D/ {4 y  l* r; K7 x注释可在单行指令后面“;”和“//”添加
“/* */”式也接受

例子：
, u$ |  o8 b$ S) n% _.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

6 ~& S/ A+ L( X' s& B- D% t* D4 ~.close;/*关闭文件*/
" k4 Q4 B9 v; t( N5 Y
+ M) m3 X+ ]% V, q; I2 [标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
. y2 x0 M' w. _9 z8 ?& o) d
数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
# O* b; x  V# v' J“1010b”和“0b1010”是2进制数值

8 x, z1 K3 r. v; ?. fequ说明：
格式：text equ value
说明：用一个text代替value
例子：
9 P3 H* \, v7 y: H) @5 U' Paddress1 equ 0x12345678
* O6 I0 R1 y3 }7 a8 bldr r0,=address1
$ i; s4 Q6 J6 B# j! i/ x9 h.pool

函数说明：
, M1 ^7 T4 z" K$ D2 D9 e8 H1 {
8 [5 w& R- t. M1 H- i, v% h.open函数：
* N. |% ]% U9 M4 W格式：
- I0 C0 a- k- D7 i.open "ROM FileName",offset
# J8 @7 Y+ ?' f1 E" c# E.open "Old FileName","New FileName",offset
  r( Q& P  q7 K. ?; N5 q0 N说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
8 C7 H0 ^0 o8 Z9 R
例子：
.open "1234.gba",0x08000000

9 @7 s2 K* T4 C% w+ y.close函数和.closefile函数：
格式：
.close
) x8 Y7 S& K8 D; N0 @8 _! N.closefile
说明：关闭文件。

3 @. L: b, j! d" p.org函数和.orga函数：
* L8 {0 J( U0 a格式：
  X+ H1 Z. e; I.org RamAddress
.orga FileAddress
说明：
' o6 r) S# l  e0 D2 b) B前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
' v- ^4 s) M; i4 e: E& x$ r
.orga函数可指定ROM文件的输出地址。
' `/ F" v+ [" g4 M: \0 @- [% f: {
  r; l( n! x7 [' H5 ^9 V( t.create函数和.createfile函数
格式：
1 \( ], x* _6 G$ I. e" S. @4 N5 D) F.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
# [: R/ N" |, u( G: P. d$ J4 V
( o: h8 b. ~- F2 u7 x+ n1 R# @.area函数
$ ~' {# E" x9 [* }' l( J( h格式：
.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
. @, d  _% J# c( S5 l
& q$ w6 L6 z$ h' y7 Y例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
# S6 Q3 P3 e& `5 J+ forg 0x100
9 o  t7 T6 [0 W* p8 {.area 0x8
5 L' l5 f2 [; j2 K( {% fbyte 0x5,0x6,0x7,0x8
# F4 @- L' l1 Y3 @+ f* g/ [.endarea

.align函数
7 j* u/ O9 K" t; X+ U0 _' L格式：.align num
# D6 v, n3 ^: d8 ^说明：写零字节，num为零字节数量，用16进制表示。
8 z  H  ~( \( `3 |! p3 n
.pool函数
格式：.pool
( G, ?, }2 K1 Q/ h8 Y* n, E9 h说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
2 h5 ~% ~+ w0 J" f& b$ C例子：
ldr r0,=0x12345678;
....
, O( N) U1 ^- h/ J.pool

.fill函数
( E# J' ~+ M1 p7 K7 I/ W4 D8 @格式：
.fill length[,value]
defs length[,value]
- M$ o" I' g& b1 @说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
6 D  _4 j$ j- E% G9 A8 `7 m+ o& Y5 L格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
6 V2 {8 D  W1 I" F& X3 s' S, v
写单字节：
2 ?) W0 ^) g' E4 Q.byte value[,...]
.db value[,...]
. D: F. p( y1 Y% z+ j$ }  j6 n.ascii value[,...]
.asciiz value[,...]
dcb value[,...]

写双字节：
5 h+ A8 h9 T: l0 o- f/ @.halfword value[,...]
( O1 U% _: b1 T3 O.dh value[,...]
) P) ]) v8 W! ^3 T& w5 H) ~dcw value[,...]
- O) I( O; l5 H5 r( H; D) f( L9 Y/ V
写四字节：
.word value[,...]
.dw value[,...]
dcd value[,...]

写doublewords：
9 T$ @6 w& ?, G! |2 Z4 r.doubleword value[,...]
8 k3 B- j( T! v: U4 i+ e.dd value[,...]
dcq value[,...]
5 h  z% A& V2 x4 q* r) W
写浮点数：
.float value[,...]
.double value[,...]
6 N7 u$ o4 a, c8 g
ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式

, X# c0 k9 P* \% z: F设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
4 m) `' L  S0 t+ Q* Y.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
2 |/ B, b5 M5 \1 G.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
2 C3 p8 |- |% K5 j* s9 F.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
- l: r! i& i3 X0 E& J.arm.big|
, @% N! `9 b+ `" E.arm.little|
& _' @+ p* f) [8 V
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。