summaryrefslogtreecommitdiffstats
path: root/Documentation/devicetree
Commit message (Collapse)AuthorAgeFilesLines
* Documentation: regulator: reference new directory from indexAhmad Fatoum2022-01-261-0/+1
| | | | | | | | The binding was recently added, but unreferenced. Fix this. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Link: https://lore.barebox.org/20220124151827.3313412-4-a.fatoum@pengutronix.de Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* documentation: regulator: add allow-dummy-supplyAndrej Picej2021-11-251-0/+35
| | | | | | | | Add "barebox,allow-dummy-supply" property documentation. Signed-off-by: Andrej Picej <andrej.picej@norik.com> Link: https://lore.barebox.org/20211119095429.1905473-7-andrej.picej@norik.com Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: add barebox porter's guideAhmad Fatoum2021-04-131-0/+2
| | | | | | | | Make new porters' life easier by having a central place for porting advice and add some initial content there. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: devicetree: include firmware in toctreeThorsten Scherer2021-02-241-0/+1
| | | | | | | | Fix Sphinx consistency warning. Fixes: fcdcb8177 ("documentation: devicetree: migrate remaining binding to reST") Signed-off-by: Thorsten Scherer <tsc@scherer.tk> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* documentation: devicetree: migrate remaining binding to reSTAhmad Fatoum2021-01-134-49/+56
| | | | | | | | | | | Eventually, we will want to have formalized YAML bindings and scripts to turn them into reST for display in the online documentation. For now, just turn the remaining text files into reST, so they can be searched as well. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/misc'Sascha Hauer2020-07-271-3/+5
|\
| * Documentation: devicetree: hint at libfdt being availableAhmad Fatoum2020-06-181-3/+5
| | | | | | | | | | | | | | | | | | Since 7e5a875fff7d ("Compile libfdt for barebox"), we now also have libfdt for operating on flattened device trees out of the PBL. Document this. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: devicetree: codify extension of upstream DTS by phandlesAhmad Fatoum2020-06-231-0/+43
|/ | | | | | | | | | | | | | | | Sync with the upstream device tree repository has been a common cause for breakage in barebox. Often unnoticed: * New bindings are merged upstream and device trees migrated, but barebox didn't yet have support * Nodes are renamed upstream, but barebox still extends the old name, with duplicate nodes resulting We can solve the second one by requiring dtc to give us errors when paths we extend no longer exist. Document how to do so. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* led: parse panic-indicator from device-treeHubert Feurstein2019-12-111-0/+3
| | | | | Signed-off-by: Hubert Feurstein <h.feurstein@gmail.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* led: add documentation for net-tx and net-rx triggersHubert Feurstein2019-12-111-1/+3
| | | | | Signed-off-by: Hubert Feurstein <h.feurstein@gmail.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: document barebox device tree handlingAhmad Fatoum2019-10-021-2/+57
| | | | | | | | | The way barebox handles the Linux device trees and the device tree compiler source included in the source tree may not be obvious to new developers. Add a basic high-level documentation. Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* misc: Add a driver to expose U-Boot environment variable dataAndrey Smirnov2019-06-071-0/+43
| | | | | | | | | | | | | | | Add a driver to expose U-Boot environment variable data as a single mmap-able device, hiding various low-level details such as: * Preamble format differences * Read/write logic in presence of redundant partition Not very useful on its own, it is a crucial low-level plumbing needed by filesystem driver introduced in the following commit. Signed-off-by: Andrey Smirnov <andrew.smirnov@gmail.com> Signed-off-by: Cory Tusar <cory.tusar@zii.aero> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: Documentation: fix typoUlrich Ölmann2019-02-071-1/+1
| | | | | Signed-off-by: Ulrich Ölmann <u.oelmann@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* documentation: document eMMC boot{0,1}-partitions bindingAhmad Fatoum2018-12-061-0/+18
| | | | | | | | The described binding was implemented in commit 6e9a87b39 ("mci: Allow to partition eMMC boot partitions"). Signed-off-by: Ahmad Fatoum <a.fatoum@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* ARM: dts: remove @0 from environment nodesSascha Hauer2018-06-191-1/+1
| | | | | | | The environment nodes do not have a reg property and as such should not have a @0 suffix. Newer dtc warns about this, so remove it. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* common: state: Add property to protect existing dataDaniel Schultz2018-04-161-0/+3
| | | | | | | | | | | After an update to a newer barebox version with an enabled state framework, existing data in storage memories could be overwritten. Add a new property to check in front of every write task, if the meta magic field only contains the magic number, zeros or ones. Signed-off-by: Daniel Schultz <d.schultz@phytec.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: Documentation: Fix typoSascha Hauer2018-01-221-2/+2
| | | | | | underlaying -> underlying Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: Documentation: fix typoUlrich Ölmann2018-01-221-1/+1
| | | | | Signed-off-by: Ulrich Ölmann <u.oelmann@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/misc'Sascha Hauer2018-01-051-1/+1
|\
| * Documentation: devicetree: m25p80: fix referenced filenameUlrich Ölmann2017-11-281-1/+1
| | | | | | | | | | | | | | | | | | Linux changed the filename in commit 8947e396a829 ("Documentation: dt: mtd: replace "nor-jedec" binding with "jedec, spi-nor"") and barebox imported this change in commit 8ed978b79062 ("dts: update to v4.1-rc4"). Signed-off-by: Ulrich Ölmann <u.oelmann@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: remove :numbered: from lower level toctreesSascha Hauer2017-12-011-1/+0
| | | | | | | | | | | | | | Only the highest level toctree may have :numbered:, otherwise sphinxs complains loudly that the subtree is already numbered. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | Documentation: Change many code blocks to no highlightSascha Hauer2017-12-013-3/+9
|/ | | | | | | Several blocks cannot be sensibly highlighted, so change the highliting to 'none'. Fixes many warnings in building the documentation. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/state'Sascha Hauer2017-09-082-121/+214
|\
| * state: use the given backend storage type nameJuergen Borleis2017-09-061-2/+4
| | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | | Change 119f92b27e131a0cb506fe8d8bffe8010fb14a3d already tried to fix it, but forgets the 'direct' usecase. The 'backend-storage-type' node is optional. Its default depends on the capability of the used backend memory, which means "circular" or NULL. The latter defaults to 'direct' in the routines. If it is NULL, the devicetree fixup routine skips exporting a 'backend-storage-type' node to the kernel's devicetree. But currently if the 'backend-storage-type' node is explicitly given as 'direct', it will be skipped silently and set to NULL instead. In this case the user of the 'barebox-state' tool then ends up with the warning: "No backend-storage-type found, using default" which is annoying, because it was given. Storing the given value will still use a NULL if the 'backend-storage-type' node isn't defined, but stores everything else if it is defined. Then the 'backend-storage-type' node is present in the kernel's devicetree as well. Signed-off-by: Juergen Borleis <jbe@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * docs: rework and extend the 'state' and 'bootchooser' documentationJuergen Borleis2017-09-061-121/+211
| | | | | | | | | | | | | | | | Many links between sections and examples were added to give the developer the help to get it work. Signed-off-by: Juergen Borleis <jbe@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
| * docs: remove build warningJuergen Borleis2017-09-061-0/+1
| | | | | | | | | | | | | | | | | | This change removes: "devicetree/bindings/rtc/dallas,ds1307.rst: WARNING: document isn't included in any toctree" warning Signed-off-by: Juergen Borleis <jbe@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | docs/DS1307: fix layoutJuergen Borleis2017-09-061-1/+6
|/ | | | | Signed-off-by: Juergen Borleis <jbe@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* of: of_path: find device via partuuidSteffen Trumtrar2017-07-101-0/+21
| | | | | | | | When a node is compatible to a fixed-partitions, support searching the corresponding device via the partuuid, if it specified in the device tree. Signed-off-by: Steffen Trumtrar <s.trumtrar@pengutronix.de> Signed-off-by: Lucas Stach <l.stach@pengutronix.de>
* Merge branch 'for-next/misc'Sascha Hauer2017-06-141-1/+2
|\
| * firmware: altera-serial: add support for Arria 10Bastian Stender2017-06-091-1/+2
| | | | | | | | | | | | | | | | | | | | | | | | | | Make FPGA specific settings configurable (padding, spi bits per word, delays) and add Arria 10 support. The Arria 10 compatible is the same as in the kernel patch "fpga manager: Add altera-ps-spi driver for Altera FPGAs" (drivers/fpga/altera-ps-spi.c). The Arria 5 compatible works unchanged. This patch was tested with Arria 5 and Arria 10. Signed-off-by: Bastian Stender <bst@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | state: Fix example in documentationSascha Hauer2017-05-091-1/+1
|/ | | | | | | The backend property must contain a phandle, so use a phandle in the example. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: Make an alias mandatorySascha Hauer2017-05-041-0/+6
| | | | | | | | The userspace barebox-state utility gets confused when no alias exists. Make the alias mandatory, so that people make it right^tm without having to ask. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: Binding: remove @0 from node nameSascha Hauer2017-05-041-1/+1
| | | | | | | | The '@0' suffix is for nodes which have a reg property, so do not use this suffix in the state example node which does not have a reg property. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: backend_circular: default to circular storageSascha Hauer2017-03-311-3/+3
| | | | | | | | Default to the new circular storage format which saves erase cycles. The old format can still be selected with backend-storage-type = "noncircular". Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: Make pointing to the backend using a phandle the only supported methodSascha Hauer2017-03-311-7/+20
| | | | | | | | | | All other methods are broken for some time already: When starting the kernel the state code rewrites the state node in the device tree and replaced the "backend" property with a phandle - even when the target can't be described as a phandle. Since using phandles is the nicest way to point to the storage device anyway remove the other methods. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* docs: state: make string variable type clearerStefan Lengfeld2016-11-031-2/+2
| | | | | | | Only fixed length strings are supported. Make the wording clearer. Signed-off-by: Stefan Lengfeld <s.lengfeld@phytec.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* docs: Add/Update state documentationMarkus Pargmann2016-07-081-1/+6
| | | | | Signed-off-by: Markus Pargmann <mpa@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* rtc: ds1307: Add support for configuring external clock pinTrent Piepho2016-05-301-0/+33
| | | | | | | | | | | | | | | | | | | | The DS1307 has a square wave output pin, which can be used to output a clock signal from the DS1307. Additionally, the DS1308 supports configuring this pin as an input from an external clock source to which it should sync itself. Add support with OF device tree properties to configure these settings. Supported features are using the clock pin as an output, an input, the rate of the pin, and if it should be enabled on battery backup power. The driver does not check that the selected features are supported by the clock chip being used. It is the designer's responsibility to create a valid device tree node; the bootloader does not attempt to be a device tree validator. Signed-off-by: Trent Piepho <tpiepho@kymetacorp.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Documentation: m25p80: include in documentationRobert Schwebel2016-02-101-0/+1
| | | | | | | | | | | Fix this warning: checking consistency... [...]Documentation/devicetree/bindings/mtd/m25p80.rst:: WARNING: document isn't included in any toctree by including the document. Signed-off-by: Robert Schwebel <r.schwebel@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* docs: fix typosUlrich Ölmann2016-02-041-1/+1
| | | | | Signed-off-by: Ulrich Ölmann <u.oelmann@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* environment: Support env from file in a file-system via device treeTrent Piepho2016-01-081-1/+14
| | | | | | | | | | | | | | | Current barebox,environment node only allows specifying a raw device or partition to load an environment from. Some boards, like OMAP and SoCFPGA, instead want to use a file located in a FAT filesystem. Extend the device tree bindings with a new property 'file-path' that will trigger this behavior. This allows any board using this driver to get the env from a file or from a raw device, instead of each machine type being either raw device only or file only. Signed-off-by: Trent Piepho <tpiepho@kymetacorp.com> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: implement signed int supportSascha Hauer2016-01-081-2/+3
| | | | Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: backend_raw: add hmac supportMarc Kleine-Budde2015-11-271-0/+19
| | | | | | | | | | | | This patch adds hmac support to the raw backend. With this patch, modifications of the header or data of a state partition can be detected, as the hmac woudln't match anymore. The hmac relies on a shared secret, which is requested from the keystore, with keystore_get_secret() using the name of the state partition as the "name" of the secret. Signed-off-by: Marc Kleine-Budde <mkl@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* Merge branch 'for-next/of_path'Sascha Hauer2015-09-011-2/+3
|\
| * of_path: Allow pointing directly to the partitionSascha Hauer2015-09-011-2/+3
| | | | | | | | | | | | | | | | We could only point to partitions in the device tree by using &norflash, "partname:barebox-environment". Allow to point to the partition directly without having to parse the partition labels. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* | mtd: m25p80: make it possible to use large blocks if desiredSascha Hauer2015-08-261-0/+10
|/ | | | | | | | | | Some SPI NOR flashes support 4K erase blocks. 4K erase blocks do not work with UBIFS which needs a minimum erase block size of 15360 bytes. Also bigger sectors are faster to erase. This patch adds a device tree option to use the bigger blocks instead of the default 4K blocks. Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de> Signed-off-by: Philipp Zabel <p.zabel@pengutronix.de>
* state: add support for fixed length stringsMarc Kleine-Budde2015-06-261-4/+15
| | | | | Signed-off-by: Marc Kleine-Budde <mkl@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: Documentation: fix dts code exampleMarc Kleine-Budde2015-06-171-3/+3
| | | | | | | It's "uint32" not "u32" and we use integers for the "enum32" defaults. Signed-off-by: Marc Kleine-Budde <mkl@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: Documentation: the backend properties are not optional (anymore)Marc Kleine-Budde2015-06-171-3/+0
| | | | | Signed-off-by: Marc Kleine-Budde <mkl@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>
* state: Documentation: add newly implemented "uint8" types.Marc Kleine-Budde2015-06-171-5/+5
| | | | | | Cc: Jan Luebbe <jluebbe@debian.org> Signed-off-by: Marc Kleine-Budde <mkl@pengutronix.de> Signed-off-by: Sascha Hauer <s.hauer@pengutronix.de>