Djam/u-boot
1
0
Fork 0
mirror of https://github.com/u-boot/u-boot.git synced 2025-04-30 16:35:37 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions

dm: clarify DM_FLAG_PROBE_AFTER_BIND behaviour

Browse source 
The DM_FLAG_PROBE_AFTER_BIND flag only makes sense on a per-device
basis, however recently added documentation as well as some confused
drivers imply that it might be added to a driver definition, this does
nothing.

Clarify the new documentation and expand on the comment by the
definition to point people in the right direction.

Signed-off-by: Caleb Connolly <caleb.connolly@linaro.org>
Reviewed-by: Simon Glass <sjg@chromium.org>
Acked-by: Michal Simek <michal.simek@amd.com>
This commit is contained in:
Caleb Connolly 2025-01-17 08:28:56 +01:00 • committed by Tom Rini
parent c11dc783fb
commit 8a0e6212bb
2 changed files with 8 additions and 3 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

6
doc/develop/driver-model/design.rst
View file

@ -843,8 +843,10 @@ steps (see device_probe()):
activated and 'known' by the uclass. activated and 'known' by the uclass.
For some platforms, certain devices must be probed to get the platform into For some platforms, certain devices must be probed to get the platform into
a working state. To help with this, drivers marked with DM_FLAG_PROBE_AFTER_BIND a working state. To help with this, devices marked with DM_FLAG_PROBE_AFTER_BIND
will be probed immediately after all devices are bound. For now, this happens in will be probed immediately after all devices are bound. This flag must be set
on the device in its ``bind()`` function with
``dev_or_flags(dev, DM_FLAG_PROBE_AFTER_BIND)``. For now, this happens in
SPL, before relocation and after relocation. See the call to ``dm_autoprobe()`` SPL, before relocation and after relocation. See the call to ``dm_autoprobe()``
for where this is done. for where this is done.

5
include/dm/device.h
View file

@ -81,7 +81,10 @@ struct driver_info;
*/ */
#define DM_FLAG_VITAL (1 << 14) #define DM_FLAG_VITAL (1 << 14)
/* Device must be probed after it was bound */ /* Device must be probed after it was bound. This flag is per-device and does
* nothing if set on a U_BOOT_DRIVER() definition. Apply it with
* dev_or_flags(dev, DM_FLAG_PROBE_AFTER_BIND) in the devices bind function.
*/
#define DM_FLAG_PROBE_AFTER_BIND (1 << 15) #define DM_FLAG_PROBE_AFTER_BIND (1 << 15)
/* /*