diff options
Diffstat (limited to 'Documentation')
-rw-r--r-- | Documentation/boards/imx/zii-vf610-dev/openocd.cfg | 8 | ||||
-rw-r--r-- | Documentation/devicetree/index.rst | 59 | ||||
-rw-r--r-- | Documentation/user/barebox.rst | 1 |
3 files changed, 61 insertions, 7 deletions
diff --git a/Documentation/boards/imx/zii-vf610-dev/openocd.cfg b/Documentation/boards/imx/zii-vf610-dev/openocd.cfg index 5127c7623d..c94f9d048d 100644 --- a/Documentation/boards/imx/zii-vf610-dev/openocd.cfg +++ b/Documentation/boards/imx/zii-vf610-dev/openocd.cfg @@ -148,10 +148,10 @@ proc ddr_init { } { mww phys 0x400ae210 0x00000506 ;# wm 32 DDRMC_CR132 0x00000506 mww phys 0x400ae224 0x00020000 ;# wm 32 DDRMC_CR137 0x00020000 mww phys 0x400ae228 0x01000100 ;# wm 32 DDRMC_CR138 0x01000100 - mww phys 0x400ae22c 0x04070303 ;# wm 32 DDRMC_CR154 0x682c4000 - mww phys 0x400ae230 0x00000040 ;# wm 32 DDRMC_CR155 0x00000009 - mww phys 0x400ae23c 0x06000080 ;# wm 32 DDRMC_CR158 0x00000006 - mww phys 0x400ae240 0x04070303 ;# wm 32 DDRMC_CR161 0x00010606 + mww phys 0x400ae268 0x682c4000 ;# wm 32 DDRMC_CR154 0x682c4000 + mww phys 0x400ae26c 0x00000009 ;# wm 32 DDRMC_CR155 0x00000009 + mww phys 0x400ae278 0x00000006 ;# wm 32 DDRMC_CR158 0x00000006 + mww phys 0x400ae284 0x00010606 ;# wm 32 DDRMC_CR161 0x00010606 # # flash-header-zii-vf610-dev.imxcfg diff --git a/Documentation/devicetree/index.rst b/Documentation/devicetree/index.rst index c6309defdf..908652642b 100644 --- a/Documentation/devicetree/index.rst +++ b/Documentation/devicetree/index.rst @@ -1,5 +1,60 @@ -Barebox specific devicetree bindings -==================================== +Barebox devicetree handling and bindings +======================================== + +The preferred way of adding board support to barebox is to have devices +on non-enumerable buses probed from device tree. +barebox imports the Linux OpenFirmware ``of_*``-API functions for device tree +parsing, which makes porting the device tree specific bits from device drivers +very straight forward. + +Additionally, barebox has support for programmatically fixing up device trees +it passes to the kernel, either directly via ``of_register_fixup`` or via device +tree overlays. + +Upstream Device Trees +--------------------- + +barebox regularly synchronizes with the Linux kernel device tree definitions +via the `kernel.org Split device-tree repository`_. +They are located under the top-level ``dts/`` directory. + +Patches against ``dts/`` and its subdirectories are not accepted upstream. + +.. _kernel.org Split device-tree repository: https://git.kernel.org/pub/scm/linux/kernel/git/devicetree/devicetree-rebasing.git/ + +barebox Device Trees +-------------------- + +For supporting architectures, barebox device trees are located in +``arch/$ARCH/dts``. Usually the barebox ``board.dts`` imports the upstream +device tree under ``dts/src/$ARCH`` with ``#include "$ARCH/board.dts"`` and +then extends it with barebox-specifics like :ref:`barebox,state`, +environment or boot-time device configuration. + +Device Tree Compiler +-------------------- + +barebox makes use of the ``dtc`` and ``fdtget`` and the underlying ``libfdt`` +from the `Device-Tree Compiler`_ project. + +.. _Device-Tree Compiler: https://git.kernel.org/pub/scm/utils/dtc/dtc.git + +These utilities are built as part of the barebox build process. Additionally, +libfdt is compiled once more as part of the ``CONFIG_BOARD_ARM_GENERIC_DT`` +if selected. + +Steps to update ``scripts/dtc``: + +* Place a ``git-checkout`` of the upstream ``dtc`` directory in the parent + directory of your barebox ``git-checkout``. +* Run ``scripts/dtc/update-dtc-source.sh`` from the top-level barebox directory. +* Wait till ``dtc`` build, test, install and commit conclude. +* Compile-test with ``CONFIG_BOARD_ARM_GENERIC_DT=y``. +* If ``scripts/dtc/Makefile`` or barebox include file changes are necessary, + apply them manually in a commit preceding the ``dtc`` update. + +barebox-specific Bindings +------------------------- Contents: diff --git a/Documentation/user/barebox.rst b/Documentation/user/barebox.rst index c021a4c743..6bea883115 100644 --- a/Documentation/user/barebox.rst +++ b/Documentation/user/barebox.rst @@ -53,7 +53,6 @@ variable and the cross compiler with the ``CROSS_COMPILE`` environment variable. Currently, ``ARCH`` must be one of: * arm -* blackfin * mips * nios2 * openrisc |