1/* SPDX-License-Identifier: GPL-2.0 */
2#ifndef _SBP_BASE_H
3#define _SBP_BASE_H
4
5#include <linux/firewire.h>
6#include <linux/spinlock.h>
7#include <linux/types.h>
8#include <linux/workqueue.h>
9#include <target/target_core_base.h>
10
11#define SBP_VERSION "v0.1"
12#define SBP_NAMELEN 32
13
14#define SBP_ORB_FETCH_SIZE 8
15
16#define MANAGEMENT_AGENT_STATE_IDLE 0
17#define MANAGEMENT_AGENT_STATE_BUSY 1
18
19#define ORB_NOTIFY(v) (((v) >> 31) & 0x01)
20#define ORB_REQUEST_FORMAT(v) (((v) >> 29) & 0x03)
21
22#define MANAGEMENT_ORB_FUNCTION(v) (((v) >> 16) & 0x0f)
23
24#define MANAGEMENT_ORB_FUNCTION_LOGIN 0x0
25#define MANAGEMENT_ORB_FUNCTION_QUERY_LOGINS 0x1
26#define MANAGEMENT_ORB_FUNCTION_RECONNECT 0x3
27#define MANAGEMENT_ORB_FUNCTION_SET_PASSWORD 0x4
28#define MANAGEMENT_ORB_FUNCTION_LOGOUT 0x7
29#define MANAGEMENT_ORB_FUNCTION_ABORT_TASK 0xb
30#define MANAGEMENT_ORB_FUNCTION_ABORT_TASK_SET 0xc
31#define MANAGEMENT_ORB_FUNCTION_LOGICAL_UNIT_RESET 0xe
32#define MANAGEMENT_ORB_FUNCTION_TARGET_RESET 0xf
33
34#define LOGIN_ORB_EXCLUSIVE(v) (((v) >> 28) & 0x01)
35#define LOGIN_ORB_RESERVED(v) (((v) >> 24) & 0x0f)
36#define LOGIN_ORB_RECONNECT(v) (((v) >> 20) & 0x0f)
37#define LOGIN_ORB_LUN(v) (((v) >> 0) & 0xffff)
38#define LOGIN_ORB_PASSWORD_LENGTH(v) (((v) >> 16) & 0xffff)
39#define LOGIN_ORB_RESPONSE_LENGTH(v) (((v) >> 0) & 0xffff)
40
41#define RECONNECT_ORB_LOGIN_ID(v) (((v) >> 0) & 0xffff)
42#define LOGOUT_ORB_LOGIN_ID(v) (((v) >> 0) & 0xffff)
43
44#define CMDBLK_ORB_DIRECTION(v) (((v) >> 27) & 0x01)
45#define CMDBLK_ORB_SPEED(v) (((v) >> 24) & 0x07)
46#define CMDBLK_ORB_MAX_PAYLOAD(v) (((v) >> 20) & 0x0f)
47#define CMDBLK_ORB_PG_TBL_PRESENT(v) (((v) >> 19) & 0x01)
48#define CMDBLK_ORB_PG_SIZE(v) (((v) >> 16) & 0x07)
49#define CMDBLK_ORB_DATA_SIZE(v) (((v) >> 0) & 0xffff)
50
51#define STATUS_BLOCK_SRC(v) (((v) & 0x03) << 30)
52#define STATUS_BLOCK_RESP(v) (((v) & 0x03) << 28)
53#define STATUS_BLOCK_DEAD(v) (((v) ? 1 : 0) << 27)
54#define STATUS_BLOCK_LEN(v) (((v) & 0x07) << 24)
55#define STATUS_BLOCK_SBP_STATUS(v) (((v) & 0xff) << 16)
56#define STATUS_BLOCK_ORB_OFFSET_HIGH(v) (((v) & 0xffff) << 0)
57
58#define STATUS_SRC_ORB_CONTINUING 0
59#define STATUS_SRC_ORB_FINISHED 1
60#define STATUS_SRC_UNSOLICITED 2
61
62#define STATUS_RESP_REQUEST_COMPLETE 0
63#define STATUS_RESP_TRANSPORT_FAILURE 1
64#define STATUS_RESP_ILLEGAL_REQUEST 2
65#define STATUS_RESP_VENDOR_DEPENDENT 3
66
67#define SBP_STATUS_OK 0
68#define SBP_STATUS_REQ_TYPE_NOTSUPP 1
69#define SBP_STATUS_SPEED_NOTSUPP 2
70#define SBP_STATUS_PAGE_SIZE_NOTSUPP 3
71#define SBP_STATUS_ACCESS_DENIED 4
72#define SBP_STATUS_LUN_NOTSUPP 5
73#define SBP_STATUS_PAYLOAD_TOO_SMALL 6
74/* 7 is reserved */
75#define SBP_STATUS_RESOURCES_UNAVAIL 8
76#define SBP_STATUS_FUNCTION_REJECTED 9
77#define SBP_STATUS_LOGIN_ID_UNKNOWN 10
78#define SBP_STATUS_DUMMY_ORB_COMPLETE 11
79#define SBP_STATUS_REQUEST_ABORTED 12
80#define SBP_STATUS_UNSPECIFIED_ERROR 0xff
81
82#define AGENT_STATE_RESET 0
83#define AGENT_STATE_ACTIVE 1
84#define AGENT_STATE_SUSPENDED 2
85#define AGENT_STATE_DEAD 3
86
87struct sbp2_pointer {
88 __be32 high;
89 __be32 low;
90};
91
92struct sbp_command_block_orb {
93 struct sbp2_pointer next_orb;
94 struct sbp2_pointer data_descriptor;
95 __be32 misc;
96 u8 command_block[12];
97};
98
99struct sbp_page_table_entry {
100 __be16 segment_length;
101 __be16 segment_base_hi;
102 __be32 segment_base_lo;
103};
104
105struct sbp_management_orb {
106 struct sbp2_pointer ptr1;
107 struct sbp2_pointer ptr2;
108 __be32 misc;
109 __be32 length;
110 struct sbp2_pointer status_fifo;
111};
112
113struct sbp_status_block {
114 __be32 status;
115 __be32 orb_low;
116 u8 data[24];
117};
118
119struct sbp_login_response_block {
120 __be32 misc;
121 struct sbp2_pointer command_block_agent;
122 __be32 reconnect_hold;
123};
124
125struct sbp_login_descriptor {
126 struct sbp_session *sess;
127 struct list_head link;
128
129 u32 login_lun;
130
131 u64 status_fifo_addr;
132 int exclusive;
133 u16 login_id;
134
135 struct sbp_target_agent *tgt_agt;
136};
137
138struct sbp_session {
139 spinlock_t lock;
140 struct se_session *se_sess;
141 struct list_head login_list;
142 struct delayed_work maint_work;
143
144 u64 guid; /* login_owner_EUI_64 */
145 int node_id; /* login_owner_ID */
146
147 struct fw_card *card;
148 int generation;
149 int speed;
150
151 int reconnect_hold;
152 u64 reconnect_expires;
153};
154
155struct sbp_tpg {
156 /* Target portal group tag for TCM */
157 u16 tport_tpgt;
158 /* Pointer back to sbp_tport */
159 struct sbp_tport *tport;
160 /* Returned by sbp_make_tpg() */
161 struct se_portal_group se_tpg;
162};
163
164struct sbp_tport {
165 /* Target Unit Identifier (EUI-64) */
166 u64 guid;
167 /* Target port name */
168 char tport_name[SBP_NAMELEN];
169 /* Returned by sbp_make_tport() */
170 struct se_wwn tport_wwn;
171
172 struct sbp_tpg *tpg;
173
174 /* FireWire unit directory */
175 struct fw_descriptor unit_directory;
176
177 /* SBP Management Agent */
178 struct sbp_management_agent *mgt_agt;
179
180 /* Parameters */
181 int enable;
182 s32 directory_id;
183 int mgt_orb_timeout;
184 int max_reconnect_timeout;
185 int max_logins_per_lun;
186};
187
188static inline u64 sbp2_pointer_to_addr(const struct sbp2_pointer *ptr)
189{
190 return (u64)(be32_to_cpu(ptr->high) & 0x0000ffff) << 32 |
191 (be32_to_cpu(ptr->low) & 0xfffffffc);
192}
193
194static inline void addr_to_sbp2_pointer(u64 addr, struct sbp2_pointer *ptr)
195{
196 ptr->high = cpu_to_be32(addr >> 32);
197 ptr->low = cpu_to_be32(addr);
198}
199
200struct sbp_target_agent {
201 spinlock_t lock;
202 struct fw_address_handler handler;
203 struct sbp_login_descriptor *login;
204 int state;
205 struct work_struct work;
206 u64 orb_pointer;
207 bool doorbell;
208};
209
210struct sbp_target_request {
211 struct sbp_login_descriptor *login;
212 u64 orb_pointer;
213 struct sbp_command_block_orb orb;
214 struct sbp_status_block status;
215 struct work_struct work;
216
217 struct se_cmd se_cmd;
218 struct sbp_page_table_entry *pg_tbl;
219 void *cmd_buf;
220
221 unsigned char sense_buf[TRANSPORT_SENSE_BUFFER];
222};
223
224struct sbp_management_agent {
225 spinlock_t lock;
226 struct sbp_tport *tport;
227 struct fw_address_handler handler;
228 int state;
229 struct work_struct work;
230 u64 orb_offset;
231 struct sbp_management_request *request;
232};
233
234struct sbp_management_request {
235 struct sbp_management_orb orb;
236 struct sbp_status_block status;
237 struct fw_card *card;
238 int generation;
239 int node_addr;
240 int speed;
241};
242
243#endif
244

source code of linux/drivers/target/sbp/sbp_target.h