54 lines · c
1/* SPDX-License-Identifier: GPL-2.0 */2 3/* Copyright (c) 2012-2018, The Linux Foundation. All rights reserved.4 * Copyright (C) 2019-2024 Linaro Ltd.5 */6#ifndef _IPA_UC_H_7#define _IPA_UC_H_8 9struct ipa;10 11/**12 * ipa_uc_interrupt_handler() - Handler for microcontroller IPA interrupts13 * @ipa: IPA pointer14 * @irq_id: IPA interrupt ID15 */16void ipa_uc_interrupt_handler(struct ipa *ipa, enum ipa_irq_id irq_id);17 18/**19 * ipa_uc_config() - Configure the IPA microcontroller subsystem20 * @ipa: IPA pointer21 */22void ipa_uc_config(struct ipa *ipa);23 24/**25 * ipa_uc_deconfig() - Inverse of ipa_uc_config()26 * @ipa: IPA pointer27 */28void ipa_uc_deconfig(struct ipa *ipa);29 30/**31 * ipa_uc_power() - Take a proxy power reference for the microcontroller32 * @ipa: IPA pointer33 *34 * The first time the modem boots, it loads firmware for and starts the35 * IPA-resident microcontroller. The microcontroller signals that it36 * has completed its initialization by sending an INIT_COMPLETED response37 * message to the AP. The AP must ensure the IPA is powered until38 * it receives this message, and to do so we take a "proxy" clock39 * reference on its behalf here. Once we receive the INIT_COMPLETED40 * message (in ipa_uc_response_hdlr()) we drop this power reference.41 */42void ipa_uc_power(struct ipa *ipa);43 44/**45 * ipa_uc_panic_notifier()46 * @ipa: IPA pointer47 *48 * Notifier function called when the system crashes, to inform the49 * microcontroller of the event.50 */51void ipa_uc_panic_notifier(struct ipa *ipa);52 53#endif /* _IPA_UC_H_ */54