Welcome to mirror list, hosted at ThFree Co, Russian Federation.

github.com/ClusterM/hakchi2.git - Unnamed repository; edit this file 'description' to name the repository.
summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorGray Kimbrough <gray.kimbrough@gmail.com>2017-03-19 22:20:07 +0300
committerGray Kimbrough <gray.kimbrough@gmail.com>2017-03-19 22:20:07 +0300
commite21b1482a50f602b7d64eb65aa68c5e6270ebf12 (patch)
tree3dfd5e96c2ce56a4fa2f0e2fa796174996505fba /README.md
parentc536f822c10d9ac3fcdf671a534a6f1bee0d2fc7 (diff)
Grammar cleanup, plus the addition of a reference to the FAQ.
Diffstat (limited to 'README.md')
-rw-r--r--README.md16
1 files changed, 10 insertions, 6 deletions
diff --git a/README.md b/README.md
index c2f5ddab..bca2f770 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,6 @@
# hakchi2
-This is GUI for hakchi by madmonkey.
+This is a GUI for hakchi by madmonkey.
This application can add more games (game ROMs) to your Nintendo Classic Mini or Famicom Mini. All you need is to connect it to a Windows PC via Micro-USB cable. No soldering or disassembling required.
@@ -11,7 +11,7 @@ https://github.com/ClusterM/hakchi2
* Fill all game data automatically using included database
* Automatically check for supported games
* Search for box art using Google Images
-* Use [Game Genie](https://en.wikipedia.org/wiki/Game_Genie) codes, includes Game Genie database
+* Use [Game Genie](https://en.wikipedia.org/wiki/Game_Genie) codes; includes Game Genie database
* Automatically patch problem games (patches for many popular games included)
* Upload hundreds of games at once
* Return to the HOME menu with a button combination instead of the Reset button
@@ -20,13 +20,17 @@ https://github.com/ClusterM/hakchi2
* Disable seizure protection
* Allows to install user-mods to add more features (even support for SNES/N64/Genesis/etc., music replacement, themes, etc.)
-## So you was first to hack NES Classic Mini?
-No! It was my Russian сomrade, madmonkey, who first published a successful hack of the the NES Classic Mini. He created the original “hakchi” tool. It was however not very user-friendly so I decided to create a tool which is simple to use by anyone, and not only Linux users. I named it “hakchi2” because I don’t like to coming up with names. So my first version was a 2.0 release :)
+## So you were the first to hack the NES Classic Mini?
+No! It was my Russian сomrade, madmonkey, who first published a successful hack of the the NES Classic Mini. He created the original “hakchi” tool. However, it was not very user-friendly, so I decided to create a tool which is simple to use by anyone--not only Linux users. I named it “hakchi2” because I don’t like to come up with names. So my first version was a 2.0 release :)
-## How to use the tool?
+## How do I use the tool?
Basically you just need to unpack it somewhere on your harddrive (installation is not required), run it, press “Add more games”, select some game ROMs and press “Synchronize”. The application will guide you through this process.
## How does the tool actually work?
-You don’t need to worry about it. But if you really want to know it’s using FEL mode. FEL is a low-level subroutine contained in the BootROM on Allwinner devices. It is used for initial programming and recovery of devices using USB. So we can upload some code into RAM and execute it. In this way we can read Linux kernel (yes the NES Classic Mini and Famicom Mini runs an Linux operating-system), write kernel or execute kernel from memory without writing it to flash. So we can dump kernel image of NES Mini, unpack it, add some games and runt a script which will copy them back to flash, repack, upload and execute. But as the games directory is on read-only partition. Therefore we also need to create and flash a custom kernel with a special script that creates a sandbox folder on writable partition and mounts it over the original games folder.This means that your original files are safe. You can not delete or harm the original files in any way, even if you wanted. For kernel patching my application just executes other applications, that is why there is a “tools” folder.
+You don’t need to worry about it. But if you really want to know, it’s using FEL mode. FEL is a low-level subroutine contained in the BootROM on Allwinner devices. It is used for initial programming and recovery of devices using USB. So we can upload some code into RAM and execute it. In this way we can read the Linux kernel (yes the NES Classic Mini and Famicom Mini runs an Linux operating-system), write kernel or execute kernel from memory without writing it to flash. So we can dump the kernel image of the NES Mini, unpack it, add some games and run a script which will copy them back to flash, repack, upload and execute. However, the games directory is on a read-only partition. Therefore we also need to create and flash a custom kernel with a special script that creates a sandbox folder on a writable partition and mounts it over the original games folder. This means that your original files are safe: you cannot delete or harm the original files in any way, even if you wanted. For kernel patching my application just executes other applications, which is why there is a “tools” folder.
+
+## What if I have another question?
+Many more commonly asked questions are answered in the FAQ:
+https://github.com/ClusterM/hakchi2/wiki/FAQ
// Alexey 'Cluster' Avdyukhin ("ClusterM" on GitHub)