2 * Copyright (c) 2018 Cisco and/or its affiliates.
3 * Licensed under the Apache License, Version 2.0 (the "License");
4 * you may not use this file except in compliance with the License.
5 * You may obtain a copy of the License at:
7 * http://www.apache.org/licenses/LICENSE-2.0
9 * Unless required by applicable law or agreed to in writing, software
10 * distributed under the License is distributed on an "AS IS" BASIS,
11 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
12 * See the License for the specific language governing permissions and
13 * limitations under the License.
16 #ifndef __included_vmnet_vmnet_h__
17 #define __included_vmnet_vmnet_h__
19 #define foreach_vmxnet3_tx_func_error \
20 _(ERROR_PACKETS, "error packets") \
21 _(NO_FREE_SLOTS, "no free tx slots")
25 #define _(f,s) VMXNET3_TX_ERROR_##f,
26 foreach_vmxnet3_tx_func_error
29 } vmxnet3_tx_func_error_t;
31 #define foreach_vmxnet3_rxmode_flags \
32 _(0, UCAST, "unicast") \
33 _(1, MCAST, "multicast") \
34 _(2, BCAST, "broadcast") \
35 _(3, ALL_MULTI, "all multicast") \
36 _(4, PROMISC, "promiscuous")
40 #define _(a, b, c) VMXNET3_RXMODE_##b = (1 << a),
41 foreach_vmxnet3_rxmode_flags
46 #define VMXNET3_REG_IMR 0x0000 /* Interrupt Mask Register */
47 #define VMXNET3_REG_TXPROD 0x0600 /* Tx Producer Index */
48 #define VMXNET3_REG_RXPROD 0x0800 /* Rx Producer Index for ring 1 */
49 #define VMXNET3_REG_RXPROD2 0x0A00 /* Rx Producer Index for ring 2 */
53 #define VMXNET3_REG_VRRS 0x0000 /* VMXNET3 Revision Report Selection */
54 #define VMXNET3_REG_UVRS 0x0008 /* UPT Version Report Selection */
55 #define VMXNET3_REG_DSAL 0x0010 /* Driver Shared Address Low */
56 #define VMXNET3_REG_DSAH 0x0018 /* Driver Shared Address High */
57 #define VMXNET3_REG_CMD 0x0020 /* Command */
58 #define VMXNET3_REG_MACL 0x0028 /* MAC Address Low */
59 #define VMXNET3_REG_MACH 0x0030 /* MAC Address High */
60 #define VMXNET3_REG_ICR 0x0038 /* Interrupt Cause Register */
61 #define VMXNET3_REG_ECR 0x0040 /* Event Cause Register */
63 #define VMXNET3_VLAN_LEN 4
64 #define VMXNET3_FCS_LEN 4
65 #define VMXNET3_MTU (1514 + VMXNET3_VLAN_LEN + VMXNET3_FCS_LEN)
67 #define VMXNET3_RXF_BTYPE (1 << 14) /* rx body buffer type */
68 #define VMXNET3_RXF_GEN (1 << 31) /* rx generation */
69 #define VMXNET3_RXCF_IP6 (1 << 20) /* rx ip6 packet */
70 #define VMXNET3_RXCF_IP4 (1 << 21) /* rx ip4 packet */
71 #define VMXNET3_RXCF_GEN (1 << 31) /* rx completion generation */
72 #define VMXNET3_RXC_INDEX (0xFFF) /* rx completion index mask */
74 #define VMXNET3_TXF_GEN (1 << 14) /* tx generation */
75 #define VMXNET3_TXF_EOP (1 << 12) /* tx end of packet */
76 #define VMXNET3_TXF_CQ (1 << 13) /* tx completion request */
77 #define VMXNET3_TXCF_GEN (1 << 31) /* tx completion generation */
78 #define VMXNET3_TXC_INDEX (0xFFF) /* tx completion index mask */
80 #define VMXNET3_RX_RING_SIZE 2
81 #define VMXNET3_INPUT_REFILL_THRESHOLD 32
82 #define VMXNET3_NUM_TX_DESC 1024
83 #define VMXNET3_NUM_TX_COMP VMXNET3_NUM_TX_DESC
84 #define VMXNET3_NUM_RX_DESC 1024
85 #define VMXNET3_NUM_RX_COMP VMXNET3_NUM_RX_DESC
87 #define VMXNET3_VERSION_MAGIC 0x69505845
88 #define VMXNET3_SHARED_MAGIC 0xbabefee1
89 #define VMXNET3_VERSION_SELECT 1
90 #define VMXNET3_UPT_VERSION_SELECT 1
91 #define VMXNET3_MAX_INTRS 25
92 #define VMXNET3_IC_DISABLE_ALL 0x1
94 #define VMXNET3_GOS_BITS_32 (1 << 0)
95 #define VMXNET3_GOS_BITS_64 (2 << 0)
96 #define VMXNET3_GOS_TYPE_LINUX (1 << 2)
97 #define VMXNET3_RXCL_LEN_MASK (0x3FFF) // 14 bits
98 #define VMXNET3_RXCL_ERROR (1 << 14)
99 #define VMXNET3_RXCI_EOP (1 << 14)
100 #define VMXNET3_RXCI_SOP (1 << 15)
102 #define foreach_vmxnet3_device_flags \
103 _(0, INITIALIZED, "initialized") \
104 _(1, ERROR, "error") \
105 _(2, ADMIN_UP, "admin-up") \
107 _(4, LINK_UP, "link-up") \
108 _(5, SHARED_TXQ_LOCK, "shared-txq-lock") \
113 #define _(a, b, c) VMXNET3_DEVICE_F_##b = (1 << a),
114 foreach_vmxnet3_device_flags
118 #define foreach_vmxnet3_set_cmds \
119 _(0, ACTIVATE_DEV, "activate device") \
120 _(1, QUIESCE_DEV, "quiesce device") \
121 _(2, RESET_DEV, "reset device") \
122 _(3, UPDATE_RX_MODE, "update rx mode") \
123 _(4, UPDATE_MAC_FILTERS, "update mac filters") \
124 _(5, UPDATE_VLAN_FILTERS, "update vlan filters") \
125 _(6, UPDATE_RSSIDT, "update rss idt") \
126 _(7, UPDATE_IML, "update iml") \
127 _(8, UPDATE_PMCFG, "update pm cfg") \
128 _(9, UPDATE_FEATURE, "update feature") \
129 _(10, STOP_EMULATION, "stop emulation") \
130 _(11, LOAD_PLUGIN, "load plugin") \
131 _(12, ACTIVATE_VF, "activate vf") \
132 _(13, RESERVED3, "reserved 3") \
133 _(14, RESERVED4, "reservced 4") \
134 _(15, REGISTER_MEMREGS, "register mem regs")
138 #define _(a, b, c) VMXNET3_CMD_##b = (a + 0xCAFE0000),
139 foreach_vmxnet3_set_cmds
143 #define foreach_vmxnet3_get_cmds \
144 _(0, GET_QUEUE_STATUS, "get queue status") \
145 _(1, GET_STATS, "get stats") \
146 _(2, GET_LINK, "get link") \
147 _(3, GET_PERM_MAC_LO, "get perm mac lo") \
148 _(4, GET_PERM_MAC_HI, "get perm mac hi") \
149 _(5, GET_DID_LO, "get did lo") \
150 _(6, GET_DID_HI, "get did hi") \
151 _(7, GET_DEV_EXTRA_INFO, "get dev extra info") \
152 _(8, GET_CONF_INTR, "get conf intr") \
153 _(9, GET_ADAPTIVE_RING_INFO, "get adaptive ring info") \
154 _(10, GET_TXDATA_DESC_SIZE, "gte txdata desc size") \
155 _(11, RESERVED5, "reserved5")
159 #define _(a, b, c) VMXNET3_CMD_##b = (a + 0xF00D0000),
160 foreach_vmxnet3_get_cmds
164 typedef CLIB_PACKED (struct
166 u32 version; u32 guest_info; u32 version_support;
167 u32 upt_version_support; u64 upt_features;
168 u64 driver_data_address; u64 queue_desc_address;
169 u32 driver_data_len; u32 queue_desc_len;
171 u16 max_num_rx_sg; u8 num_tx_queues; u8 num_rx_queues;
173 }) vmxnet3_misc_config;
175 typedef CLIB_PACKED (struct
180 u8 moderation_level[VMXNET3_MAX_INTRS]; u32 control;
182 }) vmxnet3_interrupt_config;
184 typedef CLIB_PACKED (struct
188 u16 pad; u64 multicast_address; u8 vlan_filter[512];
189 }) vmxnet3_rx_filter_config;
191 typedef CLIB_PACKED (struct
193 u32 version; u32 length;
195 }) vmxnet3_variable_config;
197 typedef CLIB_PACKED (struct
201 vmxnet3_misc_config misc;
202 vmxnet3_interrupt_config interrupt;
203 vmxnet3_rx_filter_config rx_filter;
204 vmxnet3_variable_config rss;
205 vmxnet3_variable_config pattern;
206 vmxnet3_variable_config plugin; u32 ecr;
210 typedef CLIB_PACKED (struct
215 }) vmxnet3_queue_status;
217 typedef CLIB_PACKED (struct
219 u32 num_deferred; u32 threshold;
221 }) vmxnet3_tx_queue_control;
223 typedef CLIB_PACKED (struct
227 u64 comp_address; u64 driver_data_address; u64 pad;
230 u32 num_comp; u32 driver_data_len; u8 intr_index;
232 }) vmxnet3_tx_queue_config;
234 typedef CLIB_PACKED (struct
238 u64 ucast_pkts; u64 ucast_bytes; u64 mcast_pkts;
240 u64 bcast_pkts; u64 bcast_bytes; u64 error_pkts;
244 typedef CLIB_PACKED (struct
246 vmxnet3_tx_queue_control ctrl;
247 vmxnet3_tx_queue_config cfg;
248 vmxnet3_queue_status status; vmxnet3_tx_stats stats;
252 typedef CLIB_PACKED (struct
254 u8 update_prod; u8 pad[7];
256 }) vmxnet3_rx_queue_control;
258 typedef CLIB_PACKED (struct
261 u64 comp_address; u64 driver_data_address; u64 pad;
263 u32 num_comp; u32 driver_data_len; u8 intr_index;
265 }) vmxnet3_rx_queue_config;
267 typedef CLIB_PACKED (struct
271 u64 ucast_pkts; u64 ucast_bytes; u64 mcast_pkts;
273 u64 bcast_pkts; u64 bcast_bytes; u64 nobuf_pkts;
277 typedef CLIB_PACKED (struct
279 vmxnet3_rx_queue_control ctrl;
280 vmxnet3_rx_queue_config cfg;
281 vmxnet3_queue_status status; vmxnet3_rx_stats stats;
285 typedef CLIB_PACKED (struct
287 vmxnet3_tx_queue tx; vmxnet3_rx_queue rx;
292 * buffer length -- bits 0-13
293 * buffer type -- bit 14
294 * descriptor type -- bit 15
295 * reserved -- bits 16-30
296 * generation -- bit 31
298 typedef CLIB_PACKED (struct
307 * RX desc index -- bits 0-11
309 * end of packet -- bit 14
310 * start of packet -- bit 15
311 * ring ID -- bits 16-25
312 * RSS hash type -- bits 26-29
313 * checksum not calculated -- bit 30
316 * rss: RSS hash value
319 * data length -- bits 0-13
321 * tag is stripped -- bit 15
322 * tag stripped -- bits 16-31
325 * checksum -- bits 0 - 15
326 * tcp/udp checksum correct-- bit 16
327 * udp packet -- bit 17
328 * tcp packet -- bit 18
329 * ip checksum correct -- bit 19
332 * ip fragment -- bit 22
333 * frame crc correct -- bit 23
334 * completion type -- bits 24-30
335 * generation -- bit 31
337 typedef CLIB_PACKED (struct
346 * TX desc index -- bits 0-11
350 * reserved -- bits 0-23
351 * completion type -- bits 24-30
352 * generation -- bit 31
354 typedef CLIB_PACKED (struct
363 * length -- bits 0-13
364 * generation -- bit 14
366 * descriptor type -- bit 16
368 * MSS, checksum offset -- bits 18-31
370 * header length -- bits 0-9
371 * offload mode -- bits 10-11
372 * end of packet -- bit 12
373 * completion request -- bit 13
375 * vlan tag insertion -- bit 15
376 * tag to insert -- bits 16-31
378 typedef CLIB_PACKED (struct
386 CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
397 CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
400 } vmxnet3_rx_comp_ring;
404 CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
407 vmxnet3_rx_ring rx_ring[VMXNET3_RX_RING_SIZE];
408 vmxnet3_rx_desc *rx_desc[VMXNET3_RX_RING_SIZE];
409 vmxnet3_rx_comp *rx_comp;
410 vmxnet3_rx_comp_ring rx_comp_ring;
415 CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
424 CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
427 } vmxnet3_tx_comp_ring;
431 CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
433 clib_spinlock_t lock;
435 vmxnet3_tx_desc *tx_desc;
436 vmxnet3_tx_comp *tx_comp;
437 vmxnet3_tx_ring tx_ring;
438 vmxnet3_tx_comp_ring tx_comp_ring;
441 typedef CLIB_PACKED (struct
443 vmxnet3_queues queues; vmxnet3_shared shared;
448 CLIB_CACHE_LINE_ALIGN_MARK (cacheline0);
450 u32 per_interface_next_index;
455 vlib_pci_dev_handle_t pci_dev_handle;
456 vlib_pci_addr_t pci_addr;
479 vmxnet3_device_t *devices;
480 vlib_physmem_region_index_t physmem_region;
481 u32 physmem_region_alloc;
485 extern vmxnet3_main_t vmxnet3_main;
489 vlib_pci_addr_t addr;
497 } vmxnet3_create_if_args_t;
503 vlib_buffer_t buffer;
504 } vmxnet3_input_trace_t;
506 void vmxnet3_create_if (vlib_main_t * vm, vmxnet3_create_if_args_t * args);
507 void vmxnet3_delete_if (vlib_main_t * vm, vmxnet3_device_t * ad);
509 extern clib_error_t *vmxnet3_plugin_api_hookup (vlib_main_t * vm);
510 extern vlib_node_registration_t vmxnet3_input_node;
511 extern vnet_device_class_t vmxnet3_device_class;
514 format_function_t format_vmxnet3_device;
515 format_function_t format_vmxnet3_device_name;
516 format_function_t format_vmxnet3_input_trace;
518 static_always_inline void
519 vmxnet3_reg_write (vmxnet3_device_t * vd, u8 bar, u32 addr, u32 val)
521 *(volatile u32 *) ((u8 *) vd->bar[bar] + addr) = val;
524 static_always_inline u32
525 vmxnet3_reg_read (vmxnet3_device_t * vd, u8 bar, u32 addr)
527 return *(volatile u32 *) (vd->bar[bar] + addr);
530 static_always_inline uword
531 vmxnet3_dma_addr (vlib_main_t * vm, vmxnet3_device_t * vd, void *p)
533 vmxnet3_main_t *vmxm = &vmxnet3_main;
535 return (vd->flags & VMXNET3_DEVICE_F_IOVA) ? pointer_to_uword (p) :
536 vlib_physmem_virtual_to_physical (vm, vmxm->physmem_region, p);
539 static_always_inline void
540 vmxnet3_rx_ring_advance_produce (vmxnet3_rxq_t * rxq, vmxnet3_rx_ring * ring)
543 if (PREDICT_FALSE (ring->produce == rxq->size))
546 ring->gen ^= VMXNET3_RXF_GEN;
550 static_always_inline clib_error_t *
551 vmxnet3_rxq_refill_ring0 (vlib_main_t * vm, vmxnet3_device_t * vd,
554 vmxnet3_rx_desc *rxd;
555 u16 n_refill, n_alloc;
556 vmxnet3_rx_ring *ring;
558 ring = &rxq->rx_ring[0];
559 n_refill = rxq->size - ring->fill;
561 if (PREDICT_TRUE (n_refill <= VMXNET3_INPUT_REFILL_THRESHOLD))
565 vlib_buffer_alloc_to_ring (vm, ring->bufs, ring->produce, rxq->size,
567 if (PREDICT_FALSE (n_alloc != n_refill))
570 vlib_buffer_free_from_ring (vm, ring->bufs, ring->produce, rxq->size,
572 return clib_error_return (0, "buffer alloc failed");
577 rxd = &rxq->rx_desc[0][ring->produce];
579 vlib_get_buffer_data_physical_address (vm, ring->bufs[ring->produce]);
580 rxd->flags = ring->gen | VLIB_BUFFER_DATA_SIZE;
582 vmxnet3_rx_ring_advance_produce (rxq, ring);
587 vmxnet3_reg_write (vd, 0, VMXNET3_REG_RXPROD, ring->produce);
592 static_always_inline clib_error_t *
593 vmxnet3_rxq_refill_ring1 (vlib_main_t * vm, vmxnet3_device_t * vd,
596 vmxnet3_rx_desc *rxd;
597 u16 n_refill, n_alloc;
598 vmxnet3_rx_ring *ring;
600 ring = &rxq->rx_ring[1];
601 n_refill = rxq->size - ring->fill;
603 if (PREDICT_TRUE (n_refill <= VMXNET3_INPUT_REFILL_THRESHOLD))
607 vlib_buffer_alloc_to_ring (vm, ring->bufs, ring->produce, rxq->size,
609 if (PREDICT_FALSE (n_alloc != n_refill))
612 vlib_buffer_free_from_ring (vm, ring->bufs, ring->produce, rxq->size,
614 return clib_error_return (0, "buffer alloc failed");
619 rxd = &rxq->rx_desc[1][ring->produce];
621 vlib_get_buffer_data_physical_address (vm, ring->bufs[ring->produce]);
622 rxd->flags = ring->gen | VLIB_BUFFER_DATA_SIZE | VMXNET3_RXF_BTYPE;
624 vmxnet3_rx_ring_advance_produce (rxq, ring);
629 vmxnet3_reg_write (vd, 0, VMXNET3_REG_RXPROD2, ring->produce);
634 #endif /* __included_vmnet_vmnet_h__ */
636 * fd.io coding-style-patch-verification: ON
639 * eval: (c-set-style "gnu")