mirror of
https://source.denx.de/u-boot/u-boot.git
synced 2025-08-07 15:56:59 +02:00
It is very surprising that such an uclass, specifically designed to handle resources that may be shared by different devices, is not keeping the count of the number of times a power domain has been enabled/disabled to avoid shutting it down unexpectedly or disabling it several times. Doing this causes troubles on eg. i.MX8MP because disabling power domains can be done in recursive loops were the same power domain disabled up to 4 times in a row. PGCs seem to have tight FSM internal timings to respect and it is easy to produce a race condition that puts the power domains in an unstable state, leading to ADB400 errors and later crashes in Linux. Some drivers implement their own mechanism for that, but it is probably best to add this feature in the uclass and share the common code across drivers. In order to avoid breaking existing drivers, refcounting is only enabled if the number of subdomains a device node supports is explicitly set in the probe function. ->xlate() callbacks will return the power domain ID which is then being used as the array index to reach the correct refcounter. As we do not want to break existing users while stile getting interesting error codes, the implementation is split between: - a low-level helper reporting error codes if the requested transition could not be operated, - a higher-level helper ignoring the "non error" codes, like EALREADY and EBUSY. CI tests using power domains are slightly updated to make sure the count of on/off calls is even and the results match what we *now* expect. They are also extended to test the low-level functions. Signed-off-by: Miquel Raynal <miquel.raynal@bootlin.com>
21 lines
595 B
C
21 lines
595 B
C
/* SPDX-License-Identifier: GPL-2.0 */
|
|
/*
|
|
* Copyright (c) 2016, NVIDIA CORPORATION.
|
|
*/
|
|
|
|
#ifndef __SANDBOX_POWER_DOMAIN_H
|
|
#define __SANDBOX_POWER_DOMAIN_H
|
|
|
|
struct udevice;
|
|
|
|
int sandbox_power_domain_query(struct udevice *dev, unsigned long id);
|
|
|
|
int sandbox_power_domain_test_get(struct udevice *dev);
|
|
int sandbox_power_domain_test_on(struct udevice *dev);
|
|
int sandbox_power_domain_test_off(struct udevice *dev);
|
|
int sandbox_power_domain_test_on_ll(struct udevice *dev);
|
|
int sandbox_power_domain_test_off_ll(struct udevice *dev);
|
|
int sandbox_power_domain_test_free(struct udevice *dev);
|
|
|
|
#endif
|