xref: /arm-trusted-firmware/include/drivers/st/stm32mp_reset.h (revision 91f16700b400a8c0651d24a598fc48ee2997a0d7)
1*91f16700Schasinglulu /*
2*91f16700Schasinglulu  * Copyright (c) 2018-2019, STMicroelectronics - All Rights Reserved
3*91f16700Schasinglulu  *
4*91f16700Schasinglulu  * SPDX-License-Identifier: BSD-3-Clause
5*91f16700Schasinglulu  */
6*91f16700Schasinglulu 
7*91f16700Schasinglulu #ifndef STM32MP_RESET_H
8*91f16700Schasinglulu #define STM32MP_RESET_H
9*91f16700Schasinglulu 
10*91f16700Schasinglulu #include <stdint.h>
11*91f16700Schasinglulu 
12*91f16700Schasinglulu /*
13*91f16700Schasinglulu  * Assert target reset, if @to_us non null, wait until reset is asserted
14*91f16700Schasinglulu  *
15*91f16700Schasinglulu  * @reset_id: Reset controller ID
16*91f16700Schasinglulu  * @to_us: Timeout in microsecond, or 0 if not waiting
17*91f16700Schasinglulu  * Return 0 on success and -ETIMEDOUT if waiting and timeout expired
18*91f16700Schasinglulu  */
19*91f16700Schasinglulu int stm32mp_reset_assert(uint32_t reset_id, unsigned int to_us);
20*91f16700Schasinglulu 
21*91f16700Schasinglulu /*
22*91f16700Schasinglulu  * Enable reset control for target resource
23*91f16700Schasinglulu  *
24*91f16700Schasinglulu  * @reset_id: Reset controller ID
25*91f16700Schasinglulu  */
26*91f16700Schasinglulu static inline void stm32mp_reset_set(uint32_t reset_id)
27*91f16700Schasinglulu {
28*91f16700Schasinglulu 	(void)stm32mp_reset_assert(reset_id, 0U);
29*91f16700Schasinglulu }
30*91f16700Schasinglulu 
31*91f16700Schasinglulu /*
32*91f16700Schasinglulu  * Deassert target reset, if @to_us non null, wait until reset is deasserted
33*91f16700Schasinglulu  *
34*91f16700Schasinglulu  * @reset_id: Reset controller ID
35*91f16700Schasinglulu  * @to_us: Timeout in microsecond, or 0 if not waiting
36*91f16700Schasinglulu  * Return 0 on success and -ETIMEDOUT if waiting and timeout expired
37*91f16700Schasinglulu  */
38*91f16700Schasinglulu int stm32mp_reset_deassert(uint32_t reset_id, unsigned int to_us);
39*91f16700Schasinglulu 
40*91f16700Schasinglulu /*
41*91f16700Schasinglulu  * Release reset control for target resource
42*91f16700Schasinglulu  *
43*91f16700Schasinglulu  * @reset_id: Reset controller ID
44*91f16700Schasinglulu  */
45*91f16700Schasinglulu static inline void stm32mp_reset_release(uint32_t reset_id)
46*91f16700Schasinglulu {
47*91f16700Schasinglulu 	(void)stm32mp_reset_deassert(reset_id, 0U);
48*91f16700Schasinglulu }
49*91f16700Schasinglulu 
50*91f16700Schasinglulu #endif /* STM32MP_RESET_H */
51