查看“模板:Game-HAT-Manual”的源代码

== '''产品特点''' ==
*3.5寸屏IPS屏，480×320分辨率
*60帧游戏体验，告别画面丢失和卡顿
*适用于Raspberry Pi A+/B+/2B/3B/3B+/4B (Raspberry Pi Zero/Zero W/Zero WH需另配HDMI连接线)
*带充电电路，使用18650锂电池供电，方便携带，随时游戏
*板载电量指示灯，方便查看游戏机的电量
*板载喇叭和耳机接口，听听那熟悉的BGM

== '''演示视频''' ==
<html>
<iframe src="//player.bilibili.com/player.html?aid=73932260&bvid=BV1YE411b7dA&cid=126471637&page=1" scrolling="no" border="0" frameborder="no" framespacing="0" allowfullscreen="true" style="width:680px;height:500px;"> </iframe>
</html>

== '''快速入门''' ==
=== '''硬件连接''' ===
# 连接GPIO接口。
# 连接HDMI接口。把HDMI连接器接入屏幕和主板的HDMI接口。
#* Raspberry Pi Zero/Raspberry Pi Zero W需另配HDMI连接线进行连接。
# 把Game HAT的Battery开关拨到OFF，接上18650电池。

您可以通过两种方法使用Game HAT：方法一，使用预装驱动的镜像。方法二，给系统安装驱动。

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

2) 烧写完成后，把卡插入树莓派上，把Battery开关拨到ON。正常就会启动系统了。

#如果电池电量不足，将无法启动系统，此时可以通过micro USB线，连接5V 3A电源适配器到Power接口，给Game HAT充电。充电时电量灯会闪烁。（支持边充边玩，但注意，在断开电源适配器时，树莓派系统会重新启动）
#如果电池有充足的电量，则Game HAT的LED会提示当前电量，并启动系统。

3) 进入到系统后，可以通过摇杆选择模拟器。这里选择Nintendo模拟器，按“A”确定。

4) 可以看到里面有很多游戏。选择你想玩的游戏，按“A”确定。等过场动画结束后，可以通过按"A"确定或按"Start"开始游戏。

5) 如果想退出当前游戏，可以同时按“Start”+"Select"。

6) 如果想调整音量大小和LCD的显示亮度，可以通过Game HAT右边(侧面)4个按键进行控制。先按Menu打开OSD菜单，通过Up/Left和Down/Right选择要修改的项目，通过Menu键确定，进行修改。最后通过Exit，退出OSD菜单。

==='''方法二，安装驱动'''===
{{GAME-HAT-DEVICE}}
<font color=#FF0000> 注：以上驱动暂不支持retropie-v4.7版本，微雪团队正在更新中。</font>

请在[https://retropie.org.uk/download/ retropie官网]下载镜像（根据你的树莓派，选择对应的版本）。

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

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

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

3) 烧写完成后，将Game HAT驱动复制到TF卡根目录（也可以用U盘或网络将驱动文件复制到镜像的文件系统中）。

4) 用写字板打开TF卡根目录的config.txt文件，在config.txt最后加入以下代码，保存并安全弹出TF卡。
<source lang="c">
hdmi_force_hotplug=1
hdmi_group=2
hdmi_mode=87
hdmi_cvt=640 480 60 1 0 0 0
</source>

5) 将TF卡和USB键盘接入到树莓派上，打开Battery，启动树莓派，进入系统后按键盘的F4，进入终端。

6) 前面已经把树莓派驱动复制到/boot目录下，执行以下操作：
<source lang="c">
sudo tar xzvf /boot/Game-HAT-*.tar.gz
cd Game-HAT/
sudo ./Game-HAT
</source>
重启后，即可正常进入系统。

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

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

[[File:Game-HAT-Manual02.jpg|800px]]

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

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

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

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

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"确定。重启模拟器之后即可看到新加入的游戏。

那么就开启你的复古游戏机之旅吧！

== '''WIFI联网''' ==

=== '''在retropie和raspbian系统上设置WIFI联网''' ===
*将以下文件下载，解压出wpa_supplicant.conf文件，打开wpa_supplicant.conf文件，修改WIFI的SSID和密码，保存文件。
[[:File:wpa_supplicant.zip|wpa_supplicant.zip]]
*将修改后的wpa_supplicant.conf文件放到boot目录下，重启树莓派即可。（把TF卡通过读卡器接到PC机上，打开的根目录即为boot目录）

=== '''在recalbox系统上设置WIFI联网''' ===
*按START进入主菜单
*选择网络设置
*将“启用WIFI”更改为“开”
*选择“ WIFI SSID”，然后输入您的网络名称
*选择“ WIFI 密码”，然后输入您的网络密码
[[File:GamePi-Manual-01.jpg|400px]]
*WiFi连接后，RecalBox将立即检查系统更新：
[[File:GamePi-Manual-02.jpg|400px]]

== '''其它常用操作''' ==

请查看 [https://retropie.org.uk/docs/ retropie使用说明] 
==Recalbox 使用方法==
*下载最新的Recalbox系统
https://forum.recalbox.com/topic/16576/february-2019-beta-version/2 

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

*将镜像烧写到SD卡上，同时配置config.txt文件
在config.txt文件末尾添加配置语句
<pre>
hdmi_force_hotplug=1
avoid_warnings=1
max_usb_current=1
hdmi_group=2
hdmi_mode=1
hdmi_mode=87
hdmi_cvt 640 480 60 6 0 0 0
hdmi_drive=2
display_rotate=0
</pre>
*通过SSH登录系统（树莓派需要联网）
账号：root 密码：recalboxroot
修改recalbox文件
<pre>
nano /recalbox/share/system/recalbox.conf
</pre>
将其中的语句controllers.gpio.enabled=0改为controllers.gpio.enabled=1

将语句controller.gpio.args=map=1,2改为controllers.gpio.args=map=4 gpio=5,6,13,19,21,4,26,12,23,20,16,18,-1
*修改recalbox-config.sh文件
<pre>
mount -o remount, rw /
nano /recalbox/scripts/recalbox-config.sh
</pre>
在<br />
mode="$2"<br />
extra1="$3"<br />
extra2="$4"<br />
后面添加一行代码 extra3="$5"  <br />
找到如下部分<br />
[[File:Game-HAT-Manual13.jpg|600px]]<br />
把  map="$extra2"  改为 map="$extra2 $extra3"
*保存并重启树莓派。重新进入系统后，长按Gamer HAT的任意按键进入按键重映射。正常完成重映射即可。
== '''接口定义''' ==

以下标识为“NC”的引脚表示LCD没有占用该引脚，用户可用于其它应用。

{| class="wikitable"
|-
! 引脚号 !! 标识 !! 描述
|-
| 1 || 3.3V || 电源正(3.3V电源输入)
|-
| 2 || 5V || 电源正(5V电源输入)
|-
| 3 || NC || NC
|-
| 4 || 5V || 电源正(5V电源输入)
|-
| 5 || NC || NC
|-
| 6 || GND || 电源地
|-
| 7 || Select || BCM=4，WPI=7
|-
| 8 || NC || NC
|-
| 9 || GND || 电源地
|-
| 10 || NC || NC
|-
| 11 || NC || NC
|-
| 12 || TL || BCM=18，WPI=1
|-
| 13 || NC || NC
|-
| 14 || GND || 电源地
|-
| 15 || NC || NC
|-
| 16 || TR || BCM=23，WPI=4
|-
| 17 || 3.3V || 电源正(3.3V电源输入)
|-
| 18 || NC || NC
|-
| 19 || NC || NC
|-
| 20 || GND || 电源地
|-
| 21 || NC || NC
|-
| 22 || NC || NC
|-
| 23 || NC || NC
|-
| 24 || NC || NC
|-
| 25 || GND || 电源地
|-
| 26 || NC || NC
|-
| 27 || NC || NC
|-
| 28 || NC || NC
|-
| 29 || UP || BCM=5，WPI=21
|-
| 30 || GND || GND
|-
| 31 || DOWN || BCM=6，WPI=22
|-
| 32 || B || BCM=12，WPI=26
|-
| 33 || LEFT || BCM=13，WPI=23
|-
| 34 || GND || GND
|-
| 35 || RIGHT || BCM=19，WPI=24
|-
| 36 || X || BCM=16，WPI=27
|-
| 37 || A || BCM=26，WPI=25
|-
| 38 || Y || BCM=20，WPI=28
|-
| 39 || GND || GND 
|-
| 40 || START || BCM=21，WPI=29
|}