原說明文件下載【如何在Win32系統上用GCC開發GBA應用軟體】How To Setup the Enviroment?
．原撰文作者：Anders Linden
．中文翻譯：HungJia
原說明文件下載
序言
這份文件，是給所有想在Win32系統上用GCC開發GBA應用程式的使用者導引，簡單來說就是開發環境設定。
安裝
第一個步驟即是安裝DevKit Advance，DevKit Advance是GCC的一個版本，它可以編出支援Arm處理器的應用程式(軟體)。
順道一提，DevKit Advance的作者是Jason Wilkins，網站位址有更動過，請注意。
你可以先到作者網站下載DevKit Advance(新站)http://devkitadv.sourceforge.net/download.html (下載頁面)
http://devkitadv.sourceforge.net/ (作者首頁)要下載的檔案清單如下：
�� agb-win-core-r5.zip
�� agb-win-binutils-r4.zip
�� agb-win-gcc-r4.zip
�� agb-win-newlib-r4.zip
�� agb-win-libstdcpp-r4.zip (If you want to be able to use the c++ compiler g++).
�� agb-win-patch-r4.zip
(建議先Download以上六檔案即可)
安裝步驟一、
下載完成後，將所有的檔案解壓縮( Unzip )到同一個資料匣內。要注意的是，agb-win-patch-r4.zip要放在最後一個解壓縮，因為它會用覆蓋的方式來更新某些資料。建議你將資料安裝在根磁碟槽裡 ( 一般來說為C:\ )C:\devkitadv
所有資料夾裡的檔案如下圖 -
安裝步驟二、
接下來我們要修改環境變數路徑( Environment Variable Path)。在修改先，請先記住你DevKitAdv安裝的位址(例：c:\devkitadv)。修改的方法相當簡單。在「我的電腦」上按右鍵，選擇「內容」，點選「進階」頁，再查看「環境變數」。
如圖。
你可以看到二種變數，一是使用者變數，一為系統變數。還有二個設定。
( I )
將在系統變數中的「Path變數」做一點修改。點選Path，按編輯，在變數值最後一行加上DevKitAdv\bin這個路徑。因為gcc compiler放在裡頭。另外要注意的是，不同的參數要用分號隔開。例："C:\Program Files\Symantec\Norton Ghost 2003\";c:\devkitadv\bin
( II )
在系統變數新增一變數，名稱為DevKitAdv，內容填devkitadv安裝位址。
註：如果你新增在使用者變數裡，當你不是用你身份登入時，當然的也就看不到你所設定的變數路徑囉。
到這裡，環境變數設定大致上就完成了。你可以開一個Dos命令窗來測試看設定有沒有發生效用。下一個「gcc」命令看看，沒問題的話會出現
gcc: no input files
但如果你看到：
‘gcc’不是內部或外部命令、可執行的程式或批次檔。回頭去檢查一下安裝是否有發生小錯誤吧。
開始新的Projcet時，你還需要將下面二個檔案和專案內容(程式)放在一起。
�� Lnkscript
�� Crt0.s
下載點一：http://www.devrs.com/gba/files/crtls.zip (難下載)
下載點二：http://www.suddenpresence.com/bbatutorial/chapter02/crtls.zip
(Jeff Frohwein's crt0.s and lnkscript)
每次開始設計前還有什麼要注意的。
先建立個資料夾存放程式檔案，除了lnkscript和crt0.s之外。還有二個檔案要放進去，分別是crtbegin.o和crtend.o。
複製到資料夾的時候要注意其是否為正確的版本。設計GBA的程式時可以有三種格式：ARM、THUMB、Interwork，三者有何差異呢？
ARM有很多指令，因為它是有著32位元記憶體存取能力，所以執行效率很好。缺點是code的長度會大點了。每個運算(一個指令)會用掉四個bytes (ARM Format)，若是THUMB則縮減成2bytes
如果你寫的是ARM Fromat的程式，將下面二個檔案Copy到Project資料夾中
• e:\devkitadv\lib\gcc-lib\arm-agb-elf\3.0.2\crtbegin.o and
• e:\devkitadv\lib\gcc-lib\arm-agb-elf\3.0.2\crtend.o若你寫的是THUMB Fromat的程式，則copy下列二個檔案。
• e:\devkitadv\lib\gcc-lib\arm-agb-elf\3.0.2\thumb\crtbegin.o and
• e:\devkitadv\lib\gcc-lib\arm-agb-elf\3.0.2\thumb\crtend.o什麼又是Interwork呢？因為我自己也沒有使用過，所以這裡就多提，我只知道它是ARM和THUMB格式的結合。如果你想用Interwork Format，則copy下列二個檔案。
• e:\devkitadv\lib\gcc-lib\arm-agb-elf\3.0.2\interwork\crtbegin.o and
• e:\devkitadv\lib\gcc-lib\arm-agb-elf\3.0.2\interwork\crtend.o
一個程式範例
這範例的內容大概包含了，簡單紅色底圖，用A、B鍵控制白色字標。
將crtbegin.o和crtend.o複製到程式資料夾( Arm Format )。typedef unsigned short u16;
typedef unsigned int u32;
#define RGB16(r,g,b) ((r)+(g<<5)+(b<<10))
#define screenbuffer ((u16 *)0x6000000)
#define REG_DISPCNT *(u32*)0x4000000
#define MODE3 0x3
#define BG2_ENABLE 0x400
#define REG_KEYS *(volatile u16*)0x4000130
#define REG_VCOUNT *(volatile u16*)0x4000006
#define KEY_A 1
#define KEY_B 2void AgbMain()
{
int i;
u16 keys;
int position=0;
REG_DISPCNT=MODE3 | BG2_ENABLE;
for (i=1; i<240*160; i++)
screenbuffer[i]=RGB16(31,0,0);
screenbuffer[0]=RGB16(31,31,31);
for (;;){
while (REG_VCOUNT!=159);
while (REG_VCOUNT!=160);
keys=REG_KEYS;
if ((keys & KEY_B)==0)
{
if (position>0)
{
screenbuffer[position]=RGB16(31,0,0);
screenbuffer[--position]=RGB16(31,31,31);
}
}
if ((keys & KEY_A)==0)
{
if (position<239)
{
screenbuffer[position]=RGB16(31,0,0);
screenbuffer[++position]=RGB16(31,31,31);
}
}
}
}除此之外，還需要寫一個MakeFile。在安裝Devkit時同時也包含了make應用程式在裡頭。
MakeFile的內容大致如下。
test.gba: test.elf
objcopy -O binary test.elf test.gbatest.elf: crt0.o main.o
ld -L${DEVKITADV}/lib/gcc-lib/arm-agb-elf/3.0.2 \
-L${DEVKITADV}/arm-agb-elf/lib \
crt0.o main.o -o test.elf
main.o: main.c
gcc -c -marm main.c
crt0.o: crt0.s
as crt0.s -o crt0.o
在MakeFile裡，我們可以看到之前設定的DEVKITADV環境變數發生了作用，，即使重新裝一次Devkit，Makefile還是可以重新套用，需要更改的地方可能只有「3.0.2」關於GCC版本的部分。ld可以告訴電腦去找到我們引用的libaries位置。
如果你編輯是Arm Format的程式，ld後找到的是Arm Format的library的位址。
如下~~
test.elf: crt0.o main.o
ld -L${DEVKITADV}/lib/gcc-lib/arm-agb-elf/3.0.2 \
-L${DEVKITADV}/arm-agb-elf/lib \
crt0.o main.o -o test.elf反之，若為Thumb Format的程式，得做點小小更動。
test.elf: crt0.o main.o
ld -L${DEVKITADV}/lib/gcc-lib/arm-agb-elf/3.0.2/thumb \
-L${DEVKITADV}/arm-agb-elf/lib/thumb \
crt0.o main.o -o test.elf若為Interwork，則用。
test.elf: crt0.o main.o
ld -L${DEVKITADV}/lib/gcc-lib/arm-agb-elf/3.0.2/interwork \
-L${DEVKITADV}/arm-agb-elf/lib/interwork \
crt0.o main.o -o test.elfmake設定好後，只需要執行make應該就能編譯了。
HungJia的話：
我是用另一種編譯方法，就是make.bat，我發現只要將上頭main.c那個程式的主函數名稱AgbMain()改成main.c，用下面的make.bat來做也是可以成功的。不過我只是好運剛好編成功而已，實際上我還是不知道二者的差異在那，可見得功夫沒學到家，有待更進一步研究。gcc -o test.elf main.c -lm
objcopy -O binary test.elf test.gba
pause
關於GBA.h
現在可以開始寫程式了。你可能會需要有一堆定義可以讓你引用的標頭檔，名為gba.h。在別人的DEMO作品中，你可以發現內容不同的gba.h，通常都是Demo程式會用到的定義，gba.h裡才會放。如果你想要現成或是好的gba.h檔，可以在網路上或在www.gba.org都找到。
你也可以量身打造自己的gba.h，這樣寫起程式來會更有效率。
最後更新二零零三年二月二十七日&Edit By HungJia.
