summaryrefslogtreecommitdiff
path: root/Documentation
Commit message (Collapse)AuthorAgeFilesLines
* Add support for YAML encoded outputGrant Likely2018-09-131-0/+3
| | | | | | | | | | | | | | YAML encoded DT is useful for validation of DTs using binding schemas. The YAML encoding is an intermediate format used for validation and is therefore subject to change as needed. The YAML output is dependent on DTS input with type information preserved. Signed-off-by: Grant Likely <grant.likely@arm.com> [robh: make YAML support optional, build fixes, Travis CI test, preserve type information in paths and phandles] Signed-off-by: Rob Herring <robh@kernel.org> Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* fdtput: Add documentationSimon Glass2018-06-071-0/+33
| | | | | | | | | | This is missing at present and the fdtput tool could use a litle more information than just its help text. This might be useful for distributions which want to provide a man page. Signed-off-by: Simon Glass <sjg@chromium.org> Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* fdtget: Add documentationSimon Glass2018-06-071-0/+31
| | | | | | | | | | This is missing at present and the fdtget tool is no-longer trivial. Add a little bit of information. This might be useful for distributions which want to provide a man page. Signed-off-by: Simon Glass <sjg@chromium.org> Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* fdtoverlay: A tool that applies overlaysPantelis Antoniou2017-06-151-0/+14
| | | | | | | | | | Since libfdt support overlay application on FDT blobs, provide a command line tool that applies an arbitrary number of overlays, one after another to a base fdt blob and output the result in the given file. Signed-off-by: Pantelis Antoniou <pantelis.antoniou@konsulko.com> Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* manual: Document missing optionsPantelis Antoniou2017-06-141-1/+5
| | | | | | | The -d and -s options were undocumented. Add an entry in the manual. Signed-off-by: Pantelis Antoniou <pantelis.antoniou@konsulko.com> Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* manual: Fix typo it -> inStephen Boyd2017-01-301-1/+1
| | | | | | | Two its in a row can't be right. Signed-off-by: Stephen Boyd <stephen.boyd@linaro.org> Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* dtc: Plugin and fixup supportPantelis Antoniou2016-12-091-1/+20
| | | | | | | | | | | | | | | | | This patch enable the generation of symbols & local fixup information for trees compiled with the -@ (--symbols) option. Using this patch labels in the tree and their users emit information in __symbols__ and __local_fixups__ nodes. The __fixups__ node make possible the dynamic resolution of phandle references which are present in the plugin tree but lie in the tree that are applying the overlay against. Signed-off-by: Pantelis Antoniou <pantelis.antoniou@konsulko.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de> Signed-off-by: Jan Luebbe <jlu@pengutronix.de> Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* dtc: Document the dynamic plugin internalsPantelis Antoniou2016-12-091-0/+310
| | | | | | | | Provides the document explaining the internal mechanics of plugins and options. Signed-off-by: Pantelis Antoniou <pantelis.antoniou@konsulko.com> Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* Update source code location for dtc in manual.txtHeinrich Schuchardt2014-03-031-12/+10
| | | | | | | | The information about the location of the source code of the device tree compiler was inaccurate. Signed-off-by: Heinrich Schuchardt <xypron.glpk@gmx.de> Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* Add documentation on how to submit patchesMichael Ellerman2012-10-161-0/+5
| | | | | Signed-off-by: Michael Ellerman <michael@ellerman.id.au> Acked-by: David Gibson <david@gibson.dropbear.id.au>
* dtc: Implement -d option to write out a dependency fileStephen Warren2012-01-131-0/+3
| | | | | | | | This will allow callers to rebuild .dtb files when any of the /include/d .dtsi files are modified, not just the top-level .dts file. Signed-off-by: Stephen Warren <swarren@nvidia.com> Acked-by: David Gibson <david@gibson.dropbear.id.au>
* fdtdump: rename from ftdumpMike Frysinger2011-10-261-5/+5
| | | | | | | | | | | The freetype package already installs a binary named "ftdump", so the dtc package conflicts with that. So rename the newer dtc tool to "fdtdump". This even makes a bit more sense: ftdump: [F]lat device [T]ree [dump] fdtdump: [F]lat [D]evice [T]ree [dump] Signed-off-by: Mike Frysinger <vapier@gentoo.org> Acked-by: David Gibson <david@gibson.dropbear.id.au>
* dtc: Add support for variable sized elementsAnton Staaf2011-10-111-11/+23
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Elements of size 8, 16, 32, and 64 bits are supported. The new /bits/ syntax was selected so as to not pollute the reserved keyword space with uint8/uint16/... type names. With this patch the following property assignment: property = /bits/ 16 <0x1234 0x5678 0x0 0xffff>; is equivalent to: property = <0x12345678 0x0000ffff>; It is now also possible to directly specify a 64 bit literal in a cell list, also known as an array using: property = /bits/ 64 <0xdeadbeef00000000>; It is an error to attempt to store a literal into an element that is too small to hold the literal, and the compiler will generate an error when it detects this. For instance: property = /bits/ 8 <256>; Will fail to compile. It is also an error to attempt to place a reference in a non 32-bit element. The documentation has been changed to reflect that the cell list is now an array of elements that can be of sizes other than the default 32-bit cell size. The sized_cells test tests the creation and access of 8, 16, 32, and 64-bit sized elements. It also tests that the creation of two properties, one with 16 bit elements and one with 32 bit elements result in the same property contents. Signed-off-by: Anton Staaf <robotboy@chromium.org> Acked-by: David Gibson <david@gibson.dropbear.id.au>
* dtc: Support character literals in cell listsAnton Staaf2011-09-221-1/+1
| | | | | | | | | | | | | With this patch the following property assignment: property = <0x12345678 'a' '\r' 100>; is equivalent to: property = <0x12345678 0x00000061 0x0000000D 0x00000064> Signed-off-by: Anton Staaf <robotboy@chromium.org> Acked-by: David Gibson <david@gibson.dropbear.id.au>
* Some Documentation fixes and generalizations.Jon Loeliger2008-10-031-6/+20
| | | | | | | | | Updated a jdl.com URL reference. Generalized the new section IV to be "Utility Tools" and added a small blurb about ftdump as well. Signed-off-by: Jon Loeliger <jdl@jdl.com>
* Install & document convert-dtsv0Niklaus Giger2008-10-031-0/+20
| | | | | Signed-off-by: Niklaus Giger <niklaus.giger@member.fsf.org> Acked-by: David Gibson <david@gibson.dropbear.id.au>
* dtc: Add some documentation for the dts formtaDavid Gibson2008-03-231-0/+110
| | | | | | | | This patch adds a dts-format.txt in the Documentation directory, with an introduction to the dtc source format. Note that this documentation is also going into the upcoming ePAPR specification. Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* dtc: Whitespace cleanupDavid Gibson2007-09-182-2/+2
| | | | | | | | | | | | This large patch removes all trailing whitespace from dtc (including libfdt, the testsuite and documentation). It also removes a handful of redundant blank lines (at the end of functions, or when there are two blank lines together for no particular reason). As well as anything else, this means that quilt won't whinge when I go to convert the whole of libfdt into a patch to apply to the kernel. Signed-off-by: David Gibson <david@gibson.dropbear.id.au>
* Add initial Device Tree Compiler manualJon Loeliger2007-08-092-1420/+618
| | | | | | | | This is the new location for technical descriptions of the DTC. Derived from the kernel's Documentation/powerpc/booting-without-of.txt. The booting-without-of.txt that was here was very old and out of date. Signed-off-by: Jon Loeliger <jdl@freescale.com>
* Add paper on the flattened tree and dtc presented at linux.conf.au 2006 bydwg-lastDavid Gibson2006-01-312-0/+640
| | | | way of some more documentation.
* [PATCH] dtc: Update flat OF doc for new mdio propertiesBecky Bruce2006-01-111-1/+6
| | | | | | | Add device-type and compatible as required fields for mdio node; add eTSEC to ethernet model options. Signed-off-by: Becky Bruce <Becky.bruce@freescale.com>
* Added document describing flattened tree format and what properties / nodesDavid Gibson2005-12-061-0/+1415
the kernel needs. Written by BenH and Becky Bruce.