Skip to content

Latest commit

 

History

History
145 lines (117 loc) · 7.03 KB

install_ps5000.md

File metadata and controls

145 lines (117 loc) · 7.03 KB

This document is available in [ en ]

Ruka Custom Firmware Installation Guide for PS5000

DISCLAIMER: Install it at your own responsibility. This firmware is ONLY for PS5000, installing in other devices will cause a half brick and you will need to use tools that are not available here. Please do a backup before installing the cfw!!!

Document TOC

Windows Installation

BACKUP PROCESS

  • Unzip Android Tools Console into the firmware folder (e.g. ruka_cfw_3.0_beta_1_20210806)
  • Once selected, please connect the usb to the left usb port of the system and plug the usb male to the pc
  • Press and hold SELECT key. Turn on the system and keep holding until windows recognize it or a couple of seconds
  • Open Android_Console_Tool.exe as admin
  • If its connected as the image, press 1
  • image
  • Write the following sentence RL 0x0 0xffffffff backup.img
  • image
  • It will display an error message, is totally normal. Check that you have a backup.img with a filesize aprox of 100Mb
  • image
  • Now, you can proceed with the next steps.

CFW INSTALL

  • Copy the folder ruka_cfw_3.0_beta_1_20210806\firmware inside Android Tools Console
  • image
  • Set your PS5000 in flash mode (LOADER)
    • Press and hold SELECT. Turn on the system and keep holding until windows recognize it or a couple of seconds
  • Double click on the file ruka_install_ps5000.bat
  • Allow admin privileges when windows ask for it, it will happen twice.
  • Once finished, you can switch off the system and enjoy it!

Linux Installation

  Archive:  Linux_Upgrade_Tool_v1.65.zip
   creating: Linux_Upgrade_Tool_v1.65/
  inflating: Linux_Upgrade_Tool_v1.65/config.ini  
  inflating: Linux_Upgrade_Tool_v1.65/Linux┐к╖в╣д╛▀╩╣╙├╩╓▓с_v1.32.pdf  
  inflating: Linux_Upgrade_Tool_v1.65/revision.txt  
  inflating: Linux_Upgrade_Tool_v1.65/upgrade_tool

  • Make sure the upgrade tool is an executable: chmod +x Linux_Upgrade_Tool_v1.65\upgrade_tool

  • Download latest custom firmware for your PS5000 from this repository

  • Extract the firmware: $ tar xzf ruka_cfw_3.0_beta_1_20210806.tgz

  • Set your PS5000 in flash mode (LOADER)

    • Press and hold SELECT. Turn on the system and keep holding until windows recognize it or a couple of seconds

  • Connect a USB-B to the top left port and the USB-A cable to your computer

  • Open a terminal and run the ruka_install_ps5000.sh script (you will need to be sudo or root to run it)

  • You should observe a console output similar to this:

$ sudo ./ruka_install_ps5000.sh
To flash the firmware you need to put the PS5000 into recovery mode
Connect your PS5000 console USB port 1 to your computer
Press and keep pressed the SELECT key and power the console on
Wait for 5 seconds and then release the SELECT key
The screen wil be black but the blue power led will be on

Press enter to continue
Flashing bootloader...
Program Data in ../Linux_Upgrade_Tool_v1.65
Write LBA from file (100%)
Flashing rootfs...
Program Data in ../Linux_Upgrade_Tool_v1.65
Write LBA from file (100%)
Flashing userdata partition...
Program Data in ../Linux_Upgrade_Tool_v1.65
Write LBA from file (100%)
DONE!

SD card installation

The sdcard folder contains the folders and files that need to go into the SDCARD.

The following files need to be copied into your SDcard

File Description
.config Retroarch configuration and asset files
rukafs SDCard Firmware File
configs General system and emulators configuration folder
logs log folder
roms Roms folder, copy your roms to the specific folder here (e.g. roms/mame)
roms/bios Bios folder, copy your system bios here
  • Copy the contents of those folders/file into your SD.
  • You will need to add your roms to roms folder (follow the batocera systems structure), e.g. roms/mame)
  • Add your bios into the roms/bios folder
  • Insert the SDcard back into the PS5000, reboot, and enjoy

General notes

  • The CFW has been designed to be easily upgradeable. Future upgrades will be via SDCard only, so if you have flashed the internal memory, you won't require to flash it again and instead you will just need to drop an update on your SDCard.
  • The system may report a couple of BSOD depending on errors:
    • If your SD card is missing or corrupted the system will report error A
    • If the rukafs firmware is missing from the SDCard it will report error B
  • You can use your existing SD images from different systems, but the CFW always looks for a configs/ruka/retroarch_ps5000.cfg for its retroarch configuration

Retroarch.cfg files

  • HDMI compatibility requires at least the following sets to be added to the retroarch.cfg:
    • video_fullscreen_x = "1280"
    • video_fullscreen_y = "720"
    • video_fullscreen = "true"
    • audio_device = "hw:0,1"
    • custom_viewport_height = "600"
    • custom_viewport_width = "1024"
    • aspect_ratio_index = "22"

Acknowledgements

  • All the folks that have been enjoying our releases
  • Rutjoni, for initial testing and for being right about this console
  • The folks at A12/13 telegram group
  • Bruma, Retrolocatis, and other youtubers that have reviewed our CFWs
  • Everyone at the #ps5000 RG Handhelds discord channel
  • And of course, all the rest of the ruka team, you know who you are

Changelog

Modified at Comments Contributor
2021-07-21 Initial version. fakemaria
2021-08-06 Updated installation steps to match release acmeplus