linux/drivers/net/ipa/ipa_power.c

// SPDX-License-Identifier: GPL-2.0

/* Copyright (c) 2012-2018, The Linux Foundation. All rights reserved.
 * Copyright (C) 2018-2024 Linaro Ltd.
 */

#include <linux/clk.h>
#include <linux/device.h>
#include <linux/interconnect.h>
#include <linux/pm.h>
#include <linux/pm_runtime.h>

#include "linux/soc/qcom/qcom_aoss.h"

#include "ipa.h"
#include "ipa_data.h"
#include "ipa_endpoint.h"
#include "ipa_interrupt.h"
#include "ipa_modem.h"
#include "ipa_power.h"

/**
 * DOC: IPA Power Management
 *
 * The IPA hardware is enabled when the IPA core clock and all the
 * interconnects (buses) it depends on are enabled.  Runtime power
 * management is used to determine whether the core clock and
 * interconnects are enabled, and if not in use to be suspended
 * automatically.
 *
 * The core clock currently runs at a fixed clock rate when enabled,
 * an all interconnects use a fixed average and peak bandwidth.
 */

#define IPA_AUTOSUSPEND_DELAY …

/**
 * struct ipa_power - IPA power management information
 * @dev:		IPA device pointer
 * @core:		IPA core clock
 * @qmp:		QMP handle for AOSS communication
 * @interconnect_count:	Number of elements in interconnect[]
 * @interconnect:	Interconnect array
 */
struct ipa_power { … };

/* Initialize interconnects required for IPA operation */
static int ipa_interconnect_init(struct ipa_power *power,
				 const struct ipa_interconnect_data *data)
{ … }

/* Inverse of ipa_interconnect_init() */
static void ipa_interconnect_exit(struct ipa_power *power)
{ … }

/* Enable IPA power, enabling interconnects and the core clock */
static int ipa_power_enable(struct ipa *ipa)
{ … }

/* Inverse of ipa_power_enable() */
static void ipa_power_disable(struct ipa *ipa)
{ … }

static int ipa_runtime_suspend(struct device *dev)
{ … }

static int ipa_runtime_resume(struct device *dev)
{ … }

static int ipa_suspend(struct device *dev)
{ … }

static int ipa_resume(struct device *dev)
{ … }

/* Return the current IPA core clock rate */
u32 ipa_core_clock_rate(struct ipa *ipa)
{ … }

static int ipa_power_retention_init(struct ipa_power *power)
{ … }

static void ipa_power_retention_exit(struct ipa_power *power)
{ … }

/* Control register retention on power collapse */
void ipa_power_retention(struct ipa *ipa, bool enable)
{ … }

/* Initialize IPA power management */
struct ipa_power *
ipa_power_init(struct device *dev, const struct ipa_power_data *data)
{ … }

/* Inverse of ipa_power_init() */
void ipa_power_exit(struct ipa_power *power)
{ … }

const struct dev_pm_ops ipa_pm_ops = …;