dm: tag: add some document

Some basic stuff about tag support is explained under
doc/devlop/driver-model.

Signed-off-by: AKASHI Takahiro <takahiro.akashi@linaro.org>
Reviewed-by: Simon Glass <sjg@chromium.org>
This commit is contained in:
AKASHI Takahiro
2022-04-15 16:15:36 +09:00
committed by Heinrich Schuchardt
parent a806f33401
commit b77324d831

View File

@@ -1042,6 +1042,27 @@ data structure might be worthwhile in some rare cases, once we understand
what the bottlenecks are.
Tag Support
-----------
It is sometimes useful for a subsystem to associate its own private
data (or object) to a DM device, i.e. struct udevice, to support
additional features.
Tag support in driver model will give us the ability to do so dynamically
instead of modifying "udevice" data structure. In the initial release, we
will support two type of attributes:
- a pointer with dm_tag_set_ptr(), and
- an unsigned long with dm_tag_set_val()
For example, UEFI subsystem utilizes the feature to maintain efi_disk
objects depending on linked udevice's lifecycle.
While the current implementation is quite simple, it will get evolved
as the feature is more extensively used in U-Boot subsystems.
Changes since v1
----------------