wuotan

Compatibility

Wuotan was developed under Linux and successfully tested with a Samsung Galaxy S3 Neo (GT-I9301I).

Currently, it doesn't work on Windows because it lacks some quirks that seem to be necessary to flash devices on Windows.

Installation

$ cargo install https://github.com/nickelc/wuotan.git

Usage

List connected Samsung devices

$ wuotan help detect
wuotan-detect
list connected Samsung devices

USAGE:
    wuotan detect [OPTIONS]

OPTIONS:
    -h, --help                     Print help information
        --usb-log-level <LEVEL>    set the libusb log level [possible values: error, warn, info,
                                   debug]

Example

$ wuotan detect
Bus 003 Device 014: ID 04e8:685d

Print PIT from connected Samsung device

$ wuotan help pit print
wuotan-pit-print
print the contents of the PIT from a connected device or a PIT file

USAGE:
    wuotan pit print [OPTIONS]

OPTIONS:
    -d, --device <DEVICE>          select a device via bus number and its address (ex: "003:068",
                                   "3:68")
    -f, --file <FILE>              read local PIT file
    -h, --help                     Print help information
        --usb-log-level <LEVEL>    set the libusb log level [possible values: error, warn, info,
                                   debug]

Example

$ wuotan pit print -f s3pit.dat
Entry Count: 16
Unknown 1: 1598902083
Unknown 2: 844251476
Unknown 3: 30797
Unknown 4: 0
Unknown 5: 0
Unknown 6: 0
Unknown 7: 0
Unknown 8: 0

--- Entry #0 ---
Binary Type: 0 (AP)
Device Type: 2 (MMC)
Identifier: 80
Attributes: 00000010 (Read-Only)
Update Attributes: 00000010 (FOTA)
Partition Block Size/Offset: 0
Partition Block Count: 1734
File Offset (Obsolete): 0
File Size (Obsolete): 0
Partition Name: BOOTLOADER
Flash Name: sboot.bin
FOTA Name:

--- Entry #1 ---
Binary Type: 0 (AP)
Device Type: 2 (MMC)
Identifier: 81
Attributes: 00000101 (Read/Write)
Update Attributes: 00000101 (FOTA)
Partition Block Size/Offset: 1734
Partition Block Count: 312
File Offset (Obsolete): 0
File Size (Obsolete): 0
Partition Name: TZSW
Flash Name: tz.img
FOTA Name:

--- Entry #2 ---
Binary Type: 0 (AP)
Device Type: 2 (MMC)
Identifier: 70
Attributes: 00000101 (Read/Write)
Update Attributes: 00000101 (FOTA)
Partition Block Size/Offset: 34
Partition Block Count: 16
File Offset (Obsolete): 0
File Size (Obsolete): 0
Partition Name: PIT
Flash Name: mx.pit
FOTA Name:

...

Flash partitions

$ wuotan help flash
wuotan-flash
flash partitions to a connected device

USAGE:
    wuotan flash [OPTIONS]

OPTIONS:
    -d, --device <DEVICE>          select a device via bus number and its address (ex: "003:068",
                                   "3:68")
    -h, --help                     Print help information
        --no-verify                don't verify the checksum of tar files
    -p, --part <NAME> <FILE>       partition name and file image
        --reboot                   reboot device after upload
    -t, --tar <FILE>               tar file containing the file images to be flashed
        --usb-log-level <LEVEL>    set the libusb log level [possible values: error, warn, info,
                                   debug]

Example: Flashing CF-Auto-Root

$ wuotan flash --partition recovery recovery.img --partition cache cache.img.ext4
Uploading RECOVERY
RECOVERY upload successful
Uploading CACHE
CACHE upload successful