diff options
author | Tom Rini <trini@konsulko.com> | 2020-07-24 08:42:06 -0400 |
---|---|---|
committer | Tom Rini <trini@konsulko.com> | 2020-07-24 08:42:06 -0400 |
commit | 7208396bbf1df1c7a85d263b7ff054e6b45d8240 (patch) | |
tree | 41b20866e0a94e34ca76e54a2745ca7a5ba0889b /doc/driver-model/soc-framework.rst | |
parent | 5d3a21df6694ebd66d5c34c9d62a26edc7456fc7 (diff) | |
download | u-boot-7208396bbf1df1c7a85d263b7ff054e6b45d8240.tar.gz u-boot-7208396bbf1df1c7a85d263b7ff054e6b45d8240.tar.xz u-boot-7208396bbf1df1c7a85d263b7ff054e6b45d8240.zip |
Revert "Merge tag 'dm-pull-20jul20' of git://git.denx.de/u-boot-dm"
This reverts commit 5d3a21df6694ebd66d5c34c9d62a26edc7456fc7, reversing
changes made to 56d37f1c564107e27d873181d838571b7d7860e7.
Unfortunately this is causing CI failures:
https://travis-ci.org/github/trini/u-boot/jobs/711313649
Signed-off-by: Tom Rini <trini@konsulko.com>
Diffstat (limited to 'doc/driver-model/soc-framework.rst')
-rw-r--r-- | doc/driver-model/soc-framework.rst | 68 |
1 files changed, 0 insertions, 68 deletions
diff --git a/doc/driver-model/soc-framework.rst b/doc/driver-model/soc-framework.rst deleted file mode 100644 index 2609fda644..0000000000 --- a/doc/driver-model/soc-framework.rst +++ /dev/null @@ -1,68 +0,0 @@ -.. SPDX-License-Identifier: GPL-2.0+ -.. (C) Copyright 2020 -.. Texas Instruments Incorporated - http://www.ti.com/ - -SOC ID Framework -================ - -Introduction ------------- - -The driver-model SOC ID framework is able to provide identification -information about a specific SoC in use at runtime, and also provide matching -from a set of identification information from an array. This can be useful for -enabling small quirks in drivers that exist between SoC variants that are -impractical to implement using device tree flags. It is based on UCLASS_SOC. - -UCLASS_SOC: - - drivers/soc/soc-uclass.c - - include/soc.h - -Configuration: - - CONFIG_SOC_DEVICE is selected by drivers as needed. - -Implementing a UCLASS_SOC provider ----------------------------------- - -The purpose of this framework is to allow UCLASS_SOC provider drivers to supply -identification information about the SoC in use at runtime. The framework -allows drivers to define soc_ops that return identification strings. All -soc_ops need not be defined and can be left as NULL, in which case the -framework will return -ENOSYS and not consider the value when doing an -soc_device_match. - -It is left to the driver implementor to decide how the information returned is -determined, but in general the same SOC should always return the same set of -identifying information. Information returned must be in the form of a NULL -terminated string. - -See include/soc.h for documentation of the available soc_ops and the intended -meaning of the values that can be returned. See drivers/soc/soc_sandbox.c for -an example UCLASS_SOC provider driver. - -Using a UCLASS_SOC driver -------------------------- - -The framework provides the ability to retrieve and use the identification -strings directly. It also has the ability to return a match from a list of -different sets of SoC data using soc_device_match. - -An array of 'struct soc_attr' can be defined, each containing ID information -for a specific SoC, and when passed to soc_device_match, the identifier values -for each entry in the list will be compared against the values provided by the -UCLASS_SOC driver that is in use. The first entry in the list that matches all -non-null values will be returned by soc_device_match. - -An example of various uses of the framework can be found at test/dm/soc.c. - -Describing the device using device tree ---------------------------------------- - -.. code-block:: none - - chipid: chipid { - compatible = "sandbox,soc"; - }; - -All that is required in a DT node is a compatible for a corresponding -UCLASS_SOC driver. |