ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000

* ?0 [5 S% `" G+ F9 H3 I2 ^ARMIPS assembler作者是Kingcom,目前发展到0.9版本

5 ]. W; D% q; d7 mKingcom's website：http://aerie.wingdreams.net

& Z5 C# r* l4 ]  q* ?- R- m& LARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
5 K  q. Z5 X6 y* g7 e; @2 @% S6 S
* j  m+ A, V6 t, P7 A更新版本可去http://buildbot.orphis.net/armips获得
7 h+ L, C& P% A7 h6 s/ N! y  k$ T
8 E# r+ Y4 `6 g) [) `7 h* }" XARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

ARMIPS命令行用法：

) }, }8 d  G/ m. R) _, f5 ^Usage: armips [optional parameters] <FILE>

Optional parameters:
-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
. t* {: Y- Q% G: _. i. x -root <ROOT>         Use <ROOT> as working directory during execution
-equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
- h) F5 c4 M0 }' ]) A -strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
9 U4 q* y2 J( U1 n: m4 | -erroronwarning      Treat all warnings like errors

" M- N) v+ I/ K, m3 r9 h9 DFile arguments:
7 r$ {1 ?' Y+ B8 V% j* \; w <FILE>               Main assembly code file
' q/ l5 c& G/ |
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
8 f& U! I5 _$ i$ y( A* Q( k  B-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
6 P7 U# [/ k8 g  p- Z( ^-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
/ Q$ K; V0 R  `6 Y( Z4 b% _( W
<FILE>是汇编代码文件，可用记事本之类编辑

注释说明：
注释可在单行指令后面“;”和“//”添加
“/* */”式也接受
& O5 v* s% j* U% k; r  D0 p( n) k
例子：
( U0 I. h1 F* ?" O, u9 i2 M.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

& ?/ S* w! e7 g- e; K2 v.close;/*关闭文件*/

标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
2 l/ {4 J: F* J; }2 i  [7 t* O3 Y
数值说明：
# G2 }& u" Y* I& x$ }“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
- N$ M: ~# b* }- u% N) `“1010b”和“0b1010”是2进制数值

equ说明：
格式：text equ value
说明：用一个text代替value
例子：
9 v! M" M" s, J; X  ~address1 equ 0x12345678
* c. ]* Y& }! `- Q2 F( E6 d% Rldr r0,=address1
.pool
1 _8 s. n% n' V
" X* A" j4 G: W3 l8 h7 t函数说明：

/ m: U" e. i& A4 `8 C3 ~, ^.open函数：
格式：
9 A* Z- ~+ {$ u* E7 J3 c.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
3 P2 }) c( V/ o( O说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
1 ~; d" j) I5 `
例子：
  p0 C6 q  y$ ]/ F; W7 |.open "1234.gba",0x08000000

.close函数和.closefile函数：
" M& S% @, h$ I+ C1 }: K9 N格式：
% E. V8 c1 g% t' B.close
.closefile
% w" g" ?; X/ n* C$ \( f- M说明：关闭文件。

, C# Y. k1 Y4 y* T5 F.org函数和.orga函数：
格式：
.org RamAddress
.orga FileAddress
说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。
! R; }' U. A# `4 I) N
8 l$ u; V, e& Y/ f! \1 ^.orga函数可指定ROM文件的输出地址。

.create函数和.createfile函数
; L- U1 g$ s1 I5 }7 m& g格式：
.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。
+ |6 [  Y( `' L! V( I- Z
.area函数
' U/ R' O; }6 h( n: |( s格式：
! v/ m3 y9 k: l$ d.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

$ ]5 [. ^* w3 _' F* \+ k例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
3 x0 i- m9 d: [' F8 Z" W6 ~org 0x100
; W( i# R& y, g) r- B! y/ k% w.area 0x8
0 b+ ~8 \2 g4 M, ibyte 0x5,0x6,0x7,0x8
$ b& T: S4 @$ b- t# |.endarea
* [) v+ @6 j9 b5 Q; J' d9 v" z
2 x% ?1 p9 _/ Q1 w$ N.align函数
格式：.align num
$ C3 j. D7 {) }9 |说明：写零字节，num为零字节数量，用16进制表示。
) Y# f* \+ y3 ?
.pool函数
* ^6 ?( c. {' y- ]格式：.pool
; q( ?# u: L, M' ]& G说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
6 Z4 a: {" w8 G例子：
% Q' N, I$ v' k: O. B% R9 qldr r0,=0x12345678;
5 \  E9 c. V* I& R) g, E) l....
.pool

.fill函数
, @1 O* A2 W  L格式：
.fill length[,value]
) [* Z7 x8 `7 A  C8 P* Udefs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

.skip函数：
格式：.skip length
& ?% `# F) a* P1 w: `/ G% k说明：跳过指定长度单字节数值，length用16进制表示。

8 F; X# V! E8 F3 \% s' ?& G% u写单字节：
.byte value[,...]
.db value[,...]
. V2 H. U& r. H" c2 K: f.ascii value[,...]
.asciiz value[,...]
9 L: l8 P; _" v5 V+ E- `- n4 F( |dcb value[,...]
. u* p$ y  u6 K/ Q7 U( [. M1 m
写双字节：
.halfword value[,...]
( q# p9 I1 x) \; [0 v7 _/ H9 _( _.dh value[,...]
9 f  l  @! q% |8 n" Vdcw value[,...]
- e* F5 {3 I! ?8 ]; o  x, h4 j( H
写四字节：
.word value[,...]
.dw value[,...]
& H  y- u8 X  N. l2 f( vdcd value[,...]

% n+ u( S! k3 J: K/ {写doublewords：
.doubleword value[,...]
7 o6 X. F7 b, t* U.dd value[,...]
$ {4 p6 d7 z$ O( K& Bdcq value[,...]

7 Q5 _4 S) o4 ~1 k写浮点数：
.float value[,...]
.double value[,...]

) ]# l2 H2 C* h  L% d* u0 |4 qARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式
* g' W. b- b8 D( a& T
8 W% Q" P6 g1 Q2 s$ T- ~设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
: _/ I) G) G1 L6 [0 z5 ^: Q.psp|PlayStation Portable(Allegrex)
, Y0 p  k( ^2 d0 R.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
& F  \0 l' f2 I/ {2 m# v& }" I# R.gba|GameBoy Advance(ARM7,默认是thumb模式)
  D0 q) B* `7 ]  h, i.nds|Nintendo DS(ARM9,默认是ARM模式)
! @# e6 D4 ]6 b) |, k.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
; q; p) l$ Z: u! Z% a4 v* w" {& P: `.arm.big|
" Z) u$ g, w4 E2 v.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。
) x0 [! d" q5 _) D. m' q1 [, n