ARMIPS assembler使用说明

疾风之狼

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

6 Z: j) k- i- h6 ^ARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net
( t/ L9 t5 t4 P/ l
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
4 E7 N6 ^6 _4 D) n4 J$ ^
更新版本可去http://buildbot.orphis.net/armips获得

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

: u6 C/ D" _0 I) W* V8 ~) {. a1 oARMIPS命令行用法：
$ A* T$ T4 `) `4 s+ n
  ?5 S& @+ [9 I; x" ], g8 @Usage: armips [optional parameters] <FILE>

Optional parameters:
3 V0 |: d" z& v! s8 D. P! I! T -temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
' \4 H0 X9 i0 u2 |8 H$ Y -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
9 k" I6 |5 u3 p8 W  t -root <ROOT>         Use <ROOT> as working directory during execution
7 `: @+ l! c  ~ -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
8 n+ G1 B8 c0 q; C8 A
File arguments:
<FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
- e$ l8 a9 v2 h9 c; C-root <ROOT>参数是指定执行期间要使用的工作目录
# O  t' N/ B+ a0 U" v( k" R* d-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

( t, L, [( B* l3 S9 H<FILE>是汇编代码文件，可用记事本之类编辑

注释说明：
注释可在单行指令后面“;”和“//”添加
6 N6 w8 t* }4 {2 @# v3 x# J6 R“/* */”式也接受
1 d& I: W8 d; [$ d$ b
例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
# V- a; k$ `2 W8 T4 q0 q
.close;/*关闭文件*/

标签说明：
( S  G* y3 A8 |( Z8 P标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
: k- ^# b) w* Z* R2 j
数值说明：
“0xA”和“0Ah”是16进制数值
) w$ u/ \2 E7 o“0o12”和“12o”是8进制数值
8 ^0 R. B4 h2 s; C) f' V“1010b”和“0b1010”是2进制数值
0 E) x0 }7 `! B& K6 X, O
1 x/ g" `, C, Uequ说明：
格式：text equ value
说明：用一个text代替value
" [0 i% W9 f! Y( M8 V例子：
address1 equ 0x12345678
1 B! N( L3 L1 \. M6 ?0 p0 xldr r0,=address1
.pool
4 \+ k2 C! W' C7 q
2 q% }3 \6 h' _函数说明：

.open函数：
$ g1 |6 |/ c7 `! t/ o( t% e1 J格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
+ A) `" d8 ~4 J! O+ Z4 \说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
5 F# G/ J5 K0 `4 G) q.open "1234.gba",0x08000000
: F' b6 e/ m- ~8 [
.close函数和.closefile函数：
0 N" K$ ^" `* H, f7 S  L格式：
.close
.closefile
说明：关闭文件。
6 D$ o' J, t. e. U* r: O' u
.org函数和.orga函数：
0 P, T9 g+ i6 e- g" |格式：
.org RamAddress
* I% r9 s+ S8 c% [.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
- x  S$ Q0 G* n
.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
0 }, j9 {( Y5 m, J说明：创建一个文件，如果文件是存在，他会覆盖掉。
' B4 i# t7 ^9 L- M
7 o" D. V/ W: z$ _1 J.area函数
格式：
.area SizeEquation[,fill]
' e$ P: {  c; K  R% s0 ~.endarea
1 _- s2 ]+ i7 f说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

/ f% }. K, `  I. [, M例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
0 D6 B* y' [! V1 P5 H9 z.endarea
6 N: u$ ]2 z# i* n3 P  Q# v* |2 ~
; X  N+ `$ |! h3 x: |5 f.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。

.pool函数
) R( x# i0 \7 ^' p0 k" x. v格式：.pool
# \7 A; X2 U& g+ A* V0 F说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
& P) k9 s& W+ S5 x' p例子：
, x5 W( e9 \; _ldr r0,=0x12345678;
....
.pool
4 x% \- d, g. @& c
2 D, N' ?1 M/ C1 `- G1 L5 Z( J.fill函数
格式：
.fill length[,value]
. B5 W; X! R& \: d6 z- N. z/ K, edefs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
格式：.skip length
6 p& `" ^4 C, U  \3 m/ @说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
1 M. k  s1 t4 h) c: c.byte value[,...]
.db value[,...]
! n; t1 t1 [( ^( b8 a2 E4 U.ascii value[,...]
.asciiz value[,...]
7 U$ l' t' P  c/ q2 _9 idcb value[,...]

写双字节：
# A9 O7 T6 Q+ l7 v' L" ?) s.halfword value[,...]
1 J/ h' t( _" f- y, x" y.dh value[,...]
dcw value[,...]

写四字节：
9 L& `& ^0 Z7 Q) }4 `* p.word value[,...]
  b9 r6 A; o% t! u( `% Q$ e.dw value[,...]
dcd value[,...]

写doublewords：
.doubleword value[,...]
$ `( \; u% e9 P.dd value[,...]
dcq value[,...]

写浮点数：
.float value[,...]
.double value[,...]
6 N: x0 U. G: j: k2 A6 r. @
; @& B: p3 N% e; J: n* k7 wARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式
2 A+ a$ m" k( u( R: l
/ y* B, L9 C' F9 W7 s8 X设置架构：
.psx|PlayStation 1(MIPS R3000)
7 Z1 L( A# y% w, |8 `8 ?.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
. z7 c! q1 ]$ {4 @' _! ^) |.rsp|Nintendo 64(RSP)
2 f# E0 E9 P5 q5 F0 L/ A.gba|GameBoy Advance(ARM7,默认是thumb模式)
5 t/ S% R; J. E$ M7 K  G.nds|Nintendo DS(ARM9,默认是ARM模式)
3 G! e0 ~: i4 u& Y) n. @$ }.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
.arm.little|

# S4 U7 u+ i) \7 g0 g常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
/ t) M2 _; ]0 P- ^