This repository has been archived by the owner on May 9, 2020. It is now read-only.
-
Notifications
You must be signed in to change notification settings - Fork 60
/
README
75 lines (64 loc) · 4.37 KB
/
README
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
usage:
KindleTool dm [ <input> ] [ <output> ]
Obfuscates data using Amazon's update algorithm.
If no input is provided, input from stdin
If no output is provided, output to stdout
KindleTool md [ <input> ] [ <output> ]
Deobfuscates data using Amazon's update algorithm.
If no input is provided, input from stdin
If no output is provided, output to stdout
KindleTool convert [options] <input>
Converts a Kindle update package to a gzipped TAR file, and delete input
Options:
-c, --stdout Write to standard output, keeping original files unchanged
-i, --info Just print the package information, no conversion done
-s, --sig <output> OTA V2 updates only. Extract the package signature to <output> file.
KindleTool extract <input> <output>
Extracts a Kindle update package to a directory
KindleTool create <type> <devices> [options] <dir|file> [ <output> ]
Creates a Kindle update package
If input is a directory, all files in it will be packed into an update
If input is a GZIP file, it will be converted to an update.
If no output is provided, output to stdout.
In case of OTA updates, all files with the extension ".ffs" and will be treated as update scripts
Type:
ota OTA V1 update package. Works on Kindle 3.0 and below.
ota2 OTA V2 signed update package. Works on Kindle 4.0 and up.
recovery Recovery package for restoring partitions.
Devices:
OTA V1 packages only support one device. OTA V2 packages can support multiple devices.
-d, --device k1 Kindle 1
-d, --device k2 Kindle 2 US
-d, --device k2i Kindle 2 International
-d, --device dx Kindle DX US
-d, --device dxi Kindle DX International
-d, --device dxg Kindle DX Graphite
-d, --device k3w Kindle 3 Wifi
-d, --device k3g Kindle 3 Wifi+3G
-d, --device k3gb Kindle 3 Wifi+3G Europe
-d, --device k4 Kindle 4 (No Touch)
-d, --device k5w Kindle 5 (Kindle Touch) Wifi
-d, --device k5g Kindle 5 (Kindle Touch) Wifi+3G
Options:
All the following options are optional and advanced.
-k, --key <file> PEM file containing RSA private key to sign update. Default is popular jailbreak key.
-b, --bundle <type> Manually specify package magic number. Overrides "type". Valid bundle versions:
FB01, FB02 = recovery; FC02, FD03 = ota; FC04, FD04, FL01 = ota2
-s, --srcrev <ulong|uint> OTA updates only. Source revision. OTA V1 uses uint, OTA V2 uses ulong.
Lowest version of device that package supports. Default is 0.
-t, --tgtrev <ulong|uint> OTA updates only. Target revision. OTA V1 uses uint, OTA V2 uses ulong.
Highest version of device that package supports. Default is max int value.
-1, --magic1 <uint> Recovery updates only. Magic number 1. Default is 0.
-2, --magic2 <uint> Recovery updates only. Magic number 2. Default is 0.
-m, --minor <uint> Recovery updates only. Minor number. Default is 0.
-c, --cert <ushort> OTA V2 updates only. The number of the certificate to use (found in /etc/uks on device). Default is 0.
0 = pubdevkey01.pem, 1 = pubprodkey01.pem, 2 = pubprodkey02.pem
-o, --opt <uchar> OTA V1 updates only. One byte optional data expressed as a number. Default is 0.
-r, --crit <uchar> OTA V2 updates only. One byte optional data expressed as a number. Default is 0.
-x, --meta <str> OTA V2 updates only. An optional string to add. Multiple "--meta" options supported.
Format of metastring must be: key=value
KindleTool info <serialno>
Get the default root password
notices:
1) Kindle 4.0+ has a known bug that prevents some updates with meta-strings to run.
2) Currently, even though OTA V2 supports updates that run on multiple devices, it is not possible to create a update package that will run on both the Kindle 4 (No Touch) and Kindle 5 (Kindle Touch).