| 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 |
|
| 14 |
struct ipa; |
| 15 |
|
| 16 |
/** |
| 17 |
* struct ipa_qmi - QMI state associated with an IPA |
| 18 |
* @client_handle: Used to send an QMI requests to the modem |
| 19 |
* @server_handle: Used to handle QMI requests from the modem |
| 20 |
* @modem_sq: QMAP socket address for the modem QMI server |
| 21 |
* @init_driver_work: Work structure used for INIT_DRIVER message handling |
| 22 |
* @initial_boot: True if first boot has not yet completed |
| 23 |
* @uc_ready: True once DRIVER_INIT_COMPLETE request received |
| 24 |
* @modem_ready: True when INIT_DRIVER response received |
| 25 |
* @indication_requested: True when INDICATION_REGISTER request received |
| 26 |
* @indication_sent: True when INIT_COMPLETE indication sent |
| 27 |
*/ |
| 28 |
struct 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 exchange |
| 46 |
* @ipa: IPA pointer |
| 47 |
* |
| 48 |
* This is called at the end of ipa_setup(), to prepare for the exchange |
| 49 |
* of QMI messages that perform a "handshake" between the AP and modem. |
| 50 |
* When the modem QMI server announces its presence, an AP request message |
| 51 |
* supplies operating parameters to be used to the modem, and the modem |
| 52 |
* acknowledges receipt of those parameters. The modem will not touch the |
| 53 |
* IPA hardware until this handshake is complete. |
| 54 |
* |
| 55 |
* If the modem crashes (or shuts down) a new handshake begins when the |
| 56 |
* modem's QMI server is started again. |
| 57 |
*/ |
| 58 |
int ipa_qmi_setup(struct ipa *ipa); |
| 59 |
|
| 60 |
/** |
| 61 |
* ipa_qmi_teardown() - Tear down IPA QMI handles |
| 62 |
* @ipa: IPA pointer |
| 63 |
*/ |
| 64 |
void ipa_qmi_teardown(struct ipa *ipa); |
| 65 |
|
| 66 |
#endif /* !_IPA_QMI_H_ */ |