55 lines
1.5 KiB
C
55 lines
1.5 KiB
C
|
/* SPDX-License-Identifier: GPL-2.0 */
|
||
|
|
|
||
|
|
/* Copyright (c) 2012-2018, The Linux Foundation. All rights reserved.
|
||
|
|
* Copyright (C) 2019-2022 Linaro Ltd.
|
||
|
|
*/
|
||
|
|
#ifndef _IPA_UC_H_
|
||
|
|
#define _IPA_UC_H_
|
||
|
|
|
||
|
|
struct ipa;
|
||
|
|
enum ipa_irq_id;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 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_ */
|