ARMIPS assembler使用说明

疾风之狼

4 J2 C4 p( m" }2 n3 N" f9 MARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

ARMIPS assembler作者是Kingcom,目前发展到0.9版本

/ R8 p% ^# O3 A  g/ vKingcom's website：http://aerie.wingdreams.net
, Z/ _7 k4 h7 c' q# D! r
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
& g5 j& j' H( L
, o' m" Z9 ]! I2 c更新版本可去http://buildbot.orphis.net/armips获得

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

6 ?3 t& j* x  \6 FARMIPS命令行用法：

Usage: armips [optional parameters] <FILE>
& ?' T0 h1 l, P, ^( ~9 r. ^
$ C3 H( o* {6 s9 ?  AOptional parameters:
/ o- k! f7 P3 z& P& e) j2 T; r -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
( i7 h+ d6 t3 t9 |' X -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
! U; _% X7 r# B' @0 g -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
: n# k4 ?1 T8 H/ t8 B -erroronwarning      Treat all warnings like errors

" `9 |6 Y, o; P( M: uFile arguments:
1 n0 ~& l  ~+ r7 z4 z. Z* |5 M& x <FILE>               Main assembly code file

-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
2 s: k8 l- N/ ^2 _. D3 z-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
0 x5 C- ]( [" `7 [' z+ ~+ p-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑
$ K" V6 t0 u, s6 D
注释说明：
, g/ U5 k7 }: I7 F# n注释可在单行指令后面“;”和“//”添加
“/* */”式也接受

例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

, T+ p, \  u& V" x+ Y( L.close;/*关闭文件*/
" E: T& Z2 q3 |( w! R' }3 F" w
* x2 o0 `5 G9 H3 \' g标签说明：
& d  Z3 s; M1 l& c0 c. V& R标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
( l, k3 Y; u4 A( ?. s  V* r' y$ q
# u- n1 \0 r9 u* V. H  q数值说明：
- C0 }) I  z+ {, z3 U, O7 K“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
# q( [1 j$ x, Q6 h“1010b”和“0b1010”是2进制数值
  l/ z' U* u  W/ W
equ说明：
格式：text equ value
! d8 _- f6 `2 B说明：用一个text代替value
例子：
address1 equ 0x12345678
  I6 Y  f5 _3 c/ U' }- l' P) dldr r0,=address1
.pool
8 P# f5 ]) V# n9 n/ Q- v
函数说明：
7 j- M' p6 D" {
5 e% R; T5 m) U.open函数：
2 `4 f9 T, ^( {( G6 A1 r/ t7 i格式：
.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
4 J5 f/ \% B* G* z! {1 s) ~# o: P  K5 M
例子：
3 \3 E5 V4 P& ^( ]" x.open "1234.gba",0x08000000

.close函数和.closefile函数：
! X7 J4 P1 V! Y格式：
* X# Q7 n) `$ S6 u.close
8 H0 ]) s. Q4 p; u/ O& Z+ I, w.closefile
说明：关闭文件。
! p/ Y( [2 X2 [/ d2 e
.org函数和.orga函数：
1 m9 o: b9 G( s: D" T7 K7 g格式：
) `8 T) K& |9 b5 P# C.org RamAddress
( i- N: r% m! [2 b: X# {.orga FileAddress
& M& o& [6 }; M! |+ \说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
! e# M  Q$ g. E! o2 t) x# F3 L
% X+ w3 Y! r* V: u' z.orga函数可指定ROM文件的输出地址。

$ c8 y. B: m/ I5 A2 j( c5 R3 ~' k0 H.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
3 @. z: |& B/ j1 E9 e! w$ M
.area函数
0 c; a! B( Z& F格式：
( D$ @1 i) O" H9 W' H2 d.area SizeEquation[,fill]
.endarea
; J" [8 T+ w0 ]. m$ n说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
3 [0 \- X1 }. R( O! T4 K3 d1 m.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea

.align函数
6 _+ i$ ~) t* P- R8 P4 L) N格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。
( x+ I/ g, N+ B$ S
.pool函数
6 b& f. }% r1 n& r5 @: p格式：.pool
8 H  O# a; l7 r* _$ o* [$ S说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
: t/ |& F. ]; k$ o# V1 E8 Y0 eldr r0,=0x12345678;
....
.pool

$ v: @) @. B% I. `.fill函数
/ s7 w% E2 T0 I1 x! ?$ R格式：
( k, S, k* ?+ q% x.fill length[,value]
defs length[,value]
6 m& I# a3 w' T  s4 K) x) O$ z说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

' {3 u) ^, Y5 r3 H( \1 E.skip函数：
. R* Y9 J. C- z  Y. c格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
4 v, |% O/ n0 F$ b" U
- }' R! ~; o2 [; A) F# O% N; i- ]写单字节：
.byte value[,...]
.db value[,...]
* `+ a- L; p7 G.ascii value[,...]
* T5 l3 j# \2 f1 [: j/ r( r. c.asciiz value[,...]
dcb value[,...]
9 x6 Q1 Z/ [$ X4 v# c  x
写双字节：
" e" I* m8 W# g9 g8 s) @# a.halfword value[,...]
.dh value[,...]
dcw value[,...]
* E* \, M! r8 n; A/ V  R
写四字节：
( s' m7 A$ R3 E.word value[,...]
.dw value[,...]
dcd value[,...]
2 n  n/ D1 A/ F. t. _5 H
3 x3 m( e! K: C写doublewords：
.doubleword value[,...]
.dd value[,...]
3 P9 {* Q5 Q% x; \! odcq value[,...]
6 e! D$ h0 s% C! V0 U7 n8 `. r
; M  t- ?% e8 n3 Y0 \写浮点数：
, i' L. O7 m' c0 [* A- t/ U.float value[,...]
* W) Q. q! m+ x7 Q.double value[,...]
. E3 |* `# V* h. x) P; i) y
ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
8 W! R7 a9 T: y" \; E( o& r.thumb|thumb模式
$ ]$ n5 }. o; l7 c5 r
$ l' O" X! [+ z" W; J  f1 @: Z设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
7 H- Q) Z$ J1 b  w  t; S& T.rsp|Nintendo 64(RSP)
' q- c+ z; _9 I* R.gba|GameBoy Advance(ARM7,默认是thumb模式)
! e7 O2 {# _% }& Z- j' }) j& w.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
, K1 q2 P& L$ V! o2 {5 H& q  k* j.arm.big|
.arm.little|
9 d+ i* w" V; _1 z
6 g, R  I# u" H- |, {) b/ e# f常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
0 t% z" I( f& W/ M% r; K5 T