1 /* SPDX-License-Identifier: GPL-2.0 */
3 /* Copyright (c) 2012-2018, The Linux Foundation. All rights reserved.
4 * Copyright (C) 2018-2020 Linaro Ltd.
9 #include <linux/types.h>
10 #include <linux/device.h>
11 #include <linux/notifier.h>
12 #include <linux/pm_wakeup.h>
14 #include "ipa_version.h"
18 #include "ipa_endpoint.h"
19 #include "ipa_interrupt.h"
24 struct platform_device;
31 * struct ipa - IPA information
32 * @gsi: Embedded GSI structure
33 * @version: IPA hardware version
34 * @pdev: Platform device
35 * @modem_rproc: Remoteproc handle for modem subsystem
36 * @smp2p: SMP2P information
37 * @clock: IPA clocking information
38 * @suspend_ref: Whether clock reference preventing suspend taken
39 * @table_addr: DMA address of filter/route table content
40 * @table_virt: Virtual address of filter/route table content
41 * @interrupt: IPA Interrupt information
42 * @uc_loaded: true after microcontroller has reported it's ready
43 * @reg_addr: DMA address used for IPA register access
44 * @reg_virt: Virtual address used for IPA register access
45 * @mem_addr: DMA address of IPA-local memory space
46 * @mem_virt: Virtual address of IPA-local memory space
47 * @mem_offset: Offset from @mem_virt used for access to IPA memory
48 * @mem_size: Total size (bytes) of memory at @mem_virt
49 * @mem: Array of IPA-local memory region descriptors
50 * @imem_iova: I/O virtual address of IPA region in IMEM
51 * @imem_size; Size of IMEM region
52 * @smem_iova: I/O virtual address of IPA region in SMEM
53 * @smem_size; Size of SMEM region
54 * @zero_addr: DMA address of preallocated zero-filled memory
55 * @zero_virt: Virtual address of preallocated zero-filled memory
56 * @zero_size: Size (bytes) of preallocated zero-filled memory
57 * @wakeup_source: Wakeup source information
58 * @available: Bit mask indicating endpoints hardware supports
59 * @filter_map: Bit mask indicating endpoints that support filtering
60 * @initialized: Bit mask indicating endpoints initialized
61 * @set_up: Bit mask indicating endpoints set up
62 * @enabled: Bit mask indicating endpoints enabled
63 * @endpoint: Array of endpoint information
64 * @channel_map: Mapping of GSI channel to IPA endpoint
65 * @name_map: Mapping of IPA endpoint name to IPA endpoint
66 * @setup_complete: Flag indicating whether setup stage has completed
67 * @modem_state: State of modem (stopped, running)
68 * @modem_netdev: Network device structure used for modem
69 * @qmi: QMI information
73 enum ipa_version version;
74 struct platform_device *pdev;
75 struct rproc *modem_rproc;
76 struct ipa_smp2p *smp2p;
77 struct ipa_clock *clock;
80 dma_addr_t table_addr;
83 struct ipa_interrupt *interrupt;
87 void __iomem *reg_virt;
93 const struct ipa_mem *mem;
95 unsigned long imem_iova;
98 unsigned long smem_iova;
101 dma_addr_t zero_addr;
105 struct wakeup_source *wakeup_source;
107 /* Bit masks indicating endpoint state */
108 u32 available; /* supported by hardware */
114 struct ipa_endpoint endpoint[IPA_ENDPOINT_MAX];
115 struct ipa_endpoint *channel_map[GSI_CHANNEL_COUNT_MAX];
116 struct ipa_endpoint *name_map[IPA_ENDPOINT_COUNT];
120 atomic_t modem_state; /* enum ipa_modem_state */
121 struct net_device *modem_netdev;
126 * ipa_setup() - Perform IPA setup
129 * IPA initialization is broken into stages: init; config; and setup.
130 * (These have inverses exit, deconfig, and teardown.)
132 * Activities performed at the init stage can be done without requiring
133 * any access to IPA hardware. Activities performed at the config stage
134 * require the IPA clock to be running, because they involve access
135 * to IPA registers. The setup stage is performed only after the GSI
136 * hardware is ready (more on this below). The setup stage allows
137 * the AP to perform more complex initialization by issuing "immediate
138 * commands" using a special interface to the IPA.
140 * This function, @ipa_setup(), starts the setup stage.
142 * In order for the GSI hardware to be functional it needs firmware to be
143 * loaded (in addition to some other low-level initialization). This early
144 * GSI initialization can be done either by Trust Zone on the AP or by the
147 * If it's done by Trust Zone, the AP loads the GSI firmware and supplies
148 * it to Trust Zone to verify and install. When this completes, if
149 * verification was successful, the GSI layer is ready and ipa_setup()
150 * implements the setup phase of initialization.
152 * If the modem performs early GSI initialization, the AP needs to know
153 * when this has occurred. An SMP2P interrupt is used for this purpose,
154 * and receipt of that interrupt triggers the call to ipa_setup().
156 int ipa_setup(struct ipa *ipa);