ARMIPS assembler使用说明

疾风之狼

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

ARMIPS assembler作者是Kingcom,目前发展到0.9版本
1 ?! P. Q; y  I0 |: [+ ?
* C3 Y! S: {0 n- }* L* vKingcom's website：http://aerie.wingdreams.net
6 p: g& O4 L& h0 i- @
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

更新版本可去http://buildbot.orphis.net/armips获得

ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
  {6 u& E5 c* ^8 S
4 S# O4 y+ ?/ ~4 w( e/ }4 Y7 J; TARMIPS命令行用法：
/ G$ J. G0 V2 q* t9 k1 v* ~! V5 z( w
3 H' l) P! d/ i4 h' \+ ?+ lUsage: armips [optional parameters] <FILE>

Optional 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
-root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
9 c4 ^  K& L7 q7 n -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors
; L0 ?' H* i0 m# {
File arguments:
<FILE>               Main assembly code file

3 Y2 E0 j- l4 K! y-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
; b6 a6 b( x1 C$ T$ F6 h" X% G. ~  B-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
# X+ F& c$ T4 H0 O  l9 Q-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
& ^' y  }3 `; M# [$ q5 A3 Q-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑
( r1 a; f3 J5 }3 _* x
; B: V4 `$ E+ P, _注释说明：
注释可在单行指令后面“;”和“//”添加
2 J- ?0 k2 w* {2 z4 |“/* */”式也接受

例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
" z; V  Y0 Q% g& a: s
- H( N3 X$ H5 b, k# Q.close;/*关闭文件*/

& D2 A5 z9 b+ o, W6 Y5 J8 X标签说明：
, ~! ?1 Y# ~% H标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

$ L; O( W1 i3 T* z数值说明：
) n$ C1 D& f# V2 }“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值

* y) {  D; e- tequ说明：
格式：text equ value
说明：用一个text代替value
例子：
7 k) O' y5 k9 Faddress1 equ 0x12345678
% m. N  U0 n5 G8 l6 `3 ^' j/ aldr r0,=address1
.pool
; }; h6 w& I1 W  G4 d
6 n2 y) n/ a, r' `5 s函数说明：

) V9 A+ c! w0 @' z  ~$ G. p; v.open函数：
格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
/ l/ Q) s. D: M& \# ]2 e说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
  e& y  W/ p5 n; M, l
( E. a% j! S, z4 O7 Y7 m) ~例子：
.open "1234.gba",0x08000000
, K; k5 U5 O& x& h
2 z9 @6 f: N* t8 G8 Y.close函数和.closefile函数：
1 x) t3 F) |( M+ q9 f格式：
.close
.closefile
说明：关闭文件。

.org函数和.orga函数：
, ^* a8 W- N5 K+ @" A. Z8 s+ g5 m格式：
.org RamAddress
7 G+ }5 }# D/ t& ^.orga FileAddress
说明：
2 N) S+ @5 \- i3 {$ i前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

9 E! y# Y. G1 x  q4 u1 w.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
" Q  H. Q3 e; l$ z+ B$ t- J# f4 L% [格式：
7 v0 e( D! ~; x* B- {! V3 D6 w.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
  u# g8 Y% O  F' v
.area函数
格式：
.area SizeEquation[,fill]
$ u  w# z' G5 d  Z* i.endarea
6 Z$ v( a- I" y; _! t; p4 A说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
4 d. H0 j5 Y7 y5 ?) i) O- b! h& j
* m8 W) Y- A$ ~3 i例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
- ?* J8 U4 a' S0 [8 b7 ^org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea

.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。

- x- R8 z- _. b; Q: @6 n.pool函数
+ n' I  k$ e2 U9 ?格式：.pool
* r* e2 J& B/ E' T+ X  o说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
( a; U/ A$ n! Y% @! i0 N- O# r4 R例子：
" ?6 R  g7 E- H: h6 a% q5 R. Tldr r0,=0x12345678;
....
4 b, {2 Q: G3 W.pool

9 O% \3 U6 |5 a1 K9 o, b.fill函数
格式：
.fill length[,value]
defs length[,value]
' [5 D) N& ]; |% @9 a说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

4 H  J- Z$ i- e5 E# h6 D  i" ~.skip函数：
格式：.skip length
& M& Q* }9 _1 B& _. w说明：跳过指定长度单字节数值，length用16进制表示。
  {" k! P0 Z, d$ ~2 }9 C
写单字节：
.byte value[,...]
7 k, z* L# _" ?9 U& _# H1 A.db value[,...]
# X+ m) n8 c& e' j, W0 c.ascii value[,...]
: i* B% C9 }! r  V; Q  t: d& J.asciiz value[,...]
dcb value[,...]

写双字节：
.halfword value[,...]
.dh value[,...]
dcw value[,...]

写四字节：
9 F/ u. e# @/ p7 q, }5 @( v6 J.word value[,...]
: z6 P5 c- Q& n, A, I$ J% o.dw value[,...]
dcd value[,...]
& v+ [$ P  u7 e' g/ F+ p+ P
写doublewords：
.doubleword value[,...]
5 q# X8 X* o  X" B.dd value[,...]
dcq value[,...]
! y, s* c, \* B/ T
- d! f8 p, z) ]- D写浮点数：
.float value[,...]
4 ?, A# C$ y1 K% ~+ ?.double value[,...]

2 `$ i# |  N" a: k6 _4 ~ARM的ARM模式和THUMB模式定义：
' k6 Y) A' z  k$ D; g- |7 C.arm|ARM模式
9 H# M: ~# o9 |2 n$ i, V; S.thumb|thumb模式

设置架构：
.psx|PlayStation 1(MIPS R3000)
/ Z+ B- z2 h, o( {7 B9 c+ g; t2 p: p.ps2|PlayStation 2(EmotionEngine)
# A3 t$ D$ \- a& Z9 ?# w.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
* Z1 W6 L& N0 P! o& s/ k.gba|GameBoy Advance(ARM7,默认是thumb模式)
  w: \' Y% O- N; e+ U! E7 M.nds|Nintendo DS(ARM9,默认是ARM模式)
( h* j: X8 W: Z. f1 E8 E9 k.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
.arm.little|
5 r9 s$ u( \. P( K8 I
* d3 d+ z& O- w1 \! p常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
. Y0 W9 A0 e+ V& C