ARMIPS assembler使用说明

疾风之狼

1 T% p, ^$ T4 {8 K' c5 M) o- K" vARMIPS assembler是一款ARM/MIPS汇编工具，他是命令行工具，支持ARM7/ARM9/MIPS R3000/MIPS R4000
8 J, A) v' x. I& P" c
. f% q3 M7 F) z% Q# ]: o+ hARMIPS assembler作者是Kingcom,目前发展到0.9版本

Kingcom's website：http://aerie.wingdreams.net
" e: A+ n7 N% e% m& \7 d. `$ Z
ARMIPS assembler源代码可去https://github.com/Kingcom/armips获得
! Q4 d1 ]7 _# `; [* g  E
1 q. S& Z; H7 ~: `3 P3 z更新版本可去http://buildbot.orphis.net/armips获得
. I+ i' b: u1 G; P( |3 @
ARMIPS assembler特点支持加载ROM并自动编译代码到ROM，省了使用16进制编辑器复制代码进ROM，进行ROM HACK更方便了。

3 m7 R8 S" i, Z  H: c! rARMIPS命令行用法：

* z- T& |, z. z2 y" xUsage: armips [optional parameters] <FILE>
6 G: o$ T) Y4 V9 A4 v
Optional parameters:
-temp <TEMP>         Output temporary assembly data to <TEMP> file
7 B4 U6 F2 `6 p- F7 ^: M) ^ -sym  <SYM>          Output symbol data in the sym format to <SYM> file
-sym2 <SYM2>         Output symbol data in the sym2 format to <SYM2> file
-root <ROOT>         Use <ROOT> as working directory during execution
5 k3 P% e+ r1 u7 W. y: [* b -equ  <NAME> <VAL>   Equivalent to '<NAME> equ <VAL>' in code
-strequ <NAME> <VAL> Equivalent to '<NAME> equ "<VAL>"' in code
. e2 S9 d: `8 m1 f -erroronwarning      Treat all warnings like errors
' y2 M+ w" v9 V( g9 o6 B& _
" K, S* O: }- }% bFile arguments:
  y9 t+ n, @5 D4 @2 l <FILE>               Main assembly code file
9 ~6 O7 M2 I9 ?* V; E
-temp <TEMP>参数是将临时汇编数据输出到<TEMP>文件
. E9 n( {. H+ D( ]) `7 k- s-sym <SYM>参数是将sym格式符号输出到<SYM>文件，这格式支持no$psx和no$gba
$ I! Q; v1 W, W! X: S-sym2 <SYM2>参数是将sym2格式符号输出到<SYM2>文件，这格式支持pcsx2和ppsspp
; h% k! `2 D% h: ^-root <ROOT>参数是指定执行期间要使用的工作目录
! {8 s# S5 v: H; O-equ <NAME> <VAL>参数用法不明
& Z1 \4 Z( q' b; g6 ]-strequ <NAME> <VAL>参数用法不明
-erroronwarning参数是当出现任何警告时被视为错误，防止继续编译
/ \5 W7 A2 p2 p  N6 L
<FILE>是汇编代码文件，可用记事本之类编辑

注释说明：
! u7 Z4 }- a0 E2 C, p2 D7 l注释可在单行指令后面“;”和“//”添加
“/* */”式也接受

0 u" z- y2 {4 {8 a1 T0 X9 K例子：
; }3 v8 m0 i# V: H/ {, {.open"1234.gba",0x08000000;//打开1234.gba文件，并将起始地址定义为0x08000000
% p% p" M5 @4 P! B* h
9 M. ^! {1 v) {5 E2 }.close;/*关闭文件*/
  z9 c# A& o2 |( ]
标签说明：
标签名可以包含A~Z字母和数字、下划线。但是它不能以数字开头，所有标签名称不区分大小写。

- k! r* J5 O3 }5 ~# ^数值说明：
/ V* N) r/ g3 p( b) l; p( G“0xA”和“0Ah”是16进制数值
“0o12”和“12o”是8进制数值
3 I* m5 ?, p! h4 ]“1010b”和“0b1010”是2进制数值

! I/ f" h  f$ F$ ?$ V2 H, u# T8 K" Pequ说明：
格式：text equ value
说明：用一个text代替value
例子：
2 S' G; p' O* X4 W- ?0 Faddress1 equ 0x12345678
ldr r0,=address1
8 x2 `! t, f* g.pool

. X/ ?* H  D9 N& v; d. _9 ~函数说明：
% j  Y( j) H* H' s- d3 _- E
- M6 Q& W) n7 z8 n1 L: a# ^0 \8 @.open函数：
格式：
1 d" c; i- C6 u$ g" @' x3 V.open "ROM FileName",offset
.open "Old FileName","New FileName",offset
  K, n: [* o. @3 Q0 r4 b- L说明：.open函数打开ROM文件，并将ROM文件起始地址设置为offset地址。但结果指定了2个文件，汇编器会将文件复制到第二个路径。
2 K# |% ~: N* Q5 K/ j- E
例子：
.open "1234.gba",0x08000000

& h- j; P( ?2 @8 S3 e; |.close函数和.closefile函数：
1 S- p3 |) s, q5 V& F* @格式：
+ B/ `( {' F4 R/ y5 _/ Q; s% Z.close
.closefile
$ d$ l# b" {! d" F$ C+ w说明：关闭文件。
+ R& w: w( Q: w
2 ?0 b' u2 H3 c.org函数和.orga函数：
$ T% `( J* Q  N3 e; T- k格式：
# b( P5 Z8 c4 G& l.org RamAddress
# ~$ z6 a. h* }.orga FileAddress
% Z+ X- x# `+ e; Y. Q& A说明：
前面用.open函数设置过offset地址的话，那么可以用.org函数设置offset输出地址。

5 y1 H1 @+ R" V7 j5 ~0 h.orga函数可指定ROM文件的输出地址。
( |9 v/ T: B3 b. u/ @
.create函数和.createfile函数
格式：
.create "FileName",offset
.createfile "FileName",offset
' \9 B1 J  `, N说明：创建一个文件，如果文件是存在，他会覆盖掉。
, f; I3 X* k  A3 _  C
.area函数
格式：
.area SizeEquation[,fill]
.endarea
说明：如果你要向某地址写入一定字节数值，就用.area函数，SizeEquation是能写入最大字节数，超过就编译失败

例子：向0x100地址写入0x5,0x6,0x7,0x8单字节数据
org 0x100
. }7 P+ |) A8 N& |.area 0x8
. ~+ p: `6 b6 J$ t8 F9 g* Obyte 0x5,0x6,0x7,0x8
.endarea
1 {1 [- F# a+ o6 d% E
$ v! V& p# V( a  |.align函数
格式：.align num
" s$ S( L) p4 G; p说明：写零字节，num为零字节数量，用16进制表示。
6 B3 V8 K9 w) ?1 h! t2 H' L# ~
. z9 n. F% v* ~* n' `$ \1 @.pool函数
格式：.pool
$ r  B8 [4 P$ j+ P, E# G说明：如果代码中有“ldr rx,=value”,就要用.pool对齐。
例子：
ldr r0,=0x12345678;
....
5 }8 {9 `( |% O: @: y  J0 I  ~.pool
/ k% K2 m: _/ v' r
.fill函数
" P. ^) l, v4 l: f9 a7 A2 {格式：
/ b+ C0 y' y' X2 F+ ].fill length[,value]
1 Z3 @" i# h$ Sdefs length[,value]
7 h1 j9 y8 x  U) `* K说明：填充一定长度单字节数值，如果未指定value，而填充零字节数值；length和value用16进制表示。
, k% r$ d9 X. n! c2 `2 J7 h, b! I
.skip函数：
格式：.skip length
说明：跳过指定长度单字节数值，length用16进制表示。

+ N' J- z  v& y+ V3 z9 w写单字节：
$ @) ^# v6 H* m5 K- }0 g. y.byte value[,...]
.db value[,...]
  s2 H: y3 C, w: W$ o! |.ascii value[,...]
.asciiz value[,...]
dcb value[,...]
2 }! o6 O6 g: }
写双字节：
.halfword value[,...]
.dh value[,...]
dcw value[,...]

  K, w/ Q3 X5 t- n3 f' z写四字节：
.word value[,...]
& N% E6 q; x" x.dw value[,...]
dcd value[,...]

写doublewords：
% H# M5 ^: e4 Z) ^) A# N* Q.doubleword value[,...]
% j+ \2 b6 `9 Y2 d; h0 U.dd value[,...]
; D3 V/ Y# t$ I' m* _dcq value[,...]
3 ]! E# s1 U' C# `. R5 `0 ~
7 c% p0 f# i* @$ i4 t6 a  c写浮点数：
! g* p+ {3 B2 k- t7 r: p.float value[,...]
.double value[,...]

1 B' H5 g0 B8 g8 F0 wARM的ARM模式和THUMB模式定义：
.arm|ARM模式
.thumb|thumb模式

设置架构：
.psx|PlayStation 1(MIPS R3000)
.ps2|PlayStation 2(EmotionEngine)
.psp|PlayStation Portable(Allegrex)
.n64|Nintendo 64(MIPS R4000)
.rsp|Nintendo 64(RSP)
.gba|GameBoy Advance(ARM7,默认是thumb模式)
+ v2 _0 j; X0 U* o' m& I.nds|Nintendo DS(ARM9,默认是ARM模式)
, N& y( r& B( ~.3ds|Nintendo 3DS(ARM11,默认是ARM模式)
- r; _: \9 v2 M* ]" |# H9 w: D8 ~3 g.arm.big|
.arm.little|
! }; K$ E, ]6 L
) W  s0 J* A: j% d4 {常用函数就写这些了，还有大量函数说明没写，更多说明看readme.md吧。