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:
authorHedda <rockerc.harley@gmail.com>2017-02-17 15:24:22 +0300
committerGitHub <noreply@github.com>2017-02-17 15:24:22 +0300
commitc20b81a1ccba06a0198d746e9dbb7478666134eb (patch)
treeb878e1961c4c3f10c67d02452fee50c9ae3de715 /README.md
parentb6335e3646843b937e249ef9ee98cafee8585cea (diff)
Update README.md for spelling, grammar and punctuation
Update README.md for spelling, grammar and punctuation. Also added or changed some other minor language issues, plus a signature since "I" is mentioned several times without reference to who "I" is.
Diffstat (limited to 'README.md')
-rw-r--r--README.md18
1 files changed, 11 insertions, 7 deletions
diff --git a/README.md b/README.md
index 11a50f3d..09fc92b7 100644
--- a/README.md
+++ b/README.md
@@ -1,6 +1,8 @@
# hakchi2
-This application can add more games to your Nintendo Classic Mini or Famicom Mini. All you need is to connect it to PC via microUSB cable. No soldering, no disassembling.
+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.
+
+https://github.com/ClusterM/hakchi2
Features:
* Allows to change any game settings including command line arguments
@@ -16,11 +18,13 @@ Features:
* Allows to disable epilepsy protection
* Allows to disable menu music
-## So are you hacked NES Mini?
-No! It was my russian сomrade madmonkey. He created original “hakchi” tool. It was not very user friendly so I decided to create tool which is simple for everyone, not only Linux users. I named it “hakchi2” because I don’t like to coming up with names. So first version was 2.0 :)
+## 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 :)
+
+## How to 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 to use it?
-Basically you need just to unpack it somewhere (installation not required), run it, press “Add more games”, select some ROMs and press “Synchronize”. Application will guide you.
+## 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.
-## How it’s working?
-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, NES Mini runs on Linux), 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 script which will copy them to flash, repack, upload and execute. But games directory is on read only partition. So we need also to create and flash custom kernel with special script that creates sandbox folder on writable partition and mounts it over original games folder. So your original files are safe. You can’t delete or harm original files in any way. For kernel patching my application just executing other applications, that’s why there is “tools” folder.
+// Alexey 'Cluster' Avdyukhin ("ClusterM" on GitHub)