ARMIPS assembler使用说明

疾风之狼

5 ?! L4 j# \" a8 z& d( rARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
- ]$ U6 Z+ a2 |
ARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net
3 e9 Z+ A3 n9 v5 Q; e0 r/ p9 w5 L
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
, A) Y& N% J' S( |0 s) i2 d
- f' N6 [: p$ y1 @/ {更新版本可去http://buildbot.orphis.net/armips获得
' O+ _4 ^1 f5 e" D! e& s
" c8 C) F) e+ [1 J) }ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

+ P7 |! j# r6 [9 L) }' KARMIPS命令行用法：

6 l- K7 u1 N# E5 lUsage: armips [optional parameters] <FILE>

7 Z' W9 Y! [/ [$ N4 s+ m, kOptional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
& W$ n: \% E+ {7 `: J3 |# k1 O4 ~ -sym  <SYM>          Output symbol data in the sym format to <SYM> file
, |) Y# `2 _/ Y( N8 q -sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
9 u' F8 m2 V& @; ^6 X- R2 B -root <ROOT>         Use <ROOT> as working directory during execution
1 H. U/ l3 g2 l2 v+ \9 x! P4 ~/ e* d -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

File arguments:
) D7 W2 j  X6 R) U <FILE>               Main assembly code file
) l4 q$ K8 N( O: H3 v$ A
; }6 x2 Z9 i# M: z-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
: h8 S" q. B. i8 j- Q-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
-root <ROOT>参数是指定执行期间要使用的工作目录
-equ <NAME> <VAL>参数用法不明
-strequ <NAME> <VAL>参数用法不明
. B1 h2 N# j2 c; J* J-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译

<FILE>是汇编代码文件，可用记事本之类编辑

注释说明：
注释可在单行指令后面“;”和“//”添加
  a7 _1 w( E$ t, r5 q: R“/* */”式也接受

3 a( T* b2 g. x! |+ t例子：
.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
/ Q, z# d) t4 E+ X1 I" m. i2 _* d
) k% h/ M" S: N.close;/*关闭文件*/
5 P2 H/ [, ]( ^- q
% q* m3 W7 Z# \! q; U" R) ]标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

0 G. `3 I8 I  [数值说明：
+ L, e5 Q7 k( f- |“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
5 g, M3 x1 v" N6 q, v“1010b”和“0b1010”是2进制数值
" Q! O% x/ S' F: m8 e( c/ I2 O6 W
equ说明：
格式：text equ value
说明：用一个text代替value
例子：
address1 equ 0x12345678
ldr r0,=address1
) o) t, m& Q* F.pool

函数说明：
8 K" [" Z9 q7 `  x4 j/ q
.open函数：
格式：
3 w( d" P3 n$ f% r- B* m5 K2 G6 W! S.open "ROM FileName",offset
! C6 x3 K* |6 e, z.open "Old FileName","New FileName",offset
说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
# \8 |9 O: i9 e( Y
3 `3 g: _4 r# C例子：
.open "1234.gba",0x08000000
1 q5 W. `: V0 R
.close函数和.closefile函数：
2 k+ s- y: k/ w格式：
.close
. t$ q% g( J7 h/ j! I.closefile
/ Q; _% X) c+ C+ e+ f. l说明：关闭文件。

.org函数和.orga函数：
( ~+ Y: C; e7 W+ s1 A# }6 F格式：
5 h" S3 c# P7 n6 z6 H0 p7 e.org RamAddress
8 d6 b# S3 P* z.orga FileAddress
% v* q- e% e( O% s! m) J7 p+ d$ E说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

.orga函数可指定ROM文件的输出地址。

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

3 m5 ]; m1 |& F% h- B* C; U1 w! I3 @.area函数
格式：
.area SizeEquation[,fill]
- Z4 W! \8 p. N% d# h) k.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
; d' Y- r( }$ y+ norg 0x100
* ?' O) p( B1 {, l# H.area 0x8
5 U! a+ U5 Q/ I4 qbyte 0x5,0x6,0x7,0x8
.endarea
" A1 d( T# |) a6 Q
* P, U1 `: w1 ~! \# i.align函数
2 H3 V* S+ Z; c) W格式：.align num
6 Z6 t/ Q/ n9 ~. x6 O$ [! i1 ?7 O) l说明：写零字节，num为零字节数量，用16进制表示。

.pool函数
格式：.pool
说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
# F8 ]: o8 O- z7 O6 W) M, s例子：
ldr r0,=0x12345678;
....
5 @5 X+ j3 F0 p( ].pool
, E+ f1 W; O+ D
.fill函数
/ K# l% a3 ~0 l格式：
& c8 _5 X; s% K$ U& ?* p.fill length[,value]
defs length[,value]
8 e9 T6 X6 K  B- C  {! H$ l说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。

" O. L4 k  K# o; |1 U' y.skip函数：
4 Z' j) [) d3 @; z格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

1 e" V9 k, S8 Q; A$ T4 {写单字节：
. n. w' R/ E+ E8 R& r. z.byte value[,...]
.db value[,...]
9 I+ y/ _! G2 j8 D0 V- v.ascii value[,...]
* Y2 r5 f  E' P3 e.asciiz value[,...]
dcb value[,...]
; {. T; w. j: Q" ~
写双字节：
.halfword value[,...]
.dh value[,...]
: ~" l0 p% u; A; K& pdcw value[,...]

" O& O5 o" B0 _+ |  m3 ~& v写四字节：
.word value[,...]
.dw value[,...]
( r( j% K$ S. y" ]! w* U4 w) ^) h9 `dcd value[,...]
  v/ f5 E8 ]" q0 s& D: M8 ~7 H
写doublewords：
.doubleword value[,...]
.dd value[,...]
5 u: s0 d! L& y( r6 {7 |" M5 z3 _dcq value[,...]

写浮点数：
2 n" K' e% o) A.float value[,...]
.double value[,...]
1 z& m/ h) M5 ?+ g% s& G
ARM的ARM模式和THUMB模式定义：
0 i3 W8 M" t& Z* s+ j) T.arm|ARM模式
.thumb|thumb模式

! @! c6 T  P" M% [; d, l设置架构：
.psx|PlayStation 1(MIPS R3000)
% r: ^& B% Q; ?! a! s" f.ps2|PlayStation 2(EmotionEngine)
- {, n9 {6 {" e" U7 h4 u8 v.psp|PlayStation Portable(Allegrex)
) z  g1 M' k; w8 n; @; R, ~5 T.n64|Nintendo 64(MIPS R4000)
4 I+ r" L5 p& D' ]$ y  d.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
.nds|Nintendo DS(ARM9,默认是ARM模式)
.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
.arm.big|
( M# |6 f" |& y7 M.arm.little|

常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。