ARMIPS assembler使用说明

疾风之狼

ARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
/ i# x  v5 S$ ?4 C! ?- ]3 H
ARMIPS assembler作者是Kingcom,目前发展到0.9版本
( E  s! z# X* [4 L' r  o
Kingcom's website：http://aerie.wingdreams.net
+ N* s4 B2 Z/ P; s" _0 i
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
0 O7 g. l% Y0 D& k" D
! N" ^5 n  c6 `- i5 P0 b7 |更新版本可去http://buildbot.orphis.net/armips获得
$ t9 u! ~; ]+ b8 Z" M3 n
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

. j: z4 V9 Y( e, c9 aARMIPS命令行用法：
* i- }$ L, A& q* Y; ?( p' d7 T
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
$ J7 m! L2 k1 F( o, k& w -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
( n& P& p& a8 H. y0 \0 d -root <ROOT>         Use <ROOT> as working directory during execution
! o5 x9 q' x* W! l/ \ -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
-erroronwarning      Treat all warnings like errors

0 G, L& X, j# ]) iFile arguments:
# f  T: ^' c1 h3 ~9 l: {5 g/ w <FILE>               Main assembly code file
$ N9 q2 k! U; _. q( U8 c& J
9 }# p. m4 D: ~5 g  Z% P# }-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
+ |7 Q0 D& I9 d- V3 S-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
0 ^2 }6 _8 p" P- h; t4 ?-equ <NAME> <VAL>参数用法不明
8 ~: c) ?4 w+ m( g8 |" T; F  u-strequ <NAME> <VAL>参数用法不明
  B! @  U; }: p0 V8 Z- M5 b4 P-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
' h# g4 N( l7 h1 Y" j. `
<FILE>是汇编代码文件，可用记事本之类编辑
, W2 V: x$ i5 ~
注释说明：
注释可在单行指令后面“;”和“//”添加
& i& ]9 l% d: L' a, {“/* */”式也接受
) w6 _) t" k& w5 o3 U# s
' t& Y5 v8 N0 W9 r例子：
' g& m. L/ R2 Q4 y' |.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000

.close;/*关闭文件*/

3 ]; z0 V. K& G" C- F" f! P1 z标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。
! b) y, g, f' D# _" w, v
! ]2 I; z' [- U8 j4 I1 h+ L数值说明：
“0xA”和“0Ah”是16进制数值
  x; t( t% o8 G; c9 o“0o12”和“12o”是8进制数值
' }4 S4 D0 `7 B“1010b”和“0b1010”是2进制数值

" G" E9 z6 l' Q# F3 q0 pequ说明：
格式：text equ value
说明：用一个text代替value
0 g6 C2 T- @0 D例子：
address1 equ 0x12345678
ldr r0,=address1
. F6 V9 {9 m. K.pool

9 x) @) j  ?9 r; u/ f4 \6 n3 s  |函数说明：
2 o$ S4 E* E, S) \3 m) e0 \- E4 U
( f; d- G+ z) }: R. [% I, S  p- f" \.open函数：
格式：
1 w7 }; {  N3 j  n! W) J( X' ?/ Y.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
, N& ^" K9 W9 K' W  k+ T
6 Y7 ?" s. @; e: i% |例子：
.open "1234.gba",0x08000000

4 R- {, z* o8 @  o.close函数和.closefile函数：
格式：
+ h# l$ W3 g. z$ D6 P.close
" Y. A' r% O) ~8 c4 J.closefile
说明：关闭文件。
/ X3 T7 u& _( D2 B4 q6 V4 S% _
.org函数和.orga函数：
$ K) H( e9 B' O* e- Q0 e( z1 Y. e% V- T格式：
; W: G# a/ \8 o$ g  u* E7 h.org RamAddress
$ }$ d, _. W: D/ a0 |. d! e3 R$ P.orga FileAddress
说明：
" x- Z3 \* B# I6 i前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

7 L, @+ p9 `1 g9 {.orga函数可指定ROM文件的输出地址。
& u0 S6 j  Q" Z8 r/ R7 S
.create函数和.createfile函数
格式：
  Q+ J, h) k6 j.create "FileName",offset
.createfile "FileName",offset
说明：创建一个文件，如果文件是存在，他会覆盖掉。

% B; W9 o, E5 Z.area函数
格式：
.area SizeEquation[,fill]
' _) \! L0 o8 A. ~4 T( B1 Z.endarea
/ c: u  g/ E9 W+ e: v) W. e说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

, }2 U- V- i" m$ @例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
.area 0x8
byte 0x5,0x6,0x7,0x8
' J' W; ~. [! e% o5 o- v, ]7 F) J3 w! T.endarea
9 `- [* F4 p9 V$ @1 @% K3 O
9 f/ b% `6 Y2 V; ?' b.align函数
  u" u9 T% b4 u; f格式：.align num
. \  e+ A9 i) T) }' T说明：写零字节，num为零字节数量，用16进制表示。

& f5 S$ U) V* ?' f7 X.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
5 a4 f9 k/ i& m0 o5 U( V: @....
.pool

* Q$ a5 C% j' N.fill函数
3 C: Q: n1 U! `- I) q格式：
$ n" W  N5 C: y; P# F.fill length[,value]
( ]! F% Y, g- ]3 K  Vdefs length[,value]
说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
  w& O. T1 d$ J- v3 u
.skip函数：
格式：.skip length
1 `, }' I" l* R2 A3 M' A' F说明：跳过指定长度单字节数值，length用16进制表示。

$ {" S4 i4 f* E; n8 A( X. s写单字节：
.byte value[,...]
.db value[,...]
. a( ~( S* ?; o$ q7 M.ascii value[,...]
.asciiz value[,...]
dcb value[,...]

! W+ \8 Z. T: R2 K. ~, h3 ]& t写双字节：
: T% i0 U  s+ n1 |- A9 D.halfword value[,...]
.dh value[,...]
) s  o0 a8 d! w2 i2 t( tdcw value[,...]
" q* G: l7 h/ s/ J
9 o& @( T- B, z写四字节：
.word value[,...]
! ~6 p1 }# F2 \! c4 i) o.dw value[,...]
dcd value[,...]
, {2 _6 |7 ^  m5 H
写doublewords：
( B3 l7 ^& c9 B" J* V* F& W.doubleword value[,...]
) A. P2 g2 z+ s* g+ g% H.dd value[,...]
dcq value[,...]
: V8 m0 y! Q% U: |: [
写浮点数：
.float value[,...]
/ C* d0 I0 ]0 B9 w.double value[,...]

ARM的ARM模式和THUMB模式定义：
! r4 ]/ }, k8 u: J1 Q.arm|ARM模式
6 g, v) r9 Q5 T1 M( _6 a" k+ D.thumb|thumb模式

( G0 {: o! B- A  `+ ^7 i$ \4 p设置架构：
! e3 c- @3 [8 o- u.psx|PlayStation 1(MIPS R3000)
! B/ L; ?$ ~! C.ps2|PlayStation 2(EmotionEngine)
7 m( i+ r- q) X, W' `.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
# K7 \& ~/ b. m+ N2 i# R# Z5 z% `.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
+ H3 z) @5 b6 D5 p.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
4 K( q# q0 g. r7 [; G& M.arm.big|
.arm.little|
1 H5 s3 K$ J9 S% z) |- A3 u9 |  Q
8 y! X$ [; ?0 r* r1 u3 N2 `  L常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。