linux-stable/drivers/net/ipa/ipa_uc.h
Alex Elder 7aa0e8b8bd net: ipa: rename ipa_clock_* symbols
Rename a number of functions to clarify that there is no longer a
notion of an "IPA clock," but rather that the functions are more
generally related to IPA power management.

  ipa_clock_enable() -> ipa_power_enable()
  ipa_clock_disable() -> ipa_power_disable()
  ipa_clock_rate() -> ipa_core_clock_rate()
  ipa_clock_init() -> ipa_power_init()
  ipa_clock_exit() -> ipa_power_exit()

Rename the ipa_clock structure to be ipa_power.  Rename all
variables and fields using that structure type "power" rather
than "clock".

Rename the ipa_clock_data structure to be ipa_power_data, and more
broadly, just substitute "power" for "clock" in places that
previously represented things related to the "IPA clock".

Update comments throughout.

Signed-off-by: Alex Elder <elder@linaro.org>
Signed-off-by: David S. Miller <davem@davemloft.net>
2021-08-22 09:44:17 +01:00

46 lines
1.3 KiB
C

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