/* SPDX-License-Identifier: GPL-2.0 */ /* Copyright (c) 2012-2018, The Linux Foundation. All rights reserved. * Copyright (C) 2019-2024 Linaro Ltd. */ #ifndef _IPA_UC_H_ #define _IPA_UC_H_ struct ipa; /** * ipa_uc_interrupt_handler() - Handler for microcontroller IPA interrupts * @ipa: IPA pointer * @irq_id: IPA interrupt ID */ void ipa_uc_interrupt_handler(struct ipa *ipa, enum ipa_irq_id irq_id); /** * ipa_uc_config() - Configure the IPA microcontroller subsystem * @ipa: IPA pointer */ void ipa_uc_config(struct ipa *ipa); /** * ipa_uc_deconfig() - Inverse of ipa_uc_config() * @ipa: IPA pointer */ void ipa_uc_deconfig(struct ipa *ipa); /** * ipa_uc_power() - Take a proxy power reference for the microcontroller * @ipa: IPA pointer * * The first time the modem boots, it loads firmware for and starts the * IPA-resident microcontroller. The microcontroller signals that it * has completed its initialization by sending an INIT_COMPLETED response * message to the AP. The AP must ensure the IPA is powered until * it receives this message, and to do so we take a "proxy" clock * reference on its behalf here. Once we receive the INIT_COMPLETED * message (in ipa_uc_response_hdlr()) we drop this power reference. */ void ipa_uc_power(struct ipa *ipa); /** * ipa_uc_panic_notifier() * @ipa: IPA pointer * * Notifier function called when the system crashes, to inform the * microcontroller of the event. */ void ipa_uc_panic_notifier(struct ipa *ipa); #endif /* _IPA_UC_H_ */