Flattened Device Tree Python Module

This python module is usable for manipulation with Device Tree Data and primary was created for i.MX Smart-Boot Tool

Some parts in this module have been reused from https://github.com/superna9999/pyfdt project.

Dependencies

• Python 3 - The interpreter
• Click - Python package for creating beautiful command line interface.

Installation

To install the latest version from master branch execute in shell following command:

    $ pip3 install -U https://github.com/molejar/pyFDT/archive/master.zip

In case of development, install it from cloned sources:

    $ git clone https://github.com/molejar/pyFDT.git
    $ cd pyFDT
    $ pip3 install -U -e .

NOTE: You may run into a permissions issues running these commands. Here are a few options how to fix it:

1. Run with sudo to install fdt and dependencies globally
2. Specify the --user option to install locally into your home directory (export "~/.local/bin" into PATH variable if haven't).
3. Run the command in a virtualenv local to a specific project working set.

Usage

    import fdt
    
    #-----------------------------------------------
    # convert *.dtb to *.dts
    # ----------------------------------------------
    with open("example.dtb", "rb") as f:
        dtb_data = f.read()
        
    dt = fdt.parse_dtb(dtb_data)
    
    with open("example.dts", "w") as f:
        f.write(dt.to_dts())
        
    #-----------------------------------------------
    # convert *.dts to *.dtb
    # ----------------------------------------------
    with open("example.dts", "r") as f:
        dts_text = f.read()
        
    dt = fdt.parse_dts(dts_text)
    
    with open("example.dtb", "wb") as f:
        f.write(dt.to_dtb(version=17))

[ pydtc ] Tool

The python device tree converter pydtc is a tool for conversion *.dts to *.dtb and vice versa. Is distributed together with fdt module. This tool can be used as replacement of device tree compiler.

  $ pydtc -?

Usage: pydtc [OPTIONS] COMMAND [ARGS]...

  Device Tree Converter (DTC) is a tool for converting device tree binary
  blob (*.dtb) to readable text file (*.dts) and reverse

Options:
  -v, --version  Show the version and exit.
  -?, --help     Show this message and exit.

Commands:
  todtb  Convert *.dts to *.dtb
  todts  Convert *.dtb to *.dts

$ pydtc todts OUTFILE INFILE

Convert Device Tree in binary blob (.dtb) to readable text file (.dts)

OUTFILE - The path and name of output file *.dts
INFILE - The path and name of input file *.dtb

options:

• -t, --tabsize - Tabulator Size
• -?, --help - Show help message and exit

Example:

  $ pydtc todts output.dts input.dtb
    
    DTS saved as: output.dts

$ pydtc todtb OUTFILE INFILES

Convert Device Tree in readable text file (.dts) to binary blob (.dtb)

If used more than one input file, all will be merged into one *.dtb

OUTFILE - The path and name of output file *.dtb
INFILES - List of input files *.dts

options:

• -v, --version - DTB Version
• -l, --lcversion - DTB Last Compatible Version
• -c, --cpuid - Boot CPU ID
• -a, --align - Make the blob align to the
• -p, --padding - Add padding to the blob of long
• -s, --size - Make the blob at least long
• -?, --help - Show help message and exit

Example:

  $ pydtc todtb -v 17 output.dtb input.dts
  
    DTB saved as: output.dtb