Disclaimer

This process is really safe if it is done following carefully the instructions, however we are not responsible for any damage you may cause to  your Capcom Home Arcade (CHA) because of your actions. Use the software at your own risk and under your responsibility.

The Choko Team Does not support any kind of piracy. This is a Proof of Concept.  Use the software just with the game roms you legally own.


Requirements

  • CHA - Updated to official firmware 1.51 (although this might be compatible with previous versions).
  • USB drive formatted to FAT32/EXT2/EXT3/EXT4
  • Male - Male USB Type A cable.
  • Latest Zadig Universal Drivers.
  • CHOKO HACK PACKAGE SOFTWARE. (v9.2a Updated on 2020/11/22)
  • If you already have a previous version installed, just use the update pack. Extract CHA_MOD to an usb pendisk and insert in the CHA, then turn it on (don't forget to backup any CHA_MOD folder that you already have in the USB pendisk).


  • Those with a micro SD card reader that have the system installed in a micro SD card don't need the USB cable and don't have to install zadig drivers. Just put the SD card in the PC card reader and skip to the section "Installing scripts to enable USB EXT loading".


Previous software install and USB preparation


  1. Download and install latest Zadig Universal Drivers. Note: If you already installed this drivers or have previously modded a NES Mini / SNES Mini / MD Mini... you may skip this part of the process.
    ZADIG INSTALL USB DRIVER 01.jpg
    Zdiag should be open when connecting your CHA to the PC for the very first time in order to detect the new "unknown device"...
    Zadig software when you pick the correct USB Device, ready to install the USB Drivers
    Select the "unknown device", confirm the USB ID and click "Install Driver"

If your device isn´t listed, go to options and click "List All Devices".

Zadig.png


  1. Download the latest CHOKO HACK SOFTWARE PACK and decompress the file to any folder in your PC hard drive. Inside the created folder you'll have two sub folders,  CHA_FEL and CHA_MOD, will be created.


Opening the CHA device: Putting CHA into FEL Mode

NOTE: This method requires that you open the device just once (actually, every time you want to use FEL MODE for backups/restores). Some files will be installed so that you have access to the device with the Game Manager via USB / FTP and SSH by Putty or other clients, and it is not necessary to open it again.

  1. Place CHA upside down on a smooth surface not to scratch the CHA Plate and remove the 10 screws (4 + 6 under the rubber pads; if you don't have replacement rubber pads, remove them carefull to glue them back again).
    CHA FEL BUTTON 01.jpg

  2. Now put your CHA in FEL mode.
  3. Then, go to the CHA_FEL folder (extracted from CHOKO HACK PACKAGE SOFTWARE) and run 'start.bat' (if you are using Windows) or start.sh (if you are using Linux). Press <Enter> when it asks for it.
    start.bat/start.sh success message

  4. Once you've run that, TWO new drive UNITS will appear if you are using LINUX, or ONE UNIT if you are using WINDOWS. These are partitions in the internal storage eMMC of the CHA. If you haven't made a full system backup before, now it's a good time to do it. If it doesn't show up, go to Disk Manager and add a letter to the first partition of the CHA.


Installing scripts to enable USB EXT loading


  1. Copy the three files from this new unit (boot.scr, sun8i-h3-orangepi-pc.dtb and  zImage)  to a backup folder ii you don't have a full system backup (why don't you?). Keep them safe as they are the backup of your 10 mb FAT32 partition. You can also make a copy of boot.scr renaming it boot.scr.bak.
  2. Copy the files in the 'FILES_TO_COPY_TO_CHA_DRIVE' folder (boot.scr, uIntitrd-CHA-MOD, hackinstall.sh and hackinstall.tar.gz) to the new drive, overwriting if necessary. If you have made a previous install, it is possible that an instance of uInitrd-CHA_MOD is already there and it may tell you that there is not enough free space to copy. In this case, remove the one already present and copy the new one.
    The CHA eMMC drive with Mod files should contain the boot file, sun8i-h3-orangepi-pc.dtb, uIntrd-CHA_Mod and the zImage file

  3. In Windows, do "Safe Remove - Eject" or, if in Linux, unmount both drives. It will identified as a ALLWINNER device.
  4. Power off the CHA and put the screws back in place.
  5. Choko Hack Install.gif
    The next time you power on the CHA it will install the necessary files to use be able to load games from CHA_MOD folder in USB pendisk. You should see a confirmation messages and it will automatically reboot. The second reboot in the animation above is what we see when booting with a pendisk that has CHA_MOD folder.
  6. Now you can copy the CHA_MOD folder to the root directory of a USB disk (formated to FAT32 or EXT2/EXT3/EXT4). You should to do a clean copy to avoid messing and mixing files from different hack builds. Note: For larger USB drives in Windows, if you want to use FAT32 format (others are not accessible via Windows) you can use any Free Windows tools such as Fat32 GUI Formatter, MiniAide Fat 32 Formatter... or the ones you prefer. For Linux do the same process with the suitable software.
  7. Insert the USB drive into the CHA USB EXT Port (remove the rubber cover if necessary) and start the CHA. It will copy some required files from the CHA's internal storage to the USB drive. This will take some time, Linux commands will display on screen, and the CHA will reboot once.
  8. When it's finished you should see the Choco Team Logo next to CAPCOM Logo at startup splash screen, and the standard selection of 16 games. If the install wasn't successful then you will only see the standard CAPCOM logo without the Choko logo.   
Capcom boot logo with Choko team logo


Now you can shut down (or play the standard games of course)


Video Guide


Thanks to @pedator for this great video guide!


Game Management


Add any games that you own into the appropriate directory folders on the USB drive:

  • game's roms go to CHA_MOD>usr>share>roms;
  • icons for the carousel go to CHA_MOD>opt>capcom>assets>games;
  • (optional) carousel background music has two places, CHA_MOD>opt>capcom>assets>sounds or CHA_MOD>opt>capcom>assets>sounds>music>set2 (Remix);
  • (optional) buttons layout needs *.png files in two places, CHA_MOD>opt>capcom>assets>options and CHA_MOD>opt>capcom>assets>options>large.


Finally, in CHA_MOD>opt>capcom>assets folder you need to create a file named "games.txt" with one line per game, with the following structure:

A 2 Z 1996 spf2t.png spf2t.zip spf2t.ogg Super Puzzle Fighter 2 Turbo

1st - One letter corresponding to the button layout. Can be A|B|C|D|E.

2nd - One digit indicating the game system. 1 for CPS1 and 2 for CPS2. Any other digit will hide the System/Year/Genre info in carousel.

3rd - Game genre. Available options are B (beat'm up), F (fighting), P (platform), R (sports), S (shoot'm up), Z (puzzle).

4th - The year of the game.

5th - Icon file for the carousel.

6th - ROM file with the game.

7th - Music file for carousel.

8th and remaining line - The name of the game, usually not visible anywhere in carousel.


For non arcade games to work with FB Neo (the emulator core we are using with this hack) the rom should be in some specific subfolders, in CHA_MOD>usr>share>roms.

Here you have one example for a megadrive game, with icon and music also stored in subfolders for better organization.

C 0 P 1994 megadriv/greatcirj.png megadriv/greatcirj.zip megadriv/greatcirj.ogg Great Circus Mystery - Mickey to Minnie Magical Adventure 2


We recommend using our Game Manager (still in beta testing), which makes the whole process of managing games (add, remove, arrange USB, FTP...) much easier.


You should see the Choco Team Logo next to CAPCOM Logo at startup splash screen, and any additional games you have installed on the USB drive will be available. Note:  Choko Team does not endorse or support any kind of piracy. Just use the game rom licenses you own.

If you start the CHA without the USB drive inserted, it will boot with the original CHA 16 games configuration.

Note: When USB is inserted, boot time could be slightly increased by ~5 seconds when you use this mod, specially when adding too many games.


EXTRAS

Booting with this USB hack pack you can to connect to your CHA using SSH or FTP with user root and password Choko. Just rename the folders inside CHA_MOD, removing ".disabled" from the name (dot included).

With FTP you can add or delete roms to the CHA_MOD without the need to remove the pen drive from the CHA (for example, using our Game Manager).


ENJOY YOUR CAPCOM HOME ARCADE AS MUCH AS WE DO!!!


Credits


Choko Team (in alphabetical Order).

  • Auriga
  • Campirulo
  • CHA_Fan
  • jj0
  • Kei_Dash
  • Pararegistros
  • Woises Kikex-Box


Supporters

  • Fast-Lifeguard
  • Haurayu Mifune
  • Megafriki
  • Thematho
  • Vick21

And many others of you at https://www.elotrolado.net  and  https://www.reddit.com/r/CapcomHomeArcade/

We thank you all.


THANKS:

  • And so much thanks to darkdev1!!! He was the pioneer who gave the first steps modding and exploring the potential of the CHA.
Community content is available under CC-BY-SA unless otherwise noted.