linux/drivers/net/ipa/ipa_qmi.h
Alex Elder a4388da51a net: ipa: update copyrights
Some source files state copyright dates that are earlier than the
last modification of the file.  Change the copyright year to 2022 in
all such cases.

Signed-off-by: Alex Elder <elder@linaro.org>
Link: https://lore.kernel.org/r/20220930224549.3503434-1-elder@linaro.org
Signed-off-by: Jakub Kicinski <kuba@kernel.org>
2022-10-03 16:49:20 -07:00

65 lines
2.0 KiB
C

/* SPDX-License-Identifier: GPL-2.0 */
/* Copyright (c) 2018, The Linux Foundation. All rights reserved.
* Copyright (C) 2018-2022 Linaro Ltd.
*/
#ifndef _IPA_QMI_H_
#define _IPA_QMI_H_
#include <linux/types.h>
#include <linux/soc/qcom/qmi.h>
struct ipa;
/**
* struct ipa_qmi - QMI state associated with an IPA
* @client_handle: Used to send an QMI requests to the modem
* @server_handle: Used to handle QMI requests from the modem
* @modem_sq: QMAP socket address for the modem QMI server
* @init_driver_work: Work structure used for INIT_DRIVER message handling
* @initial_boot: True if first boot has not yet completed
* @uc_ready: True once DRIVER_INIT_COMPLETE request received
* @modem_ready: True when INIT_DRIVER response received
* @indication_requested: True when INDICATION_REGISTER request received
* @indication_sent: True when INIT_COMPLETE indication sent
*/
struct ipa_qmi {
struct qmi_handle client_handle;
struct qmi_handle server_handle;
/* Information used for the client handle */
struct sockaddr_qrtr modem_sq;
struct work_struct init_driver_work;
/* Flags used in negotiating readiness */
bool initial_boot;
bool uc_ready;
bool modem_ready;
bool indication_requested;
bool indication_sent;
};
/**
* ipa_qmi_setup() - Set up for QMI message exchange
* @ipa: IPA pointer
*
* This is called at the end of ipa_setup(), to prepare for the exchange
* of QMI messages that perform a "handshake" between the AP and modem.
* When the modem QMI server announces its presence, an AP request message
* supplies operating parameters to be used to the modem, and the modem
* acknowledges receipt of those parameters. The modem will not touch the
* IPA hardware until this handshake is complete.
*
* If the modem crashes (or shuts down) a new handshake begins when the
* modem's QMI server is started again.
*/
int ipa_qmi_setup(struct ipa *ipa);
/**
* ipa_qmi_teardown() - Tear down IPA QMI handles
* @ipa: IPA pointer
*/
void ipa_qmi_teardown(struct ipa *ipa);
#endif /* !_IPA_QMI_H_ */