Skip to content

Latest commit

 

History

History
75 lines (55 loc) · 2.09 KB

README.md

File metadata and controls

75 lines (55 loc) · 2.09 KB

ClockWorkPI Sim-Arduboy

Arduboy board implementation using simavr,
tweaked for ClockWork(GameSH>)

How to install

  • SSH to your GameSH>
  • create folder /home/cpi/games/ArduBoy:
> mkdir ~/games/ArduBoy
  • navigate to that folder, and clone the repo:
> cd ~/games/ArduBoy
> git clone --recursive https://github.com/ITCactus/sim-arduboy.git
  • copy 22_ArduBoy folder to the desired Launcher's menu folder.
    e.g. for main menu copy to /home/cpi/apps/Menu:
> cp -r ~/games/ArduBoy/sim-arduboy/22_ArduBoy ~/apps/Menu/
  • build/rebuild:
> sudo apt-get update && sudo apt-get install build-essential libelf-dev libsdl2-dev freeglut3-dev
> cd ~/games/ArduBoy/sim-arduboy/
> make
  • make it executable:
> chmod +x ~/games/ArduBoy/sim-arduboy/sim_arduboy

  • restart the Launcher on GameSH> (or reboot it)

  • make sure, you switched to the Lima GPU driver via Settings->GPU Driver Switch->Lima driver (with Fbturbo, emulator either running too slow, or not starting at all)

  • put some ArduBoy games (hex-files. you can find some here) into /home/cpi/games/ArduBoy folder

  • launch ArduBoy from Menu, and select desired game from the list

  • have fun (use A and B buttons to action/back,menu button to exit)

To rebuild "ArduBoy" by yourself
  • SSH to your GameSH>
  • setup Dependencies:
> sudo apt-get update && sudo apt-get install build-essential libelf-dev libsdl2-dev freeglut3-dev
  • build/rebuild:
> cd ~/games/ArduBoy/sim-arduboy/
> make
  • make it executable:
> chmod +x ~/games/ArduBoy/sim-arduboy/sim_arduboy

Limitations

  • emulation speed is not accurate (feel free to contribute improvements for it to the current repo)
  • no sound emulated (feel free to contribute improvements for it to the original sim-arduboy repo)
  • no RGB LEDs/lights emulated

Note

tested on ClockWork OS v0.5 and Launcher 1.25