ARMIPS assembler使用说明

疾风之狼

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

, M3 u! F$ n+ E5 t' @# c* AARMIPS assembler作者是Kingcom,目前发展到0.9版本

* \6 D3 A' J* o+ j& G3 M1 l" DKingcom's website：http://aerie.wingdreams.net

ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
6 {: i2 d* v8 j/ H" I
! G  F2 w# r) c9 D+ @4 q更新版本可去http://buildbot.orphis.net/armips获得

ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

1 ], M) O  w0 X. `% \/ M3 E8 XARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>

3 ]$ X: s, ]  k) u) x# H! bOptional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
-sym  <SYM>          Output symbol data in the sym format to <SYM> file
- U/ ~7 Y6 M+ c+ f  r! E8 D; {2 k/ h -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
  L5 v4 H, f& ]0 L7 a -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
: B8 \0 D6 B. [/ |2 \ -erroronwarning      Treat all warnings like errors
  K, e* \! V- E6 w' U
File arguments:
<FILE>               Main assembly code file
5 ^( _, w* s  [+ t  G3 T  d5 K
/ y1 u2 x: Z1 A) c-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
& @  `! v4 V; F3 x* F( ~; C4 E-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑

. v, A6 M# {7 A* f2 K注释说明：
注释可在单行指令后面“;”和“//”添加
# g; F( l( [' l  a5 s7 D$ b“/* */”式也接受

# d' [/ D( P0 }& F8 G例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

, J; m0 g- Q/ w6 V.close;/*关闭文件*/

标签说明：
3 ?7 \- f, Q# I* `; t  X% N标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

$ O- ^  _; _" p) P- E( E% s3 c数值说明：
“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值
8 L6 H& w' I0 h; D* E/ ]
2 Q; g  l" e6 A! V7 pequ说明：
格式：text equ value
. D$ p4 d. P6 H说明：用一个text代替value
) O# z+ T# O' O" K例子：
3 q( F- G, C) a. ^) I! Z; c! Paddress1 equ 0x12345678
: r& L- `' o) Lldr r0,=address1
.pool
2 C# T! F& q# {1 f2 C8 D" M
函数说明：

.open函数：
, H# L% l. b, L- N& U5 M- }, C格式：
- p: p6 \2 n  v3 [, h. J.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
- G9 D. }: s$ x6 z说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

8 V7 f+ v7 f2 E( L4 A例子：
  W2 ^1 x: E! |4 w.open "1234.gba",0x08000000
7 F# o, ~2 X9 m1 P
: A  I0 T; n7 ^& q, O4 j# c3 ?.close函数和.closefile函数：
: [" c' E& Y3 m8 L* e; m. H格式：
.close
. ?& x9 m; S( c( ?! y.closefile
说明：关闭文件。
4 r: H9 R1 M/ I$ Q
" v" ?! {2 Z) k$ W6 ].org函数和.orga函数：
9 P- B- K* c/ u( S7 _% x, N! T格式：
.org RamAddress
! k: Z0 ~  G! b3 D. `) }1 T5 o.orga FileAddress
说明：
0 x$ [$ W9 {, j% f7 j6 K( H前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。
- w. t* j. V$ ~2 l# S  `( H# p
.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
" [7 U" e  y' ^6 m! O说明：创建一个文件，如果文件是存在，他会覆盖掉。
6 }5 C% O) `8 r4 O) c7 O; ^: c
.area函数
格式：
: s8 p7 T! U# l& T8 w2 s# b0 k.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
6 |% x" t- B& I$ Q# }
例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
5 y! R% `" v0 b* s" o1 `; Eorg 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
; V2 ^0 [$ t1 l* _7 E) [.endarea

2 P+ I8 ~  e, r0 t& e  X  ]2 B.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。
2 l1 z7 X5 M: B3 l
3 _! D7 b% ?  E; l. [# N; k.pool函数
格式：.pool
6 Y6 E0 w) \1 {说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
( y1 R- X- A$ ?. w) P- lldr r0,=0x12345678;
5 I4 Z" f% H! @& X....
.pool

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

.skip函数：
格式：.skip length
. X# O: q; h3 Q) ]说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
.byte value[,...]
) ^( H: D+ o3 z! [6 O.db value[,...]
.ascii value[,...]
" f( f& K+ Y8 Z0 C4 J.asciiz value[,...]
; l7 e5 V  M: D/ V, q5 W% Ndcb value[,...]
3 P! k, {! K6 G, i4 N
写双字节：
.halfword value[,...]
/ |. P: Q1 O& ~( r, I8 q9 x2 w! q.dh value[,...]
* I: [! L* [# M1 J$ b7 ddcw value[,...]
+ }# Z. t' y2 }+ S
写四字节：
9 E. Y, r; X$ m1 u.word value[,...]
( d( B8 A9 v  Q# ^% q& @4 ^.dw value[,...]
dcd value[,...]

写doublewords：
.doubleword value[,...]
  V2 S- k; C1 _.dd value[,...]
! c1 F- }& L$ T: Z- }  Ddcq value[,...]
$ p. r4 A" _- K6 `/ B. |" ]$ s
) d4 C7 Z# T( W写浮点数：
" Y3 I! l; E$ l% _.float value[,...]
.double value[,...]
" w0 U6 a! H; Y9 F/ |# x, B1 R2 Y
  E, M  c( I- S0 \0 BARM的ARM模式和THUMB模式定义：
.arm|ARM模式
# ^# X6 |5 B/ s% C2 {" q.thumb|thumb模式
* B0 M  q3 z& _; m, A' _& R
设置架构：
.psx|PlayStation 1(MIPS R3000)
. X: A/ x5 N% A% Y.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
/ @; O( k% N# K" E" o4 I.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
# Z; p) ^1 `- ?/ x0 ?.arm.big|
.arm.little|
! i; g8 h8 j# n5 e
: W* d( [4 w$ B1 O) W常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。