ARMIPS assembler使用说明

疾风之狼

4 _& d2 R- n+ NARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

& B+ t9 B; t8 n# S! x: `ARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net
$ R& o) Y1 B6 ]: U( j  N
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得

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

6 o+ O( c6 G' [  t- Q; w, GARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

5 |, x% h, y/ d. B! ~2 w! ?ARMIPS命令行用法：
" c7 ~$ l, N7 n
* S) a# J: r% S, I  T- W3 m% lUsage: armips [optional parameters] <FILE>
) e( d8 y6 G4 A5 {8 I# M, r7 R( j: b& i3 @
Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
" e* Z' _8 h6 z/ n# M( x -sym  <SYM>          Output symbol data in the sym format to <SYM> file
6 s7 l' y2 ~3 w -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
/ g8 C2 y* V( S3 W7 e9 ^  a -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors

File arguments:
. `9 t8 {5 J. d  W+ n: r# j- Y6 Z <FILE>               Main assembly code file

4 H& Q( `5 U  k. a# @: j& Q-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
& U& N( t8 M2 a-equ <NAME> <VAL>参数用法不明
  g- g# d8 u7 Z3 J: X-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

# J+ J/ h2 |/ J; }<FILE>是汇编代码文件，可用记事本之类编辑
. A" @4 J- T8 E) F' ?1 \5 `: T
! D+ _# L* E# q# M  Y- K4 d& u$ t& R注释说明：
注释可在单行指令后面“;”和“//”添加
“/* */”式也接受

例子：
, Y3 L  p/ ?! q.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
6 h0 z7 Z( G6 }8 i: N% M
.close;/*关闭文件*/

. R4 A/ H' P( a! j3 Z% c# Q标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

数值说明：
0 _' T) _2 @  J“0xA”和“0Ah”是16进制数值
8 z) p; m1 j! n6 @; o“0o12”和“12o”是8进制数值
“1010b”和“0b1010”是2进制数值

equ说明：
格式：text equ value
说明：用一个text代替value
例子：
address1 equ 0x12345678
ldr r0,=address1
.pool
- ]3 b$ A* l: s0 ^; V2 k
# m+ O  A4 C8 o函数说明：

( B- j5 P1 S6 F.open函数：
格式：
.open "ROM FileName",offset
) B1 S% A/ _1 M9 c+ }# t.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
# Q, x/ N, {8 n. _& Q
& U- A; u( \9 b: k1 P& q9 l例子：
.open "1234.gba",0x08000000
1 f3 c, l+ g/ T) [( c8 s+ j0 M
.close函数和.closefile函数：
格式：
5 b5 |9 ^0 c& T2 [.close
.closefile
说明：关闭文件。

.org函数和.orga函数：
7 U5 f* _, ^6 ~格式：
0 V) |8 k0 ?5 h4 J% l$ x1 W9 S.org RamAddress
.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

2 y$ H- m8 ?8 t; A; H& w! Q1 g.orga函数可指定ROM文件的输出地址。
4 c  C7 L* [( v/ ^: W' z" H
3 z- n, l- Z# P# k  [.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
& }  X+ k5 Y. j9 K1 ?/ u; M4 r( c3 O说明：创建一个文件，如果文件是存在，他会覆盖掉。
$ U7 b4 u: T5 y2 O, a' O! M4 i: }
: e1 x: B9 O. f  }- L& v9 |.area函数
格式：
.area SizeEquation[,fill]
.endarea
% n0 D. v8 o; n5 [4 i# p) G说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败
7 v( B4 g  h  u  v7 R
1 h0 r0 t4 T0 I( T! b; ^3 X例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
* o' P( ~, v* V# horg 0x100
3 I2 y* G4 M* m2 P4 G; @.area 0x8
: _; X: ], S  D! |1 }. v* n& ubyte 0x5,0x6,0x7,0x8
.endarea

" |! f- [  G) z# A6 M# D.align函数
格式：.align num
说明：写零字节，num为零字节数量，用16进制表示。
' u/ S6 m: q, s$ u& l$ O; U
+ Y5 ]" F3 h  ?- T.pool函数
' H# v+ G5 C5 L, h格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
9 f9 ^& R& ~+ J- J) V  k! y/ ?例子：
& m/ C$ o' S; x+ g% `+ Fldr r0,=0x12345678;
/ N0 c* v2 B2 Y0 Q5 c....
.pool
" o' T5 ?4 ^" F
2 e4 p) R; P& ]4 O.fill函数
格式：
' O' c+ R- @3 W- H9 X5 E9 C, W.fill length[,value]
8 \4 E: |/ W8 q: Sdefs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

- v- K8 b2 J4 c4 q1 Y.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。
* _# c0 t) x+ h" _& Q; R
  v" i' \3 d* W5 I; F写单字节：
: l5 d8 Q& ]0 c; p, k7 V.byte value[,...]
.db value[,...]
.ascii value[,...]
.asciiz value[,...]
! I/ g. r8 d5 y) c. ndcb value[,...]

6 Z! S" d4 w" C" t. B% X$ @写双字节：
+ c* M2 ]5 |2 x8 t9 @.halfword value[,...]
.dh value[,...]
dcw value[,...]

写四字节：
4 r7 L4 g$ O, _1 u& @6 z+ M! i.word value[,...]
.dw value[,...]
; d: ]2 d( b/ R% x+ zdcd value[,...]
  j5 M$ Q2 [5 |% N
写doublewords：
' c) s* [6 Z* B- k.doubleword value[,...]
.dd value[,...]
5 v: _" P0 W0 L; H. v$ @dcq value[,...]

% a7 ?; I; m- Y6 U5 T+ X写浮点数：
.float value[,...]
: L, {; @# I& t. g. g! M.double value[,...]

ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
7 W7 [/ \  U0 h) r  ].thumb|thumb模式

" m# H6 l$ E/ q设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
9 ~/ f7 \2 F2 ]: u) w- I# u! y. i- E.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
% t# S( v+ U7 R6 Z+ F1 L.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
. C$ K& v3 X* U8 H% h* `2 q.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
& d# ?  F6 z5 p# p- x