ARMIPS assembler使用说明

疾风之狼

; A; N7 z! i/ x' K9 L! ]; ]0 ?& d' RARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
' E' m% J- n' B; ~+ c
ARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net

' ]) z, O2 P3 [& T) p. LARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

更新版本可去http://buildbot.orphis.net/armips获得
2 E* u6 D8 o5 J/ D1 l. Q4 ~
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
, p- a( `* L. U8 W! W. W# M4 S
ARMIPS命令行用法：

7 P" |& u* c3 R( G8 a1 QUsage: armips [optional parameters] <FILE>
. `4 h' v2 a/ M( f
1 G- \) A& y- T+ I! ~3 v$ s, A/ ~Optional parameters:
2 U# j6 L- C8 i" Q9 w' m- x* K -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
. D" b/ i, u$ B9 ~% b  a: g2 Q5 p! N -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
. Y( W2 l/ x+ H1 P -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
0 J3 E6 t- E" Z; d/ Y -erroronwarning      Treat all warnings like errors

! ?: @3 O4 w# tFile arguments:
<FILE>               Main assembly code file

, l# m8 F5 e& t4 N( k/ v-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
) d4 K4 a: w( {3 y/ I-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
( `: K6 n1 B- G2 k5 q-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
8 v0 T3 C# d$ f, Q. x, f! y9 T6 e; }4 P-equ <NAME> <VAL>参数用法不明
# W, @* @" M: A-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

* h$ i! W, ^& h- P5 G) a<FILE>是汇编代码文件，可用记事本之类编辑

" d5 c& T# f5 }' p$ T' f  Y) A注释说明：
! J# u( s9 t6 a& T7 p( W. C注释可在单行指令后面“;”和“//”添加
* `# ]2 x5 G) h8 y' z3 T$ q0 r“/* */”式也接受
1 g3 V& V  r- c! T# g
. B4 a& ^8 z% ]9 y2 r例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

.close;/*关闭文件*/
* [* O. @. v7 F+ w* T" ?- P
标签说明：
. |  l' \& X5 Y8 Y标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
$ _9 z5 U8 n& T- M0 r: J
3 C, _0 q% h9 ?$ r( Y% @/ `( d数值说明：
“0xA”和“0Ah”是16进制数值
1 d& i/ C$ j( y# d" x“0o12”和“12o”是8进制数值
( @! U( c/ D$ ~) ^" ?( V9 x“1010b”和“0b1010”是2进制数值
* i8 ~/ H0 V9 q* I/ Y# n$ g9 G" s
equ说明：
( U7 i1 K/ }" b2 ?* t$ F格式：text equ value
说明：用一个text代替value
例子：
5 K4 ?9 O! j! ^( _" \5 t/ ^address1 equ 0x12345678
( ]' {6 `8 k# fldr r0,=address1
.pool

* y3 Y  a. r0 |) {4 U' N函数说明：

; U6 [+ b3 i# X" d+ ?9 c.open函数：
格式：
9 F; d. V5 s- f8 {. X& Z$ h.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
, H5 O4 @% D" n0 L- L说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
6 U# m2 C& Q0 q8 {( J+ \' P; V8 e1 \4 e.open "1234.gba",0x08000000

.close函数和.closefile函数：
格式：
.close
5 ^- p& P# i9 `0 I$ ^9 `9 M.closefile
% w* `- l* N% O5 `, }说明：关闭文件。

.org函数和.orga函数：
格式：
.org RamAddress
.orga FileAddress
说明：
# D3 Y8 W8 ]: u" ?, t& e前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

  a: O: X+ q1 r0 E1 s4 l6 L, g# ?.orga函数可指定ROM文件的输出地址。
) |+ J' H4 X2 u! b
  k$ x7 X8 d& Y& x+ t2 ~.create函数和.createfile函数
5 M* i! S: a  g* B0 V& L格式：
, C  m# ?# r) q7 T* [: U( k6 t9 ^.create "FileName",offset
1 u1 u9 D3 N% w- p1 ~2 s.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
( I  l6 a4 w' X0 I9 c- c
.area函数
格式：
.area SizeEquation[,fill]
.endarea
3 l" y+ D3 H" N+ f/ {, t说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

  t5 q% |5 M7 _0 A" ~7 C+ |例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
" h* [) ]! c& b) \0 o7 X4 u# Iorg 0x100
1 D% ?" P* H$ B8 F( S* R.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
( K& U5 F' P/ u
.align函数
* G3 |+ Q; B5 t# G格式：.align num
/ \4 M" F2 y4 ?+ U( o3 z; Q  A说明：写零字节，num为零字节数量，用16进制表示。
2 Y* C3 W- k3 g6 V$ D& S8 Y4 k
.pool函数
" X3 R  R% e) r格式：.pool
. y1 A* q, h0 K+ n9 {% }4 S  W, }说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
7 T$ r: f: Z8 o5 h; g例子：
) u- q; `8 |8 R' Zldr r0,=0x12345678;
! j' {* ]/ D1 X9 S4 m4 f  {....
3 `- n3 O) A7 w  P.pool

.fill函数
+ I2 z0 ]+ d: z& k9 S5 `: M) {$ r' _格式：
.fill length[,value]
defs length[,value]
( R& [$ M+ @3 [' E6 ^. Z说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
* ~4 R( P9 U+ H4 @+ Z# X+ M
.skip函数：
0 S+ N4 y4 m) Y2 @  a% Q5 E格式：.skip length
% y; T0 j( v4 X5 Y; _8 A( T& v5 G说明：跳过指定长度单字节数值，length用16进制表示。
* a1 y$ C* f+ _  N1 o) {4 e
写单字节：
5 o, N5 S3 z6 B) i- n  u1 N* O.byte value[,...]
.db value[,...]
& q* q( e9 ~; z( j+ D9 w+ m& T.ascii value[,...]
2 z9 C/ `1 z, b3 g+ t.asciiz value[,...]
dcb value[,...]

写双字节：
, N2 A& Z0 d5 R! q.halfword value[,...]
.dh value[,...]
dcw value[,...]
5 u" h. v  g' T( ~0 M
4 J$ l8 S4 o" n# r, z3 l3 b" B写四字节：
.word value[,...]
8 L7 a: K4 o  O- i' v.dw value[,...]
dcd value[,...]
/ r) Z+ Z6 P. r- n* L
写doublewords：
.doubleword value[,...]
' m) e3 a' ]" N) x.dd value[,...]
) t# O4 _/ a9 G- P, _* tdcq value[,...]
& ?# c# K& X4 h6 G8 n4 @* c+ b
写浮点数：
.float value[,...]
' B  z: o$ N; ?) M.double value[,...]

, p) m& d# W/ V+ q. ?* ~. RARM的ARM模式和THUMB模式定义：
& B, c; [5 ]& X.arm|ARM模式
.thumb|thumb模式

设置架构：
.psx|PlayStation 1(MIPS R3000)
  W( |/ r; {/ M.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
* ~( S4 h; ]. y( P* ?.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
9 R& B! q3 G# s.arm.little|
6 l5 ?+ N: [  A
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。