GamePi13

来自Waveshare Wiki
跳转至： 导航、 搜索

产品简介

  • 提供树莓派系列和RP2040-PiZero系列教程。
  • 采用1.3寸IPS屏，240×240分辨率，画质好，色彩鲜明，可视角度大。
  • 支持RetroPie游戏系统和Recalbox游戏系统，配套有上千款经典游戏，只要TF卡够大，还能任性添加喜欢的游戏。
  • 板载PWM音频输出喇叭和耳机接口，听听那熟悉的BGM。

产品参数

  • 工作电压： 3.3V
  • 通信接口： SPI
  • 屏幕类型： IPS
  • 控制芯片： ST7789
  • 分辨率： 240(H)RGB x 240(V)
  • 显示尺寸： 23.4（H）x 23.4（V）mm
  • 像素大小： 0.0975（H）x 0.0975（V）mm
  • 产品尺寸: 65 x 31(mm)

功能引脚

功能引脚 Board物理引脚序号 BCM编码 描述
5V 2/4 / 5V电源正
3.3V 1 / 3.3V电源正
GND 6/9/30/34 / 电源地
R 8 14 按键TR
L 16 23 按键TL
X 10 15 按键X
Y 32 12 按键Y
B 38 20 按键B
A 40 21 按键A
Up 29 5 按键Up
Left 36 16 按键Left
Down 31 6 按键Down
Right 33 13 按键Right
Select 35 19 按键Select
Start 37 26 按键Start
DC 22 25 LCD显示数据/命令选择引脚
SCLK 23 11 LCD的SPI时钟
CS 24 8 LCD使能选择引脚;低电平使用，高电平禁用
MOSI 19 10 LCD的SPI数据输入
RST 13 27 LCD的复位, 低电平有效
AUDIO 12 18 音频输出

Raspberrypi使用教程

预安装镜像

对于新手小白，我们提供了预安装镜像方便您更快上手使用模块，你可以烧写完预安装镜像后，将TF卡插入树莓派，上电即可直接使用。

具体配置过程如下步骤。

官方系统

Bookworm系统显示配置

适用于Rpi4 & Rpi5

配置SPI显示器：
 下载完系统后，将SD卡插在PC上，下载复制waveshare13.dtbo到/boot/overlays/目录
编辑config.txt配置文件：

  • 屏蔽KMS和双屏显示，如下图

FBCP CLOSE.jpg

  • 在文件最后面添加下列配置
dtparam=spi=on
dtoverlay=waveshare13
dtoverlay=audremap18
hdmi_force_hotplug=1
max_usb_current=1
hdmi_group=2
hdmi_mode=87
hdmi_cvt 480 480 60 6 0 0 0
hdmi_drive=2
display_hdmi_rotate=0

如果需要搭配棱镜使用，可以将末尾的“display_hdmi_rotate=0”改为“display_hdmi_rotate=0x10002”，详情见#参数介绍
设置CLI自动登录： 

sudo raspi-config nonint do_boot_behaviour B2

Note1：确保树莓派的用户名为pi否则无法正常自动登录
切换为X11： 

sudo raspi-config nonint do_wayland W1
sudo reboot

Note2：设置上述所有配置后，系统每次重启期间都会变久一点，SSH也需要等待一会儿才能进入；
下载编译安装fbcp： 

sudo apt install libraspberrypi-dev -y
sudo apt-get install unzip -y
sudo apt-get install cmake -y
sudo wget https://www.waveshare.net/w/upload/6/66/Rpi-fbcp.zip
sudo unzip ./Rpi-fbcp.zip
cd rpi-fbcp/
sudo rm -rf build
sudo mkdir -m 777 ./build
cd build
sudo cmake ..
sudo make
sudo install fbcp /usr/local/bin/fbcp

设置开机自启动：

  • 打开.bash_profile文件，如果没有.bash_profile文件则自己创建一个
sudo nano ~/.bash_profile
  • 把以下代码加到.bash_profile文件最下面
if [ "$(cat /proc/device-tree/model | cut -d ' ' -f 3)" = "5" ]; then
    # rpi 5B configuration
    export FRAMEBUFFER=/dev/fb1
    startx  2> /tmp/xorg_errors
else
    # Non-pi5 configuration
    export FRAMEBUFFER=/dev/fb0
    fbcp &
    startx  2> /tmp/xorg_errors
fi

上述配置重启生效 

sudo reboot

适用于全系列树莓派

必须是基于bookworm-lite版本操作，64位 lite、32位 lite
配置SPI显示器：
下载完系统后，将SD卡插在PC上，下载复制waveshare13.dtbo到/boot/overlays/目录
编辑config.txt文件：

  • 屏蔽下图对应的语句

FBCP CLOSE.jpg

  • 在文件最后面添加下列配置
dtparam=spi=on
dtoverlay=waveshare13
dtoverlay=audremap18
hdmi_force_hotplug=1
max_usb_current=1
hdmi_group=2
hdmi_mode=87
hdmi_cvt 480 480 60 6 0 0 0
hdmi_drive=2
display_hdmi_rotate=0
arm_freq=1200
core_freq=500
over_voltage=2
gpu_freq=700
force_turbo=1

如果需要搭配棱镜使用，可以将“display_hdmi_rotate=0”改为“display_hdmi_rotate=0x10002”，详情见#参数介绍
 下载必要的软件：

  • 更新系统
sudo apt update && sudo apt upgrade && sudo apt full-upgrade -y
  • 安装xorg服务
sudo apt-get install --no-install-recommends xserver-xorg -y
sudo apt-get install --no-install-recommends xinit -y
  • 安装桌面管理器
sudo apt install lightdm -y
  • 安装树莓派官方GUI
sudo apt install raspberrypi-ui-mods -y
  • 安装浏览器(可选)
sudo apt install chromium-browser -y
  • 安装音乐播放器(可选)
sudo apt install vlc -y
  • 安装git(可选)
sudo apt install git -y

下载编译安装fbcp：
打开树莓派终端，执行：

sudo apt install libraspberrypi-dev -y
sudo apt-get install unzip -y
sudo apt-get install cmake -y
sudo wget https://www.waveshare.net/w/upload/6/66/Rpi-fbcp.zip
sudo unzip ./Rpi-fbcp.zip
cd rpi-fbcp/
sudo rm -rf build
sudo mkdir -m 777 ./build
cd build
sudo cmake ..
sudo make
sudo install fbcp /usr/local/bin/fbcp

设置开机自启动：

  • 打开.bash_profile文件，如果没有.bash_profile文件则自己创建一个
sudo nano ~/.bash_profile

把以下代码加到.bash_profile文件最下面 

if [ "$(cat /proc/device-tree/model | cut -d ' ' -f 3)" = "5" ]; then
    # rpi 5B configuration
    export FRAMEBUFFER=/dev/fb1
    startx  2> /tmp/xorg_errors
else
    # Non-pi5 configuration
    export FRAMEBUFFER=/dev/fb0
    fbcp &
    startx  2> /tmp/xorg_errors
fi

sudo reboot重启保存

设置CLI自动登录：

sudo raspi-config nonint do_boot_behaviour B2
sudo raspi-config nonint do_wayland W1
sudo reboot

重启后主屏幕即可正常显示。
Note1：确保树莓派的用户名为pi否则无法正常自动登录
Note2：设置上述所有配置后，系统每次重启期间都会变久一点，SSH也需要等待一会儿才能进入；

Bullseye/Buster系统显示配置

配置SPI显示器：
下载复制waveshare13.dtbo到/boot/overlays/目录 

sudo cp waveshare13.dtbo /boot/overlays/

编辑config.txt文件：
屏蔽下图对应的语句
FBCP CLOSE.jpg
在config.txt最后加入以下代码 

dtparam=spi=on
dtoverlay=waveshare13
dtoverlay=audremap18
hdmi_force_hotplug=1
max_usb_current=1
hdmi_group=2
hdmi_mode=87
hdmi_cvt 480 480 60 6 0 0 0
hdmi_drive=2
display_hdmi_rotate=0
#arm_freq=1200
#core_freq=500
#over_voltage=2
#gpu_freq=700
#force_turbo=1

如果需要搭配棱镜使用，可以将“display_hdmi_rotate=0”改为“display_hdmi_rotate=0x10002”，详情见#参数介绍
 下载运行驱动：
打开树莓派终端，执行：

sudo apt-get install unzip -y
sudo apt-get install cmake -y
sudo wget https://www.waveshare.net/w/upload/6/66/Rpi-fbcp.zip
sudo unzip ./Rpi-fbcp.zip
cd rpi-fbcp/
sudo mkdir -m 777 ./build
cd build
sudo cmake ..
sudo make -j8
sudo install fbcp /usr/local/bin/fbcp
sudo ./fbcp

设置开机自启动： 

sudo cp ~/rpi-fbcp/build/fbcp /usr/local/bin/fbcp
sudo nano /etc/rc.local

在 exit 0 前面添加 fbcp&。注意一定要添加"&" 后台运行，否则可能会出现系统不能启动的情况。
1in3 lcd fb5.png

随后需要进行重启

sudo reboot

重启后即可正常显示

音频配置

1.下载复制audremap18.dtbo到/boot/overlays/目录 

sudo cp audremap18.dtbo /boot/overlays/

2.编辑config.txt配置文件

  • 在文件最后面添加下列配置
dtoverlay=audremap18

3.切换音频输出 

sudo raspi-config

依次选择System Options --> Audio --> Headphones -->Ok
GameP13-t35.jpg
4.重启生效 

sudo reboot

5.音频输出测试

  • 方法一：在指令行CLI测试；
vlc xxx.mp3

如果没有安装vlc则 

sudo apt-get install vlc
  • 方法二：在图形界面GUI测试；

鼠标双击xxx.mp3文件默认打开vlc播放，如果没有安装vlc则需要安装 

sudo apt-get install vlc

按键配置

运行按键测试Demo 

sudo wget https://www.waveshare.net/w/upload/f/fe/Button_press_detector.zip
sudo unzip ./Button_press_detector.zip
sudo python3 ~/Desktop/button_press_detector.py

Retropie系统

注：此系统不支持在Pi5上使用。

方法一：使用预装驱动的镜像（推荐）

搭配树莓派Zero/Zero 2W使用，建议直接使用#预安装镜像

方法二：安装驱动

下载系统

1. 将TF卡连接到PC，下载并使用Raspberry Pi Imager进行烧录对应系统镜像。
Retropie gamepi13 6.png

2. 镜像烧写完成后，打开TF卡根目录的config.txt文件，在config.txt末尾加入以下代码，保存并安全弹出TF卡。

hdmi_force_hotplug=1

3. 烧写完成后，将HDMI显示器接入到树莓派上，启动树莓派，进入系统后按键盘的F4，进入终端。（也可通过网络登录到终端控制界面）

配置WIFI

在终端输入raspi-config打开系统配置界面，选择System Options -> Wireless LAN
Wifi gamepi13 1.png
Wifi gamepi13 2.png
选择国家，这里我选择了CN China。
Wifi gamepi13 3.png
Wifi gamepi13 4.png
输入WIFI名称。
Wifi gamepi13 5.png
输入WIFI密码，重启保存。
Wifi gamepi13 6.png
Wifi gamepi13 7.png

运行fbcp移植程序

cd ~
wget https://www.waveshare.net/w/upload/1/18/Gamepi13_fbcp.zip
unzip Gamepi13_fbcp.zip
cd Gamepi13_fbcp/build
sudo chmod +x *
sudo ./fbcp-ili9341

等待几秒后1.3寸屏幕即可正常显示

设置用户界面尺寸

更改 LCD 显示分辨率 

sudo nano /boot/config.txt

添加以下代码 

hdmi_force_hotplug=1
hdmi_group=2
hdmi_mode=1
hdmi_mode=87
hdmi_cvt 480 480 60 6 0 0 0
#display_rotate=0
avoid_warnings=1

重启保存 

sudo reboot

如果需要搭配棱镜使用，可以将“display_rotate=0”改为“display_rotate=0x10002”，详情见#参数介绍

设置开机自启动

sudo nano /etc/rc.local

在 exit 0 前面添加以下语句。注意一定要添加"&" 后台运行，否则可能会出现系统不能启动的情况。

sudo /home/pi/fbcp-ili9341/build/fbcp-ili9341 &

配置操作杆

  • 打开树莓派终端，输入以下指令进入配置界面
cd RetroPie-Setup/
sudo ./retropie_setup.sh

Retropie gamepi13 1.png
Retropie gamepi13 2.png
Retropie gamepi13 3.png
Retropie gamepi13 4.png
Retropie gamepi13 5.png

  • 安装好驱动程序后，编辑mk_arcade_joystick_rpi.conf文件
sudo nano /etc/modprobe.d/mk_arcade_joystick_rpi.conf

注释掉原有语句，将以下操纵杆配置添加到此文件 

options mk_arcade_joystick_rpi map=5 gpio=5,6,16,13,26,19,21,20,15,12,14,23

Retropie gamepi13 7.jpg
重新启动以重新映射您的按键后，Gamepad 即可工作

音频配置教程

  • 将 audremap18.dtbo 下载到您的pi
wget https://www.waveshare.net/w/upload/9/90/Audremap18.dtbo
sudo cp Audremap18.dtbo /boot/overlays/
  • 编辑config.txt
sudo nano /boot/config.txt

在末尾添加以下代码，启用gpio18作为pwm音频引脚 

dtoverlay=audremap18，pins_18_19
  • 重启后，您需要添加本地音频

输入sudo raspi-config选择System Options -> Audio -> Headphones

  • 转到 Retropie 菜单

Retropie gamepi13 8.png
选择->Audio->Headphones,重启保存声音功能即可正常使用。

添加游戏

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

在Retropie 菜单界面选择RASPI-CONFIG
Retropie gamepi13 8.png

Game-HAT-Manual04.jpg

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

Game-HAT-Manual05.jpg

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

  • 准备好相应的游戏ROMs。

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

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

Game-HAT-Manual06.png

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

点击此处进行下载。

Game-HAT-Manual07.png

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

Game-HAT-Manual08.png

  • 更新ROMs

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

Game-HAT-Manual09.jpg

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

Game-HAT-Manual10.png

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

Game-HAT-Manual11.png

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

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

参数介绍

通过在 config.txt 文件中设置 display_hdmi_rotate 参数，您可以调整 HDMI 显示器的方向，包括旋转和翻转。
以下是参数的具体说明：

display_hdmi_rotate 结果
0 无旋转（默认方向）
1 顺时针旋转90度
2 顺时针旋转180度
3 顺时针旋转270度
0x10000 水平翻转
0x20000 垂直翻转
  • 您还可以通过组合设置实现更复杂的效果。例如：

180 度旋转 + 水平和垂直翻转 = 0x20000 + 0x10000 + 2 = 0x30002

  • 如果您设置 display_hdmi_rotate=1（90 度）或 display_hdmi_rotate=3（270 度），系统会使用额外的 GPU 内存来完成图像旋转。

对于 GPU 内存设置为 16MB 的设备，这些选项可能无法正常工作。可以修改 config.txt 文件中的 gpu_mem 参数来增加 GPU 内存分配。 

gpu_mem=64

RP2040-PiZero使用教程

运行示例程序

安装Thonny IDE

为了方便在电脑上使用MicroPython开发RP2040-PiZero板，建议下载Thonny IDE。

  • 下载Thonny IDE并按照步骤安装，安装包均为Windows版本，其他版本请参考Thonny 官网。
  • 安装完成之后，第一次要配置语言和主板环境，由于我们是为了使用RP2040-PiZero，所以注意主板环境选择Raspberry Pi 选项

Pico-R3-Tonny1.png

MicroPython

1.下载并解压为.uf2格式的MicroPython固件。
2.按住BOOT键后连接电脑后，松开BOOT键，电脑会出现一个可移动磁盘，将固件复制进去。
3.下载解压示例程序，将代码上传到 Raspberry Pi Pico，步骤如下。（此处以Tetris 游戏为例）

  • 在视图下勾选文件，并在左侧的工具栏中选择对应的文件路径

Thonny gamepi13 1.png
Thonny gamepi13 2.png

  • 全选文件，右键点击上传

Thonny gamepi13 3.png
4.等待上传成功后，拔下USB，在RP2040-PiZero上插上GamePi13，重新上电即可运行自动运行游戏程序。

CircuitPython

1.下载并解压为.uf2格式的CircuitPython固件。
2.按住BOOT键后连接电脑后，松开BOOT键，电脑会出现一个可移动磁盘，将固件复制进去，等待几秒会再次出现一个磁盘。
3.删除新生成的可移动磁盘中的所有文件，下载解压示例程序，将示例程序中“flappybird-CODE”文件夹中的所有文件复制进磁盘中，如下图。
Thonny gamepi13 4.png
4.等待复制成功后，拔下USB，在RP2040-PiZero上插上GamePi13，重新上电即可运行自动运行游戏程序。

C/C++系列

环境搭建

对于 C/C++，建议使用 Pico VS Code 进行开发，这是一款 Microsoft Visual Studio Code 扩展，旨在让您在为 Raspberry Pi Pico 系列开发板创建、开发和调试项目时更加轻松。无论您是初学者还是经验丰富的专业人士，此工具都可以帮助您自信而轻松地进行 Pico 开发。下面我们介绍如何安装该扩展并使用。

安装VSCode
  1. 首先，点击下载 pico-vscode 程序包，解压并打开程序包，双击安装 VSCode
    Pico-vscode-1.JPG
    注意：如果已安装 vscode 注意检查版本是否为 v1.87.0 或更高版本
    Pico-vscode-2.JPG
    Pico-vscode-3.JPG
安装扩展
  1. 点击扩展，选择从 VSIX 安装
    Pico-vscode-4.JPG
  2. 选择 vsix 后缀的软件包，点击安装
    Pico-vscode-5.JPG
  3. 随后 vscode 会自动安装 raspberry-pi-pico 及其依赖扩展，可以点击刷新查看安装进度
    Pico-vscode-6.JPG
  4. 右下角显示完成安装，关闭 vscode
    Pico-vscode-7.JPG
配置扩展
  1. 打开目录 C:\Users\用户名，将整个 .pico-sdk 拷贝至该目录
    Pico-vscode-8.JPG
  2. 拷贝完成
    Pico-vscode-9.JPG
  3. 打开 vscode，对 Raspberry Pi Pico 扩展中各个路径进行配置
    Pico-vscode-10.JPG
    配置如下： 
    Cmake Path：
${HOME}/.pico-sdk/cmake/v3.28.6/bin/cmake.exe

Git Path:
${HOME}/.pico-sdk/git/cmd/git.exe    

Ninja Path:
${HOME}/.pico-sdk/ninja/v1.12.1/ninja.exe

Python3 Path:
${HOME}/.pico-sdk/python/3.12.1/python.exe
新建工程
  1. 配置完成，测试新建工程，输入工程名、选择路径后点击 Creat 创建工程
    测试官方示例，可以点击工程名旁的 Example 进行选择
    Pico-vscode-11.JPG
  2. 创建工程成功
    Pico-vscode-12.JPG
  3. 选择SDK版本
    Pico-vscode-13.JPG
  4. 选择 Yes 进行高级配置
    Pico-vscode-14.JPG
  5. 选择交叉编译链，13.2.Rel1 适用 ARM 核，RISCV.13.3 适用 RISCV 核，这里根据您的需求任意选择其中一个即可
    Pico-vscode-15.JPG
  6. CMake 版本选择 Default（前面配置的路径）
    Pico-vscode-16.JPG
  7. Ninja 版本选择 Default
    Pico-vscode-17.JPG
  8. 选择开发板
    Pico-vscode-18.JPG
  9. 点击 Complie 进行编译
    Pico-vscode-19.JPG
  10. 成功编译出 uf2 格式文件即可
    Pico-vscode-20.JPG
导入工程
  1. 打开C的示例程序，导入工程，注意：导入工程的 Cmake 文件不能有中文（包括注释），否则可能导致导入失败
  2. 成功编译出 uf2 格式文件即可
    Pico-vscode-20.JPG
  3. 按住BOOT键后连接电脑后，松开BOOT键，电脑会出现一个可移动磁盘，将.uf2文件复制进去。
更新扩展
  1. 离线包中的扩展版本为0.15.2，安装完成后，您也可以选择更新至最新版本
    Pico-vscode-22.JPG

开源例程

MircoPython视频例程(github)
MicroPython固件/Blink例程（C）
树莓派官方C/C++示例程序 (github)
树莓派官方micropython示例程序 (github)


资料

示例代码

GamePi13 RP2040 示例代码

数据手册

原理图

软件

售后

联系人：吴工
EMAIL：3005496359@qq.com
电话：0755-83043099
QQ：3005496359
微信：扫下方二维码添加
Wxy.png

说明：进行售后服务前，请准备好客户信息（定货单位、定货人等），以供验证

取自“https://www.waveshare.net/w/index.php?title=GamePi13&oldid=121389”