C51贪吃蛇移植到GBA上01-GBA游戏编译环境以及代码移植注意点

实机效果

这个是用GBA烧录卡在NDSL上运行的样子。下方的按键说明是原来C51平台上用的（那个开发板只有3个按键），后面会删掉。

贪吃蛇的源码已开源（EmbSnake）

https://gitee.com/slipperstree/EmbSnake

EmbSnake是一款贪食蛇游戏。主要面向嵌入式环境，模块化设计，分离了设备相关性。只需要针对特定的设备实现一些必要的函数就可以很快移植到你的平台上。根据需要可剪裁各种功能以适应各种MCU的可用储存空间（ROM）。

包含了C51某开发板的一个实现版本。这个GBA版也是基于那个版本移植的。等GBA版本移植的差不多了也会推到仓库中作为sample之一。

GBA游戏编译环境

安装devkitPro （ https://devkitpro.org/ ）
代码编辑推荐vscode，通过配置可以实现配合GBA模拟器打断点调试（ https://www.youtube.com/watch?v=Rj0lf46iljc ）

使用tonclib框架

tonclib是基于devkitPro编译环境的一套第三方GBA框架，包装了很多功能函数。而且，个人觉得tonc的教程是最完整的。
tonclib相关资源
- 示例ROM (v1.4.2): tonc-bin.zip
- 示例源码 (v1.4.2): tonc-code.zip
- 官网教程 (v1.4.2): tonc-website
- 纯文字版教程 (v1.4.2): tonc-text.zip
- 电子书格式版教程 (v1.4): tonc.chm
- PDF版教程 (v1.4.2): tonc.pdf
使用tonc注意点
- 编译tonc的示例源码你可能会遇到这个错误 tte_main.c:(.text+0x240): undefined reference to __ctype_ptr__ 这是因为预编译好的tonclib二进制文件不适用最新版本的devkitPro你需要手动编译一次tonclib文件夹。不用害怕，进入code/tonclib文件夹后执行一次make就好了。
- 你还可能碰到这个错误: make: gbafix: No such file or directory 这是因为tonc的makefile里面用到了一个外部工具gbafix用于修复gba文件的头部使其能在gba硬件上运行。这个小工具的位置在devkitPro安装路径下的tools/bin目录中。你只要在makefile顶部添加一行 PATH := $(DEVKITPRO)/tools/bin:$(PATH)

代码移植注意点

idata，xdata关键字需要删掉。直接定义内存即可，GBA有32K内存肯定够用了
code关键字需要改成const。大多是用于点阵字库定义之类的不会变化的大数组。

C51驱动液晶一般使用的颜色格式为RGB565，需要改成GBA的BGR555格式。为方便修改，博主写了一个小工具可以从RGB565转换成GBR555。（附小工具的c语言源码，有需要的请自行编译）

#include <stdio.h>
#include <stdlib.h>
char buf[10];
int r565,g565,b565;
float r555,g555,b555;
int bgr555;
int main(){
    printf("input RGB565 color(ex. f800):");
    scanf("%s", buf);
    int number = (int)strtol(buf, NULL, 16);
    r565 = number>>11;
    g565 = (number>>5) & 0xbff; //0000 0111,111 11111
    b565 = number & 0x1f; // 000 11111
    g555 = g565 * 0x1f / 0x3f;
    bgr555 = b565<<10 | ((int)g555)<<5 | r565;
    printf("GBA-Color-Format BGR555= 0x%04x\n", bgr555);
    return 0;
}

延时函数避免被优化掉需要加上不优化声明，如下

#pragma GCC optimize(0)
void delay_ms(u16 n)
    u16 x,y;
    for(x=n;x>0;x--)
        for(y=110;y>0;y--);
            C51贪吃蛇移植到GBA上01-GBA游戏编译环境以及代码移植注意点
            芒果 • 2022 年 04 月 04 日     
            <h2>实机效果</h2><p><img src="/usr/uploads/2022/04/1842985417.jpg" alt="" title="" style=""></p><p>这个是用GBA烧录卡在NDSL上运行的样子。下方的按键说明是原来C51平台上用的（那个开发板只有3个按键），后面会删掉。</p><h2>贪吃蛇的源码已开源（EmbSnake）</h2><p><span class="external-link"><a class="no-external-link" href="https://gitee.com/slipperstree/EmbSnake" target="_blank"><i data-feather="external-link"></i>https://gitee.com/slipperstree/EmbSnake</a></span></p><blockquote>EmbSnake是一款贪食蛇游戏。主要面向嵌入式环境，模块化设计，分离了设备相关性。只需要针对特定的设备实现一些必要的函数就可以很快移植到你的平台上。根据需要可剪裁各种功能以适应各种MCU的可用储存空间（ROM）。</blockquote><p>包含了C51某开发板的一个实现版本。这个GBA版也是基于那个版本移植的。等GBA版本移植的差不多了也会推到仓库中作为sample之一。</p><h2>GBA游戏编译环境</h2><ul><li>安装devkitPro （<span class="external-link"><a class="no-external-link" href="https://devkitpro.org/" target="_blank"><i data-feather="external-link"></i>https://devkitpro.org/</a></span>）</li><li>代码编辑推荐vscode，通过配置可以实现配合GBA模拟器打断点调试 （<span class="external-link"><a class="no-external-link" href="https://www.youtube.com/watch?v=Rj0lf46iljc" target="_blank"><i data-feather="external-link"></i>https://www.youtube.com/watch?v=Rj0lf46iljc</a></span>）</li></ul><h2>使用tonclib框架</h2><ul><li>tonclib是基于devkitPro编译环境的一套第三方GBA框架，包装了很多功能函数。而且，个人觉得tonc的教程是最完整的。</li><li>tonclib相关资源</li><li><ul><li>示例ROM (v1.4.2): <span class="external-link"><a class="no-external-link" href="https://www.coranac.com/files/tonc-bin.zip" target="_blank"><i data-feather="external-link"></i>tonc-bin.zip</a></span></li><li>示例源码 (v1.4.2): <span class="external-link"><a class="no-external-link" href="https://www.coranac.com/files/tonc-code.zip" target="_blank"><i data-feather="external-link"></i>tonc-code.zip</a></span></li><li>官网教程 (v1.4.2): <span class="external-link"><a class="no-external-link" href="https://www.coranac.com/tonc/text/toc.htm" target="_blank"><i data-feather="external-link"></i>tonc-website</a></span></li><li>纯文字版教程 (v1.4.2): <span class="external-link"><a class="no-external-link" href="https://www.coranac.com/files/tonc-text.zip" target="_blank"><i data-feather="external-link"></i>tonc-text.zip</a></span></li><li>电子书格式版教程 (v1.4): <span class="external-link"><a class="no-external-link" href="https://www.coranac.com/files/tonc.chm" target="_blank"><i data-feather="external-link"></i>tonc.chm</a></span></li><li>PDF版教程 (v1.4.2): <span class="external-link"><a class="no-external-link" href="https://www.coranac.com/files/tonc.pdf" target="_blank"><i data-feather="external-link"></i>tonc.pdf</a></span></li></ul></li><li>使用tonc注意点</li><li><ul><li>编译tonc的示例源码你可能会遇到这个错误 <code>tte_main.c:(.text+0x240): undefined reference to __ctype_ptr__</code>这是因为预编译好的tonclib二进制文件不适用最新版本的devkitPro你需要手动编译一次tonclib文件夹。不用害怕，进入code/tonclib文件夹后执行一次make就好了。</li><li>你还可能碰到这个错误: <code>make: gbafix: No such file or directory</code>这是因为tonc的makefile里面用到了一个外部工具gbafix用于修复gba文件的头部使其能在gba硬件上运行。这个小工具的位置在devkitPro安装路径下的tools/bin目录中。你只要在makefile顶部添加一行<code>PATH := $(DEVKITPRO)/tools/bin:$(PATH)</code></li></ul></li></ul><h2>代码移植注意点</h2><ul><li>idata，xdata关键字需要删掉。直接定义内存即可，GBA有32K内存肯定够用了</li><li>code关键字需要改成const。大多是用于点阵字库定义之类的不会变化的大数组。</li><li><p>C51驱动液晶一般使用的颜色格式为RGB565，需要改成GBA的BGR555格式。为方便修改，博主写了一个小工具可以从RGB565转换成GBR555。（附小工具的c语言源码，有需要的请自行编译）</p><pre><code class="lang-cpp">#include &lt;stdio.h&gt;
#include &lt;stdlib.h&gt;
char buf[10];
int r565,g565,b565;
float r555,g555,b555;
int bgr555;
int main(){
    printf(&quot;input RGB565 color(ex. f800):&quot;);
    scanf(&quot;%s&quot;, buf);
    int number = (int)strtol(buf, NULL, 16);
    r565 = number&gt;&gt;11;
    g565 = (number&gt;&gt;5) &amp; 0xbff; //0000 0111,111 11111
    b565 = number &amp; 0x1f; // 000 11111
    g555 = g565 * 0x1f / 0x3f;
    bgr555 = b565&lt;&lt;10 | ((int)g555)&lt;&lt;5 | r565;
    printf(&quot;GBA-Color-Format BGR555= 0x%04x\n&quot;, bgr555);
    return 0;
}</code></pre></li><li><p>延时函数避免被优化掉需要加上不优化声明，如下</p><pre><code class="lang-cpp">#pragma GCC optimize(0)
void delay_ms(u16 n)
    u16 x,y;
    for(x=n;x&gt;0;x--)
        for(y=110;y&gt;0;y--);
}</code></pre></li></ul>