Home | History | Annotate | only in /external/dtc
Up to higher level directory
NameDateSize
.travis.yml21-Aug-2018719
Android.bp21-Aug-201827
Android.mk21-Aug-2018578
checks.c21-Aug-201828.4K
convert-dtsv0-lexer.l21-Aug-20185K
data.c21-Aug-20185.1K
Documentation/21-Aug-2018
dtc-lexer.l21-Aug-20186.7K
dtc-parser.y21-Aug-20189.8K
dtc.c21-Aug-20189.3K
dtc.h21-Aug-20188.2K
dtdiff21-Aug-2018636
fdtdump.c21-Aug-20185.9K
fdtget.c21-Aug-20188.8K
fdtoverlay.c21-Aug-20183.9K
fdtput.c21-Aug-201811.3K
flattree.c21-Aug-201822.2K
fstree.c21-Aug-20182.2K
GPL21-Aug-201817.6K
libfdt/21-Aug-2018
livetree.c21-Aug-201820K
Makefile21-Aug-20187.6K
Makefile.convert-dtsv021-Aug-2018286
Makefile.dtc21-Aug-2018372
Makefile.utils21-Aug-2018455
MODULE_LICENSE_GPL21-Aug-20180
NOTICE21-Aug-201817.6K
pylibfdt/21-Aug-2018
README21-Aug-20182.4K
README.license21-Aug-20182.9K
README.version21-Aug-2018149
scripts/21-Aug-2018
srcpos.c21-Aug-20186.8K
srcpos.h21-Aug-20183.5K
tests/21-Aug-2018
TODO21-Aug-2018260
treesource.c21-Aug-20186K
util.c21-Aug-20189.4K
util.h21-Aug-20187.6K
version_non_gen.h21-Aug-201846

README

      1 The source tree contains the Device Tree Compiler (dtc) toolchain for
      2 working with device tree source and binary files and also libfdt, a
      3 utility library for reading and manipulating the binary format.
      4 
      5 DTC and LIBFDT are maintained by:
      6 
      7 David Gibson <david (a] gibson.dropbear.id.au>
      8 Jon Loeliger <jdl (a] jdl.com>
      9 
     10 
     11 Python library
     12 --------------
     13 
     14 A Python library is also available. To build this you will need to install
     15 swig and Python development files. On Debian distributions:
     16 
     17    sudo apt-get install swig python-dev
     18 
     19 The library provides an Fdt class which you can use like this:
     20 
     21 $ PYTHONPATH=../pylibfdt python
     22 >>> import libfdt
     23 >>> fdt = libfdt.Fdt(open('test_tree1.dtb').read())
     24 >>> node = fdt.path_offset('/subnode@1')
     25 >>> print node
     26 124
     27 >>> prop_offset = fdt.first_property_offset(node)
     28 >>> prop = fdt.get_property_by_offset(prop_offset)
     29 >>> print '%s=%r' % (prop.name, prop.value)
     30 compatible=bytearray(b'subnode1\x00')
     31 >>> print '%s=%s' % (prop.name, prop.value)
     32 compatible=subnode1
     33 >>> node2 = fdt.path_offset('/')
     34 >>> print fdt.getprop(node2, 'compatible')
     35 test_tree1
     36 
     37 You will find tests in tests/pylibfdt_tests.py showing how to use each
     38 method. Help is available using the Python help command, e.g.:
     39 
     40     $ cd pylibfdt
     41     $ python -c "import libfdt; help(libfdt)"
     42 
     43 If you add new features, please check code coverage:
     44 
     45     $ sudo apt-get install python-pip python-pytest
     46     $ sudo pip install coverage
     47     $ cd tests
     48     $ coverage run pylibfdt_tests.py
     49     $ coverage html
     50     # Open 'htmlcov/index.html' in your browser
     51 
     52 
     53 To install the library via the normal setup.py method, use:
     54 
     55     ./pylibfdt/setup.py [--prefix=/path/to/install_dir]
     56 
     57 If --prefix is not provided, the default prefix is used, typically '/usr'
     58 or '/usr/local'. See Python's distutils documentation for details. You can
     59 also install via the Makefile if you like, but the above is more common.
     60 
     61 To install both libfdt and pylibfdt you can use:
     62 
     63     make install [SETUP_PREFIX=/path/to/install_dir] \
     64             [PREFIX=/path/to/install_dir]
     65 
     66 To disable building the python library, even if swig and Python are available,
     67 use:
     68 
     69     make NO_PYTHON=1
     70 
     71 
     72 More work remains to support all of libfdt, including access to numeric
     73 values.
     74 
     75 
     76 Mailing list
     77 ------------
     78 The following list is for discussion about dtc and libfdt implementation
     79 mailto:devicetree-compiler (a] vger.kernel.org
     80 
     81 Core device tree bindings are discussed on the devicetree-spec list:
     82 mailto:devicetree-spec (a] vger.kernel.org
     83 

README.license

      1 Licensing and contribution policy of dtc and libfdt
      2 ===================================================
      3 
      4 This dtc package contains two pieces of software: dtc itself, and
      5 libfdt which comprises the files in the libfdt/ subdirectory.  These
      6 two pieces of software, although closely related, are quite distinct.
      7 dtc does not incoporate or rely on libfdt for its operation, nor vice
      8 versa.  It is important that these two pieces of software have
      9 different license conditions.
     10 
     11 As the copyright banners in each source file attest, dtc is licensed
     12 under the GNU GPL.  The full text of the GPL can be found in the file
     13 entitled 'GPL' which should be included in this package.  dtc code,
     14 therefore, may not be incorporated into works which do not have a GPL
     15 compatible license.
     16 
     17 libfdt, however, is GPL/BSD dual-licensed.  That is, it may be used
     18 either under the terms of the GPL, or under the terms of the 2-clause
     19 BSD license (aka the ISC license).  The full terms of that license are
     20 given in the copyright banners of each of the libfdt source files.
     21 This is, in practice, equivalent to being BSD licensed, since the
     22 terms of the BSD license are strictly more permissive than the GPL.
     23 
     24 I made the decision to license libfdt in this way because I want to
     25 encourage widespread and correct usage of flattened device trees,
     26 including by proprietary or otherwise GPL-incompatible firmware or
     27 tools.  Allowing libfdt to be used under the terms of the BSD license
     28 makes that it easier for vendors or authors of such software to do so.
     29 
     30 This does mean that libfdt code could be "stolen" - say, included in a
     31 proprietary fimware and extended without contributing those extensions
     32 back to the libfdt mainline.  While I hope that doesn't happen, I
     33 believe the goal of allowing libfdt to be widely used is more
     34 important than avoiding that.  libfdt is quite small, and hardly
     35 rocket science; so the incentive for such impolite behaviour is small,
     36 and the inconvenience caused therby is not dire.
     37 
     38 Licenses such as the LGPL which would allow code to be used in non-GPL
     39 software, but also require contributions to be returned were
     40 considered.  However, libfdt is designed to be used in firmwares and
     41 other environments with unusual technical constraints.  It's difficult
     42 to anticipate all possible changes which might be needed to meld
     43 libfdt into such environments and so difficult to suitably word a
     44 license that puts the boundary between what is and isn't permitted in
     45 the intended place.  Again, I judged encouraging widespread use of
     46 libfdt by keeping the license terms simple and familiar to be the more
     47 important goal.
     48 
     49 **IMPORTANT** It's intended that all of libfdt as released remain
     50 permissively licensed this way.  Therefore only contributions which
     51 are released under these terms can be merged into the libfdt mainline.
     52 
     53 
     54 David Gibson <david (a] gibson.dropbear.id.au>
     55 (principal original author of dtc and libfdt)
     56 2 November 2007
     57 

README.version

      1 URL: https://git.kernel.org/cgit/utils/dtc/dtc.git/commit/?id=120775eb1cf39f8dcecd695c3ff1cfef8aeb669d
      2 Version: 1.4.2 plus bugfixes
      3 Owners: cphoenix
      4