===== Overview =====

Stuff related to device trees and the Linux kernel, using examples from the current Linux kernel.

===== TO DO =====

  * overlays
  * keywords (/plugin/, /memreserve/, /omit-if-no-ref/, /bits/)

===== MISC (for now) =====

  * "The unit-address must match the first address specified in the reg property of the node. If the node has no reg property, the @unit-address must be omitted and the node-name alone differentiates the node from other nodes at the same level in the tree. The binding for a particular bus may specify additional, more specific requirements for the format of reg and the unit-address."

===== Some links =====

General links:

  * [[https://www.devicetree.org/|devicetree.org]]
  * [[http://developer.toradex.com/device-tree-customization|Toradex: Device tree customization]]
  * [[http://free-electrons.com/pub/conferences/2014/elc/petazzoni-device-tree-dummies/|Thomas Petazzoni's "Device Tree for Dummies"]]
  * [[https://www.nxp.com/docs/en/application-note/AN5125.pdf|NXP: Introduction to Device Trees]]
  * [[https://www.openfirmware.info/data/docs/of1275.pdf|IEEE 1275]]

Kernel links:

  * [[https://github.com/torvalds/linux/tree/master/Documentation|Documentation/]]
    * [[https://github.com/torvalds/linux/tree/master/Documentation/devicetree|devicetree/]]
  * [[https://github.com/torvalds/linux/tree/master/include|include/]]
    * [[https://github.com/torvalds/linux/tree/master/include/dt-bindings|dt-bindings/]]
  * [[https://github.com/torvalds/linux/tree/master/drivers|drivers/]]
    * [[https://github.com/torvalds/linux/tree/master/drivers/of|of/]]

elinux.org pages:

    * [[https://elinux.org/Device_Tree_Reference|Device Tree Reference]]
    * [[https://elinux.org/Device_Tree_Usage|Device Tree Usage]]
    * [[https://elinux.org/Device_Tree_Source_Undocumented|Device_Tree_Source_Undocumented]]
    * [[https://elinux.org/Device_Tree_Mysteries|Device_Tree_Mysteries]]

Xillybus Zynq Device Tree Tutorial:

    * [[http://xillybus.com/tutorials/device-tree-zynq-1|Part 1]]
    * [[http://xillybus.com/tutorials/device-tree-zynq-2|Part 2]]
    * [[http://xillybus.com/tutorials/device-tree-zynq-3|Part 3]]
    * [[http://xillybus.com/tutorials/device-tree-zynq-4|Part 4]]
    * [[http://xillybus.com/tutorials/device-tree-zynq-5|Part 5]]
    * [[http://xillybus.com/tutorials/device-tree-altera-soc-cyclone|Setting up a device tree entry on Altera’s SoC FPGAs]]

===== Internal wiki pages =====

  * [[Device tree naming conventions]]
  * [[Proper device tree design]]
  * [[Device tree standard properties]]
  * [[Device tree node requirements]]
  * [[Comparing device trees with dtx_diff]]
  * [[Hierarchical device files]]