ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
) W& U# b" k* ?) {( P% A4 c3 r
ARMIPS assembler作者是Kingcom,目前发展到0.9版本
) c/ H+ S( X3 Z5 M( G2 i+ ?) U6 u; T
. T0 m$ B9 h! R& z. kKingcom's website：http://aerie.wingdreams.net
$ C) L- O1 c7 b- Y& q$ [
  e. k& o7 ?8 ~4 H) A- t. jARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
$ k- F% j! g- W$ R/ @
& f& j8 L: Y& Y% h% D更新版本可去http://buildbot.orphis.net/armips获得
- t0 k  J9 |; t
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：
( i7 Q) `. a) g$ X
Usage: armips [optional parameters] <FILE>

6 j7 x! y4 k% \" `" P4 wOptional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
2 ]/ p5 O' d3 ~6 K' h' c/ B8 p# g& s2 @ -sym  <SYM>          Output symbol data in the sym format to <SYM> file
, t% N6 B8 S5 o! c0 v -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
6 S: n# a  l6 A1 Q! l. o' N -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
% ]' d2 [7 M* X& q -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors

File arguments:
: H# `4 f+ e+ H( u, f <FILE>               Main assembly code file

: z/ u0 c/ R* y$ Z  K! V-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
# U1 d' ^  e1 u  L: _4 v; Z. Y-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
, D/ k! K& P: _7 S-root <ROOT>参数是指定执行期间要使用的工作目录
+ F- [6 b1 H7 M1 s+ c-equ <NAME> <VAL>参数用法不明
. j5 ?" ]+ o  w, O' u-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
/ A2 E+ Z( q5 `" U) Y6 t
! A" `6 x! Y6 x! C$ V' S<FILE>是汇编代码文件，可用记事本之类编辑
4 R  A7 K# L. C" Z% n8 W
注释说明：
注释可在单行指令后面“;”和“//”添加
8 v- Q- N/ G3 r8 S- V“/* */”式也接受
* V( |" O; {5 b6 s$ Q
例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
# N7 d* j! n1 N% i. g
.close;/*关闭文件*/

标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
6 \- U( K! s- L$ X
6 {6 S2 r) O. Q& }* l  H$ w数值说明：
! f( t6 h" V& B# T. I4 K) h: X2 t5 c- ?" G“0xA”和“0Ah”是16进制数值
; Y4 X; z: X5 y! q* D: r3 `: a+ g“0o12”和“12o”是8进制数值
$ m3 t0 V( a5 W$ B* Q' f8 h& a“1010b”和“0b1010”是2进制数值
$ ?$ s& R. }! D- E% N8 G# }. d
equ说明：
格式：text equ value
9 w. A, ?$ N7 z" G说明：用一个text代替value
$ {! f& I5 N, }1 q例子：
address1 equ 0x12345678
2 Y2 E4 P- h8 u) U  lldr r0,=address1
8 w) J" g+ W0 m$ V7 ]. P! ?.pool
/ z4 _' e( L% H; j1 e
函数说明：
9 N$ s+ S7 F( f& j4 k5 A. G& Z5 c
! D  M+ b; {3 ^.open函数：
格式：
4 G% k6 {0 x: F.open "ROM FileName",offset
6 c: t1 |/ E; {$ P; p4 H) I.open "Old FileName","New FileName",offset
" M4 B+ E8 V, R  D/ E0 `说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。

例子：
* s0 L  v2 U  W: Z0 j+ I9 e- U.open "1234.gba",0x08000000

+ O( J# X8 I- j& x0 j: i$ ^.close函数和.closefile函数：
格式：
.close
/ ^  A: Y  O, y: H1 i2 c& z8 B.closefile
说明：关闭文件。
" ?" k' I7 K; C, M( x
4 _, P3 t9 }& {.org函数和.orga函数：
3 h, j; _9 [  D8 a  o格式：
.org RamAddress
% @  N& I$ E6 ^. s6 h$ n, R.orga FileAddress
# Q! V6 X/ x6 y说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

* y+ M) j, v% x% n.orga函数可指定ROM文件的输出地址。
# n+ ~6 I4 ^- l$ a3 G+ ~: Z
.create函数和.createfile函数
格式：
- r6 q/ b  i- ~1 u9 ?4 D.create "FileName",offset
0 A: y" {  W. q% I.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。

% h( e# ~4 h9 T$ H. ?.area函数
格式：
.area SizeEquation[,fill]
' S0 ^3 x& G" z% x! v2 n: E5 u.endarea
5 W* f2 ?# `0 O; j说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
* h  R4 n; `& A3 x9 r
) t. v" {) L+ `- c+ r  R例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
! u) D. v$ F7 p. u.endarea

.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。

9 M, f+ V9 Y; w9 N.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
: X! N- f0 j0 p2 E....
  T1 Y5 T7 I! E: F0 f" k.pool

; _. e# x( }8 I, q- N.fill函数
格式：
: A) V, L; c2 U; o4 f1 S.fill length[,value]
1 Z9 y" y7 T7 u: rdefs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
7 I/ O3 ?  S0 _! O. n格式：.skip length
- G% L0 ^. t% K) q( ~: T说明：跳过指定长度单字节数值，length用16进制表示。

写单字节：
.byte value[,...]
.db value[,...]
.ascii value[,...]
.asciiz value[,...]
8 [( f( s9 _2 c6 [! k  l' Pdcb value[,...]
$ X7 _& f* ]- u
) `8 g9 K3 U+ H7 c写双字节：
- g) H- J# S/ S- \' @+ b: b7 L.halfword value[,...]
3 p! G/ E& I+ e+ C/ h.dh value[,...]
1 t* ?; z) y' x, v# Gdcw value[,...]
% z- U1 l% ~. @4 n& \; g; Z/ i7 L
写四字节：
) }3 R$ v9 L: p, i; p1 @! w  g. J.word value[,...]
.dw value[,...]
: V( P& s% L) @$ T/ h% h' Zdcd value[,...]

写doublewords：
.doubleword value[,...]
4 w% T, o* P; a/ s" w.dd value[,...]
" G' N9 b! m6 _4 b, e( m) ?9 ?dcq value[,...]

写浮点数：
4 o  R" ^. c1 C9 X" j.float value[,...]
.double value[,...]
' [8 g8 c- `& y  p
( S1 E( z' Q& p. z8 M- cARM的ARM模式和THUMB模式定义：
! K2 A* {* _9 d.arm|ARM模式
3 x" h# \' b* W5 ^3 v6 P.thumb|thumb模式
9 c* s  r! L$ t" x2 O
设置架构：
.psx|PlayStation 1(MIPS R3000)
+ a, h: I/ L5 c1 ^.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.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|

* c0 Y. }: ]$ d0 x6 `. `. U. z常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。