ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
! `; R( E! T5 J& j+ X( E
$ m  C, u% g: ^+ x% r+ b+ m" g! j( x! xARMIPS assembler作者是Kingcom,目前发展到0.9版本
5 w! n3 v6 c, `. ]! `( F& C- O
5 W4 C1 C/ }7 Y8 [* ~/ xKingcom's website：http://aerie.wingdreams.net
- G- I" E) U8 L
7 _* Z0 c% P7 O1 H$ U3 l+ UARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
9 I6 ]' b% s4 W: u. B. h2 c
更新版本可去http://buildbot.orphis.net/armips获得
- ?% E# D1 Z# O+ L$ M" K
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。
3 A- I8 [1 o1 \. Z. u
ARMIPS命令行用法：
) l9 c! W) Y$ M8 d% m
Usage: armips [optional parameters] <FILE>
; {  l. i2 b( z. G) M7 d) X
Optional parameters:
- u) n( \$ n3 B8 e+ ` -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
. j" N5 K( Z# L- {) S) y  d% z -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors
+ b! a8 x4 g$ [% a* A7 d  K/ W
% Y* p& V8 W! V2 {File arguments:
<FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
) D# m7 b3 |% _-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
, t2 R. B) z% d' {-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

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

0 Q; N$ s& {$ C, j( ^& t' V4 |注释说明：
6 H) `  T8 X5 @" F. m( O$ k) B注释可在单行指令后面“;”和“//”添加
“/* */”式也接受

例子：
1 n! n. g, E5 K" S. S: b7 b.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

.close;/*关闭文件*/
4 J8 Y* B, t7 }
/ L! S, ?3 {4 J! q5 [- R标签说明：
+ J1 H. j9 J0 P( g2 M# y; k标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
" X5 O  z# {  @" N1 G3 n
2 N( i' B9 ]1 \% p% Y数值说明：
! s: L0 ^  \) I9 L0 V; @; c“0xA”和“0Ah”是16进制数值
: Z7 A1 j4 w9 x- ~' A! j0 C“0o12”和“12o”是8进制数值
! D! @( R0 D0 O' w0 @0 L“1010b”和“0b1010”是2进制数值
, d* ?5 T# ^. H
equ说明：
& u, e3 A; p& \2 B1 E. `格式：text equ value
, u; E: C3 D; i4 N/ k. r* K说明：用一个text代替value
" F8 k  i7 b/ y; Y例子：
address1 equ 0x12345678
ldr r0,=address1
.pool
. N; r4 R( F+ {: l  y
# Y4 a7 B$ p; M# `函数说明：

.open函数：
! h3 z# H! h1 W# ^格式：
4 ?7 }6 l1 O! [.open "ROM FileName",offset
& ~6 U+ {- _8 U.open "Old FileName","New FileName",offset
% [0 c1 x1 l( [' p+ l说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

) k" N; f7 N" p9 f6 [例子：
.open "1234.gba",0x08000000

.close函数和.closefile函数：
格式：
9 O/ b# ]3 E4 \( ^.close
.closefile
说明：关闭文件。
; M4 ?9 F4 A) u& v
.org函数和.orga函数：
5 q1 }: s( M1 M格式：
.org RamAddress
.orga FileAddress
/ Y( F$ |/ F, u" j7 @: @: g, p; @" o说明：
6 Q5 W; Q" M/ A前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
4 C/ O2 R0 K2 C( E( h
( J! j' K2 t, |" X) Z8 f4 A.orga函数可指定ROM文件的输出地址。

- ?' s2 A( l! p. O/ V+ R.create函数和.createfile函数
2 A9 x- @; F+ ?4 Q格式：
.create "FileName",offset
.createfile "FileName",offset
6 Z; ]3 E3 t2 d; |说明：创建一个文件，如果文件是存在，他会覆盖掉。
* i8 f6 [$ W5 t
.area函数
格式：
, I: D8 a" i! b. f. F  ]+ t+ v. u.area SizeEquation[,fill]
.endarea
. ^2 G( u- u4 u& _3 A4 m% r# d0 `说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
- t4 I4 M" F* F& s5 J& N3 A% w( n.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
* N9 K3 e+ c3 M
.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。
0 k. m. c+ }& Z) a( D
- t+ a/ c! T# @/ p- I.pool函数
1 Y/ K/ ~- h7 S* ~- J  o) w$ w5 o格式：.pool
0 Z9 E& m) \$ d4 S7 M* [说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
3 s! U& v" g. [1 B2 p: ]....
. s3 e. V  u. H+ v5 [.pool

.fill函数
格式：
. _! G( E0 q& G8 T6 S' o.fill length[,value]
defs length[,value]
, z6 E6 ]+ \2 O6 h' F7 L( d说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
格式：.skip length
+ r% P7 q$ |( s. Z& m& `" }说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
# L8 c  }4 O( D$ X! y0 F.byte value[,...]
.db value[,...]
.ascii value[,...]
.asciiz value[,...]
. U5 U1 s+ C5 Jdcb value[,...]

写双字节：
; j# M$ I9 G* S, o6 E.halfword value[,...]
& U7 e/ S6 d1 t9 P/ K2 w- u1 c.dh value[,...]
dcw value[,...]

/ s: b' I& ?& V8 M2 D写四字节：
.word value[,...]
. f5 B* n. n, b; w# J6 n0 V.dw value[,...]
8 q( ?( V  x8 Tdcd value[,...]
# T, c# M$ a5 |  q( Q- ?  k6 P1 X
写doublewords：
.doubleword value[,...]
.dd value[,...]
dcq value[,...]
9 L/ }$ V# {" `9 ~( \& Q
" F0 P( j/ T' M, \# T$ p' k2 U写浮点数：
.float value[,...]
.double value[,...]
* I! R6 l$ R" J" _: y/ |$ g( c& O
* J$ N. W$ d/ \ARM的ARM模式和THUMB模式定义：
- k" _+ W# o/ x6 ]9 v& T( z.arm|ARM模式
.thumb|thumb模式

  u7 J: N$ k7 c2 @& N设置架构：
( q0 a/ R. }( S; V/ z' \.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
- H1 B1 F: V' ]& z" g6 |* _.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
; g% O3 k# U" M8 z6 @.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
.arm.little|

& r0 Q8 I2 x. N! A/ m6 j( Q% N常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。