109 lines · c
1/* SPDX-License-Identifier: GPL-2.0 */2 3/* Copyright (c) 2012-2018, The Linux Foundation. All rights reserved.4 * Copyright (C) 2018-2024 Linaro Ltd.5 */6#ifndef _IPA_INTERRUPT_H_7#define _IPA_INTERRUPT_H_8 9#include <linux/types.h>10 11struct platform_device;12 13struct ipa;14struct ipa_interrupt;15 16enum ipa_irq_id;17 18/**19 * ipa_interrupt_suspend_enable - Enable TX_SUSPEND for an endpoint20 * @interrupt: IPA interrupt structure21 * @endpoint_id: Endpoint whose interrupt should be enabled22 *23 * Note: The "TX" in the name is from the perspective of the IPA hardware.24 * A TX_SUSPEND interrupt arrives on an AP RX enpoint when packet data can't25 * be delivered to the endpoint because it is suspended (or its underlying26 * channel is stopped).27 */28void ipa_interrupt_suspend_enable(struct ipa_interrupt *interrupt,29 u32 endpoint_id);30 31/**32 * ipa_interrupt_suspend_disable - Disable TX_SUSPEND for an endpoint33 * @interrupt: IPA interrupt structure34 * @endpoint_id: Endpoint whose interrupt should be disabled35 */36void ipa_interrupt_suspend_disable(struct ipa_interrupt *interrupt,37 u32 endpoint_id);38 39/**40 * ipa_interrupt_simulate_suspend() - Simulate TX_SUSPEND IPA interrupt41 * @interrupt: IPA interrupt structure42 *43 * This calls the TX_SUSPEND interrupt handler, as if such an interrupt44 * had been signaled. This is needed to work around a hardware quirk45 * that occurs if aggregation is active on an endpoint when its underlying46 * channel is suspended.47 */48void ipa_interrupt_simulate_suspend(struct ipa_interrupt *interrupt);49 50/**51 * ipa_interrupt_enable() - Enable an IPA interrupt type52 * @ipa: IPA pointer53 * @ipa_irq: IPA interrupt ID54 */55void ipa_interrupt_enable(struct ipa *ipa, enum ipa_irq_id ipa_irq);56 57/**58 * ipa_interrupt_disable() - Disable an IPA interrupt type59 * @ipa: IPA pointer60 * @ipa_irq: IPA interrupt ID61 */62void ipa_interrupt_disable(struct ipa *ipa, enum ipa_irq_id ipa_irq);63 64/**65 * ipa_interrupt_irq_enable() - Enable IPA interrupts66 * @ipa: IPA pointer67 *68 * This enables the IPA interrupt line69 */70void ipa_interrupt_irq_enable(struct ipa *ipa);71 72/**73 * ipa_interrupt_irq_disable() - Disable IPA interrupts74 * @ipa: IPA pointer75 *76 * This disables the IPA interrupt line77 */78void ipa_interrupt_irq_disable(struct ipa *ipa);79 80/**81 * ipa_interrupt_config() - Configure IPA interrupts82 * @ipa: IPA pointer83 *84 * Return: 0 if successful, or a negative error code85 */86int ipa_interrupt_config(struct ipa *ipa);87 88/**89 * ipa_interrupt_deconfig() - Inverse of ipa_interrupt_config()90 * @ipa: IPA pointer91 */92void ipa_interrupt_deconfig(struct ipa *ipa);93 94/**95 * ipa_interrupt_init() - Initialize the IPA interrupt structure96 * @pdev: IPA platform device pointer97 *98 * Return: Pointer to an IPA interrupt structure, or a pointer-coded error99 */100struct ipa_interrupt *ipa_interrupt_init(struct platform_device *pdev);101 102/**103 * ipa_interrupt_exit() - Inverse of ipa_interrupt_init()104 * @interrupt: IPA interrupt structure105 */106void ipa_interrupt_exit(struct ipa_interrupt *interrupt);107 108#endif /* _IPA_INTERRUPT_H_ */109