ARMIPS assembler使用说明

疾风之狼

5 y6 U; ]5 s" c2 O4 ]% ]% b" I! iARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

) K$ H! h" `+ T( qARMIPS assembler作者是Kingcom,目前发展到0.9版本
" g! j: R6 A) _! z( ~
Kingcom's website：http://aerie.wingdreams.net
2 X+ D3 z7 N$ x0 Q( {; Q4 V7 v7 u
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
- M( u. e+ j4 e- R' ?
7 M8 t) p6 M" c- k: [更新版本可去http://buildbot.orphis.net/armips获得

: x" h) W+ ?# m! Q9 X* [ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：
6 U, B$ ]$ r( X8 c. m8 @  l
7 n5 R0 j* \* I% ~( |5 W1 {% JUsage: armips [optional parameters] <FILE>
9 |! X; ]4 J( ?5 u( |
Optional parameters:
) I! E7 ?$ \" W -temp <TEMP>         Output temporary assembly data to <TEMP> file
% F: N- N8 K) A -sym  <SYM>          Output symbol data in the sym format to <SYM> file
7 a! |5 `. P" \. n+ j -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
3 j& |8 Z/ X8 C# t( ~0 K4 z' p3 ] -root <ROOT>         Use <ROOT> as working directory during execution
( q$ \2 S4 N. |7 G* W -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
: w" Q& d4 L0 a% W4 z% u -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
: N- q; s' W+ k" G+ v- n! `) S: ` -erroronwarning      Treat all warnings like errors

File arguments:
<FILE>               Main assembly code file

% e  p+ j0 Q0 q9 G-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
: `) \5 `" k$ j: O+ [% g-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
- N7 R  n' v- B6 {9 m( O-equ <NAME> <VAL>参数用法不明
. X* O( `: t# K-strequ <NAME> <VAL>参数用法不明
" r: a& M" _- w' {- z0 F-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
0 Q4 ^: u' Q) P0 o- |
2 v* V& l! a( k2 T<FILE>是汇编代码文件，可用记事本之类编辑

, x" k4 v( W, ?( r! s, o: w* H注释说明：
% a% E. q# _& M2 e% @  z注释可在单行指令后面“;”和“//”添加
“/* */”式也接受

' M+ s, |0 X, B, q$ f例子：
' O9 a' n9 D( a.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

  g1 o& w* s9 q.close;/*关闭文件*/
9 C5 O% P1 Z# g1 N
  c& b( J5 _- L5 K: T  z标签说明：
5 }% }4 Z- z. v- t. A% J/ S标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
; k1 v, C$ N0 ]' q
4 Q; x1 m3 {. b# v# G9 C数值说明：
“0xA”和“0Ah”是16进制数值
; {6 G) X2 y# V: s% D6 \“0o12”和“12o”是8进制数值
- Q& ]% c' C4 p  l3 l5 y“1010b”和“0b1010”是2进制数值

equ说明：
格式：text equ value
说明：用一个text代替value
例子：
3 O# p; H* D' n& n; D: \& o! V/ uaddress1 equ 0x12345678
- e( h# Z! G" h& @  O0 Fldr r0,=address1
.pool
  Y  k2 I% G7 ?
2 h* B8 k1 `/ W6 I# X, [2 z函数说明：

5 N  C% e/ e2 \  J6 G( D0 K' F: L.open函数：
' i' j/ }! [6 v格式：
3 }+ E% h4 k6 @, I1 b.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
2 g+ f2 }9 |3 t& @: w1 ^说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
/ D/ l4 m% q9 g, w1 Y! W
( {% W; A$ p6 Z( u6 w$ j  F例子：
. k1 j3 u5 {9 F# [" I1 S.open "1234.gba",0x08000000

.close函数和.closefile函数：
格式：
8 k, O7 x! Y; R% t6 n4 g* W.close
.closefile
5 R/ w& z& K+ F( P8 {1 W0 y) C3 t说明：关闭文件。

.org函数和.orga函数：
; k: }2 K; e( x: d, `格式：
& u( p& `  [3 x- b7 }7 Q2 R.org RamAddress
.orga FileAddress
# T9 m7 m2 b' O; }说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
: g! b+ N6 }  {, P( `# {% P
.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。

.area函数
( U# P- G& x! A格式：
.area SizeEquation[,fill]
" U" ~2 i9 ]* d; k4 n+ A' E, L) L.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

( h' D6 [5 a, k4 N% R# ^- }4 q例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
.endarea
* u8 d0 W2 l3 `1 c2 b9 `  m
.align函数
格式：.align num
" ^" W' H. F1 ~+ D8 p2 C说明：写零字节，num为零字节数量，用16进制表示。

! h+ Z0 l' ^" n9 G  I( P.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
' U4 V+ ^( S3 ]5 P, ?: |* G例子：
( h/ q8 A4 z* g5 Q3 sldr r0,=0x12345678;
3 x  `8 i0 }: |& }....
.pool

.fill函数
格式：
+ g5 [. ^  h: i; s* A6 {6 @  b.fill length[,value]
defs length[,value]
% T1 C9 r+ l" u- d( Y说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

! k. Z7 j3 K) O  J3 p, E/ f4 B写单字节：
.byte value[,...]
( G/ i! o( X* S2 N0 `+ K5 q.db value[,...]
% q* x" |$ e' ?4 U3 U: R.ascii value[,...]
8 S2 o0 g7 K7 t7 d1 {.asciiz value[,...]
* S  s6 v2 A1 y& idcb value[,...]
* f1 h! Q& J5 J8 ^0 n, \
写双字节：
.halfword value[,...]
  h, R0 `8 j% w3 x8 o.dh value[,...]
dcw value[,...]

0 q& ~3 e+ i( |4 D0 p5 Q& k写四字节：
.word value[,...]
.dw value[,...]
dcd value[,...]

写doublewords：
) t$ U. M( o' P0 g# F% m5 `$ g8 q* k. y.doubleword value[,...]
.dd value[,...]
dcq value[,...]
# x% \1 O6 v) }1 w
! L) U! }3 z5 i! X8 \0 N: I写浮点数：
# C1 s1 j: E8 Z) c; F4 u.float value[,...]
( j3 n+ S( \3 z5 Z4 |9 v2 q.double value[,...]
( t2 z/ ?; P& K, X0 e) p
ARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式

设置架构：
8 \! o2 r5 S6 x( |- U& a8 O.psx|PlayStation 1(MIPS R3000)
1 c8 H! G  R" Q0 W0 E% k. w# n.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
' p2 A# G+ T8 ^; z) B* `+ {( v4 \.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
, ~- ~/ e# Y* }+ n! k. h( ^+ A.arm.little|
! |2 v$ D$ Q; q. E
常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。