67 lines · c
1/* SPDX-License-Identifier: GPL-2.0 */2 3/* Copyright (c) 2018, The Linux Foundation. All rights reserved.4 * Copyright (C) 2018-2024 Linaro Ltd.5 */6#ifndef _IPA_QMI_H_7#define _IPA_QMI_H_8 9#include <linux/types.h>10#include <linux/workqueue.h>11 12#include <linux/soc/qcom/qmi.h>13 14struct ipa;15 16/**17 * struct ipa_qmi - QMI state associated with an IPA18 * @client_handle: Used to send an QMI requests to the modem19 * @server_handle: Used to handle QMI requests from the modem20 * @modem_sq: QMAP socket address for the modem QMI server21 * @init_driver_work: Work structure used for INIT_DRIVER message handling22 * @initial_boot: True if first boot has not yet completed23 * @uc_ready: True once DRIVER_INIT_COMPLETE request received24 * @modem_ready: True when INIT_DRIVER response received25 * @indication_requested: True when INDICATION_REGISTER request received26 * @indication_sent: True when INIT_COMPLETE indication sent27 */28struct ipa_qmi {29 struct qmi_handle client_handle;30 struct qmi_handle server_handle;31 32 /* Information used for the client handle */33 struct sockaddr_qrtr modem_sq;34 struct work_struct init_driver_work;35 36 /* Flags used in negotiating readiness */37 bool initial_boot;38 bool uc_ready;39 bool modem_ready;40 bool indication_requested;41 bool indication_sent;42};43 44/**45 * ipa_qmi_setup() - Set up for QMI message exchange46 * @ipa: IPA pointer47 *48 * This is called at the end of ipa_setup(), to prepare for the exchange49 * of QMI messages that perform a "handshake" between the AP and modem.50 * When the modem QMI server announces its presence, an AP request message51 * supplies operating parameters to be used to the modem, and the modem52 * acknowledges receipt of those parameters. The modem will not touch the53 * IPA hardware until this handshake is complete.54 *55 * If the modem crashes (or shuts down) a new handshake begins when the56 * modem's QMI server is started again.57 */58int ipa_qmi_setup(struct ipa *ipa);59 60/**61 * ipa_qmi_teardown() - Tear down IPA QMI handles62 * @ipa: IPA pointer63 */64void ipa_qmi_teardown(struct ipa *ipa);65 66#endif /* !_IPA_QMI_H_ */67