ARMIPS assembler使用说明

疾风之狼

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

" w, K0 \; C# y8 \0 QARMIPS assembler作者是Kingcom,目前发展到0.9版本

/ Z. ~: D1 J2 z4 ?Kingcom's website：http://aerie.wingdreams.net
8 y$ G( t) g  ]% H8 S! D
4 A8 e$ u# h8 w( R# SARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

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

ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
9 b8 j  X" Z+ [" m
ARMIPS命令行用法：
1 p7 [6 T1 M9 n$ a+ b- ?
Usage: armips [optional parameters] <FILE>

6 C; d$ Z+ }) B6 d9 q& VOptional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
8 d4 s* c/ X! R9 B7 h1 m -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
4 |- Z+ ?* m* A/ ?! Z/ W9 c -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
& t" }6 c! V( w -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors

9 ^/ t4 y6 C) S* J  d* ~, iFile arguments:
3 s6 T6 k# n* e) X0 h <FILE>               Main assembly code file
. a$ I7 b6 S! u+ Y5 L" U
% \1 q' ]' {0 A# |! Z5 F+ y+ x-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
, L: _- A- {6 V# B6 M" b6 o-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
/ z' _) A# ^  C8 e" b% }
<FILE>是汇编代码文件，可用记事本之类编辑

3 R  S4 v- i: l6 R注释说明：
注释可在单行指令后面“;”和“//”添加
! Z; |: B5 F, _6 a9 T8 W“/* */”式也接受

例子：
; v# p+ t6 E+ T* J5 g.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
! l; j0 ?/ i7 {# l* X9 X% @
# e2 ~2 _  ^9 b1 k+ w4 O; V.close;/*关闭文件*/
, M6 K* O' S) D+ S  G& q; Y% D
9 c) Q2 r+ R$ S. E; w0 i* S% X/ y标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
“0xA”和“0Ah”是16进制数值
1 e+ L& w! D( A1 [“0o12”和“12o”是8进制数值
% n# ^2 ?+ w3 N: n1 K# z5 v“1010b”和“0b1010”是2进制数值

equ说明：
* |9 V. X# _# h4 G1 }# c格式：text equ value
说明：用一个text代替value
例子：
address1 equ 0x12345678
ldr r0,=address1
.pool
2 X! q' C# K2 \1 ^+ F9 X
1 r7 u2 {  Z' s函数说明：

' t' ~) m9 p5 `9 _& I# r  T.open函数：
格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
6 q6 _* c1 [! o说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
- H- J1 R4 {. ^9 `* Z$ u; v
例子：
.open "1234.gba",0x08000000
; m8 a6 a4 K/ @6 t
* K8 O  b) f4 S, N.close函数和.closefile函数：
' L* `4 I  D* J: `# f+ Z格式：
6 H0 u% B7 D) P+ ]+ g. v  s.close
.closefile
说明：关闭文件。
( P. D& Y# F* u1 p
! K* S* g0 b9 y. ]! G6 T# m.org函数和.orga函数：
* M: [( j, E( O: [0 E" f格式：
6 S2 Y& s+ T4 J# Y) H: q6 P& |.org RamAddress
5 y: c5 s- r/ c* }8 s3 g) P- h.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。
5 r5 f" Q  Q, v
.create函数和.createfile函数
: E' I/ d8 L& S7 y" M3 E1 E# g格式：
6 C0 X: u% P) u" q6 U.create "FileName",offset
.createfile "FileName",offset
* Y- U; ?' x$ q4 X说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
1 |+ k* v9 f1 E: M& K( t格式：
.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
- V  K5 H0 O1 f2 H+ |
.align函数
; J: N8 Q/ `  c: _7 b格式：.align num
8 D/ X+ W& o2 b+ r) p说明：写零字节，num为零字节数量，用16进制表示。

; s; k6 ~3 @2 k6 g; K; |7 D.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
6 `6 \) L$ s$ V* ?% n* t2 Z; p0 N例子：
ldr r0,=0x12345678;
....
" n' H5 k; Y) L+ y& g8 |' |.pool

.fill函数
格式：
.fill length[,value]
defs length[,value]
1 p9 |6 S2 C! d5 I, b说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
.byte value[,...]
- e- T! @/ L( M- ^% @: x! X.db value[,...]
.ascii value[,...]
.asciiz value[,...]
dcb value[,...]

" h2 P3 m. f5 M写双字节：
.halfword value[,...]
4 w4 q* z( g* e3 ^.dh value[,...]
dcw value[,...]
6 \8 G: S. ]* `. Y. A
写四字节：
.word value[,...]
) L: C( o1 q" b+ v+ n7 `$ J) J4 [.dw value[,...]
0 k& c# F( e) c4 j0 xdcd value[,...]

9 y; D, w6 l) p: ~1 w4 b. A写doublewords：
.doubleword value[,...]
' @; R# l' ]7 o.dd value[,...]
/ j3 {8 g. E1 X5 I/ X7 bdcq value[,...]

4 f" ?# A7 g$ a  r3 u) Q' R7 E写浮点数：
) V/ K9 @& y$ Q0 I.float value[,...]
.double value[,...]

ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
6 U3 _. q) n8 a.thumb|thumb模式

设置架构：
/ Z: ]$ V' z9 I.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
2 z7 X0 w: F" q% o+ B# @.psp|PlayStation Portable(Allegrex)
6 {, |; `! Z- k1 j- q+ W. \5 J.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|
.arm.little|
9 [2 u$ \+ ]7 I
* I. i% O8 p  a% M' U常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
4 ~8 Z2 e, W( Y) j