如何使用gpi-case搭建pico-8平台

2019/11/14 pico-8

完整说明一下,组合树莓派,然后安装系统到调试,使用的过程。

准备工作

需要的硬件清单

  • ¥399 Retroflag GPi CASE 复古旗GPi套件
  • ¥80 Raspberry Pi Zero W 树莓派ZeroW
  • ¥30 MicroSD 卡, 32G
  • ¥10 MicroSD 卡读卡器
  • ¥3 AA 5号电池三节(可选)
  • ¥0 PC/MAC 电脑一台
  • ¥25 USB Wifi(PC和wifi不在一个网段时需要)
    注意树莓派不要买错,买成WH,WH多了个头,装不进去的
    电池建议买充电电池,不嫌重的话,充电宝也可以
    

需要的软件清单

开始组装硬件

套件内有图示说明,照着拼装就没太大问题

GPi CASE组合图例

  1. 关闭电源开关,取下卡带
  2. 打开卡带,小心sd卡封套别掉了,取出 IO转换版
  3. 组合一下自带的螺丝刀,往壳上拧上四个螺母
  4. 连接 树莓派 和 IO转换板(先不要急着上螺丝,这一步我拧爆一个螺母。。。)
  5. 装上sd卡封套,合上外壳,最后拧好4个螺丝

开始安装软件

  1. 格式化sd卡
    • 32G或更小的,选 FAT 格式,64G或更大的,选 ExFAT 格式
  2. 使用烧录工具,把retropi镜像烧入sd卡
  3. 安装gpi case补丁
    • 解压 GPi_Case_patch 然后将整个目录文件放到sd卡的根目录下
    • 进入sd卡上的 GPi_Case_patch 目录,双击 install_patch.bat 运行
  4. 设置wifi
    • 在sd卡根目录新建 wpa_supplicant.conf 文件,按照下面的参考格式填入内容并保存
      country=CN
      ctrl_interface=DIR=/var/run/wpa_supplicant GROUP=netdev
      update_config=1
         
      network={
      ssid="WiFi-A"
      psk="12345678"
      key_mgmt=WPA-PSK
      priority=1
      }
      
      #ssid:网络的ssid
      #psk:密码
      #priority:连接优先级,数字越大优先级越高(不可以是负数)
      #scan_ssid:连接隐藏WiFi时需要指定该值为1
        
      如果你的 WiFi 没有密码
      network={
      ssid="你的无线网络名称(ssid)"
      key_mgmt=NONE
      }
            
      如果你的 WiFi 使用WEP加密
      network={
      ssid="你的无线网络名称(ssid)"
      key_mgmt=NONE
      wep_key0="你的wifi密码"
      }
            
      如果你的 WiFi 使用WPA/WPA2加密
      network={
      ssid="你的无线网络名称(ssid)"
      key_mgmt=WPA-PSK
      psk="你的wifi密码"
      }
            
      如果你不清楚 WiFi 的加密模式,可以在安卓手机上用 root explorer 打开 /data/misc/wifi/wpa/       wpa_supplicant.conf,查看 WiFi 的信息。
      
    • 每次启动后 wpa_supplicant.conf 这个文件会消失,有改动的话需重新添加
  5. 开启ssh服务
    • 在sd卡根目录新建一个空白文件,命名为 ssh。注意要小写且不要有任何扩展名。
  6. 远程连接系统IP
    • sd卡插好,打开电池仓,中间有个安全关机开关设置到 On ,开机
    • 等待开机后,选retropie进入设置界面,找到 SHOW IP 选项进入,记下 IP 地址
    • pc 打开putty ssh远程连接树莓派,这里注意pc需要和wifi在同一个网段
      Host Name 这里填 pi@xxx.xxx.xx.xxx (刚才看到的IP地址)
      端口 22
      默认密码 raspberry
      
    • ftp 也连接一下 方便传文件,打开 ftp 连接工具
      主机名填 xxx.xxx.xx.xxx (刚才看到的IP地址)
      用户名 pi
      端口 22
      默认密码 raspberry
      
  7. 配置Gpi case按键
    • 第一次开机需要设置按键,按住任意按键不放就可以开始配置
    • 然后根据提示,一个个按键设置下去
    • Left/Right shoulder 左右肩键在背后有三个凸点的地方
    • 剩余没有的按键可以按住任意键不放跳过
  8. 安装安全关机脚本
    • 在putty打开的ssh窗口中输入
      wget -O - "https://raw.githubusercontent.com/RetroFlag/retroflag-picase/master/  install_gpi.sh" | sudo bash
      

      等几分钟,完成后会自动重启

  9. 扩展文件系统
    • 等待开机后,选retropie进入设置界面
    • 选择 raspi-config 选项进入
    • 然后选 Advanced Configuration, 然后 expand_rootfs
    • Finish 然后 确认 reboot 重启
  10. 拷贝rom游戏
    • 网络邻居或者资源管理器路径输入 \\RETROPIE 找到 roms 文件夹拷入对应平台的游戏即可

配置pico8

  1. 解压 pico-8树莓派版本
    • ftp 打开目录 /home/pi/pico-8pico-8 目录的文件拷入
    • 新建一个文件 Start PICO-8.sh 拷贝到 /home/pi/pico-8
    • ssh窗口中输入 sudo apt-get install wiringpi 安装 wiringPI
  2. 解压 SDL 到 /home/pi/pico-8 目录,变成差不多这样的目录结构 /home/pi/pico-8/SDL2-2.0.10
    • ssh窗口输入以下命令配置
       cd /home/pi/pico-8/SDL2-2.0.10/test
       sudo chmod 777 configure
       ./configure
       make controllermap
      
    • 继续输入 ./controllermap 0 >> /home/pi/pico-8/sdl_controllers.txt GPI屏幕上会显示手柄配置
      按照提示依次输入对应按键
      没有的按键 按下B 跳过
      需要设置 B, A, Y, X, 十字键, L/R 肩键, start 和 select
      完成后会生成 sdl_controllers.txt 在 /home/pi/pico-8/ 目录下
      
  3. 配置 在线游玩模式的 pico-8
    • ftp或者ssh 打开 /opt/retropie/configs/all/emulationstation/es_systems.cfg 或者 /etc/emulationstation/es_systems.cfg 这里可以先备份一下,万一改错了就进不去了
    • 找到同样的 <system></system> 结构 加入以下配置
       <system>
       <name>pico8</name>
       <fullname>PICO-8</fullname>
       <path>/home/pi/pico-8</path>
       <extension>.sh .SH</extension>
       <command>/opt/retropie/supplementary/runcommand/runcommand.sh 0 "/home/pi/pico-8/pico8 -splore"</command>
       <platform>pico8</platform>
       <theme>pico8</theme>
       </system>
      
    • (ftp操作) 先修改文件读写权限,然后就可以直接修改文件后保存
    • (ssh操作) 按 ctrl+x 然后 y 保存退出
  4. 配置 读取 rom 的 pico-8
    • 同样文件下加入以下配置
      <system>
      <name>pico8ctm</name>
      <fullname>PICO-8</fullname>
      <path>/home/pi/RetroPie/roms/pico-8</path>
      <extension>.p8</extension>
      <command>/opt/retropie/supplementary/runcommand/runcommand.sh 0 "/home/pi/pico8/pico8   -run %ROM%"</command>
      <platform>pico8</platform>
      <theme>pico8</theme>
      </system> 
      
    • ssh操作 输入 shutdown -r now 重启
  5. 帧率限制调整
    • pico8的 _update60 是不限帧的,所以需要调整一下硬件限制 ~/.lexaloffle/pico-8/config.txt 找到 foreground_sleep_ms 改成 5 左右基本上就不会突然帧率增加了。
  6. 到这里就差不多完成了,之后可以拷贝整个sd目录文件做个备份

最后,感谢阅读,希望这篇指导可以帮助到您~

参考文章:

  • http://shumeipai.nxez.com/2017/09/13/raspberry-pi-network-configuration-before-boot.html
  • https://sinisterspatula.github.io/RetroflagGpiGuides/pico8/pico8
  • https://www.lexaloffle.com/bbs/?tid=3935
  • https://howchoo.com/g/ndc3njbhytv/retroflag-gpi-setup#configure-the-controller

Search

    Table of Contents