aboutsummaryrefslogtreecommitdiff
path: root/Documentation/manual.txt
diff options
context:
space:
mode:
authorSimon Glass <sjg@chromium.org>2018-06-06 12:33:31 -0600
committerDavid Gibson <david@gibson.dropbear.id.au>2018-06-07 21:54:38 +1000
commite617cbe1bd6739a4c530643252264a90e566a5f6 (patch)
tree9a170434ef379e0d03a635b1bbb01c9f27c20203 /Documentation/manual.txt
parent180a93924014dcf57fb46b538b8ec6b017831c6a (diff)
downloaddtc-e617cbe1bd6739a4c530643252264a90e566a5f6.zip
dtc-e617cbe1bd6739a4c530643252264a90e566a5f6.tar.gz
dtc-e617cbe1bd6739a4c530643252264a90e566a5f6.tar.bz2
fdtget: Add documentation
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>
Diffstat (limited to 'Documentation/manual.txt')
-rw-r--r--Documentation/manual.txt31
1 files changed, 31 insertions, 0 deletions
diff --git a/Documentation/manual.txt b/Documentation/manual.txt
index 72403ac..af8d315 100644
--- a/Documentation/manual.txt
+++ b/Documentation/manual.txt
@@ -693,3 +693,34 @@ Where options are:
-i, --input Input base DT blob
-o, --output Output DT blob
-v, --verbose Verbose message output
+
+4 ) fdtget -- Read properties from device tree
+
+This command can be used to obtain individual values from the device tree in a
+nicely formatted way. You can specify multiple nodes to display (when using -p)
+or multiple node/property pairs (when not using -p). For the latter, each
+property is displayed on its own line, with a space between each cell within
+the property.
+
+The syntax of the fdtget command is:
+
+ fdtget <options> <dt file> [<node> <property>]...
+ fdtget -p <options> <dt file> [<node> ]...
+
+where options are:
+
+ <type> s=string, i=int, u=unsigned, x=hex
+ Optional modifier prefix:
+ hh or b=byte, h=2 byte, l=4 byte (default)
+
+ Options: -[t:pld:hV]
+ -t, --type <arg> Type of data
+ -p, --properties List properties for each node
+ -l, --list List subnodes for each node
+ -d, --default <arg> Default value to display when the property is missing
+ -h, --help Print this help and exit
+ -V, --version Print version and exit
+
+If -t is not provided, fdtget will try to figure out the type, trying to detect
+strings, string lists and the size of each value in the property. This is
+similar to how fdtdump works, and uses the same heuristics.