查看“GamePi20”的源代码

<div class="tabber">
<div class="tabbertab" title="使用说明">
{{Product
|name = GamePi20
|images=<div class="tabber"><div class="tabbertab" title="套餐">[[File:GamePi20-1.jpg|360px |alt=GAME-HAT]]</div><div class="tabbertab" title="配件包">[[File:GamePi20-2.jpg|360px |alt=GAME-HAT]]</div></div>
|categories=
{{Category|树莓派游戏机}}
{{Category|树莓派}}
{{Category|IPS}}
{{Category|显示屏}}
|brand=Waveshare
|features=
* 树莓派游戏机
* 分辨率：320×240
|related=
{{Game-Pi-Related}}
}}

== '''产品特点''' ==
*支持Raspberry Pi Zero/Zero W/Zero WH
*采用2寸IPS屏，320×240分辨率，画质好，色彩鲜明，可视角度大
*支持RetroPie游戏系统和Recalbo游戏系统，配套有上千款经典游戏，只要TF卡够大，还能任性添加喜欢的游戏
*带充电电路，内置14500锂电池供电，方便携带，随时游戏
*板载电量指示灯，方便查看游戏机的电量
*板载喇叭和耳机接口，听听那熟悉的BGM

== '''快速入门''' ==
===组装说明===
*[[GamePi20 Assembly]]

=== '''硬件连接''' ===
# 将Raspberry Pi Zero/Raspberry Pi Zero W插到GamePi20扩展板中，并装到金属底盒。
# 装上导电胶垫和按键。最后盖上控制面板固定
您可以通过两种方法使用  GamePi20游戏机：方法一，使用预装驱动的镜像。方法二，给RetroPie系统安装驱动。

<font color=#FF0000>新手或者首次安装推荐安装预装驱动的镜像，镜像已做了大量优化，添加游戏ROM，直接可玩。</font>

=== '''方法一，使用预装驱动的镜像''' ===
1) 这里提供预装驱动的镜像，解压并把镜像写入到TF卡中（打开[https://{{SERVERNAME}}/w/upload/7/76/Win32DiskImager.zip Win32DiskImager.exe]软件，选择.img文件，点击「write」烧写镜像）。
*[https://pan.baidu.com/s/1V0RR-zthfBxCt5F45IzKNw  GamePi20启动镜像]------------提取码：q9ee

2) 烧写完成后，把卡插入树莓派上，并组装好游戏机。把开关从OFF拨到ON，正常LCD的背光会亮起，系统开始启动。由于Raspberry Pi 1/Zero/Zero W性能比较差，开机可能比较慢，需耐心等待。

#如果电池电量不足，将无法启动系统，此时可以通过micro USB线，连接5V 2A电源适配器到Power接口(开关旁边的Micro USB接口)，给GamePi20充电。充电时电量灯会闪烁。（支持边充边玩，但注意，在接上和断开电源适配器时，树莓派系统都会重新启动，玩游戏时注意要保存进度）
#如果电池有充足的电量，则GamePi15的LED会提示当前电量，并启动系统。

3) 一般操作
*对于retropie：
#进入到系统后，可以通过左边的方向键选择模拟器。这里选择Nintendo模拟器，按“A”确定。
#可以看到里面有很多游戏。选择你想玩的游戏，按“A”确定。等过场动画结束后，可以通过按"A"确定或按"Start"开始游戏。
#如果想退出当前游戏，可以同时按“Start"+"Select"。
#如果想调整音量大小，可以在非游戏状态下，按"Start"，选择“SOUND SETTINGS”，按"A"确定，通过左右方向键调节“SYSTEM VOLUME”，按"B"退出即可。
*对于recalbox：
#进入到系统后，可以通过左边的方向键选择模拟器。这里选择相应的模拟器，按“B”确定。
#可以看到里面有很多游戏。选择你想玩的游戏，按“B”确定。等过场动画结束后，可以通过按"A"确定或按"Start"开始游戏。
#如果想退出当前游戏，可以同时按“Start"+"Select"。
#如果想调整音量大小，可以在非游戏状态下，按"Start"，选择“SOUND SETTINGS”，按"B"确定，通过左右方向键调节“SYSTEM VOLUME”，按"A"退出即可。

==='''方法二，安装驱动'''===

===='''在retropie上安装驱动'''====
请在[https://retropie.org.uk/download/ retropie官网]下载最新版本的镜像（根据你的树莓派，选择对应的版本）。

[[File:Game-HAT-Manual01.jpg|500px]]

1) 将镜像文件下载到电脑上，并解压得到.img文件。

2) 将TF卡连接到电脑，打开[https://{{SERVERNAME}}/w/upload/7/76/Win32DiskImager.zip Win32DiskImager.exe]软件，选择第1步准备的.img文件，点击write烧写镜像。

3) 烧写完成后，将TF卡和USB键盘并联网(需要[[ETH/USB HUB HAT]])和HDMI显示器接入到树莓派上，把开关从OFF拨到ON，启动树莓派，进入系统后按键盘的F4，进入终端。（也可通过网络登录到终端控制界面）

4) 执行以下操作设置屏幕显示：
*打开编辑配置文件，启用一些模块<br />
<pre>
sudo nano /etc/modules
#添加如下：
spi-bcm2835
flexfb
fbtft_device
</pre>
在文件后面添加如下三个语句，第一行是确保屏幕的SPI已经启动并正在运行，第二个命令实际是启动 fbtft 模块。<br />
*新建另外一个配置文件，配置 fbtft<br />
<pre>
sudo nano /etc/modprobe.d/fbtft.conf
</pre>
*将下面语句添加到新建的空白文件中<br />
<pre>
options fbtft_device name=flexfb gpios=reset:27,dc:25,cs:8,led:24 speed=96000000 bgr=1 fps=60 custom=1 height=240 width=320
options flexfb setaddrwin=0 width=320 height=240 init=-1,0x11,-2,120,-1,0x36,0xA0,-1,0x3A,0x05,-1,0x21,-1,0x2A,0x00,0x01,0x00,0x3F,-1,0x2B,0x00,0x00,0x00,0xEF,-1,0xB2,0x0C,0x0C,0x00,0x33,0x33,-1,0xB7,0x35,-1,0xBB,0x1F,-1,0xC0,0x2C,-1,0xC2,0x01,-1,0xC3,0x12,-1,0xC4,0x20,-1,0xC6,0x0F,-1,0xD0,0xA4,0xA1,-1,0xE0,0xD0,0x08,0x11,0x08,0x0C,0x15,0x39,0x33,0x50,0x36,0x13,0x14,0x29,0x2D,-1,0xE1,0xD0,0x08,0x10,0x08,0x06,0x06,0x39,0x44,0x51,0x0B,0x16,0x14,0x2F,0x31,-1,0x29,-3
</pre>
<font color="#FF0000">
这里需要注意一下，这里是以options开头的两行语句。<br />
</font>
gpios=reset:27,dc:25,cs:8,led:24 这个设置屏幕对应的引脚<br />
height=240 width=320 设置屏幕分辨率大小。 <br />
*重启一下树莓派
<pre>
sudo reboot
</pre>
重启后，正常进入系统。后可以发现/dev/fb1设备。
显示用户界面只需将 fb0 上的内容直接拷贝到 fb1 上，fb0 和 fb1 同步。首先安装一下工具软件<br />
<pre>
sudo apt-get install cmake git
</pre>
使用 github 上的开源代码来实现这个功能，下载代码并安装。<br />
<pre>
cd ~
git clone https://github.com/tasanakorn/rpi-fbcp
cd rpi-fbcp/
mkdir build
cd build/
cmake ..
make
sudo install fbcp /usr/local/bin/fbcp
</pre>
设置开机启动<br />
<pre>
sudo nano /etc/rc.local
</pre>
设置开机启动。在 exit 0 前面添加 fbcp&。注意一定要添加"&"  后台运行，否则可能会出现系统不能启动的情况。<br />
[[file:1in3_lcd_fb5.png|900px]]<br />
最后在/boot/config.txt 文件中设置用户界面显示尺寸。<br />
<pre>
sudo nano /boot/config.txt
#添加
hdmi_force_hotplug=1
hdmi_cvt=640 480 60 1 0 0 0
hdmi_group=2
hdmi_mode=1
hdmi_mode=87
dtoverlay=pwm
</pre>
这里是设置系统界面分辨率，和设置PWM音频输出。<br />
启动树莓派后可以发现屏幕已经出现用户界面了。<br />

5) 安装按键摇杆操作，执行以下操作：
<source lang="c">
git clone https://github.com/waveshare/mk_arcade_joystick_rpi.git
cd mk_arcade_joystick_rpi
sudo ./install.sh 3
</source>
重启后，进入系统。

6) 长按"A"键（其它键也可以），会进入到按键映射界面。

按说明分别按对应的键，进行映射。长按“A”键（其它键也可以），可以跳过多余按键的映射。

所有按键映射完成后
#按"A"保存配置并配置界面。
#按"B"或"Start"键放弃配置并退出配置界面。

之后就可以正常玩游戏了。

===='''在recalbox上安装驱动'''====
请在[https://archive.recalbox.com/ recalbox官网]下载最新版本的镜像（根据你的树莓派，选择对应的版本）。

[[File:GamePi15-Manual-02.jpg]]

1) 将镜像文件下载到电脑上，并解压得到.img文件。

2) 将TF卡连接到电脑，打开[https://{{SERVERNAME}}/w/upload/7/76/Win32DiskImager.zip Win32DiskImager.exe]软件，选择第1步准备的.img文件，点击write烧写镜像。

3) 将TF卡和USB键盘并联网(需要ETH/USB HUB HAT)和HDMI显示器接入到树莓派上，把开关从OFF拨到ON，启动树莓派，进入系统后按键盘的F4，在按Alt+F2，输入帐号：root，密码：recalboxroot，进入终端。（也可通过网络登录到终端控制界面）

4) 执行以下操作设置屏幕显示：
<source lang="c">
mount -o remount, rw /boot
mount -o remount, rw /
</source>
执行这两条命令设置文件系统可写。

*打开编辑配置文件，启用一些模块<br />
<pre>
nano /etc/modules.conf
#添加如下：
flexfb
fbtft_device
</pre>
在文件后面添加如下两个语句，命令实际是启动 fbtft 模块。<br />
boot/config.txt添加下面语句，开启SPI
<pre>
dtparam=spi=on
</pre>
*新建另外一个配置文件，配置 fbtft<br />
<pre>
nano /etc/modprobe.d/fbtft.conf
</pre>
*将下面语句添加到新建的空白文件中<br />
<pre>
options fbtft_device name=flexfb gpios=reset:27,dc:25,cs:8,led:24 speed=96000000 bgr=1 fps=60 custom=1 height=240 width=320
options flexfb setaddrwin=0 width=320 height=240 init=-1,0x11,-2,120,-1,0x36,0xA0,-1,0x3A,0x05,-1,0x21,-1,0x2A,0x00,0x01,0x00,0x3F,-1,0x2B,0x00,0x00,0x00,0xEF,-1,0xB2,0x0C,0x0C,0x00,0x33,0x33,-1,0xB7,0x35,-1,0xBB,0x1F,-1,0xC0,0x2C,-1,0xC2,0x01,-1,0xC3,0x12,-1,0xC4,0x20,-1,0xC6,0x0F,-1,0xD0,0xA4,0xA1,-1,0xE0,0xD0,0x08,0x11,0x08,0x0C,0x15,0x39,0x33,0x50,0x36,0x13,0x14,0x29,0x2D,-1,0xE1,0xD0,0x08,0x10,0x08,0x06,0x06,0x39,0x44,0x51,0x0B,0x16,0x14,0x2F,0x31,-1,0x29,-3
</pre>
<font color="#FF0000">
这里需要注意一下，这里是以options开头的两行语句。<br />
</font>
gpios=reset:27,dc:25,cs:8,led:24 这个设置屏幕对应的引脚<br />
height=240 width=320 设置屏幕分辨率大小。 <br />
*重启一下树莓派
<pre>
 reboot
</pre>
重启后，正常进入系统。后可以发现/dev/fb1设备。
添加开机启动fbcp<br />
<pre>
nano /etc/init.d/rcS
</pre>
在文件最后面添加<br />
<pre>
fbcp &
</pre>
注意一定要添加"&"  后台运行，否则可能会出现系统不能启动的情况。<br />

修改recalbox.conf 配置文件，注意有时候保存了还是原来的状态，不修改这个进去游戏会没有显示<br />
<pre>
#global.videomode=CEA 4 HDMI
global.videomode=default

#global.ratio=auto
global.ratio=4/3
</pre>
最后在/boot/config.txt 文件中设置用户界面显示尺寸。<br />
<pre>
sudo nano /boot/config.txt
#添加
hdmi_force_hotplug=1
hdmi_cvt=640 480 60 1 0 0 0
hdmi_group=2
hdmi_mode=1
hdmi_mode=87
dtoverlay=pwm
</pre>
这里是设置系统界面分辨率，和设置PWM音频输出。<br />
启动树莓派后可以发现屏幕已经出现用户界面了。<br />

5) 设置GPIO按键
打开recalbox.conf 配置文件，找到如下部分，并修改为如下设置。
<pre>
# ------------ D2 - GPIO Controllers ------------ #
## GPIO Controllers
## enable controllers on GPIO with mk_arcarde_joystick_rpi (0,1)
controllers.gpio.enabled=1
## mk_gpio arguments, map=1 for one controller, map=1,2 for 2 (map=1,map=1,2)
controllers.gpio.args=map=5 gpio=12,20,21,13,26,16,23,4,6,17,22,5,-1
</pre>

== '''添加新游戏''' ==

本身我们镜像默认提供的游戏可能不是你感兴趣的，这时需要自行添加游戏。

注：这里仅说明retropie的添加方式，recalbox类似。

1) 由于大部分游戏容量很大，在添加游戏前，我们先进行文件系统扩展。

在配置界面选择RASPI-CONFIG，回车

[[File:Game-HAT-Manual03.jpg|600px]]

[[File:Game-HAT-Manual04.jpg|600px]]

选择7 Advanced Options -> A1 Expand Filesystem，回车-》Finish。(这个过程需要接上USB键盘进行操作)

[[File:Game-HAT-Manual05.jpg|600px]]

选择Ok，对系统进行重启。重启后，文件系统扩展完成。

2) 准备好相应的游戏ROMs。

这里推荐一个非常酷的网站：http://coolrom.com/

你可以通过PC机，在里面下载各种游戏ROMs。比如我们要玩Sony Playstation游戏，可以选择

[[File:Game-HAT-Manual06.png|600px]]

在里面找到你想玩的游戏，进行下载即可。例如：http://coolrom.com/roms/psx/39719/Tekken_3.php

点击此处进行下载。

[[File:Game-HAT-Manual07.png|600px]]

把下载好的文件解压，得到以下的ROMs

[[File:Game-HAT-Manual08.png|600px]]

3) 更新ROMs

网线接到树莓派上（树莓派需要和你的PC机在同一个局域网）。在RetroPie列表下找到SHOW IP，按"A"，可以查到当前树莓派的IP。如下图：

[[File:Game-HAT-Manual09.jpg|600px]]

在你的PC机上，打开相应的IP，如下图：

[[File:Game-HAT-Manual10.png|800px]]

把ROMs复制到相关的目录即可，如下图：

[[File:Game-HAT-Manual11.png|600px]]

之后在模拟器选择界面，按"Start"->QUIT->RESTART EMULATIONSTATION，按"A"确定。重启模拟器之后即可看到新加入的游戏。

那么就开启你的复古游戏机之旅吧！
</div>
<div class="tabbertab" title="资料">

==组装说明==
*[[GamePi20 Assembly]]

==原理图==
*[https://{{SERVERNAME}}/w/upload/d/de/GamePi20_Schematic.pdf GamePi20原理图]

==相关镜像==
*[https://pan.baidu.com/s/1Q9DFq4uk-Gj2ndP7o9SJJw Pi2/Pi3/Pi3+启动镜像]------------提取码：rhdw
==相关镜像==
{{Game-HAT-ROM}}
==软件==
{{RPI-LCD Software}}
==树莓派相关教程==
*[[DVK512_Datasheets|开发教程]]
{{Raspberry Pi Study}}


转到：[[#软件]]，[[#程序]]，[[#文档]]


</div>
== FAQ ==
<div class="tabbertab" title="FAQ">
{{FAQ|我自己做的系统，NEO-GEO的游戏玩不了，怎么办？|
把[[:File:neogeo.zip |neogeo.zip]]放到系统 bios/ 和 roms/neogeo/ 下面(注意:不要解压)，之后重启一下系统试试。
|||}}
</div>
<div class="tabbertab" title="售后">
{{Service06}}</div>