1/* SPDX-License-Identifier: GPL-2.0-or-later */
2/*
3 * Copyright Gavin Shan, IBM Corporation 2016.
4 */
5
6#ifndef __NCSI_INTERNAL_H__
7#define __NCSI_INTERNAL_H__
8
9enum {
10 NCSI_CAP_BASE = 0,
11 NCSI_CAP_GENERIC = 0,
12 NCSI_CAP_BC,
13 NCSI_CAP_MC,
14 NCSI_CAP_BUFFER,
15 NCSI_CAP_AEN,
16 NCSI_CAP_VLAN,
17 NCSI_CAP_MAX
18};
19
20enum {
21 NCSI_CAP_GENERIC_HWA = 0x01, /* HW arbitration */
22 NCSI_CAP_GENERIC_HDS = 0x02, /* HNC driver status change */
23 NCSI_CAP_GENERIC_FC = 0x04, /* HNC to MC flow control */
24 NCSI_CAP_GENERIC_FC1 = 0x08, /* MC to HNC flow control */
25 NCSI_CAP_GENERIC_MC = 0x10, /* Global MC filtering */
26 NCSI_CAP_GENERIC_HWA_UNKNOWN = 0x00, /* Unknown HW arbitration */
27 NCSI_CAP_GENERIC_HWA_SUPPORT = 0x20, /* Supported HW arbitration */
28 NCSI_CAP_GENERIC_HWA_NOT_SUPPORT = 0x40, /* No HW arbitration */
29 NCSI_CAP_GENERIC_HWA_RESERVED = 0x60, /* Reserved HW arbitration */
30 NCSI_CAP_GENERIC_HWA_MASK = 0x60, /* Mask for HW arbitration */
31 NCSI_CAP_GENERIC_MASK = 0x7f,
32 NCSI_CAP_BC_ARP = 0x01, /* ARP packet filtering */
33 NCSI_CAP_BC_DHCPC = 0x02, /* DHCP client filtering */
34 NCSI_CAP_BC_DHCPS = 0x04, /* DHCP server filtering */
35 NCSI_CAP_BC_NETBIOS = 0x08, /* NetBIOS packet filtering */
36 NCSI_CAP_BC_MASK = 0x0f,
37 NCSI_CAP_MC_IPV6_NEIGHBOR = 0x01, /* IPv6 neighbor filtering */
38 NCSI_CAP_MC_IPV6_ROUTER = 0x02, /* IPv6 router filering */
39 NCSI_CAP_MC_DHCPV6_RELAY = 0x04, /* DHCPv6 relay / server MC */
40 NCSI_CAP_MC_DHCPV6_WELL_KNOWN = 0x08, /* DHCPv6 well-known MC */
41 NCSI_CAP_MC_IPV6_MLD = 0x10, /* IPv6 MLD filtering */
42 NCSI_CAP_MC_IPV6_NEIGHBOR_S = 0x20, /* IPv6 neighbour filtering */
43 NCSI_CAP_MC_MASK = 0x3f,
44 NCSI_CAP_AEN_LSC = 0x01, /* Link status change */
45 NCSI_CAP_AEN_CR = 0x02, /* Configuration required */
46 NCSI_CAP_AEN_HDS = 0x04, /* HNC driver status */
47 NCSI_CAP_AEN_MASK = 0x07,
48 NCSI_CAP_VLAN_ONLY = 0x01, /* Filter VLAN packet only */
49 NCSI_CAP_VLAN_NO = 0x02, /* Filter VLAN and non-VLAN */
50 NCSI_CAP_VLAN_ANY = 0x04, /* Filter Any-and-non-VLAN */
51 NCSI_CAP_VLAN_MASK = 0x07
52};
53
54enum {
55 NCSI_MODE_BASE = 0,
56 NCSI_MODE_ENABLE = 0,
57 NCSI_MODE_TX_ENABLE,
58 NCSI_MODE_LINK,
59 NCSI_MODE_VLAN,
60 NCSI_MODE_BC,
61 NCSI_MODE_MC,
62 NCSI_MODE_AEN,
63 NCSI_MODE_FC,
64 NCSI_MODE_MAX
65};
66
67/* Supported media status bits for Mellanox Mac affinity command.
68 * Bit (0-2) for different protocol support; Bit 1 for RBT support,
69 * bit 1 for SMBUS support and bit 2 for PCIE support. Bit (3-5)
70 * for different protocol availability. Bit 4 for RBT, bit 4 for
71 * SMBUS and bit 5 for PCIE.
72 */
73enum {
74 MLX_MC_RBT_SUPPORT = 0x01, /* MC supports RBT */
75 MLX_MC_RBT_AVL = 0x08, /* RBT medium is available */
76};
77
78/* OEM Vendor Manufacture ID */
79#define NCSI_OEM_MFR_MLX_ID 0x8119
80#define NCSI_OEM_MFR_BCM_ID 0x113d
81#define NCSI_OEM_MFR_INTEL_ID 0x157
82/* Intel specific OEM command */
83#define NCSI_OEM_INTEL_CMD_GMA 0x06 /* CMD ID for Get MAC */
84#define NCSI_OEM_INTEL_CMD_KEEP_PHY 0x20 /* CMD ID for Keep PHY up */
85/* Broadcom specific OEM Command */
86#define NCSI_OEM_BCM_CMD_GMA 0x01 /* CMD ID for Get MAC */
87/* Mellanox specific OEM Command */
88#define NCSI_OEM_MLX_CMD_GMA 0x00 /* CMD ID for Get MAC */
89#define NCSI_OEM_MLX_CMD_GMA_PARAM 0x1b /* Parameter for GMA */
90#define NCSI_OEM_MLX_CMD_SMAF 0x01 /* CMD ID for Set MC Affinity */
91#define NCSI_OEM_MLX_CMD_SMAF_PARAM 0x07 /* Parameter for SMAF */
92/* OEM Command payload lengths*/
93#define NCSI_OEM_INTEL_CMD_GMA_LEN 5
94#define NCSI_OEM_INTEL_CMD_KEEP_PHY_LEN 7
95#define NCSI_OEM_BCM_CMD_GMA_LEN 12
96#define NCSI_OEM_MLX_CMD_GMA_LEN 8
97#define NCSI_OEM_MLX_CMD_SMAF_LEN 60
98/* Offset in OEM request */
99#define MLX_SMAF_MAC_ADDR_OFFSET 8 /* Offset for MAC in SMAF */
100#define MLX_SMAF_MED_SUPPORT_OFFSET 14 /* Offset for medium in SMAF */
101/* Mac address offset in OEM response */
102#define BCM_MAC_ADDR_OFFSET 28
103#define MLX_MAC_ADDR_OFFSET 8
104#define INTEL_MAC_ADDR_OFFSET 1
105
106
107struct ncsi_channel_version {
108 u32 version; /* Supported BCD encoded NCSI version */
109 u32 alpha2; /* Supported BCD encoded NCSI version */
110 u8 fw_name[12]; /* Firmware name string */
111 u32 fw_version; /* Firmware version */
112 u16 pci_ids[4]; /* PCI identification */
113 u32 mf_id; /* Manufacture ID */
114};
115
116struct ncsi_channel_cap {
117 u32 index; /* Index of channel capabilities */
118 u32 cap; /* NCSI channel capability */
119};
120
121struct ncsi_channel_mode {
122 u32 index; /* Index of channel modes */
123 u32 enable; /* Enabled or disabled */
124 u32 size; /* Valid entries in ncm_data[] */
125 u32 data[8]; /* Data entries */
126};
127
128struct ncsi_channel_mac_filter {
129 u8 n_uc;
130 u8 n_mc;
131 u8 n_mixed;
132 u64 bitmap;
133 unsigned char *addrs;
134};
135
136struct ncsi_channel_vlan_filter {
137 u8 n_vids;
138 u64 bitmap;
139 u16 *vids;
140};
141
142struct ncsi_channel_stats {
143 u32 hnc_cnt_hi; /* Counter cleared */
144 u32 hnc_cnt_lo; /* Counter cleared */
145 u32 hnc_rx_bytes; /* Rx bytes */
146 u32 hnc_tx_bytes; /* Tx bytes */
147 u32 hnc_rx_uc_pkts; /* Rx UC packets */
148 u32 hnc_rx_mc_pkts; /* Rx MC packets */
149 u32 hnc_rx_bc_pkts; /* Rx BC packets */
150 u32 hnc_tx_uc_pkts; /* Tx UC packets */
151 u32 hnc_tx_mc_pkts; /* Tx MC packets */
152 u32 hnc_tx_bc_pkts; /* Tx BC packets */
153 u32 hnc_fcs_err; /* FCS errors */
154 u32 hnc_align_err; /* Alignment errors */
155 u32 hnc_false_carrier; /* False carrier detection */
156 u32 hnc_runt_pkts; /* Rx runt packets */
157 u32 hnc_jabber_pkts; /* Rx jabber packets */
158 u32 hnc_rx_pause_xon; /* Rx pause XON frames */
159 u32 hnc_rx_pause_xoff; /* Rx XOFF frames */
160 u32 hnc_tx_pause_xon; /* Tx XON frames */
161 u32 hnc_tx_pause_xoff; /* Tx XOFF frames */
162 u32 hnc_tx_s_collision; /* Single collision frames */
163 u32 hnc_tx_m_collision; /* Multiple collision frames */
164 u32 hnc_l_collision; /* Late collision frames */
165 u32 hnc_e_collision; /* Excessive collision frames */
166 u32 hnc_rx_ctl_frames; /* Rx control frames */
167 u32 hnc_rx_64_frames; /* Rx 64-bytes frames */
168 u32 hnc_rx_127_frames; /* Rx 65-127 bytes frames */
169 u32 hnc_rx_255_frames; /* Rx 128-255 bytes frames */
170 u32 hnc_rx_511_frames; /* Rx 256-511 bytes frames */
171 u32 hnc_rx_1023_frames; /* Rx 512-1023 bytes frames */
172 u32 hnc_rx_1522_frames; /* Rx 1024-1522 bytes frames */
173 u32 hnc_rx_9022_frames; /* Rx 1523-9022 bytes frames */
174 u32 hnc_tx_64_frames; /* Tx 64-bytes frames */
175 u32 hnc_tx_127_frames; /* Tx 65-127 bytes frames */
176 u32 hnc_tx_255_frames; /* Tx 128-255 bytes frames */
177 u32 hnc_tx_511_frames; /* Tx 256-511 bytes frames */
178 u32 hnc_tx_1023_frames; /* Tx 512-1023 bytes frames */
179 u32 hnc_tx_1522_frames; /* Tx 1024-1522 bytes frames */
180 u32 hnc_tx_9022_frames; /* Tx 1523-9022 bytes frames */
181 u32 hnc_rx_valid_bytes; /* Rx valid bytes */
182 u32 hnc_rx_runt_pkts; /* Rx error runt packets */
183 u32 hnc_rx_jabber_pkts; /* Rx error jabber packets */
184 u32 ncsi_rx_cmds; /* Rx NCSI commands */
185 u32 ncsi_dropped_cmds; /* Dropped commands */
186 u32 ncsi_cmd_type_errs; /* Command type errors */
187 u32 ncsi_cmd_csum_errs; /* Command checksum errors */
188 u32 ncsi_rx_pkts; /* Rx NCSI packets */
189 u32 ncsi_tx_pkts; /* Tx NCSI packets */
190 u32 ncsi_tx_aen_pkts; /* Tx AEN packets */
191 u32 pt_tx_pkts; /* Tx packets */
192 u32 pt_tx_dropped; /* Tx dropped packets */
193 u32 pt_tx_channel_err; /* Tx channel errors */
194 u32 pt_tx_us_err; /* Tx undersize errors */
195 u32 pt_rx_pkts; /* Rx packets */
196 u32 pt_rx_dropped; /* Rx dropped packets */
197 u32 pt_rx_channel_err; /* Rx channel errors */
198 u32 pt_rx_us_err; /* Rx undersize errors */
199 u32 pt_rx_os_err; /* Rx oversize errors */
200};
201
202struct ncsi_dev_priv;
203struct ncsi_package;
204
205#define NCSI_PACKAGE_SHIFT 5
206#define NCSI_PACKAGE_INDEX(c) (((c) >> NCSI_PACKAGE_SHIFT) & 0x7)
207#define NCSI_RESERVED_CHANNEL 0x1f
208#define NCSI_CHANNEL_INDEX(c) ((c) & ((1 << NCSI_PACKAGE_SHIFT) - 1))
209#define NCSI_TO_CHANNEL(p, c) (((p) << NCSI_PACKAGE_SHIFT) | (c))
210#define NCSI_MAX_PACKAGE 8
211#define NCSI_MAX_CHANNEL 32
212
213struct ncsi_channel {
214 unsigned char id;
215 int state;
216#define NCSI_CHANNEL_INACTIVE 1
217#define NCSI_CHANNEL_ACTIVE 2
218#define NCSI_CHANNEL_INVISIBLE 3
219 bool reconfigure_needed;
220 spinlock_t lock; /* Protect filters etc */
221 struct ncsi_package *package;
222 struct ncsi_channel_version version;
223 struct ncsi_channel_cap caps[NCSI_CAP_MAX];
224 struct ncsi_channel_mode modes[NCSI_MODE_MAX];
225 /* Filtering Settings */
226 struct ncsi_channel_mac_filter mac_filter;
227 struct ncsi_channel_vlan_filter vlan_filter;
228 struct ncsi_channel_stats stats;
229 struct {
230 struct timer_list timer;
231 bool enabled;
232 unsigned int state;
233#define NCSI_CHANNEL_MONITOR_START 0
234#define NCSI_CHANNEL_MONITOR_RETRY 1
235#define NCSI_CHANNEL_MONITOR_WAIT 2
236#define NCSI_CHANNEL_MONITOR_WAIT_MAX 5
237 } monitor;
238 struct list_head node;
239 struct list_head link;
240};
241
242struct ncsi_package {
243 unsigned char id; /* NCSI 3-bits package ID */
244 unsigned char uuid[16]; /* UUID */
245 struct ncsi_dev_priv *ndp; /* NCSI device */
246 spinlock_t lock; /* Protect the package */
247 unsigned int channel_num; /* Number of channels */
248 struct list_head channels; /* List of channels */
249 struct list_head node; /* Form list of packages */
250
251 bool multi_channel; /* Enable multiple channels */
252 u32 channel_whitelist; /* Channels to configure */
253 struct ncsi_channel *preferred_channel; /* Primary channel */
254};
255
256struct ncsi_request {
257 unsigned char id; /* Request ID - 0 to 255 */
258 bool used; /* Request that has been assigned */
259 unsigned int flags; /* NCSI request property */
260#define NCSI_REQ_FLAG_EVENT_DRIVEN 1
261#define NCSI_REQ_FLAG_NETLINK_DRIVEN 2
262 struct ncsi_dev_priv *ndp; /* Associated NCSI device */
263 struct sk_buff *cmd; /* Associated NCSI command packet */
264 struct sk_buff *rsp; /* Associated NCSI response packet */
265 struct timer_list timer; /* Timer on waiting for response */
266 bool enabled; /* Time has been enabled or not */
267 u32 snd_seq; /* netlink sending sequence number */
268 u32 snd_portid; /* netlink portid of sender */
269 struct nlmsghdr nlhdr; /* netlink message header */
270};
271
272enum {
273 ncsi_dev_state_major = 0xff00,
274 ncsi_dev_state_minor = 0x00ff,
275 ncsi_dev_state_probe_deselect = 0x0201,
276 ncsi_dev_state_probe_package,
277 ncsi_dev_state_probe_channel,
278 ncsi_dev_state_probe_mlx_gma,
279 ncsi_dev_state_probe_mlx_smaf,
280 ncsi_dev_state_probe_cis,
281 ncsi_dev_state_probe_keep_phy,
282 ncsi_dev_state_probe_gvi,
283 ncsi_dev_state_probe_gc,
284 ncsi_dev_state_probe_gls,
285 ncsi_dev_state_probe_dp,
286 ncsi_dev_state_config_sp = 0x0301,
287 ncsi_dev_state_config_cis,
288 ncsi_dev_state_config_oem_gma,
289 ncsi_dev_state_config_clear_vids,
290 ncsi_dev_state_config_svf,
291 ncsi_dev_state_config_ev,
292 ncsi_dev_state_config_sma,
293 ncsi_dev_state_config_ebf,
294 ncsi_dev_state_config_dgmf,
295 ncsi_dev_state_config_ecnt,
296 ncsi_dev_state_config_ec,
297 ncsi_dev_state_config_ae,
298 ncsi_dev_state_config_gls,
299 ncsi_dev_state_config_done,
300 ncsi_dev_state_suspend_select = 0x0401,
301 ncsi_dev_state_suspend_gls,
302 ncsi_dev_state_suspend_dcnt,
303 ncsi_dev_state_suspend_dc,
304 ncsi_dev_state_suspend_deselect,
305 ncsi_dev_state_suspend_done
306};
307
308struct vlan_vid {
309 struct list_head list;
310 __be16 proto;
311 u16 vid;
312};
313
314struct ncsi_dev_priv {
315 struct ncsi_dev ndev; /* Associated NCSI device */
316 unsigned int flags; /* NCSI device flags */
317#define NCSI_DEV_PROBED 1 /* Finalized NCSI topology */
318#define NCSI_DEV_HWA 2 /* Enabled HW arbitration */
319#define NCSI_DEV_RESHUFFLE 4
320#define NCSI_DEV_RESET 8 /* Reset state of NC */
321 unsigned int gma_flag; /* OEM GMA flag */
322 spinlock_t lock; /* Protect the NCSI device */
323 unsigned int package_probe_id;/* Current ID during probe */
324 unsigned int package_num; /* Number of packages */
325 struct list_head packages; /* List of packages */
326 struct ncsi_channel *hot_channel; /* Channel was ever active */
327 struct ncsi_request requests[256]; /* Request table */
328 unsigned int request_id; /* Last used request ID */
329#define NCSI_REQ_START_IDX 1
330 unsigned int pending_req_num; /* Number of pending requests */
331 struct ncsi_package *active_package; /* Currently handled package */
332 struct ncsi_channel *active_channel; /* Currently handled channel */
333 struct list_head channel_queue; /* Config queue of channels */
334 struct work_struct work; /* For channel management */
335 struct packet_type ptype; /* NCSI packet Rx handler */
336 struct list_head node; /* Form NCSI device list */
337#define NCSI_MAX_VLAN_VIDS 15
338 struct list_head vlan_vids; /* List of active VLAN IDs */
339
340 bool multi_package; /* Enable multiple packages */
341 bool mlx_multi_host; /* Enable multi host Mellanox */
342 u32 package_whitelist; /* Packages to configure */
343};
344
345struct ncsi_cmd_arg {
346 struct ncsi_dev_priv *ndp; /* Associated NCSI device */
347 unsigned char type; /* Command in the NCSI packet */
348 unsigned char id; /* Request ID (sequence number) */
349 unsigned char package; /* Destination package ID */
350 unsigned char channel; /* Destination channel ID or 0x1f */
351 unsigned short payload; /* Command packet payload length */
352 unsigned int req_flags; /* NCSI request properties */
353 union {
354 unsigned char bytes[16]; /* Command packet specific data */
355 unsigned short words[8];
356 unsigned int dwords[4];
357 };
358 unsigned char *data; /* NCSI OEM data */
359 struct genl_info *info; /* Netlink information */
360};
361
362extern struct list_head ncsi_dev_list;
363extern spinlock_t ncsi_dev_lock;
364
365#define TO_NCSI_DEV_PRIV(nd) \
366 container_of(nd, struct ncsi_dev_priv, ndev)
367#define NCSI_FOR_EACH_DEV(ndp) \
368 list_for_each_entry_rcu(ndp, &ncsi_dev_list, node)
369#define NCSI_FOR_EACH_PACKAGE(ndp, np) \
370 list_for_each_entry_rcu(np, &ndp->packages, node)
371#define NCSI_FOR_EACH_CHANNEL(np, nc) \
372 list_for_each_entry_rcu(nc, &np->channels, node)
373
374/* Resources */
375int ncsi_reset_dev(struct ncsi_dev *nd);
376void ncsi_start_channel_monitor(struct ncsi_channel *nc);
377void ncsi_stop_channel_monitor(struct ncsi_channel *nc);
378struct ncsi_channel *ncsi_find_channel(struct ncsi_package *np,
379 unsigned char id);
380struct ncsi_channel *ncsi_add_channel(struct ncsi_package *np,
381 unsigned char id);
382struct ncsi_package *ncsi_find_package(struct ncsi_dev_priv *ndp,
383 unsigned char id);
384struct ncsi_package *ncsi_add_package(struct ncsi_dev_priv *ndp,
385 unsigned char id);
386void ncsi_remove_package(struct ncsi_package *np);
387void ncsi_find_package_and_channel(struct ncsi_dev_priv *ndp,
388 unsigned char id,
389 struct ncsi_package **np,
390 struct ncsi_channel **nc);
391struct ncsi_request *ncsi_alloc_request(struct ncsi_dev_priv *ndp,
392 unsigned int req_flags);
393void ncsi_free_request(struct ncsi_request *nr);
394struct ncsi_dev *ncsi_find_dev(struct net_device *dev);
395int ncsi_process_next_channel(struct ncsi_dev_priv *ndp);
396bool ncsi_channel_has_link(struct ncsi_channel *channel);
397bool ncsi_channel_is_last(struct ncsi_dev_priv *ndp,
398 struct ncsi_channel *channel);
399int ncsi_update_tx_channel(struct ncsi_dev_priv *ndp,
400 struct ncsi_package *np,
401 struct ncsi_channel *disable,
402 struct ncsi_channel *enable);
403
404/* Packet handlers */
405u32 ncsi_calculate_checksum(unsigned char *data, int len);
406int ncsi_xmit_cmd(struct ncsi_cmd_arg *nca);
407int ncsi_rcv_rsp(struct sk_buff *skb, struct net_device *dev,
408 struct packet_type *pt, struct net_device *orig_dev);
409int ncsi_aen_handler(struct ncsi_dev_priv *ndp, struct sk_buff *skb);
410
411#endif /* __NCSI_INTERNAL_H__ */
412

source code of linux/net/ncsi/internal.h