ARMIPS assembler使用说明

疾风之狼

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

ARMIPS assembler作者是Kingcom,目前发展到0.9版本
! Q/ \/ r  k( Q+ C
: N" l/ g+ ~& X4 ]! xKingcom's website：http://aerie.wingdreams.net
$ k5 ~% i& o( Q; M# t6 ^) S4 E2 {
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

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

# g! i7 A- K; c  M: x7 r* ?ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

  B' O0 L0 o) @! S' Q1 eARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>

& z7 E/ G( k+ V' ?% `3 wOptional parameters:
% I, A) n" d# z# _ -temp <TEMP>         Output temporary assembly data to <TEMP> file
$ X5 V4 u7 W$ C  L$ u -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
7 y# g: Q, @7 c4 K5 M: R$ T' b -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
6 Z" z# f/ d* z9 q
File arguments:
& U  G6 Q. G8 Q2 o# o; \# f/ r <FILE>               Main assembly code file

# H0 s) t% Q" N$ ?4 i4 L-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

2 P; E/ x' d; y9 {<FILE>是汇编代码文件，可用记事本之类编辑
5 r( h) s0 n8 x( R  D
7 n. V$ {$ i" N- x  p$ d注释说明：
注释可在单行指令后面“;”和“//”添加
# i- g# l/ G: A“/* */”式也接受

例子：
# t; B; B4 k9 Q8 S1 ~.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
* c2 }( d# o8 `  |
.close;/*关闭文件*/

标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
) g' Q5 I  d  g& d- b% e
& P$ @' h! f8 i9 w数值说明：
“0xA”和“0Ah”是16进制数值
4 D6 ~1 G2 `. x9 T) J“0o12”和“12o”是8进制数值
5 t* M' Q5 r$ x0 P8 W- _! E( g- \: G“1010b”和“0b1010”是2进制数值
2 g) o9 F% l' g0 ^& z0 @3 A
equ说明：
$ ]  v/ Y, h: P格式：text equ value
说明：用一个text代替value
例子：
& b/ @; L% x5 U9 x2 X8 X% l' z" ~address1 equ 0x12345678
# l; i5 C8 m5 L2 f& c* }# C/ lldr r0,=address1
0 k5 ~2 J6 F1 Z) m" Z' S' ?.pool

7 ^6 o) l) r8 F5 E函数说明：
5 t( X2 d2 [, _) T+ t, x' _
1 T. c! P2 Z! S4 b1 U( v.open函数：
格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

; D5 |9 ]+ k% c& T  \例子：
* Z; S6 [3 {* Y0 y) l' I.open "1234.gba",0x08000000

.close函数和.closefile函数：
格式：
.close
, }, }  g+ `7 ]4 W.closefile
说明：关闭文件。
) l$ F" T4 E" d7 R
0 B! P# S, {8 d1 C, A# C5 j.org函数和.orga函数：
7 `2 n; p5 k) J) p格式：
5 ~! y4 p8 a+ v- N.org RamAddress
( u4 Q6 q. B5 T( q4 C; w1 i.orga FileAddress
, P+ O$ W, t& G. K' {2 E  G说明：
) {! Q+ O6 ?" {5 y5 p$ `( }前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。
: |3 X' W% Q! y7 E2 u! D2 F7 {
, D/ ~. |" G$ N) D.create函数和.createfile函数
4 E4 ]( F5 \* K4 u0 K: `格式：
.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
3 s# ?+ F; D" d
.area函数
格式：
3 s' Z/ N- X+ X0 d.area SizeEquation[,fill]
.endarea
# n5 l/ n; b1 g( I" n说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
! }' Y: F6 q" D; Q8 u, `
( e; U) S3 Y8 q. a9 T( h" L6 Y3 W例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
: J6 v: _8 T( a( P4 Porg 0x100
* P# h" Z" {, F* W( u! F  d.area 0x8
- m; J, S; A, P5 Ybyte 0x5,0x6,0x7,0x8
.endarea

.align函数
格式：.align num
, v3 H& i! U. \. ?说明：写零字节，num为零字节数量，用16进制表示。
* O8 r" |5 S2 ]! C5 N9 x5 b4 E& J
: \& i! \) l) b5 v7 ^+ E.pool函数
! \2 {8 k) n% r% G格式：.pool
# s' ~* B2 o# u6 O; M说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
& d& ]" J( e: J  v$ m- @7 hldr r0,=0x12345678;
....
.pool
8 Q6 y' L* Y" l2 Y: K( l5 C
.fill函数
, \* t; z: a4 G. H1 v' T4 L格式：
- b. e$ H% D3 I; Z.fill length[,value]
defs length[,value]
- ?$ g5 }/ a9 t说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
& p' Q, m  Q! T0 |8 m
4 \, x3 R- O( S: o0 W) m* i.skip函数：
+ z- i3 t6 q% b格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

4 X/ s# h& |6 m% B0 C# ]( m写单字节：
.byte value[,...]
.db value[,...]
, P3 a' c- f9 T/ [& P.ascii value[,...]
.asciiz value[,...]
dcb value[,...]

! k  C6 m3 y+ N3 H+ u  p& R写双字节：
! {: m$ P' G* J$ F) b9 ~.halfword value[,...]
3 I7 [9 [" x3 f/ a6 ^; c! g.dh value[,...]
dcw value[,...]
2 s( f4 {* P7 ~  h- J
' P4 F+ C- M- N写四字节：
.word value[,...]
2 T# C1 N. D0 ^( u" {) U$ z1 f.dw value[,...]
1 |8 \" u; d; o. ydcd value[,...]
8 E6 A. X* t( M6 Y$ d. N0 b$ a/ N( |
( g" a- u" m* o6 m) L8 b写doublewords：
$ i. o% |# Q/ e) |.doubleword value[,...]
0 N- W! K- G6 \$ c% ?$ _8 z0 T.dd value[,...]
dcq value[,...]

/ b2 c5 M7 B1 n6 n  Z" A; k写浮点数：
* W/ k( \. H! v/ _.float value[,...]
' i. I2 i4 d! W7 h.double value[,...]
/ P$ l6 Z# M1 N0 v$ a
ARM的ARM模式和THUMB模式定义：
! O" J, b! T  Y4 r+ C7 P.arm|ARM模式
.thumb|thumb模式

6 G% w: a: b. s, O# g2 W  ^2 h设置架构：
* P" o5 l* ^7 U$ l.psx|PlayStation 1(MIPS R3000)
! M. Y; }* I5 G" w- O.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
& F2 }0 r' e5 \! Z2 `% N' P0 g.n64|Nintendo 64(MIPS R4000)
9 a( k) V- s0 n6 k. l# o8 X5 w6 b.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
: E* m( t" s6 C( g4 h6 ]9 G.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
" M% s7 O9 f/ F; K2 X.arm.little|
. A# X  |+ p- B. a' j
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。