Skip to content

Commit

Permalink
house keeping
Browse files Browse the repository at this point in the history
  • Loading branch information
wuyongzheng committed Aug 10, 2012
1 parent 7565454 commit 434b87e
Showing 1 changed file with 14 additions and 7 deletions.
21 changes: 14 additions & 7 deletions README.txt
Original file line number Diff line number Diff line change
@@ -1,24 +1,30 @@
gimgtools is a set of command-line tools to examine and manipulate Garmin IMG
(the map format) files. The tools are:

* gimginfo: Print information of the map. Mainly used for reverse engineering
the file format.
Usage: gimginfo map.img
* gimgunlock: Unlock a locked map so that it can be used on ALL devices. There
is no need to specify your device ID or map keys. It works by decrypting
the TRE section. The decrypting key is the same for all maps. If you like
Garmin, please buy their map!
Usage: gimgunlock map.img
* gimgxor: Some maps have been scrambled by a trival XOR algorithm. They do
not work with gimginfo or gimgunlock. You can use gimgxor to unscramble
them.
not work with other gimg* tools. You can use gimgxor to unscramble them.
Usage: gimgxor map.img
=== The following tools are for reverse engineering only ===
* gimginfo: Print information of the map.
Usage: gimginfo map.img
* gimgextract: Extract the IMG sections.
Usage: gimgextract map.img
* gimgch: Hexdump and compare section header of two or more IMGs. Extremely
useful for reverse engineering the file format.
Usage: gimgch [-w columns] [-m max_sf_per_img] [-s pattern] map1.img map2.img ...

Other than that, I have done some research on the deviation of China map
coordinates. Though there is no concrete result, you can follow it in this
article
http://wuyongzheng.wordpress.com/2010/01/22/china-map-deviation-as-a-regression-problem/
The cmdc tool is to generate the deviation table.
My ultimate goal is to change the coordinates in place, i.e. change individual
bytes without recompiling the map. The cmdc tool is to generate the deviation
table. The gimgfixcmd tool fixes the deviation of a map.

Bug Report:
Please post it to google code http://code.google.com/p/gimgtools/. If you can
Expand All @@ -27,7 +33,8 @@ fix it, you can do so in github and let me know.
Credits:
Most of the reverse engineering on IMG format was done by other pepole (listed
below). I just read their docs and code. The reverse engineering of the
unlocking algorithm is done be me.
unlocking algorithm and the GMP section (aka the NT format by Garmin) are my
work.

http://sourceforge.net/projects/garmin-img/
http://libgarmin.sourceforge.net/
Expand Down

0 comments on commit 434b87e

Please sign in to comment.