ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
- }5 W! b; f. w% N
ARMIPS assembler作者是Kingcom,目前发展到0.9版本
. g* q0 S3 V9 o8 x0 D; n3 }0 f/ q
Kingcom's website：http://aerie.wingdreams.net
& T, K6 x" @2 C& r- M
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

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

6 S$ b) m8 v1 c( R, J" C4 L3 {ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
6 i& s' e5 Y) M# E* H. j
ARMIPS命令行用法：
5 v) U0 w% A( A3 I
( @4 I9 u( H& D: i$ L6 aUsage: armips [optional parameters] <FILE>

Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
# B: f  I( c. g* E -sym  <SYM>          Output symbol data in the sym format to <SYM> file
-sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
9 E) }( I6 i8 B" V& t -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
8 z! }& @- z3 i( y' Q% S -erroronwarning      Treat all warnings like errors
# `( L) ~; _7 H  c8 h) I8 p
File arguments:
<FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
/ K; c8 ]) }8 S; t-root <ROOT>参数是指定执行期间要使用的工作目录
3 o6 G' s* [, j. G1 \-equ <NAME> <VAL>参数用法不明
' [4 y. A% A3 u-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑
  y$ s! W8 n) N6 h- S! N6 v
* q$ ]$ O) |4 Z1 m注释说明：
注释可在单行指令后面“;”和“//”添加
+ ?: v7 N6 |' T- b3 z: p“/* */”式也接受

例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

" T2 T  x( {0 X- Q: G! ^* ?& t.close;/*关闭文件*/

' Z% A, d  y7 ^0 E  F标签说明：
' v1 H9 A3 f  J4 d标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
( X+ K! |6 q* \! B8 t4 D
* g9 I) T( ]0 P( l数值说明：
# A( U) ?! J+ Q6 g“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值

& n5 j# r- }  Y3 N# J- o' ^6 m6 _9 Gequ说明：
& ?9 c/ V* `3 `- d; c$ ]% h格式：text equ value
7 d, t! V4 F7 q% Y说明：用一个text代替value
% e) f8 c* Y  R' @  L/ h; F例子：
# @' |2 t5 T# Raddress1 equ 0x12345678
ldr r0,=address1
  w( A0 m" Q; X% U; n; C6 b/ A% [.pool

函数说明：
0 r2 S1 q5 M5 X4 T) u# d& x! G
.open函数：
5 p1 s  z3 f' b6 G9 b格式：
.open "ROM FileName",offset
, [5 v' Q- i- {2 S: C.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

! J+ A9 L9 w% Y! U; g3 Q例子：
2 }, ]6 h$ _- b. E' u.open "1234.gba",0x08000000
+ V7 n6 M7 A6 {9 T6 P! P
* w- M/ N. r1 U.close函数和.closefile函数：
' `" B" x- X: I# _$ m  N格式：
.close
- `+ u$ Z/ ?2 h.closefile
! ^/ p  y* z  k" |! x5 d& t7 U说明：关闭文件。
" K; q! x. n& ?' [4 ?% K. x
4 z2 L+ x; ^6 I7 q) o" Q.org函数和.orga函数：
格式：
( l7 t% _* e+ t5 z! W& ].org RamAddress
.orga FileAddress
  i. B/ R- m5 x; _$ w说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
. `8 W- K6 ~9 S' |1 J7 r) p  b1 ~2 V  \. g
2 H0 p! _2 w2 w( {) j! ?4 Y.orga函数可指定ROM文件的输出地址。

  D1 j% K' K9 A4 L9 J9 g7 }.create函数和.createfile函数
格式：
$ u1 q+ z, P4 X0 P; o1 ~1 n+ J.create "FileName",offset
' ^2 k9 |8 E8 _; B- i.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
! a1 i! e$ ^8 h7 @$ N7 I: j4 Y
.area函数
格式：
.area SizeEquation[,fill]
.endarea
( s1 Z5 o# [6 w& m说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

) y* c4 P; L- {0 a4 G) S例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
1 u5 ^6 B; H! i$ z$ E( R( Gorg 0x100
.area 0x8
7 r# V" w1 p) l- q2 j  J7 Gbyte 0x5,0x6,0x7,0x8
.endarea
7 l/ ~7 v8 c3 ?, a6 S* W
.align函数
格式：.align num
: j; m! v# }8 t' J# a( t9 r说明：写零字节，num为零字节数量，用16进制表示。
7 I$ g4 p& D1 p+ _( N3 J3 ^
.pool函数
格式：.pool
* o% ]. q6 X( |2 N说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
" E4 `* Y1 Z% v# I例子：
9 h' ^% H* w1 k, L" i  Mldr r0,=0x12345678;
) g" Y, v1 i8 q+ z5 P....
.pool
" @  D$ a* `" j1 Q. C# S; l$ X
! Y; t# u( W( {2 b. a.fill函数
  z; P! l, d$ E; m$ M' t格式：
# e  C. K& c% s" C+ E; x8 ~9 d& I) S.fill length[,value]
defs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
7 T. `8 k/ h& b8 o
- w6 ?5 A! k2 @, ]9 `( j, w.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
. W' N7 D% T- a1 g6 L" b: S.byte value[,...]
  x1 j9 \; S1 V' E8 G; S.db value[,...]
.ascii value[,...]
) m7 w6 l% c. o.asciiz value[,...]
dcb value[,...]

: V8 o( F' [. |+ y# q9 v( U写双字节：
.halfword value[,...]
.dh value[,...]
0 j9 N0 r+ q" U7 O- P# P. \2 zdcw value[,...]

写四字节：
) L5 Q  S* L- X.word value[,...]
0 p1 S6 ?1 A/ o.dw value[,...]
dcd value[,...]

$ U9 U1 b/ Q2 Q2 w* E写doublewords：
! U5 n5 H+ k5 H& A  p.doubleword value[,...]
.dd value[,...]
dcq value[,...]
' E! W& w8 r7 y: M  t( ?- E- \
写浮点数：
.float value[,...]
.double value[,...]

7 V) G) @+ M0 R9 F7 P# L) zARM的ARM模式和THUMB模式定义：
' p8 L! y8 C  G8 c" u9 |.arm|ARM模式
. F, j/ F; n7 i: s% V# l/ x" x.thumb|thumb模式
, r; ]* {5 b% g9 x/ D$ ]$ A& b( m: |
1 ?2 [7 s, u4 |5 ?7 q' T% i设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
6 m2 M; U0 |8 g' ]0 Y.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
: e7 [4 o* ~' P1 y.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
; g" B1 a( j6 o.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
0 s9 l: l' ?' m.arm.big|
: k1 P, A0 o- ^; x* t8 s.arm.little|
2 H2 y$ K4 g/ i
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。