blob: 3b15c4e25a3a7fb14207d7750d1dedbab0413dab [file] [log] [blame]
xjb04a4022021-11-25 15:01:52 +08001// 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#if IS_ENABLED(CONFIG_ACPI)
8int sdw_acpi_find_slaves(struct sdw_bus *bus);
9#else
10static inline int sdw_acpi_find_slaves(struct sdw_bus *bus)
11{
12 return -ENOTSUPP;
13}
14#endif
15
16void sdw_extract_slave_id(struct sdw_bus *bus,
17 u64 addr, struct sdw_slave_id *id);
18
19enum {
20 SDW_MSG_FLAG_READ = 0,
21 SDW_MSG_FLAG_WRITE,
22};
23
24/**
25 * struct sdw_msg - Message structure
26 * @addr: Register address accessed in the Slave
27 * @len: number of messages
28 * @dev_num: Slave device number
29 * @addr_page1: SCP address page 1 Slave register
30 * @addr_page2: SCP address page 2 Slave register
31 * @flags: transfer flags, indicate if xfer is read or write
32 * @buf: message data buffer
33 * @ssp_sync: Send message at SSP (Stream Synchronization Point)
34 * @page: address requires paging
35 */
36struct sdw_msg {
37 u16 addr;
38 u16 len;
39 u8 dev_num;
40 u8 addr_page1;
41 u8 addr_page2;
42 u8 flags;
43 u8 *buf;
44 bool ssp_sync;
45 bool page;
46};
47
48#define SDW_DOUBLE_RATE_FACTOR 2
49
50extern int rows[SDW_FRAME_ROWS];
51extern int cols[SDW_FRAME_COLS];
52
53/**
54 * sdw_port_runtime: Runtime port parameters for Master or Slave
55 *
56 * @num: Port number. For audio streams, valid port number ranges from
57 * [1,14]
58 * @ch_mask: Channel mask
59 * @transport_params: Transport parameters
60 * @port_params: Port parameters
61 * @port_node: List node for Master or Slave port_list
62 *
63 * SoundWire spec has no mention of ports for Master interface but the
64 * concept is logically extended.
65 */
66struct sdw_port_runtime {
67 int num;
68 int ch_mask;
69 struct sdw_transport_params transport_params;
70 struct sdw_port_params port_params;
71 struct list_head port_node;
72};
73
74/**
75 * sdw_slave_runtime: Runtime Stream parameters for Slave
76 *
77 * @slave: Slave handle
78 * @direction: Data direction for Slave
79 * @ch_count: Number of channels handled by the Slave for
80 * this stream
81 * @m_rt_node: sdw_master_runtime list node
82 * @port_list: List of Slave Ports configured for this stream
83 */
84struct sdw_slave_runtime {
85 struct sdw_slave *slave;
86 enum sdw_data_direction direction;
87 unsigned int ch_count;
88 struct list_head m_rt_node;
89 struct list_head port_list;
90};
91
92/**
93 * sdw_master_runtime: Runtime stream parameters for Master
94 *
95 * @bus: Bus handle
96 * @stream: Stream runtime handle
97 * @direction: Data direction for Master
98 * @ch_count: Number of channels handled by the Master for
99 * this stream, can be zero.
100 * @slave_rt_list: Slave runtime list
101 * @port_list: List of Master Ports configured for this stream, can be zero.
102 * @bus_node: sdw_bus m_rt_list node
103 */
104struct sdw_master_runtime {
105 struct sdw_bus *bus;
106 struct sdw_stream_runtime *stream;
107 enum sdw_data_direction direction;
108 unsigned int ch_count;
109 struct list_head slave_rt_list;
110 struct list_head port_list;
111 struct list_head bus_node;
112};
113
114struct sdw_dpn_prop *sdw_get_slave_dpn_prop(struct sdw_slave *slave,
115 enum sdw_data_direction direction,
116 unsigned int port_num);
117int sdw_configure_dpn_intr(struct sdw_slave *slave, int port,
118 bool enable, int mask);
119
120int sdw_transfer(struct sdw_bus *bus, struct sdw_msg *msg);
121int sdw_transfer_defer(struct sdw_bus *bus, struct sdw_msg *msg,
122 struct sdw_defer *defer);
123
124#define SDW_READ_INTR_CLEAR_RETRY 10
125
126int sdw_fill_msg(struct sdw_msg *msg, struct sdw_slave *slave,
127 u32 addr, size_t count, u16 dev_num, u8 flags, u8 *buf);
128
129/* Read-Modify-Write Slave register */
130static inline int
131sdw_update(struct sdw_slave *slave, u32 addr, u8 mask, u8 val)
132{
133 int tmp;
134
135 tmp = sdw_read(slave, addr);
136 if (tmp < 0)
137 return tmp;
138
139 tmp = (tmp & ~mask) | val;
140 return sdw_write(slave, addr, tmp);
141}
142
143#endif /* __SDW_BUS_H */