esp-idf/examples/storage/parttool/parttool_example.py

#!/usr/bin/env python
#
# Demonstrates the use of parttool.py, a tool for performing partition level
# operations.
#
# Copyright 2018 Espressif Systems (Shanghai) PTE LTD
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http:#www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
import argparse
import os
import sys

PARTITION_TABLE_DIR = os.path.join('components', 'partition_table', '')


def assert_file_same(file1, file2, err):
    with open(file1, 'rb') as f1:
        with open(file2, 'rb') as f2:
            f1 = f1.read()
            f2 = f2.read()

            if len(f1) < len(f2):
                f2 = f2[:len(f1)]
            else:
                f1 = f1[:len(f2)]

            if not f1 == f2:
                raise Exception(err)


def main():
    COMPONENTS_PATH = os.path.expandvars(os.path.join('$IDF_PATH', 'components'))
    PARTTOOL_DIR = os.path.join(COMPONENTS_PATH, 'partition_table')

    sys.path.append(PARTTOOL_DIR)
    from gen_empty_partition import generate_blanked_file
    from parttool import PartitionName, PartitionType, ParttoolTarget

    parser = argparse.ArgumentParser('ESP-IDF Partitions Tool Example')

    parser.add_argument('--port', '-p', help='port where the device to perform operations on is connected')
    parser.add_argument('--binary', '-b', help='path to built example binary', default=os.path.join('build', 'parttool.bin'))

    args = parser.parse_args()

    target = ParttoolTarget(args.port)

    # Read app partition and save the contents to a file. The app partition is identified
    # using type-subtype combination
    print('Checking if device app binary matches built binary')
    factory = PartitionType('app', 'factory')
    target.read_partition(factory, 'app.bin')
    assert_file_same(args.binary, 'app.bin', 'Device app binary does not match built binary')

    # Retrieve info on data storage partition, this time identifying it by name.
    storage = PartitionName('storage')
    storage_info = target.get_partition_info(storage)
    print('Found data partition at offset 0x{:x} with size 0x{:x}'.format(storage_info.offset, storage_info.size))

    # Create a file whose contents will be written to the storage partition
    with open('write.bin', 'wb') as f:
        # Create a file to write to the data partition with randomly generated content
        f.write(os.urandom(storage_info.size))

    # Write the contents of the created file to storage partition
    print('Writing to data partition')
    target.write_partition(storage, 'write.bin')

    # Read back the contents of the storage partition
    print('Reading data partition')
    target.read_partition(storage, 'read.bin')

    assert_file_same('write.bin', 'read.bin', 'Read contents of storage partition does not match source file contents')

    # Erase contents of the storage partition
    print('Erasing data partition')
    target.erase_partition(storage)

    # Read back the erased data partition
    print('Reading data partition')
    target.read_partition(storage, 'read.bin')

    # Generate a file of all 0xFF
    generate_blanked_file(storage_info.size, 'blank.bin')

    assert_file_same('blank.bin', 'read.bin', 'Contents of storage partition not fully erased')

    # Example end and cleanup
    print('\nPartition tool operations performed successfully!')
    clean_files = ['app.bin', 'read.bin', 'blank.bin', 'write.bin']
    for clean_file in clean_files:
        os.unlink(clean_file)


if __name__ == '__main__':
    main()