1/* SPDX-License-Identifier: (GPL-2.0 OR BSD-3-Clause) */
2/* Copyright(c) 2015-17 Intel Corporation. */
3
4#ifndef __SDW_BUS_H
5#define __SDW_BUS_H
6
7#define DEFAULT_BANK_SWITCH_TIMEOUT 3000
8#define DEFAULT_PROBE_TIMEOUT 2000
9
10u64 sdw_dmi_override_adr(struct sdw_bus *bus, u64 addr);
11
12#if IS_ENABLED(CONFIG_ACPI)
13int sdw_acpi_find_slaves(struct sdw_bus *bus);
14#else
15static inline int sdw_acpi_find_slaves(struct sdw_bus *bus)
16{
17 return -ENOTSUPP;
18}
19#endif
20
21int sdw_of_find_slaves(struct sdw_bus *bus);
22void sdw_extract_slave_id(struct sdw_bus *bus,
23 u64 addr, struct sdw_slave_id *id);
24int sdw_slave_add(struct sdw_bus *bus, struct sdw_slave_id *id,
25 struct fwnode_handle *fwnode);
26int sdw_master_device_add(struct sdw_bus *bus, struct device *parent,
27 struct fwnode_handle *fwnode);
28int sdw_master_device_del(struct sdw_bus *bus);
29
30#ifdef CONFIG_DEBUG_FS
31void sdw_bus_debugfs_init(struct sdw_bus *bus);
32void sdw_bus_debugfs_exit(struct sdw_bus *bus);
33void sdw_slave_debugfs_init(struct sdw_slave *slave);
34void sdw_slave_debugfs_exit(struct sdw_slave *slave);
35void sdw_debugfs_init(void);
36void sdw_debugfs_exit(void);
37#else
38static inline void sdw_bus_debugfs_init(struct sdw_bus *bus) {}
39static inline void sdw_bus_debugfs_exit(struct sdw_bus *bus) {}
40static inline void sdw_slave_debugfs_init(struct sdw_slave *slave) {}
41static inline void sdw_slave_debugfs_exit(struct sdw_slave *slave) {}
42static inline void sdw_debugfs_init(void) {}
43static inline void sdw_debugfs_exit(void) {}
44#endif
45
46enum {
47 SDW_MSG_FLAG_READ = 0,
48 SDW_MSG_FLAG_WRITE,
49};
50
51/**
52 * struct sdw_msg - Message structure
53 * @addr: Register address accessed in the Slave
54 * @len: number of messages
55 * @dev_num: Slave device number
56 * @addr_page1: SCP address page 1 Slave register
57 * @addr_page2: SCP address page 2 Slave register
58 * @flags: transfer flags, indicate if xfer is read or write
59 * @buf: message data buffer
60 * @ssp_sync: Send message at SSP (Stream Synchronization Point)
61 * @page: address requires paging
62 */
63struct sdw_msg {
64 u16 addr;
65 u16 len;
66 u8 dev_num;
67 u8 addr_page1;
68 u8 addr_page2;
69 u8 flags;
70 u8 *buf;
71 bool ssp_sync;
72 bool page;
73};
74
75/**
76 * struct sdw_btp_msg - Message structure
77 * @addr: Start Register address accessed in the Slave
78 * @len: number of bytes to transfer. More than 64Kb can be transferred
79 * but a practical limit of SDW_BPT_MSG_MAX_BYTES is enforced.
80 * @dev_num: Slave device number
81 * @flags: transfer flags, indicate if xfer is read or write
82 * @buf: message data buffer (filled by host for write, filled
83 * by Peripheral hardware for reads)
84 */
85struct sdw_bpt_msg {
86 u32 addr;
87 u32 len;
88 u8 dev_num;
89 u8 flags;
90 u8 *buf;
91};
92
93#define SDW_DOUBLE_RATE_FACTOR 2
94#define SDW_STRM_RATE_GROUPING 1
95
96extern int sdw_rows[SDW_FRAME_ROWS];
97extern int sdw_cols[SDW_FRAME_COLS];
98
99int sdw_find_row_index(int row);
100int sdw_find_col_index(int col);
101
102/**
103 * sdw_port_runtime: Runtime port parameters for Master or Slave
104 *
105 * @num: Port number. For audio streams, valid port number ranges from
106 * [1,14]
107 * @ch_mask: Channel mask
108 * @transport_params: Transport parameters
109 * @port_params: Port parameters
110 * @port_node: List node for Master or Slave port_list
111 * @lane: Which lane is used
112 *
113 * SoundWire spec has no mention of ports for Master interface but the
114 * concept is logically extended.
115 */
116struct sdw_port_runtime {
117 int num;
118 int ch_mask;
119 struct sdw_transport_params transport_params;
120 struct sdw_port_params port_params;
121 struct list_head port_node;
122 unsigned int lane;
123};
124
125/**
126 * sdw_slave_runtime: Runtime Stream parameters for Slave
127 *
128 * @slave: Slave handle
129 * @direction: Data direction for Slave
130 * @ch_count: Number of channels handled by the Slave for
131 * this stream
132 * @m_rt_node: sdw_master_runtime list node
133 * @port_list: List of Slave Ports configured for this stream
134 */
135struct sdw_slave_runtime {
136 struct sdw_slave *slave;
137 enum sdw_data_direction direction;
138 unsigned int ch_count;
139 struct list_head m_rt_node;
140 struct list_head port_list;
141};
142
143/**
144 * sdw_master_runtime: Runtime stream parameters for Master
145 *
146 * @bus: Bus handle
147 * @stream: Stream runtime handle
148 * @direction: Data direction for Master
149 * @ch_count: Number of channels handled by the Master for
150 * this stream, can be zero.
151 * @slave_rt_list: Slave runtime list
152 * @port_list: List of Master Ports configured for this stream, can be zero.
153 * @stream_node: sdw_stream_runtime master_list node
154 * @bus_node: sdw_bus m_rt_list node
155 */
156struct sdw_master_runtime {
157 struct sdw_bus *bus;
158 struct sdw_stream_runtime *stream;
159 enum sdw_data_direction direction;
160 unsigned int ch_count;
161 struct list_head slave_rt_list;
162 struct list_head port_list;
163 struct list_head stream_node;
164 struct list_head bus_node;
165};
166
167struct sdw_transport_data {
168 int hstart;
169 int hstop;
170 int block_offset;
171 int sub_block_offset;
172 unsigned int lane;
173};
174
175struct sdw_dpn_prop *sdw_get_slave_dpn_prop(struct sdw_slave *slave,
176 enum sdw_data_direction direction,
177 unsigned int port_num);
178int sdw_configure_dpn_intr(struct sdw_slave *slave, int port,
179 bool enable, int mask);
180
181int sdw_transfer(struct sdw_bus *bus, struct sdw_msg *msg);
182int sdw_transfer_defer(struct sdw_bus *bus, struct sdw_msg *msg);
183
184#define SDW_READ_INTR_CLEAR_RETRY 10
185
186int sdw_fill_msg(struct sdw_msg *msg, struct sdw_slave *slave,
187 u32 addr, size_t count, u16 dev_num, u8 flags, u8 *buf);
188
189/* Fill transport parameter data structure */
190static inline void sdw_fill_xport_params(struct sdw_transport_params *params,
191 int port_num, bool grp_ctrl_valid,
192 int grp_ctrl, int sample_int,
193 int off1, int off2,
194 int hstart, int hstop,
195 int pack_mode, int lane_ctrl)
196{
197 params->port_num = port_num;
198 params->blk_grp_ctrl_valid = grp_ctrl_valid;
199 params->blk_grp_ctrl = grp_ctrl;
200 params->sample_interval = sample_int;
201 params->offset1 = off1;
202 params->offset2 = off2;
203 params->hstart = hstart;
204 params->hstop = hstop;
205 params->blk_pkg_mode = pack_mode;
206 params->lane_ctrl = lane_ctrl;
207}
208
209/* Fill port parameter data structure */
210static inline void sdw_fill_port_params(struct sdw_port_params *params,
211 int port_num, int bps,
212 int flow_mode, int data_mode)
213{
214 params->num = port_num;
215 params->bps = bps;
216 params->flow_mode = flow_mode;
217 params->data_mode = data_mode;
218}
219
220/* broadcast read/write for tests */
221int sdw_bread_no_pm_unlocked(struct sdw_bus *bus, u16 dev_num, u32 addr);
222int sdw_bwrite_no_pm_unlocked(struct sdw_bus *bus, u16 dev_num, u32 addr, u8 value);
223
224/*
225 * At the moment we only track Master-initiated hw_reset.
226 * Additional fields can be added as needed
227 */
228#define SDW_UNATTACH_REQUEST_MASTER_RESET BIT(0)
229
230void sdw_clear_slave_status(struct sdw_bus *bus, u32 request);
231int sdw_slave_modalias(const struct sdw_slave *slave, char *buf, size_t size);
232void sdw_compute_slave_ports(struct sdw_master_runtime *m_rt,
233 struct sdw_transport_data *t_data);
234
235#endif /* __SDW_BUS_H */
236

source code of linux/drivers/soundwire/bus.h