rocker: add new rocker ethernet switch device
v3 cover rocker: add new rocker ethernet switch device
From: Scott Feldman <[email protected]>
v3:
- Per Stefan Hajnoczi review:
- move HMP rocker cmds to "info rocker"
- prefix QMP rocker cmds with query-
- tag QMP cmds as "Since 2.3"
- convert structs to typedef with CamelCase naming
- Remove SDHCI device ID move patch...Paolo Bonzini is addressing SDHCI move is separate patch.
v2:
- Address reg_guide.txt review comments from Eric Blake
- Address QMP review comments from Eric Blake
v1:
[This is a collaboration between myself and Jiri Pirko].
This patch set adds a new ethernet switch device, called rocker. Rocker is intended to emulate HW features of switch ASICs found in today's data-center-class switch/routers. The original motivation in creating a new device is to accelerate device driver development for ethernet switches in the Linux kernel. A device driver for rocker already exists in the Linux 3.18 kernel and loads against this device. Basic L2 switching (bridging) functionality is offloaded to the device. Work continues to enable offloading of L3 routing functions and ACLs, as well as support for a flow-based modes, such as OpenVSwitch with OpenFlow. Future support for terminating L2-over-L3 tunnels is also planned.
The core network processing functions are based on the spec of a real device:
Broadcom's OF-DPA. Specifically, rocker borrows OF-DPA's network processing pipeline comprised of flow match and action tables. Only the OF-DPA spec was used in constructing rocker. The rocker developers do not have access to the real OF-DPA's software source code, so this is a clean-room, ground-up development.
Each rocker device is a PCI device with a memory-mapped register space and MSI-X interrupts for command and event processing, as well as CPU-bound I/O. Each device can support up to 62 "front-panel" ports, which present themselves as -netdev attachment points. The device is programmed using OF-DPA flow and group tables to setup the flow pipeline. The programming defines the forwarding path for packets ingressing on 'front-panel' ports. The forwarding path can look at L2/L3/L4 packet header to forward the packet to its destination. For the performance path, packets would ingress and egress only on the device, and not be passed up to the device driver (or host OS). The slow path for control packets will forward packets to the CPU via the device driver for host OS processing.
A QMP/HMP interface is added to give inside into the device's internal port configuration and flow/group tables.
A test directory is included with some basic sanity tests to verify the device and driver.
Scott Feldman (9):
net: add MAC address string printer
virtio-net: use qemu_mac_strdup_printf
rocker: add register programming guide
pci: add rocker device ID
pci: add network device class 'other' for network switches
rocker: add new rocker switch device
qmp: add rocker device support
rocker: add tests
MAINTAINERS: add rocker
MAINTAINERS | 6 + default-configs/pci.mak | 1 + docs/specs/pci-ids.txt | 1 + hmp-commands.hx | 24 + hmp.c | 303 +++++ hmp.h | 4 + hw/net/Makefile.objs | 3 + hw/net/rocker/reg_guide.txt | 961 +++++++++++++ hw/net/rocker/rocker.c | 1440 ++++++++++++++++++++ hw/net/rocker/rocker.h | 76 ++ hw/net/rocker/rocker_desc.c | 379 ++++++ hw/net/rocker/rocker_desc.h | 57 + hw/net/rocker/rocker_fp.c | 242 ++++ hw/net/rocker/rocker_fp.h | 54 + hw/net/rocker/rocker_hw.h | 475 +++++++ hw/net/rocker/rocker_of_dpa.c | 2622 ++++++++++++++++++++++++++++++++++++ hw/net/rocker/rocker_of_dpa.h | 25 + hw/net/rocker/rocker_tlv.h | 244 ++++ hw/net/rocker/rocker_world.c | 108 ++ hw/net/rocker/rocker_world.h | 63 + hw/net/rocker/test/README | 5 + hw/net/rocker/test/all | 19 + hw/net/rocker/test/bridge | 43 + hw/net/rocker/test/bridge-stp | 52 + hw/net/rocker/test/bridge-vlan | 52 + hw/net/rocker/test/bridge-vlan-stp | 64 + hw/net/rocker/test/port | 22 + hw/net/rocker/test/tut.dot | 8 + hw/net/virtio-net.c | 12 +- include/hw/pci/pci.h | 1 + include/hw/pci/pci_ids.h | 1 + include/net/net.h | 1 + monitor.c | 28 + net/net.c | 7 + qapi-schema.json | 3 + qapi/rocker.json | 259 ++++ qmp-commands.hx | 97 ++ 37 files changed, 7753 insertions(+), 9 deletions(-) create mode 100644 hw/net/rocker/reg_guide.txt create mode 100644 hw/net/rocker/rocker.c create mode 100644 hw/net/rocker/rocker.h create mode 100644 hw/net/rocker/rocker_desc.c create mode 100644 hw/net/rocker/rocker_desc.h create mode 100644 hw/net/rocker/rocker_fp.c create mode 100644 hw/net/rocker/rocker_fp.h create mode 100644 hw/net/rocker/rocker_hw.h create mode 100644 hw/net/rocker/rocker_of_dpa.c create mode 100644 hw/net/rocker/rocker_of_dpa.h create mode 100644 hw/net/rocker/rocker_tlv.h create mode 100644 hw/net/rocker/rocker_world.c create mode 100644 hw/net/rocker/rocker_world.h create mode 100644 hw/net/rocker/test/README create mode 100755 hw/net/rocker/test/all create mode 100755 hw/net/rocker/test/bridge create mode 100755 hw/net/rocker/test/bridge-stp create mode 100755 hw/net/rocker/test/bridge-vlan create mode 100755 hw/net/rocker/test/bridge-vlan-stp create mode 100755 hw/net/rocker/test/port create mode 100644 hw/net/rocker/test/tut.dot create mode 100644 qapi/rocker.json
Signature · 1 line
1.7.10.4
PATCH v3 1/9 net: add MAC address string printer
From: Scott Feldman <[email protected]>
We can use this in virtio-net code as well as new Rocker driver code, so up-level this.
--- include/net/net.h | 1 + net/net.c | 7 +++++++ 2 files changed, 8 insertions(+)
include/net/net.h +1 -0
@@ -97,6 +97,7 @@ typedef struct NICState {bool peer_deleted; } NICState; +char *qemu_mac_strdup_printf (const uint8_t *macaddr);NetClientState *qemu_find_netdev (const char *id);int qemu_find_net_clients_except (const char *id,NetClientState **ncs,NetClientOptionsKind type,int max);
net/net.c +7 -0
@@ -151,6 +151,13 @@ int parse_host_port(struct sockaddr_in *saddr, const char *str)return 0 ; } +char *qemu_mac_strdup_printf (const uint8_t *macaddr) +{ +return g_strdup_printf ("%.2x:%.2x:%.2x:%.2x:%.2x:%.2x" , + macaddr[0 ], macaddr[1 ], macaddr[2 ], + macaddr[3 ], macaddr[4 ], macaddr[5 ]); +} +void qemu_format_nic_info_str (NetClientState *nc,uint8_t macaddr[6 ]) { snprintf(nc->info_str, sizeof(nc->info_str),
Signature · 1 line
1.7.10.4
PATCH v3 2/9 virtio-net: use qemu_mac_strdup_printf
In reply to [email protected]From: Scott Feldman <[email protected]>
--- hw/net/virtio-net.c | 12 +++--------- 1 file changed, 3 insertions(+), 9 deletions(-)
hw/net/virtio-net.c +3 -9
@@ -226,12 +226,6 @@ static void rxfilter_notify(NetClientState *nc) } } -static char *mac_strdup_printf (const uint8_t *mac) -{ -return g_strdup_printf ("%.2x:%.2x:%.2x:%.2x:%.2x:%.2x" , mac[0 ], - mac[1 ], mac[2 ], mac[3 ], mac[4 ], mac[5 ]); -} -static intList *get_vlan_table (VirtIONet *n) {intList *list, *entry;
@@ -284,12 +278,12 @@ static RxFilterInfo *virtio_net_query_rxfilter(NetClientState *nc) info->multicast_overflow = n->mac_table.multi_overflow; info->unicast_overflow = n->mac_table.uni_overflow; - info->main_mac =mac_strdup_printf (n->mac); + info->main_mac =qemu_mac_strdup_printf (n->mac); str_list =NULL ;for (i =0 ; i < n->mac_table.first_multi; i++) { entry =g_malloc0 (sizeof (*entry)); - entry->value =mac_strdup_printf (n->mac_table.macs + i *ETH_ALEN ); + entry->value =qemu_mac_strdup_printf (n->mac_table.macs + i *ETH_ALEN ); entry->next = str_list; str_list = entry; }
@@ -298,7 +292,7 @@ static RxFilterInfo *virtio_net_query_rxfilter(NetClientState *nc) str_list =NULL ;for (i = n->mac_table.first_multi; i < n->mac_table.in_use; i++) { entry =g_malloc0 (sizeof (*entry)); - entry->value =mac_strdup_printf (n->mac_table.macs + i *ETH_ALEN ); + entry->value =qemu_mac_strdup_printf (n->mac_table.macs + i *ETH_ALEN ); entry->next = str_list; str_list = entry; }
Signature · 1 line
1.7.10.4
PATCH v3 3/9 rocker: add register programming guide
In reply to [email protected]From: Scott Feldman <[email protected]>
This is the register programming guide for the Rocker device. It's intended for driver writers and device writers. It covers the device's PCI space, the register set, DMA interface, and interrupts.
--- hw/net/rocker/reg_guide.txt | 961 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 961 insertions(+) create mode 100644 hw/net/rocker/reg_guide.txt
hw/net/rocker/reg_guide.txt new file +961 -0
@@ -0,0 +1,961 @@ +Rocker Network Switch Register Programming Guide +Copyright (c) Scott Feldman <[email protected]> +Copyright (c) Neil Horman <[email protected]> +Version 0.11, 12/29/2014 + +LICENSE +======= + +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +SECTION 1: Introduction +======================= + +Overview +-------- + +This document describes the hardware/software interface for the Rocker switch +device. The intended audience is authors of OS drivers and device emulation +software. + +Notations and Conventions +------------------------- + +o In register descriptions, [n:m] indicates a range from bit n to bit m, +inclusive. +o Use of leading 0x indicates a hexadecimal number. +o Use of leading 0b indicates a binary number. +o The use of RSVD or Reserved indicates that a bit or field is reserved for +future use. +o Field width is in bytes, unless otherwise noted. +o Register are (R) read-only, (R/W) read/write, (W) write-only, or (COR) clear +on read +o TLV values in network-byte-order are designated with (N). + + +SECTION 2: PCI Configuration Registers +====================================== + +PCI Configuration Space +----------------------- + +Each switch instance registers as a PCI device with PCI configuration space: + + offset width description value + --------------------------------------------- + 0x0 2 Vendor ID 0x1b36 + 0x2 2 Device ID 0x0006 + 0x4 4 Command/Status + 0x8 1 Revision ID 0x01 + 0x9 3 Class code 0x2800 + 0xC 1 Cache line size + 0xD 1 Latency timer + 0xE 1 Header type + 0xF 1 Built-in self test + 0x10 4 Base address low + 0x14 4 Base address high + 0x18-28 Reserved + 0x2C 2 Subsystem vendor ID 0x0000 + 0x2E 2 Subsystem ID 0x0000 + 0x30-38 Reserved + 0x3C 1 Interrupt line + 0x3D 1 Interrupt pin 0x00 + 0x3E 1 Min grant 0x00 + 0x3D 1 Max latency 0x00 + 0x40 1 TRDY timeout + 0x41 1 Retry count + 0x42 2 Reserved + + +SECTION 3: Memory-Mapped Register Space +======================================= + +There are two memory-mapped BARs. BAR0 maps device register space and is +0x2000 in size. BAR1 maps MSI-X vector and PBA tables and is also 0x2000 in +size, allowing for 256 MSI-X vectors. The host BIOS will assign the base +address location. The host driver/OS will map the base address to host memory, +giving the driver mmio access to the device register space. + +All registers are 4 or 8 bytes long. It is assumed host software will access 4 +byte registers with one 4-byte access, and 8 byte registers with either two +4-byte accesses or a single 8-byte access. In the case of two 4-byte accesses, +access must be lower and then upper 4-bytes, in that order. + +BAR0 device register space is organized as follows: + + offset description + ------------------------------------------------------ + 0x0000-0x000f Bogus registers to catch misbehaving + drivers. Writes do nothing. Reads + back as 0xDEADBABE. + 0x0010-0x00ff Test registers + 0x0300-0x03ff General purpose registers + 0x1000-0x1fff Descriptor control + +Holes in register space are reserved. Writes to reserved registers do nothing. +Reads to reserved registers read back as 0. + +No fancy stuff like write-combining is enabled on any of the registers. + +BAR1 MSI-X register space is organized as follows: + + offset description + ------------------------------------------------------ + 0x0000-0x0fff MSI-X vector table (256 vectors total) + 0x1000-0x1fff MSI-X PBA table + + +SECTION 4: Interrupts, DMA, and Endianess +========================================= + +PCI Interrupts +-------------- + +The device supports only MSI-X interrupts. BAR1 memory-mapped region contains +the MSI-X vector and PBA tables, with support for up to 256 MSI-X vectors. + +The vector assignment is: + + vector description + ----------------------------------------------------- + 0 Command descriptor ring completion + 1 Event descriptor ring completion + 2 Test operation completion + 3 RSVD + 4-255 Tx and Rx descriptor ring completion + Tx vector is even + Rx vector is odd + +A MSI-X vector table entry is 16 bytes: + + field offset width description + ------------------------------------------------------------- + lower_addr 0x0 4 [31:2] message address[31:2] + [1:0] Rsvd (4 byte alignment + required) + upper_addr 0x4 4 [31:19] Rsvd + [14:0] message address[46:32] + data 0x8 4 message data[31:0] + control 0xc 4 [31:1] Rsvd + [0] mask (0 = enable, + 1 = masked) + +Software should install the Interrupt Service Routine (ISR) before any ports +are enabled or any commands are issued on the command ring. + +DMA Operations +-------------- + +DMA operations are used for packet DMA to/from the CPU, command and event +processing. Command processing includes statistical counters and table dumps, +table insertion/deletion, and more. Event processing provides an async +notification method for device-originating events. Each DMA operation has a +set of control registers to manage a descriptor ring. The descriptor rings are +allocated from contiguous host DMA-able memory and registers specify the rings +base address, size and current head and tail indices. Software always writes +the head, and hardware always writes the tail. + +The higher-order bit of DMA_DESC_COMP_ERR is used to mark hardware completion +of a descriptor. Software will clear this bit when posting a descriptor to the +ring, and hardware will set this bit when the descriptor is complete. + +Descriptor ring sizes must be a power of 2 and range from 2 to 64K entries. +Descriptor rings' base address must be 8-byte aligned. Descriptors must be +packed within ring. Each descriptor in each ring must also be aligned on an 8 +byte boundary. Each descriptor ring will have these registers: + + DMA_DESC_xxx_BASE_ADDR, offset 0x1000 + (x * 32), 64-bit, (R/W) + DMA_DESC_xxx_SIZE, offset 0x1008 + (x * 32), 32-bit, (R/W) + DMA_DESC_xxx_HEAD, offset 0x100c + (x * 32), 32-bit, (R/W) + DMA_DESC_xxx_TAIL, offset 0x1010 + (x * 32), 32-bit, (R) + DMA_DESC_xxx_CTRL, offset 0x1014 + (x * 32), 32-bit, (W) + DMA_DESC_xxx_CREDITS, offset 0x1018 + (x * 32), 32-bit, (R/W) + DMA_DESC_xxx_RSVD1, offset 0x101c + (x * 32), 32-bit, (R/W) + +Where x is descriptor ring index: + + index ring + -------------------- + 0 CMD + 1 EVENT + 2 TX (port 0) + 3 RX (port 0) + 4 TX (port 1) + 5 RX (port 1) + . + . + . + 124 TX (port 61) + 125 RX (port 61) + 126 Resv + 127 Resv + +Writing BASE_ADDR or SIZE will reset HEAD and TAIL to zero. HEAD cannot be +written passed TAIL. To do so would wrap the ring. An empty ring is when HEAD +== TAIL. A full ring is when HEAD is one position behind TAIL. Both HEAD and +TAIL increment and modulo wrap at the ring size. + +CTRL register bits: + + bit name description + ------------------------------------------------------------------------ + [0] CTRL_RESET Reset the descriptor ring + [1:31] Reserved + +All descriptor types share some common fields: + + field width description + ------------------------------------------------------------------- + DMA_DESC_BUF_ADDR 8 Phys addr of desc payload, 8-byte + aligned + DMA_DESC_COOKIE 8 Desc cookie for completion matching, + upper-most bit is reserved + DMA_DESC_BUF_SIZE 2 Desc payload size in bytes + DMA_DESC_TLV_SIZE 2 Desc payload total size in bytes + used for TLVs. Must be <= + DMA_DESC_BUF_SIZE. + DMA_DESC_COMP_ERR 2 Completion status of associated + desc payload. High order bit is + clear on new descs, toggled by + hw for completed items. + +To support forward- and backward-compatibility, descriptor and completion +payloads are specified in TLV format. Fields are packed with Type=field name, +Length=field length, and Value=field value. Software will ignore unknown fields +filled in by the switch. Likewise, the switch will ignore unknown fields +filled in by software. + +Descriptor payload buffer is 8-byte aligned and TLVs are 8-byte aligned. The +value within a TLV is also 8-byte aligned. The (packed, 8 byte) TLV header is: + + field width description + ----------------------------- + type 4 TLV type + len 2 TLV value length + pad 2 Reserved + +The alignment requirements for descriptors and TLVs are to avoid unaligned +access exceptions in software. Note that the payload for each TLV is also +8 byte aligned. + +Figure 1 shows an example descriptor buffer with two TLVs. + + <------- 8 bytes -------> + + 8-byte +––––+ +–––––––––––+–––––+–––––+ +–+ + align | type | len | pad | TLV#1 hdr | + +–––––––––––+–––––+–––––+ (len=22) | + | | | + | value | TVL#1 value | + | | (padded to 8-byte | + | +–––––+ alignment) | + | |/////| | + 8-byte +––––+ +–––––––––––+–––––––––––+ | + align | type | len | pad | TLV#2 hdr DESC_BUF_SIZE + +–––––+–––––+–––––+–––––+ (len=2) | + |value|/////////////////| TLV#2 value | + +–––––+/////////////////| | + |///////////////////////| | + |///////////////////////| | + |///////////////////////| | + |////////unused/////////| | + |////////space//////////| | + |///////////////////////| | + |///////////////////////| | + |///////////////////////| | + +–––––––––––––––––––––––+ +–+ + + fig. 1 + +TLVs can be nested within the NEST TLV type. + +Interrupt credits +^^^^^^^^^^^^^^^^^ + +MSI-X vectors used for descriptor ring completions use a credit mechanism for +efficient device, PCIe bus, OS and driver operations. Each descriptor ring has +a credit count which represent the number of outstanding descriptors to be +processed by the driver. As the device marks descriptors complete, the credit +count is incremented. As the driver processes those outstanding descriptors, +it returns credits back to the device. This way, the device knows the driver's +progress and can make decisions about when to fire the next interrupt or not. +When the credit count is zero, and the first descriptors are posted for the +driver, a single interrupt is fired. Once the interrupt is fired, the +interrupt is disabled (auto-masked). In response to the interrupt, the driver +will process descriptors and PIO write a returned credit value for that +descriptor ring. If the driver returns all credits (the driver caught up with +the device and there is no outstanding work), then the interrupt is unmasked, +but not fired. If only partial credits are returned, the interrupt remains +masked but the device generates an interrupt, signaling the driver that more +outstanding work is available. + +Endianess +--------- + +Device registers are hard-coding to little-endian (LE). The driver should +convert to/from host endianess to LE for device register accesses. + +Descriptors are LE. Descriptor buffer TLVs will have LE type and length +fields, but the value field can either be LE or network-byte-order, depending +on context. TLV values containing network packet data will be in network-byte +order. A TLV value containing a field or mask used to compare against network +packet data is network-byte order. For example, flow match fields (and masks) +are network-byte-order since they're matched directly, byte-by-byte, against +network packet data. All non-network-packet TLV multi-byte values will be LE. + +TLV values in network-byte-order are designated with (N). + + +SECTION 5: Test Registers +========================= + +Rocker switch has several test registers to support troubleshooting register +access, interrupt generation, and DMA operations: + + TEST_REG, offset 0x0010, 32-bit (R/W) + TEST_REG64, offset 0x0018, 64-bit (R/W) + TEST_IRQ, offset 0x0020, 32-bit (R/W) + TEST_DMA_ADDR, offset 0x0028, 64-bit (R/W) + TEST_DMA_SIZE, offset 0x0030, 32-bit (R/W) + TEST_DMA_CTRL, offset 0x0034, 32-bit (R/W) + +Reads to TEST_REG and TEST_REG64 will read a value 2x the last value written to +the register. The 32-bit and 64-bit versions are for testing 32-bit and 64-bit +host accesses. + +Bits written to TEST_IRQ will cause same (unmasked) bits to be written to +IRQ_STAT and an interrupt generated. Use IRQ_MASK to mask and unmask +particular bits. + +To test basic DMA operations, allocate a DMA-able host buffer and put the +buffer address into TEST_DMA_ADDR and size into TEST_DMA_SIZE. Then, write to +TEST_DMA_CTRL to manipulate the buffer contents. TEST_DMA_CTRL operations are: + + operation value description + ----------------------------------------------------------- + TEST_DMA_CTRL_CLEAR 1 clear buffer + TEST_DMA_CTRL_FILL 2 fill buffer bytes with 0x96 + TEST_DMA_CTRL_INVERT 4 invert bytes in buffer + +Various buffer address and sizes should be tested to verify no address boundary +issue exists. In particular, buffers that start on odd-8-byte boundary and/or +span multiple PAGE sizes should be tested. + + +SECTION 6: Ports +================ + +Physical and Logical Ports +------------------------------------ + +The switch supports up to 62 physical (front-panel) ports. Register +PORT_PHYS_COUNT returns the actual number of physical ports available: + + PORT_PHYS_COUNT, offset 0x0304, 32-bit, (R) + +In addition to front-panel ports, the switch supports logical ports for +tunnels. + +Front-panel ports and logical tunnel ports are mapped into a single 32-bit port +space. A special CPU port is assigned port 0. The front-panel ports are +mapped to ports 1-62. A special loopback port is assigned port 63. Logical +tunnel ports are assigned ports 0x0001000-0x0001ffff. +To summarize the port assignments: + + port mapping + ------------------------------------------------------- + 0 CPU port (for packets to/from host CPU) + 1-62 front-panel physical ports + 63 loopback port + 64-0x0000ffff RSVD + 0x00010000-0x0001ffff logical tunnel ports + 0x00020000-0xffffffff RSVD + +Physical Port Mode +------------------ + +Switch front-panel ports operate in a mode. Current, only mode is OF-DPA. +OF-DPA[1] mode is based on OpenFlow Data Plane Abstraction (OF-DPA) Abstract +Switch Specification, Version 1.0, from Broadcom Corporation. To set/get the +mode for front-panel ports, see port settings, below. + +Port Settings +------------- + +Links status for all front-panel ports is available via PORT_PHYS_LINK_STATUS: + + PORT_PHYS_LINK_STATUS, offset 0x0310, 64-bit, (R) + + Value is port bitmap. Bits 0 and 63 always read 0. Bits 1-62 + read 1 for link UP and 0 for link DOWN for respective front-panel ports. + +Other properties for front-panel ports are available via DMA CMD descriptors: + + Get PORT_SETTINGS descriptor: + + field width description + ---------------------------------------------- + PORT_SETTINGS 2 CMD_GET + PPORT 4 Physical port # + + Get PORT_SETTINGS completion: + + field width description + ---------------------------------------------- + PPORT 4 Physical port # + SPEED 4 Current port interface speed, in Mbps + DUPLEX 1 1 = Full, 0 = Half + AUTONEG 1 1 = enabled, 0 = disabled + MACADDR 6 Port MAC address + MODE 1 0 = OF-DPA + + Set PORT_SETTINGS descriptor: + + field width description + ---------------------------------------------- + PORT_SETTINGS 2 CMD_SET + PPORT 4 Physical port # + SPEED 4 Port interface speed, in Mbps + DUPLEX 1 1 = Full, 0 = Half + AUTONEG 1 1 = enabled, 0 = disabled + MACADDR 6 Port MAC address + MODE 1 0 = OF-DPA + +Port Enable +----------- + +Front-panel ports are initially disabled, which means port ingress and egress +packets will be dropped. To enable or disable a port, use PORT_PHYS_ENABLE: + + PORT_PHYS_ENABLE: offset 0x0318, 64-bit, (R/W) + + Value is bitmap of first 64 ports. Bits 0 and 63 are ignored + and always read as 0. Write 1 to enable port; write 0 to disable it. + Default is 0. + +SECTION 7: Switch Control +========================= + +This section covers switch-wide register settings. + +Control +------- + +This register is used for low level control of the switch. + + CONTROL: offset 0x0300, 32-bit, (W) + + bit name description + ------------------------------------------------------------------------ + [0] CONTROL_RESET If set, device will perform reset (same + as pci reset) + [1:31] Reserved + +Switch ID +--------- + +The switch has a SWITCH_ID to be used by software to uniquely identify the +switch: + + SWITCH_ID: offset 0x0320, 64-bit, (R) + + Value is opaque to switch software and no special encoding is implied. + + +SECTION 8: CPU Packet Processing +================================ + +For packets ingressing on switch ports that are not forwarded by the switch but +rather directed to the host CPU for further processing are delivered in the +DMA RX ring. Likewise, for host CPU originating packets destined to egress on +switch ports onto the network are scheduled by software using the DMA TX ring. + +Tx Packet Processing +-------------------- + +Software schedules packets for egress on switch ports using the DMA TX ring. A +TX descriptor buffer describes the packet location and size in host DMA-able +memory, the destination port, and any hardware-offload functions (such as L3 +payload checksum offload). Software then bumps the descriptor head to signal +hardware of new Tx work. In response, hardware will DMA read Tx descriptors up +to head, DMA read descriptor buffer and packet data, perform offloading +functions, and finally frame packet on wire (network). Once packet processing +is complete, hardware will writeback status to descriptor(s) to signal to +software that Tx is complete and software resources (e.g. skb) backing packet +can be released. + +Figure 2 shows an example 3-fragment packet queued with one Tx descriptor. A +TLV is used for each packet fragment. + + pkt frag 1 + +–––––––+ +–+ + +–––+ | | + desc buf | | | | + +––––––––+ | | | | + Tx ring +–––+ +–––––+ | | | + +–––––––––+ | | TLVs | +–––––––+ | + | +–––+ +––––––––+ pkt frag 2 | + | desc 0 | | +–––––+ +–––––––+ | + +–––––––––+ | TLVs | +–––+ | | + head+–+ | +––––––––+ | | | + | desc 1 | | +–––––+ +–––––––+ |pkt + +–––––––––+ | TLVs | | | + | | +––––––––+ | pkt frag 3 | + | | | +–––––––+ | + +–––––––––+ +–––+ | | + | | | | | + | | | | | + +–––––––––+ | | | + | | | | | + | | | | | + +–––––––––+ | | | + | | +–––––––+ +–+ + | | + +–––––––––+ + + fig 2. + +The TLVs for Tx descriptor buffer are: + + field width description + --------------------------------------------------------------------- + PPORT 4 Destination physical port # + TX_OFFLOAD 1 Hardware offload modes: + 0: no offload + 1: insert IP csum (ipv4 only) + 2: insert TCP/UDP csum + 3: L3 csum calc and insert + into csum offset (TX_L3_CSUM_OFF) + 16-bit 1's complement csum value. + IPv4 pseudo-header and IP + already calculated by OS + and inserted. + 4: TSO (TCP Segmentation Offload) + TX_L3_CSUM_OFF 2 For L3 csum offload mode, the offset, + from the beginning of the packet, + of the csum field in the L3 header + TX_TSO_MSS 2 For TSO offload mode, the + Maximum Segment Size in bytes + TX_TSO_HDR_LEN 2 For TSO offload mode, the + length of ethernet, IP, and + TCP/UDP headers, including IP + and TCP options. + TX_FRAGS <array> Packet fragments + TX_FRAG <nest> Packet fragment + TX_FRAG_ADDR 8 DMA address of packet fragment + TX_FRAG_LEN 2 Packet fragment length + +Possible status return codes in descriptor on completion are: + + DESC_COMP_ERR reason + -------------------------------------------------------------------- + 0 OK + ENXIO address or data read err on desc buf or packet + fragment + EINVAL bad pport or TSO or csum offloading error + ENOMEM no memory for internal staging tx fragment + +Rx Packet Processing +-------------------- + +For packets ingressing on switch ports that are not forwarded by the switch but +rather directed to the host CPU for further processing are delivered in the +DMA RX ring. Rx descriptor buffers are allocated by software and placed on the +ring. Hardware will fill Rx descriptor buffers with packet data, write the +completion, and signal to software that a new packet is ready. Since Rx packet +size is not known a-priori, the Rx descriptor buffer must be allocated for +worst-case packet size. A single Rx descriptor will contain the entire Rx +packet data in one RX_PACKET TLV. Other Rx TLVs describe and hardware offloads +performed on the packet, such as checksum validation. + +The TLVs for Rx descriptor buffer are: + + field width description + --------------------------------------------------- + PPORT 4 Source physical port # + RX_FLAGS 2 Packet parsing flags: + (1 << 0): IPv4 packet + (1 << 1): IPv6 packet + (1 << 2): csum calculated + (1 << 3): IPv4 csum good + (1 << 4): IP fragment + (1 << 5): TCP packet + (1 << 6): UDP packet + (1 << 7): TCP/UDP csum good + RX_CSUM 2 IP calculated checksum: + IPv4: IP payload csum + IPv6: header and payload csum + (Only valid is RX_FLAGS:csum calc is set) + RX_PACKET (N) <var> Packet data + +Possible status return codes in descriptor on completion are: + + DESC_COMP_ERR reason + -------------------------------------------------------------------- + 0 OK + ENXIO address or data read err on desc buf + ENOMEM no memory for internal staging desc buf + EMSGSIZE Rx descriptor buffer wasn't big enough to contain + pactet data TLV and other TLVs. + + +SECTION 9: OF-DPA Mode +====================== + +OF-DPA mode allows the switch to offload flow packet processing functions to +hardware. An OpenFlow controller would communicate with an OpenFlow agent +installed on the switch. The OpenFlow agent would (directly or indirectly) +communicate with the Rocker switch driver, which in turn would program switch +hardware with flow functionality, as defined in OF-DPA. The block diagram is: + + +–––––––––––––––----–––+ + | OF | + | Remote Controller | + +––––––––+––----–––––––+ + | + | + +––––––––+–––––––––+ + | OF | + | Local Agent | + +––––––––––––––––––+ + | | + | Rocker Driver | + +––––––––––––––––––+ + <this spec> + +––––––––––––––––––+ + | | + | Rocker Switch | + +––––––––––––––––––+ + +To participate in flow functions, ports must be configure for OF-DPA mode +during switch initialization. + +OF-DPA Flow Table Interface +--------------------------- + +There are commands to add, modify, delete, and get stats of flow table entries. +The commands are issued using the DMA CMD descriptor ring. The following +commands are defined: + + CMD_ADD: add an entry to flow table + CMD_MOD: modify an entry in flow table + CMD_DEL: delete an entry from flow table + CMD_GET_STATS: get stats for flow entry + +TLVs for add and modify commands are: + + field width description + ---------------------------------------------------- + OF_DPA_CMD 2 CMD_[ADD|MOD] + OF_DPA_TBL 2 Flow table ID + 0: ingress port + 10: vlan + 20: termination mac + 30: unicast routing + 40: multicast routing + 50: bridging + 60: ACL policy + OF_DPA_PRIORITY 4 Flow priority + OF_DPA_HARDTIME 4 Hard timeout for flow + OF_DPA_IDLETIME 4 Idle timeout for flow + OF_DPA_COOKIE 8 Cookie + +Additional TLVs based on flow table ID: + +Table ID 0: ingress port + + field width description + ---------------------------------------------------- + OF_DPA_IN_PPORT 4 ingress physical port number + OF_DPA_GOTO_TBL 2 goto table ID; zero to drop + +Table ID 10: vlan + + field width description + ---------------------------------------------------- + OF_DPA_IN_PPORT 4 ingress physical port number + OF_DPA_VLAN_ID 2 (N) vlan ID + OF_DPA_VLAN_ID_MASK 2 (N) vlan ID mask + OF_DPA_GOTO_TBL 2 goto table ID; zero to drop + OF_DPA_NEW_VLAN_ID 2 (N) new vlan ID + +Table ID 20: termination mac + + field width description + ---------------------------------------------------- + OF_DPA_IN_PPORT 4 ingress physical port number + OF_DPA_IN_PPORT_MASK 4 ingress physical port number mask + OF_DPA_ETHERTYPE 2 (N) must be either 0x0800 or 0x86dd + OF_DPA_DST_MAC 6 (N) destination MAC + OF_DPA_DST_MAC_MASK 6 (N) destination MAC mask + OF_DPA_VLAN_ID 2 (N) vlan ID + OF_DPA_VLAN_ID_MASK 2 (N) vlan ID mask + OF_DPA_GOTO_TBL 2 only acceptable values are + unicast or multicast routing + table IDs + OF_DPA_OUT_PPORT 2 if specified, must be + controller, set zero otherwise + +Table ID 30: unicast routing + + field width description + ---------------------------------------------------- + OF_DPA_ETHERTYPE 2 (N) must be either 0x0800 or 0x86dd + OF_DPA_DST_IP 4 (N) destination IPv4 address. + Must be unicast address + OF_DPA_DST_IP_MASK 4 (N) IP mask. Must be prefix mask + OF_DPA_DST_IPV6 16 (N) destination IPv6 address. + Must be unicast address + OF_DPA_DST_IPV6_MASK 16 (N) IPv6 mask. Must be prefix mask + OF_DPA_GOTO_TBL 2 goto table ID; zero to drop + OF_DPA_GROUP_ID 4 data for GROUP action must + be an L3 Unicast group entry + +Table ID 40: multicast routing + + field width description + ---------------------------------------------------- + OF_DPA_ETHERTYPE 2 (N) must be either 0x0800 or 0x86dd + OF_DPA_VLAN_ID 2 (N) vlan ID + OF_DPA_SRC_IP 4 (N) source IPv4. Optional, + can contain IPv4 address, + must be completely masked + if not used + OF_DPA_SRC_IP_MASK 4 (N) IP Mask + OF_DPA_DST_IP 4 (N) destination IPv4 address. + Must be multicast address + OF_DPA_SRC_IPV6 16 (N) source IPv6 Address. Optional. + Can contain IPv6 address, + must be completely masked + if not used + OF_DPA_SRC_IPV6_MASK 16 (N) IPv6 mask. + OF_DPA_DST_IPV6 16 (N) destination IPv6 Address. Must + be multicast address + Must be multicast address + OF_DPA_GOTO_TBL 2 goto table ID; zero to drop + OF_DPA_GROUP_ID 4 data for GROUP action must + be an L3 multicast group entry + +Table ID 50: bridging + + field width description + ---------------------------------------------------- + OF_DPA_VLAN_ID 2 (N) vlan ID + OF_DPA_TUNNEL_ID 4 tunnel ID + OF_DPA_DST_MAC 6 (N) destination MAC + OF_DPA_DST_MAC_MASK 6 (N) destination MAC mask + OF_DPA_GOTO_TBL 2 goto table ID; zero to drop + OF_DPA_GROUP_ID 4 data for GROUP action must + be a L2 Interface, L2 + Multicast, L2 Flood, + or L2 Overlay group entry + as appropriate + OF_DPA_TUNNEL_LPORT 4 unicast Tenant Bridging + flows specify a tunnel + logical port ID + OF_DPA_OUT_PPORT 2 data for OUTPUT action, + restricted to CONTROLLER, + set to 0 otherwise + +Table ID 60: acl policy + + field width description + ---------------------------------------------------- + OF_DPA_IN_PPORT 4 ingress physical port number + OF_DPA_IN_PPORT_MASK 4 ingress physical port number mask + OF_DPA_ETHERTYPE 2 (N) ethertype + OF_DPA_VLAN_ID 2 (N) vlan ID + OF_DPA_VLAN_ID_MASK 2 (N) vlan ID mask + OF_DPA_VLAN_PCP 2 (N) vlan Priority Code Point + OF_DPA_VLAN_PCP_MASK 2 (N) vlan Priority Code Point mask + OF_DPA_SRC_MAC 6 (N) source MAC + OF_DPA_SRC_MAC_MASK 6 (N) source MAC mask + OF_DPA_DST_MAC 6 (N) destination MAC + OF_DPA_DST_MAC_MASK 6 (N) destination MAC mask + OF_DPA_TUNNEL_ID 4 tunnel ID + OF_DPA_SRC_IP 4 (N) source IPv4. Optional, + can contain IPv4 address, + must be completely masked + if not used + OF_DPA_SRC_IP_MASK 4 (N) IP Mask + OF_DPA_DST_IP 4 (N) destination IPv4 address. + Must be multicast address + OF_DPA_DST_IP_MASK 4 (N) IP Mask + OF_DPA_SRC_IPV6 16 (N) source IPv6 Address. Optional. + Can contain IPv6 address, + must be completely masked + if not used + OF_DPA_SRC_IPV6_MASK 16 (N) IPv6 mask + OF_DPA_DST_IPV6 16 (N) destination IPv6 Address. Must + be multicast address. + OF_DPA_DST_IPV6_MASK 16 (N) IPv6 mask + OF_DPA_SRC_ARP_IP 4 (N) source IPv4 address in the ARP + payload. Only used if ethertype + == 0x0806. + OF_DPA_SRC_ARP_IP_MASK 4 (N) IP Mask + OF_DPA_IP_PROTO 1 IP protocol + OF_DPA_IP_PROTO_MASK 1 IP protocol mask + OF_DPA_IP_DSCP 1 DSCP + OF_DPA_IP_DSCP_MASK 1 DSCP mask + OF_DPA_IP_ECN 1 ECN + OF_DPA_IP_ECN_MASK 1 ECN mask + OF_DPA_L4_SRC_PORT 2 (N) L4 source port, only for + TCP, UDP, or SCTP + OF_DPA_L4_SRC_PORT_MASK 2 (N) L4 source port mask + OF_DPA_L4_DST_PORT 2 (N) L4 source port, only for + TCP, UDP, or SCTP + OF_DPA_L4_DST_PORT_MASK 2 (N) L4 source port mask + OF_DPA_ICMP_TYPE 1 ICMP type, only if IP + protocol is 1 + OF_DPA_ICMP_TYPE_MASK 1 ICMP type mask + OF_DPA_ICMP_CODE 1 ICMP code + OF_DPA_ICMP_CODE_MASK 1 ICMP code mask + OF_DPA_IPV6_LABEL 4 (N) IPv6 flow label + OF_DPA_IPV6_LABEL_MASK 4 (N) IPv6 flow label mask + OF_DPA_GROUP_ID 4 data for GROUP action + OF_DPA_QUEUE_ID_ACTION 1 write the queue ID + OF_DPA_NEW_QUEUE_ID 1 queue ID + OF_DPA_VLAN_PCP_ACTION 1 write the VLAN priority + OF_DPA_NEW_VLAN_PCP 1 VLAN priority + OF_DPA_IP_DSCP_ACTION 1 write the DSCP + OF_DPA_NEW_IP_DSCP 1 new DSCP + OF_DPA_TUNNEL_LPORT 4 restrct to valid tunnel + logical port, set to 0 + otherwise. + OF_DPA_OUT_PPORT 2 data for OUTPUT action, + restricted to CONTROLLER, + set to 0 otherwise + OF_DPA_CLEAR_ACTIONS 4 if 1 packets matching flow are + dropped (all other instructions + ignored) + +TLVs for flow delete and get stats command are: + + field width description + --------------------------------------------------- + OF_DPA_CMD 2 CMD_[DEL|GET_STATS] + OF_DPA_COOKIE 8 Cookie + +On completion of get stats command, the descriptor buffer is written back with +the following TLVs: + + field width description + --------------------------------------------------- + OF_DPA_STAT_DURATION 4 Flow duration + OF_DPA_STAT_RX_PKTS 8 Received packets + OF_DPA_STAT_TX_PKTS 8 Transmit packets + +Possible status return codes in descriptor on completion are: + + DESC_COMP_ERR command reason + -------------------------------------------------------------------- + 0 all OK + EFAULT all head or tail index outside + of ring + ENXIO all address or data read err on + desc buf + EMSGSIZE GET_STATS cmd descriptor buffer wasn't + big enough to contain write-back + TLVs + EINVAL all invalid parameters passed in + EEXIST ADD entry already exists + ENOSPC ADD no space left in flow table + ENOENT MOD|DEL|GET_STATS cookie invalid + +Group Table Interface +--------------------- + +There are commands to add, modify, delete, and get stats of group table +entries. The commands are issued using the DMA CMD descriptor ring. The +following commands are defined: + + CMD_ADD: add an entry to group table + CMD_MOD: modify an entry in group table + CMD_DEL: delete an entry from group table + CMD_GET_STATS: get stats for group entry + +TLVs for add and modify commands are: + + field width description + ----------------------------------------------------------- + FLOW_GROUP_CMD 2 CMD_[ADD|MOD] + FLOW_GROUP_ID 2 Flow group ID + FLOW_GROUP_TYPE 1 Group type: + 0: L2 interface + 1: L2 rewrite + 2: L3 unicast + 3: L2 multicast + 4: L2 flood + 5: L3 interface + 6: L3 multicast + 7: L3 ECMP + 8: L2 overlay + FLOW_VLAN_ID 2 Vlan ID (types 0, 3, 4, 6) + FLOW_L2_PORT 2 Port (types 0) + FLOW_INDEX 4 Index (all types but 0) + FLOW_OVERLAY_TYPE 1 Overlay sub-type (type 8): + 0: Flood unicast tunnel + 1: Flood multicast tunnel + 2: Multicast unicast tunnel + 3: Multicast multicast tunnel + FLOW_GROUP_ACTION nest + FLOW_GROUP_ID 2 next group ID in chain (all + types except 0) + FLOW_OUT_PORT 4 egress port (types 0, 8) + FLOW_POP_VLAN_TAG 1 strip outer VLAN tag (type 1 + only) + FLOW_VLAN_ID 2 (types 1, 5) + FLOW_SRC_MAC 6 (types 1, 2, 5) + FLOW_DST_MAC 6 (types 1, 2) + +TLVs for flow delete and get stats command are: + + field width description + ----------------------------------------------------------- + FLOW_GROUP_CMD 2 CMD_[DEL|GET_STATS] + FLOW_GROUP_ID 2 Flow group ID + +On completion of get stats command, the descriptor buffer is written back with +the following TLVs: + + field width description + --------------------------------------------------- + FLOW_GROUP_ID 2 Flow group ID + FLOW_STAT_DURATION 4 Flow duration + FLOW_STAT_REF_COUNT 4 Flow reference count + FLOW_STAT_BUCKET_COUNT 4 Flow bucket count + +Possible status return codes in descriptor on completion are: + + DESC_COMP_ERR command reason + -------------------------------------------------------------------- + 0 all OK + EFAULT all head or tail index outside + of ring + ENXIO all address or data read err on + desc buf + ENOSPC GET_STATS cmd descriptor buffer wasn't + big enough to contain write-back + TLVs + EINVAL ADD|MOD invalid parameters passed in + EEXIST ADD entry already exists + ENOSPC ADD no space left in flow table + ENOENT MOD|DEL|GET_STATS group ID invalid + EBUSY DEL group reference count non-zero + ENODEV ADD next group ID doesn't exist + + + +References +========== + +[1] OpenFlow Data Plane Abstraction (OF-DPA) Abstract Switch Specification, +Version 1.0, from Broadcom Corporation, February 21, 2014.
Signature · 1 line
1.7.10.4
Re: [Qemu-devel] [PATCH v3 3/9] rocker: add register programming guide
Quoted 6 lines · On 11/01/2015 04:57, [email protected] wrote:
From: Scott Feldman <[email protected]>
This is the register programming guide for the Rocker device. It's intended for driver writers and device writers. It covers the device's PCI space, the register set, DMA interface, and interrupts.
Quoted 6 lines
Signed-off-by Scott Feldman <[email protected]>Signed-off-by Jiri Pirko <[email protected]>--- hw/net/rocker/reg_guide.txt | 961 +++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 961 insertions(+) create mode 100644 hw/net/rocker/reg_guide.txt
This should be docs/specs/rocker.txt
Quoted 63 lines
hw/net/rocker/reg_guide.txt new file +57
-0@@ -0,0 +1,961 @@ +Rocker Network Switch Register Programming Guide +Copyright (c) Scott Feldman <[email protected]> +Copyright (c) Neil Horman <[email protected]> +Version 0.11, 12/29/2014 + +LICENSE +======= + +This program is free software; you can redistribute it and/or modify +it under the terms of the GNU General Public License as published by +the Free Software Foundation; either version 2 of the License, or +(at your option) any later version. + +This program is distributed in the hope that it will be useful, +but WITHOUT ANY WARRANTY; without even the implied warranty of +MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the +GNU General Public License for more details. + +SECTION 1: Introduction +======================= + +Overview +-------- + +This document describes the hardware/software interface for the Rocker switch +device. The intended audience is authors of OS drivers and device emulation +software. + +Notations and Conventions +------------------------- + +o In register descriptions, [n:m] indicates a range from bit n to bit m, +inclusive. +o Use of leading 0x indicates a hexadecimal number. +o Use of leading 0b indicates a binary number. +o The use of RSVD or Reserved indicates that a bit or field is reserved for +future use. +o Field width is in bytes, unless otherwise noted. +o Register are (R) read-only, (R/W) read/write, (W) write-only, or (COR) clear +on read +o TLV values in network-byte-order are designated with (N). + + +SECTION 2: PCI Configuration Registers +====================================== + +PCI Configuration Space +----------------------- + +Each switch instance registers as a PCI device with PCI configuration space: + + offset width description value + --------------------------------------------- + 0x0 2 Vendor ID 0x1b36 + 0x2 2 Device ID 0x0006 + 0x4 4 Command/Status + 0x8 1 Revision ID 0x01
hw/net/rocker/reg_guide.txt line 67
Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+ 0x9 3 Class code 0x2800 + 0xC 1 Cache line size + 0xD 1 Latency timer + 0xE 1 Header type + 0xF 1 Built-in self test + 0x10 4 Base address low + 0x14 4 Base address high + 0x18-28 Reserved + 0x2C 2 Subsystem vendor ID 0x0000 + 0x2E 2 Subsystem ID 0x0000
This should not be guaranteed to 0, should it?
Quoted 8 lines
hw/net/rocker/reg_guide.txt new file +8
-0+ 0x30-38 Reserved + 0x3C 1 Interrupt line + 0x3D 1 Interrupt pin 0x00 + 0x3E 1 Min grant 0x00 + 0x3D 1 Max latency 0x00 + 0x40 1 TRDY timeout + 0x41 1 Retry count + 0x42 2 Reserved
hw/net/rocker/reg_guide.txt line 85
Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+ + +SECTION 3: Memory-Mapped Register Space +======================================= + +There are two memory-mapped BARs. BAR0 maps device register space and is +0x2000 in size. BAR1 maps MSI-X vector and PBA tables and is also 0x2000 in +size, allowing for 256 MSI-X vectors. The host BIOS will assign the base +address location. The host driver/OS will map the base address to host memory, +giving the driver mmio access to the device register space.
No need for the bits after "The host BIOS..." since that's just normal PCI.
hw/net/rocker/reg_guide.txt line 90
Quoted 4 lines
hw/net/rocker/reg_guide.txt new file +4
-0+All registers are 4 or 8 bytes long. It is assumed host software will access 4 +byte registers with one 4-byte access, and 8 byte registers with either two +4-byte accesses or a single 8-byte access. In the case of two 4-byte accesses, +access must be lower and then upper 4-bytes, in that order.
Double 4-byte accesses are not implemented, are they?
Quoted 9 lines
hw/net/rocker/reg_guide.txt new file +9
-0+Interrupt credits +^^^^^^^^^^^^^^^^^ + +MSI-X vectors used for descriptor ring completions use a credit mechanism for +efficient device, PCIe bus, OS and driver operations. Each descriptor ring has +a credit count which represent the number of outstanding descriptors to be +processed by the driver. As the device marks descriptors complete, the credit +count is incremented. As the driver processes those outstanding descriptors, +it returns credits back to the device. This way, the device knows the driver's
hw/net/rocker/reg_guide.txt line 298
Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+progress and can make decisions about when to fire the next interrupt or not. +When the credit count is zero, and the first descriptors are posted for the +driver, a single interrupt is fired. Once the interrupt is fired, the +interrupt is disabled (auto-masked). In response to the interrupt, the driver +will process descriptors and PIO write a returned credit value for that +descriptor ring. If the driver returns all credits (the driver caught up with +the device and there is no outstanding work), then the interrupt is unmasked, +but not fired. If only partial credits are returned, the interrupt remains +masked but the device generates an interrupt, signaling the driver that more +outstanding work is available.
Perhaps mention that this masking is unrelated to the MSI-X interrupt mask register?
hw/net/rocker/reg_guide.txt line 320
Quoted 4 lines
hw/net/rocker/reg_guide.txt new file +4
-0+SECTION 5: Test Registers +========================= + +Rocker switch has several test registers to support troubleshooting register
s/Rocker switch/Rocker/
hw/net/rocker/reg_guide.txt line 330
Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+access, interrupt generation, and DMA operations: + + TEST_REG, offset 0x0010, 32-bit (R/W) + TEST_REG64, offset 0x0018, 64-bit (R/W) + TEST_IRQ, offset 0x0020, 32-bit (R/W) + TEST_DMA_ADDR, offset 0x0028, 64-bit (R/W) + TEST_DMA_SIZE, offset 0x0030, 32-bit (R/W) + TEST_DMA_CTRL, offset 0x0034, 32-bit (R/W) + +Reads to TEST_REG and TEST_REG64 will read a value 2x the last value written to
s/2x/equal to twice/
hw/net/rocker/reg_guide.txt line 332
Quoted 2 lines
hw/net/rocker/reg_guide.txt new file +2
-0+the register. The 32-bit and 64-bit versions are for testing 32-bit and 64-bit +host accesses.
Right now, as mentioned above, 64-bit registers must be accessed with a single 32-bit host access.
In the case of 32-bit host accesses, should TEST_REG64's value be latched until the upper half is written? If so, please mention it and describe that this behavior is shared with the other 64-bit Rocker registers.
hw/net/rocker/reg_guide.txt line 336
Quoted 3 lines
hw/net/rocker/reg_guide.txt new file +3
-0+Bits written to TEST_IRQ will cause same (unmasked) bits to be written to +IRQ_STAT and an interrupt generated. Use IRQ_MASK to mask and unmask +particular bits.
It looks like actually TEST_IRQ will generate a single interrupt, not many of them. So writing 1 sets bits 1 in the PBA, not bit 0. Writing 3 sets bits 3, not bits 0 and 1.
Please do not use "IRQ_STAT", call it the PBA instead. Also remove the reference to IRQ_MASK, it's uninteresting.
Quoted 6 lines
hw/net/rocker/reg_guide.txt new file +6
-0+SECTION 7: Switch Control +========================= + +This section covers switch-wide register settings. + +Control
hw/net/rocker/reg_guide.txt line 459
Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+------- + +This register is used for low level control of the switch. + + CONTROL: offset 0x0300, 32-bit, (W) + + bit name description + ------------------------------------------------------------------------ + [0] CONTROL_RESET If set, device will perform reset (same + as pci reset)
It's not the same as PCI reset, as it will not reset BARs for example.
hw/net/rocker/reg_guide.txt line 479
Quoted 8 lines
hw/net/rocker/reg_guide.txt new file +8
-0+ +SECTION 8: CPU Packet Processing +================================ + +For packets ingressing on switch ports that are not forwarded by the switch but +rather directed to the host CPU for further processing are delivered in the +DMA RX ring. Likewise, for host CPU originating packets destined to egress on +switch ports onto the network are scheduled by software using the DMA TX ring.
Ingress packets for ports that are not forwarded by the switch are directed to the host CPU for further processing, and delivered in the DMA RX ring. Likewise, the host CPU can use the DMA TX ring to schedule packets that will egress onto the network.
Quoted 73 lines
hw/net/rocker/reg_guide.txt new file +73
-0+ +Tx Packet Processing +-------------------- + +Software schedules packets for egress on switch ports using the DMA TX ring. A +TX descriptor buffer describes the packet location and size in host DMA-able +memory, the destination port, and any hardware-offload functions (such as L3 +payload checksum offload). Software then bumps the descriptor head to signal +hardware of new Tx work. In response, hardware will DMA read Tx descriptors up +to head, DMA read descriptor buffer and packet data, perform offloading +functions, and finally frame packet on wire (network). Once packet processing +is complete, hardware will writeback status to descriptor(s) to signal to +software that Tx is complete and software resources (e.g. skb) backing packet +can be released. + +Figure 2 shows an example 3-fragment packet queued with one Tx descriptor. A +TLV is used for each packet fragment. + + pkt frag 1 + +–––––––+ +–+ + +–––+ | | + desc buf | | | | + +––––––––+ | | | | + Tx ring +–––+ +–––––+ | | | + +–––––––––+ | | TLVs | +–––––––+ | + | +–––+ +––––––––+ pkt frag 2 | + | desc 0 | | +–––––+ +–––––––+ | + +–––––––––+ | TLVs | +–––+ | | + head+–+ | +––––––––+ | | | + | desc 1 | | +–––––+ +–––––––+ |pkt + +–––––––––+ | TLVs | | | + | | +––––––––+ | pkt frag 3 | + | | | +–––––––+ | + +–––––––––+ +–––+ | | + | | | | | + | | | | | + +–––––––––+ | | | + | | | | | + | | | | | + +–––––––––+ | | | + | | +–––––––+ +–+ + | | + +–––––––––+ + + fig 2. + +The TLVs for Tx descriptor buffer are: + + field width description + --------------------------------------------------------------------- + PPORT 4 Destination physical port # + TX_OFFLOAD 1 Hardware offload modes: + 0: no offload + 1: insert IP csum (ipv4 only) + 2: insert TCP/UDP csum + 3: L3 csum calc and insert + into csum offset (TX_L3_CSUM_OFF) + 16-bit 1's complement csum value. + IPv4 pseudo-header and IP + already calculated by OS + and inserted. + 4: TSO (TCP Segmentation Offload) + TX_L3_CSUM_OFF 2 For L3 csum offload mode, the offset, + from the beginning of the packet, + of the csum field in the L3 header + TX_TSO_MSS 2 For TSO offload mode, the + Maximum Segment Size in bytes + TX_TSO_HDR_LEN 2 For TSO offload mode, the + length of ethernet, IP, and + TCP/UDP headers, including IP + and TCP options. + TX_FRAGS <array> Packet fragments + TX_FRAG <nest> Packet fragment
hw/net/rocker/reg_guide.txt line 562
Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+ TX_FRAG_ADDR 8 DMA address of packet fragment + TX_FRAG_LEN 2 Packet fragment length + +Possible status return codes in descriptor on completion are: + + DESC_COMP_ERR reason + -------------------------------------------------------------------- + 0 OK + ENXIO address or data read err on desc buf or packet + fragment
This is more like EFAULT actually.
hw/net/rocker/reg_guide.txt line 564
Quoted 2 lines
hw/net/rocker/reg_guide.txt new file +2
-0+ EINVAL bad pport or TSO or csum offloading error + ENOMEM no memory for internal staging tx fragment
QEMU is portable and these values are not, unfortunately. So please hardcode them to be 6/22/12 respectively.
Or even better, to avoid the temptation, make them 1/2/3 and create new constants ROCKER_OK, ROCKER_ERR_FAULT, ROCKER_ERR_INVAL, ROCKER_ERR_NOMEM.
In any case, since you are at it, sort them in either numeric order or alphabetic order (apart from OK which can remain first).
Quoted 32 lines
hw/net/rocker/reg_guide.txt new file +32
-0+Rx Packet Processing +-------------------- + +For packets ingressing on switch ports that are not forwarded by the switch but +rather directed to the host CPU for further processing are delivered in the +DMA RX ring. Rx descriptor buffers are allocated by software and placed on the +ring. Hardware will fill Rx descriptor buffers with packet data, write the +completion, and signal to software that a new packet is ready. Since Rx packet +size is not known a-priori, the Rx descriptor buffer must be allocated for +worst-case packet size. A single Rx descriptor will contain the entire Rx +packet data in one RX_PACKET TLV. Other Rx TLVs describe and hardware offloads +performed on the packet, such as checksum validation. + +The TLVs for Rx descriptor buffer are: + + field width description + --------------------------------------------------- + PPORT 4 Source physical port # + RX_FLAGS 2 Packet parsing flags: + (1 << 0): IPv4 packet + (1 << 1): IPv6 packet + (1 << 2): csum calculated + (1 << 3): IPv4 csum good + (1 << 4): IP fragment + (1 << 5): TCP packet + (1 << 6): UDP packet + (1 << 7): TCP/UDP csum good + RX_CSUM 2 IP calculated checksum: + IPv4: IP payload csum + IPv6: header and payload csum + (Only valid is RX_FLAGS:csum calc is set) + RX_PACKET (N) <var> Packet data
hw/net/rocker/reg_guide.txt line 607
Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+ +Possible status return codes in descriptor on completion are: + + DESC_COMP_ERR reason + -------------------------------------------------------------------- + 0 OK + ENXIO address or data read err on desc buf + ENOMEM no memory for internal staging desc buf + EMSGSIZE Rx descriptor buffer wasn't big enough to contain + pactet data TLV and other TLVs.
EMSGSIZE in fact doesn't exist on Windows even. So make this ROCKER_ERR_MSGSIZE==4.
hw/net/rocker/reg_guide.txt line 665
Quoted 11 lines
hw/net/rocker/reg_guide.txt new file +11
-0+ field width description + ---------------------------------------------------- + OF_DPA_CMD 2 CMD_[ADD|MOD] + OF_DPA_TBL 2 Flow table ID + 0: ingress port + 10: vlan + 20: termination mac + 30: unicast routing + 40: multicast routing + 50: bridging + 60: ACL policy
Decimal, I guess. Better mention it, if only for completeness.
Quoted 8 lines
hw/net/rocker/reg_guide.txt new file +8
-0+Possible status return codes in descriptor on completion are: + + DESC_COMP_ERR command reason + -------------------------------------------------------------------- + 0 all OK + EFAULT all head or tail index outside + of ring + ENXIO all address or data read err on
hw/net/rocker/reg_guide.txt line 953
Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+ desc buf + ENOSPC GET_STATS cmd descriptor buffer wasn't + big enough to contain write-back + TLVs + EINVAL ADD|MOD invalid parameters passed in + EEXIST ADD entry already exists + ENOSPC ADD no space left in flow table + ENOENT MOD|DEL|GET_STATS group ID invalid + EBUSY DEL group reference count non-zero + ENODEV ADD next group ID doesn't exist
Same as above, please add decimal values instead of overloading errno.
Paolo
Re: [Qemu-devel] [PATCH v3 3/9] rocker: add register programming guide
Quoted 16 lines · Paolo Bonzini
Quoted 15 lines · On 11/01/2015 04:57, [email protected] wrote:
hw/net/rocker/reg_guide.txt new file +15
-0+PCI Configuration Space +----------------------- + +Each switch instance registers as a PCI device with PCI configuration space: + + offset width description value + --------------------------------------------- + 0x0 2 Vendor ID 0x1b36 + 0x2 2 Device ID 0x0006 + 0x4 4 Command/Status + 0x8 1 Revision ID 0x01 + 0x9 3 Class code 0x2800 + 0xC 1 Cache line size + 0xD 1 Latency timer + 0xE 1 Header type
Quoted 8 lines
hw/net/rocker/reg_guide.txt line 67
Quoted 6 lines
hw/net/rocker/reg_guide.txt new file +6
-0+ 0xF 1 Built-in self test + 0x10 4 Base address low + 0x14 4 Base address high + 0x18-28 Reserved + 0x2C 2 Subsystem vendor ID 0x0000 + 0x2E 2 Subsystem ID 0x0000This should not be guaranteed to 0, should it?
Your're right. Added a note that subsystem implementation will fill this in.
Quoted 13 lines
Quoted 13 lines
hw/net/rocker/reg_guide.txt new file +12
-0+ 0x30-38 Reserved + 0x3C 1 Interrupt line + 0x3D 1 Interrupt pin 0x00 + 0x3E 1 Min grant 0x00 + 0x3D 1 Max latency 0x00 + 0x40 1 TRDY timeout + 0x41 1 Retry count + 0x42 2 Reserved + + +SECTION 3: Memory-Mapped Register Space +=======================================
Quoted 8 lines
hw/net/rocker/reg_guide.txt line 85
Quoted 6 lines
hw/net/rocker/reg_guide.txt new file +6
-0+ +There are two memory-mapped BARs. BAR0 maps device register space and is +0x2000 in size. BAR1 maps MSI-X vector and PBA tables and is also 0x2000 in +size, allowing for 256 MSI-X vectors. The host BIOS will assign the base +address location. The host driver/OS will map the base address to host memory, +giving the driver mmio access to the device register space.No need for the bits after "The host BIOS..." since that's just normal PCI.
Gone.
Quoted 6 lines
hw/net/rocker/reg_guide.txt line 90
Quoted 4 lines
hw/net/rocker/reg_guide.txt new file +4
-0+All registers are 4 or 8 bytes long. It is assumed host software will access 4 +byte registers with one 4-byte access, and 8 byte registers with either two +4-byte accesses or a single 8-byte access. In the case of two 4-byte accesses, +access must be lower and then upper 4-bytes, in that order.Double 4-byte accesses are not implemented, are they?
They are now :) Tested on i386. I'll include changes with v4.
Quoted 14 lines
Quoted 14 lines
hw/net/rocker/reg_guide.txt new file +14
-0+Interrupt credits +^^^^^^^^^^^^^^^^^ + +MSI-X vectors used for descriptor ring completions use a credit mechanism for +efficient device, PCIe bus, OS and driver operations. Each descriptor ring has +a credit count which represent the number of outstanding descriptors to be +processed by the driver. As the device marks descriptors complete, the credit +count is incremented. As the driver processes those outstanding descriptors, +it returns credits back to the device. This way, the device knows the driver's +progress and can make decisions about when to fire the next interrupt or not. +When the credit count is zero, and the first descriptors are posted for the +driver, a single interrupt is fired. Once the interrupt is fired, the +interrupt is disabled (auto-masked). In response to the interrupt, the driver +will process descriptors and PIO write a returned credit value for that
Quoted 8 lines
hw/net/rocker/reg_guide.txt line 298
Quoted 5 lines
hw/net/rocker/reg_guide.txt new file +5
-0+descriptor ring. If the driver returns all credits (the driver caught up with +the device and there is no outstanding work), then the interrupt is unmasked, +but not fired. If only partial credits are returned, the interrupt remains +masked but the device generates an interrupt, signaling the driver that more +outstanding work is available.Perhaps mention that this masking is unrelated to the MSI-X interrupt mask register?
Done.
Quoted 6 lines
hw/net/rocker/reg_guide.txt line 320
Quoted 4 lines
hw/net/rocker/reg_guide.txt new file +4
-0+SECTION 5: Test Registers +========================= + +Rocker switch has several test registers to support troubleshooting registers/Rocker switch/Rocker/
Done.
Quoted 4 lines
Quoted 4 lines
hw/net/rocker/reg_guide.txt new file +4
-0+access, interrupt generation, and DMA operations: + + TEST_REG, offset 0x0010, 32-bit (R/W) + TEST_REG64, offset 0x0018, 64-bit (R/W)
Quoted 8 lines
hw/net/rocker/reg_guide.txt line 330
Quoted 6 lines
hw/net/rocker/reg_guide.txt new file +6
-0+ TEST_IRQ, offset 0x0020, 32-bit (R/W) + TEST_DMA_ADDR, offset 0x0028, 64-bit (R/W) + TEST_DMA_SIZE, offset 0x0030, 32-bit (R/W) + TEST_DMA_CTRL, offset 0x0034, 32-bit (R/W) + +Reads to TEST_REG and TEST_REG64 will read a value 2x the last value written tos/2x/equal to twice/
Done.
Quoted 5 lines
hw/net/rocker/reg_guide.txt line 332
Quoted 2 lines
hw/net/rocker/reg_guide.txt new file +2
-0+the register. The 32-bit and 64-bit versions are for testing 32-bit and 64-bit +host accesses.Right now, as mentioned above, 64-bit registers must be accessed with a single 32-bit host access.
Fixed in implementation.
Quoted 5 lines
In the case of 32-bit host accesses, should TEST_REG64's value be latched until the upper half is written? If so, please mention it and describe that this behavior is shared with the other 64-bit Rocker registers.
Quoted 7 lines
hw/net/rocker/reg_guide.txt line 336
Quoted 3 lines
hw/net/rocker/reg_guide.txt new file +3
-0+Bits written to TEST_IRQ will cause same (unmasked) bits to be written to +IRQ_STAT and an interrupt generated. Use IRQ_MASK to mask and unmask +particular bits.It looks like actually
TEST_IRQwill generate a single interrupt, not many of them. So writing 1 sets bits 1 in the PBA, not bit 0. Writing 3 sets bits 3, not bits 0 and 1.
Good catch...updated doc.
Quoted 13 lines
Please do not use "
IRQ_STAT", call it the PBA instead. Also remove the reference toIRQ_MASK, it's uninteresting.Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+SECTION 7: Switch Control +========================= + +This section covers switch-wide register settings. + +Control +------- + +This register is used for low level control of the switch. +
Quoted 8 lines
hw/net/rocker/reg_guide.txt line 459
Quoted 6 lines
hw/net/rocker/reg_guide.txt new file +6
-0+ CONTROL: offset 0x0300, 32-bit, (W) + + bit name description + ------------------------------------------------------------------------ + [0] CONTROL_RESET If set, device will perform reset (same + as pci reset)It's not the same as PCI reset, as it will not reset BARs for example.
Fixed.
Quoted 5 lines
Quoted 5 lines
hw/net/rocker/reg_guide.txt new file +5
-0+ +SECTION 8: CPU Packet Processing +================================ + +For packets ingressing on switch ports that are not forwarded by the switch but
Quoted 8 lines
hw/net/rocker/reg_guide.txt line 479
Quoted 3 lines
hw/net/rocker/reg_guide.txt new file +3
-0+rather directed to the host CPU for further processing are delivered in the +DMA RX ring. Likewise, for host CPU originating packets destined to egress on +switch ports onto the network are scheduled by software using the DMA TX ring.Ingress packets for ports that are not forwarded by the switch are directed to the host CPU for further processing, and delivered in the DMA RX ring. Likewise, the host CPU can use the DMA TX ring to schedule packets that will egress onto the network.
Fixed by simplifying.
Quoted 86 lines
Quoted 73 lines
hw/net/rocker/reg_guide.txt new file +73
-0+ +Tx Packet Processing +-------------------- + +Software schedules packets for egress on switch ports using the DMA TX ring. A +TX descriptor buffer describes the packet location and size in host DMA-able +memory, the destination port, and any hardware-offload functions (such as L3 +payload checksum offload). Software then bumps the descriptor head to signal +hardware of new Tx work. In response, hardware will DMA read Tx descriptors up +to head, DMA read descriptor buffer and packet data, perform offloading +functions, and finally frame packet on wire (network). Once packet processing +is complete, hardware will writeback status to descriptor(s) to signal to +software that Tx is complete and software resources (e.g. skb) backing packet +can be released. + +Figure 2 shows an example 3-fragment packet queued with one Tx descriptor. A +TLV is used for each packet fragment. + + pkt frag 1 + +–––––––+ +–+ + +–––+ | | + desc buf | | | | + +––––––––+ | | | | + Tx ring +–––+ +–––––+ | | | + +–––––––––+ | | TLVs | +–––––––+ | + | +–––+ +––––––––+ pkt frag 2 | + | desc 0 | | +–––––+ +–––––––+ | + +–––––––––+ | TLVs | +–––+ | | + head+–+ | +––––––––+ | | | + | desc 1 | | +–––––+ +–––––––+ |pkt + +–––––––––+ | TLVs | | | + | | +––––––––+ | pkt frag 3 | + | | | +–––––––+ | + +–––––––––+ +–––+ | | + | | | | | + | | | | | + +–––––––––+ | | | + | | | | | + | | | | | + +–––––––––+ | | | + | | +–––––––+ +–+ + | | + +–––––––––+ + + fig 2. + +The TLVs for Tx descriptor buffer are: + + field width description + --------------------------------------------------------------------- + PPORT 4 Destination physical port # + TX_OFFLOAD 1 Hardware offload modes: + 0: no offload + 1: insert IP csum (ipv4 only) + 2: insert TCP/UDP csum + 3: L3 csum calc and insert + into csum offset (TX_L3_CSUM_OFF) + 16-bit 1's complement csum value. + IPv4 pseudo-header and IP + already calculated by OS + and inserted. + 4: TSO (TCP Segmentation Offload) + TX_L3_CSUM_OFF 2 For L3 csum offload mode, the offset, + from the beginning of the packet, + of the csum field in the L3 header + TX_TSO_MSS 2 For TSO offload mode, the + Maximum Segment Size in bytes + TX_TSO_HDR_LEN 2 For TSO offload mode, the + length of ethernet, IP, and + TCP/UDP headers, including IP + and TCP options. + TX_FRAGS <array> Packet fragments + TX_FRAG <nest> Packet fragmenthw/net/rocker/reg_guide.txt line 562
Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+ TX_FRAG_ADDR 8 DMA address of packet fragment + TX_FRAG_LEN 2 Packet fragment length + +Possible status return codes in descriptor on completion are: + + DESC_COMP_ERR reason + -------------------------------------------------------------------- + 0 OK + ENXIO address or data read err on desc buf or packet + fragmentThis is more like EFAULT actually.
Quoted 8 lines
hw/net/rocker/reg_guide.txt line 564
Quoted 2 lines
hw/net/rocker/reg_guide.txt new file +2
-0+ EINVAL bad pport or TSO or csum offloading error + ENOMEM no memory for internal staging tx fragmentQEMU is portable and these values are not, unfortunately. So please hardcode them to be 6/22/12 respectively.
Or even better, to avoid the temptation, make them 1/2/3 and create new constants
ROCKER_OK,ROCKER_ERR_FAULT,ROCKER_ERR_INVAL,ROCKER_ERR_NOMEM.
Since Linux driver is already out there in 3.18, we're stuck with the values defined in errno.h for x86_64. But, no problem, I've hard-coded those values for ROCKER_EINVAL, ROCKER_ENOMEM, etc. I'll switch the Linux driver over to these constants when it's touched again.
Quoted 76 lines
In any case, since you are at it, sort them in either numeric order or alphabetic order (apart from OK which can remain first).
Quoted 32 lines
hw/net/rocker/reg_guide.txt new file +32
-0+Rx Packet Processing +-------------------- + +For packets ingressing on switch ports that are not forwarded by the switch but +rather directed to the host CPU for further processing are delivered in the +DMA RX ring. Rx descriptor buffers are allocated by software and placed on the +ring. Hardware will fill Rx descriptor buffers with packet data, write the +completion, and signal to software that a new packet is ready. Since Rx packet +size is not known a-priori, the Rx descriptor buffer must be allocated for +worst-case packet size. A single Rx descriptor will contain the entire Rx +packet data in one RX_PACKET TLV. Other Rx TLVs describe and hardware offloads +performed on the packet, such as checksum validation. + +The TLVs for Rx descriptor buffer are: + + field width description + --------------------------------------------------- + PPORT 4 Source physical port # + RX_FLAGS 2 Packet parsing flags: + (1 << 0): IPv4 packet + (1 << 1): IPv6 packet + (1 << 2): csum calculated + (1 << 3): IPv4 csum good + (1 << 4): IP fragment + (1 << 5): TCP packet + (1 << 6): UDP packet + (1 << 7): TCP/UDP csum good + RX_CSUM 2 IP calculated checksum: + IPv4: IP payload csum + IPv6: header and payload csum + (Only valid is RX_FLAGS:csum calc is set) + RX_PACKET (N) <var> Packet datahw/net/rocker/reg_guide.txt line 607
Quoted 10 lines
hw/net/rocker/reg_guide.txt new file +10
-0+ +Possible status return codes in descriptor on completion are: + + DESC_COMP_ERR reason + -------------------------------------------------------------------- + 0 OK + ENXIO address or data read err on desc buf + ENOMEM no memory for internal staging desc buf + EMSGSIZE Rx descriptor buffer wasn't big enough to contain + pactet data TLV and other TLVs.EMSGSIZE in fact doesn't exist on Windows even. So make this ROCKER_ERR_MSGSIZE==4.
hw/net/rocker/reg_guide.txt line 665
Quoted 11 lines
hw/net/rocker/reg_guide.txt new file +11
-0+ field width description + ---------------------------------------------------- + OF_DPA_CMD 2 CMD_[ADD|MOD] + OF_DPA_TBL 2 Flow table ID + 0: ingress port + 10: vlan + 20: termination mac + 30: unicast routing + 40: multicast routing + 50: bridging + 60: ACL policyDecimal, I guess. Better mention it, if only for completeness.
Quoted 12 lines
hw/net/rocker/reg_guide.txt new file +12
-0+Possible status return codes in descriptor on completion are: + + DESC_COMP_ERR command reason + -------------------------------------------------------------------- + 0 all OK + EFAULT all head or tail index outside + of ring + ENXIO all address or data read err on + desc buf + ENOSPC GET_STATS cmd descriptor buffer wasn't + big enough to contain write-back + TLVs
Quoted 8 lines
hw/net/rocker/reg_guide.txt line 953
Quoted 6 lines
hw/net/rocker/reg_guide.txt new file +6
-0+ EINVAL ADD|MOD invalid parameters passed in + EEXIST ADD entry already exists + ENOSPC ADD no space left in flow table + ENOENT MOD|DEL|GET_STATS group ID invalid + EBUSY DEL group reference count non-zero + ENODEV ADD next group ID doesn't existSame as above, please add decimal values instead of overloading errno.
Updated doc with new ROCKER_Exxx return codes.
Quoted 2 lines
Paolo
PATCH v3 4/9 pci: add rocker device ID
In reply to [email protected]From: Scott Feldman <[email protected]>
--- docs/specs/pci-ids.txt | 1 + include/hw/pci/pci.h | 1 + 2 files changed, 2 insertions(+)
docs/specs/pci-ids.txt +1 -0
@@ -45,6 +45,7 @@ PCI devices (other than virtio): 1b36:0003 PCI Dual-port 16550A adapter (docs/specs/pci-serial.txt) 1b36:0004 PCI Quad-port 16550A adapter (docs/specs/pci-serial.txt) 1b36:0005 PCI test device (docs/specs/pci-testdev.txt) +1b36:0006 PCI Rocker Ethernet switch device 1b36:0007 PCI SD Card Host Controller Interface (SDHCI) All these devices are documented in docs/specs.
include/hw/pci/pci.h +1 -0
@@ -88,6 +88,7 @@#define PCI_DEVICE_ID_REDHAT_SERIAL2 0x0003#define PCI_DEVICE_ID_REDHAT_SERIAL4 0x0004#define PCI_DEVICE_ID_REDHAT_TEST 0x0005 +#define PCI_DEVICE_ID_REDHAT_ROCKER 0x0006#define PCI_DEVICE_ID_REDHAT_SDHCI 0x0007#define PCI_DEVICE_ID_REDHAT_QXL 0x0100
Signature · 1 line
1.7.10.4
PATCH v3 5/9 pci: add network device class 'other' for network switches
In reply to [email protected]From: Scott Feldman <[email protected]>
Rocker is an ethernet switch device, so add 'other' network device class as defined by PCI to cover these types of devices.
--- include/hw/pci/pci_ids.h | 1 + 1 file changed, 1 insertion(+)
include/hw/pci/pci_ids.h +1 -0
@@ -23,6 +23,7 @@#define PCI_CLASS_STORAGE_OTHER 0x0180#define PCI_CLASS_NETWORK_ETHERNET 0x0200 +#define PCI_CLASS_NETWORK_OTHER 0x0280#define PCI_CLASS_DISPLAY_VGA 0x0300#define PCI_CLASS_DISPLAY_OTHER 0x0380
Signature · 1 line
1.7.10.4
PATCH v3 6/9 rocker: add new rocker switch device
In reply to [email protected]From: Scott Feldman <[email protected]>
Rocker is a simulated ethernet switch device. The device supports up to 62 front-panel ports and supports L2 switching and L3 routing functions, as well as L2/L3/L4 ACLs. The device presents a single PCI device for each switch, with a memory-mapped register space for device driver access.
Rocker device is invoked with -device, for example a 4-port switch:
-device rocker,name=sw1,len-ports=4,ports[0]=dev0,ports[1]=dev1, \
ports[2]=dev2,ports[3]=dev3Each port is a netdev and can be paired with using -netdev id=<port name>.
--- default-configs/pci.mak | 1 + hw/net/Makefile.objs | 3 + hw/net/rocker/rocker.c | 1395 +++++++++++++++++++++++++ hw/net/rocker/rocker.h | 76 ++ hw/net/rocker/rocker_desc.c | 379 +++++++ hw/net/rocker/rocker_desc.h | 57 + hw/net/rocker/rocker_fp.c | 232 +++++ hw/net/rocker/rocker_fp.h | 53 + hw/net/rocker/rocker_hw.h | 475 +++++++++ hw/net/rocker/rocker_of_dpa.c | 2314 +++++++++++++++++++++++++++++++++++++++++ hw/net/rocker/rocker_of_dpa.h | 25 + hw/net/rocker/rocker_tlv.h | 244 +++++ hw/net/rocker/rocker_world.c | 108 ++ hw/net/rocker/rocker_world.h | 63 ++ 14 files changed, 5425 insertions(+) create mode 100644 hw/net/rocker/rocker.c create mode 100644 hw/net/rocker/rocker.h create mode 100644 hw/net/rocker/rocker_desc.c create mode 100644 hw/net/rocker/rocker_desc.h create mode 100644 hw/net/rocker/rocker_fp.c create mode 100644 hw/net/rocker/rocker_fp.h create mode 100644 hw/net/rocker/rocker_hw.h create mode 100644 hw/net/rocker/rocker_of_dpa.c create mode 100644 hw/net/rocker/rocker_of_dpa.h create mode 100644 hw/net/rocker/rocker_tlv.h create mode 100644 hw/net/rocker/rocker_world.c create mode 100644 hw/net/rocker/rocker_world.h
default-configs/pci.mak +1 -0
@@ -32,3 +32,4 @@ CONFIG_PCI_TESTDEV=y CONFIG_NVME_PCI=y CONFIG_SD=y CONFIG_SDHCI=y +CONFIG_ROCKER=y
hw/net/Makefile.objs +3 -0
@@ -35,3 +35,6 @@ obj-y += vhost_net.o obj-$(CONFIG_ETSEC) += fsl_etsec/etsec.o fsl_etsec/registers.o \ fsl_etsec/rings.o fsl_etsec/miim.o + +common-obj-y += rocker/rocker.o rocker/rocker_fp.o rocker/rocker_desc.o \ + rocker/rocker_world.o rocker/rocker_of_dpa.o
hw/net/rocker/rocker.c new file +1395 -0
1,395 lines not on this page · raw message
hw/net/rocker/rocker.h new file +76 -0
76 lines not on this page · raw message
hw/net/rocker/rocker_desc.c new file +379 -0
379 lines not on this page · raw message
hw/net/rocker/rocker_desc.h new file +57 -0
57 lines not on this page · raw message
hw/net/rocker/rocker_fp.c new file +232 -0
232 lines not on this page · raw message
hw/net/rocker/rocker_fp.h new file +53 -0
53 lines not on this page · raw message
hw/net/rocker/rocker_hw.h new file +475 -0
475 lines not on this page · raw message
hw/net/rocker/rocker_of_dpa.c new file +2314 -0
323 lines not on this page · raw message
hw/net/rocker/rocker_of_dpa.h new file +25 -0
Lines of this file are not shown. View the raw message.
hw/net/rocker/rocker_tlv.h new file +244 -0
244 lines not on this page · raw message
hw/net/rocker/rocker_world.c new file +108 -0
108 lines not on this page · raw message
hw/net/rocker/rocker_world.h new file +63 -0
63 lines not on this page · raw message
The rest of this diff is not shown. View the raw message.
Signature · 1 line
1.7.10.4
Part of the diff is not shown here. View the raw message.
Re: [Qemu-devel] [PATCH v3 6/9] rocker: add new rocker switch device
hw/net/rocker/rocker.c line 1083
Quoted 13 lines · On 11/01/2015 04:57, [email protected] wrote:
hw/net/rocker/rocker.c new file +13
-0+static const MemoryRegionOps rocker_mmio_ops = { + .read = rocker_mmio_read, + .write = rocker_mmio_write, + .endianness =DEVICE_LITTLE_ENDIAN , + .valid = { + .min_access_size =4 , + .max_access_size =8 , + }, + .impl = { + .min_access_size =4 , + .max_access_size =8 , + }, +};
I suggest that you only use 32-bit registers in the internal implementation, where writing to the low part of a 64-bit register only writes to a latch. You can then use .impl.max_access_size == 4 but keep .valid.max_access_size == 8.
QEMU will then take care of passing 64-bit writes down as two 32-bit writes, in increasing address.
Paolo
Re: [Qemu-devel] [PATCH v3 6/9] rocker: add new rocker switch device
Quoted 22 lines · Paolo Bonzini
hw/net/rocker/rocker.c line 1083
Quoted 13 lines · On 11/01/2015 04:57, [email protected] wrote:
hw/net/rocker/rocker.c new file +13
-0+static const MemoryRegionOps rocker_mmio_ops = { + .read = rocker_mmio_read, + .write = rocker_mmio_write, + .endianness =DEVICE_LITTLE_ENDIAN , + .valid = { + .min_access_size =4 , + .max_access_size =8 , + }, + .impl = { + .min_access_size =4 , + .max_access_size =8 , + }, +};I suggest that you only use 32-bit registers in the internal implementation, where writing to the low part of a 64-bit register only writes to a latch. You can then use .impl.max_access_size == 4 but keep .valid.max_access_size == 8.
Quoted 2 lines
QEMU will then take care of passing 64-bit writes down as two 32-bit writes, in increasing address.
I tried setting .impl.max_access_size=4 and the Linux driver self-test fails on 64-bit reg write/read. 32-bit regs writes/reads are OK. On the 64-bit write/read, the self test writes a value and expects to read back 2x the value written. After making the change .impl.max_access_size=4, the reg reads back as 0, regardless of what was written.
The driver uses writeq/readq for 64-bit writes/reads.
I'm inclined to not change the device and leave .impl.max_access_size=8.
-scott
Re: [Qemu-devel] [PATCH v3 6/9] rocker: add new rocker switch device
Quoted 6 lines · Scott Feldman
I tried setting .impl.max_access_size=4 and the Linux driver self-test fails on 64-bit reg write/read. 32-bit regs writes/reads are OK. On the 64-bit write/read, the self test writes a value and expects to read back 2x the value written. After making the change .impl.max_access_size=4, the reg reads back as 0, regardless of what was written.
It would be a bug. I can try to look at it later.
Paolo
Quoted 3 lines
The driver uses writeq/readq for 64-bit writes/reads.
I'm inclined to not change the device and leave .impl.max_access_size=8.
Re: [Qemu-devel] [PATCH v3 6/9] rocker: add new rocker switch device
In reply to [email protected]Quoted 9 lines · On 01/11/2015 11:57 AM, [email protected] wrote:
From: Scott Feldman <[email protected]>
Rocker is a simulated ethernet switch device. The device supports up to 62 front-panel ports and supports L2 switching and L3 routing functions, as well as L2/L3/L4 ACLs. The device presents a single PCI device for each switch, with a memory-mapped register space for device driver access.
Rocker device is invoked with -device, for example a 4-port switch:
Quoted 8 lines
-device rocker,name=sw1,len-ports=4,ports[0]=dev0,ports[1]=dev1, \ ports[2]=dev2,ports[3]=dev3Each port is a netdev and can be paired with using -netdev id=<port name>.
Signed-off-by Scott Feldman <[email protected]>Signed-off-by Jiri Pirko <[email protected]>---
Looks like the devices does not support state saving. How about tagging it with unmigratable first?
Quoted 27 lines
default-configs/pci.mak | 1 + hw/net/Makefile.objs | 3 + hw/net/rocker/rocker.c | 1395 +++++++++++++++++++++++++ hw/net/rocker/rocker.h | 76 ++ hw/net/rocker/rocker_desc.c | 379 +++++++ hw/net/rocker/rocker_desc.h | 57 + hw/net/rocker/rocker_fp.c | 232 +++++ hw/net/rocker/rocker_fp.h | 53 + hw/net/rocker/rocker_hw.h | 475 +++++++++ hw/net/rocker/rocker_of_dpa.c | 2314 +++++++++++++++++++++++++++++++++++++++++ hw/net/rocker/rocker_of_dpa.h | 25 + hw/net/rocker/rocker_tlv.h | 244 +++++ hw/net/rocker/rocker_world.c | 108 ++ hw/net/rocker/rocker_world.h | 63 ++ 14 files changed, 5425 insertions(+) create mode 100644 hw/net/rocker/rocker.c create mode 100644 hw/net/rocker/rocker.h create mode 100644 hw/net/rocker/rocker_desc.c create mode 100644 hw/net/rocker/rocker_desc.h create mode 100644 hw/net/rocker/rocker_fp.c create mode 100644 hw/net/rocker/rocker_fp.h create mode 100644 hw/net/rocker/rocker_hw.h create mode 100644 hw/net/rocker/rocker_of_dpa.c create mode 100644 hw/net/rocker/rocker_of_dpa.h create mode 100644 hw/net/rocker/rocker_tlv.h create mode 100644 hw/net/rocker/rocker_world.c create mode 100644 hw/net/rocker/rocker_world.h
[...]
Quoted 5 lines
hw/net/rocker/rocker.c new file +5
-0+ +typedef struct rocker { + /* private */ + PCIDevice parent_obj; + /* public */
hw/net/rocker/rocker.c line 48
Quoted 10 lines
hw/net/rocker/rocker.c new file +10
-0+ +MemoryRegion mmio; +MemoryRegion msix_bar; + +/* switch configuration */ +char *name;/* switch name */ +uint32_t fp_ports;/* front-panel port count */ +NICPeers *fp_ports_peers; +MACAddr fp_start_macaddr;/* front-panel port 0 mac addr */ +uint64_t switch_id;/* switch id */
Looks like the function of name ad switch_id are duplicated?
Quoted 20 lines
hw/net/rocker/rocker.c new file +20
-0+ +/* front-panel ports */ +FpPort *fp_port[ROCKER_FP_PORTS_MAX ]; + +/* register backings */ +uint32_t test_reg; +uint64_t test_reg64; +dma_addr_t test_dma_addr; +uint32_t test_dma_size; + +/* desc rings */ +DescRing **rings; + +/* switch worlds */ +World *worlds[ROCKER_WORLD_TYPE_MAX ]; +World *world_dflt; + +QLIST_ENTRY (rocker) next; +} Rocker; +
[...]
Quoted 91 lines
hw/net/rocker/rocker.c new file +91
-0+ +static int tx_consume (Rocker *r,DescInfo *info) +{ +PCIDevice *dev =PCI_DEVICE (r); +char *buf =desc_get_buf (info, true); +RockerTlv *tlv_frag; +RockerTlv *tlvs[ROCKER_TLV_TX_MAX +1 ]; +struct iovec iov[ROCKER_TX_FRAGS_MAX ] = { {0 , }, }; +uint32_t pport; +uint32_t port; +uint16_t tx_offload =ROCKER_TX_OFFLOAD_NONE ; +uint16_t tx_l3_csum_off =0 ; +uint16_t tx_tso_mss =0 ; +uint16_t tx_tso_hdr_len =0 ; +int iovcnt =0 ; +int err =0 ; +int rem; +int i; + +if (!buf) { +return -ENXIO ; + } + +rocker_tlv_parse (tlvs,ROCKER_TLV_TX_MAX , buf,desc_tlv_size (info)); + +if (!tlvs[ROCKER_TLV_TX_FRAGS ]) { +return -EINVAL ; + } + + pport =rocker_get_pport_by_tx_ring (r,desc_get_ring (info)); +if (!fp_port_from_pport (pport, &port)) { +return -EINVAL ; + } + +if (tlvs[ROCKER_TLV_TX_OFFLOAD ]) { + tx_offload =rocker_tlv_get_u8 (tlvs[ROCKER_TLV_TX_OFFLOAD ]); + } + +switch (tx_offload) { +case ROCKER_TX_OFFLOAD_L3_CSUM : +if (!tlvs[ROCKER_TLV_TX_L3_CSUM_OFF ]) { +return -EINVAL ; + } +case ROCKER_TX_OFFLOAD_TSO : +if (!tlvs[ROCKER_TLV_TX_TSO_MSS ] || + !tlvs[ROCKER_TLV_TX_TSO_HDR_LEN ]) { +return -EINVAL ; + } + } + +if (tlvs[ROCKER_TLV_TX_L3_CSUM_OFF ]) { + tx_l3_csum_off =rocker_tlv_get_le16 (tlvs[ROCKER_TLV_TX_L3_CSUM_OFF ]); + } + +if (tlvs[ROCKER_TLV_TX_TSO_MSS ]) { + tx_tso_mss =rocker_tlv_get_le16 (tlvs[ROCKER_TLV_TX_TSO_MSS ]); + } + +if (tlvs[ROCKER_TLV_TX_TSO_HDR_LEN ]) { + tx_tso_hdr_len =rocker_tlv_get_le16 (tlvs[ROCKER_TLV_TX_TSO_HDR_LEN ]); + } + +rocker_tlv_for_each_nested (tlv_frag, tlvs[ROCKER_TLV_TX_FRAGS ], rem) { +hwaddr frag_addr; +uint16_t frag_len; + +if (rocker_tlv_type (tlv_frag) !=ROCKER_TLV_TX_FRAG ) { +return -EINVAL ; + } + +rocker_tlv_parse_nested (tlvs,ROCKER_TLV_TX_FRAG_ATTR_MAX , tlv_frag); + +if (!tlvs[ROCKER_TLV_TX_FRAG_ATTR_ADDR ] || + !tlvs[ROCKER_TLV_TX_FRAG_ATTR_LEN ]) { +return -EINVAL ; + } + + frag_addr =rocker_tlv_get_le64 (tlvs[ROCKER_TLV_TX_FRAG_ATTR_ADDR ]); + frag_len =rocker_tlv_get_le16 (tlvs[ROCKER_TLV_TX_FRAG_ATTR_LEN ]); + + iov[iovcnt].iov_len = frag_len; + iov[iovcnt].iov_base =g_malloc (frag_len); +if (!iov[iovcnt].iov_base) { + err = -ENOMEM ; + goto err_no_mem; + } + +if (pci_dma_read (dev, frag_addr, iov[iovcnt].iov_base, + iov[iovcnt].iov_len)) { + err = -ENXIO ; + goto err_bad_io;
hw/net/rocker/rocker.c line 206
Quoted 10 lines
hw/net/rocker/rocker.c new file +10
-0+ } + +if (++iovcnt >ROCKER_TX_FRAGS_MAX ) { + goto err_too_many_frags; + } + } + +if (iovcnt) { +/* XXX perform Tx offloads */ +/* XXX silence compiler for now */
Need add TSO here (e1000 is a good reference) or disable TSO in driver.
Quoted 17 lines
hw/net/rocker/rocker.c new file +17
-0+ tx_l3_csum_off += tx_tso_mss = tx_tso_hdr_len =0 ; + } + + err =fp_port_eg (r->fp_port[port], iov, iovcnt); + +err_no_mem: +err_bad_io: +err_too_many_frags: +for (i =0 ; i < iovcnt; i++) { +if (iov[i].iov_base) { +g_free (iov[i].iov_base); + } + } + +return err; +} +
[...]
Quoted 28 lines
hw/net/rocker/rocker.c new file +28
-0+ +int rocker_event_link_changed (Rocker *r,uint32_t pport,bool link_up) +{ +DescRing *ring = r->rings[ROCKER_RING_EVENT ]; +DescInfo *info =desc_ring_fetch_desc (ring); +RockerTlv *nest; +char *buf; +size_t tlv_size; +int pos; +int err; + +if (!info) { +return -ENOBUFS ; + } + + tlv_size =rocker_tlv_total_size (sizeof (uint16_t )) +/* event type */ +rocker_tlv_total_size (0 ) +/* nest */ +rocker_tlv_total_size (sizeof (uint32_t )) +/* pport */ +rocker_tlv_total_size (sizeof (uint8_t ));/* link up */ + +if (tlv_size >desc_buf_size (info)) { + err = -EMSGSIZE ; + goto err_too_big; + } + + buf =desc_get_buf (info, false); +if (!buf) { + err = -ENOMEM ;
hw/net/rocker/rocker.c line 465
Quoted 10 lines
hw/net/rocker/rocker.c new file +10
-0+ goto err_no_mem; + } + + pos =0 ; +rocker_tlv_put_le32 (buf, &pos,ROCKER_TLV_EVENT_TYPE , +ROCKER_TLV_EVENT_TYPE_LINK_CHANGED ); + nest =rocker_tlv_nest_start (buf, &pos,ROCKER_TLV_EVENT_INFO ); +rocker_tlv_put_le32 (buf, &pos,ROCKER_TLV_EVENT_LINK_CHANGED_PPORT , pport); +rocker_tlv_put_u8 (buf, &pos,ROCKER_TLV_EVENT_LINK_CHANGED_LINKUP , + link_up ?1 :0 );
Looks like those types are not documented.
Quoted 53 lines
hw/net/rocker/rocker.c new file +53
-0+rocker_tlv_nest_end (buf, &pos, nest); + + err =desc_set_buf (info, tlv_size); + +err_too_big: +err_no_mem: +if (desc_ring_post_desc (ring, err)) { +rocker_msix_irq (r,ROCKER_MSIX_VEC_EVENT ); + } + +return err; +} + +int rocker_event_mac_vlan_seen (Rocker *r,uint32_t pport,uint8_t *addr, +uint16_t vlan_id) +{ +DescRing *ring = r->rings[ROCKER_RING_EVENT ]; +DescInfo *info; +FpPort *fp_port; +uint32_t port; +RockerTlv *nest; +char *buf; +size_t tlv_size; +int pos; +int err; + +if (!fp_port_from_pport (pport, &port)) { +return -EINVAL ; + } + fp_port = r->fp_port[port]; +if (!fp_port_get_learning (fp_port)) { +return 0 ; + } + + info =desc_ring_fetch_desc (ring); +if (!info) { +return -ENOBUFS ; + } + + tlv_size =rocker_tlv_total_size (sizeof (uint16_t )) +/* event type */ +rocker_tlv_total_size (0 ) +/* nest */ +rocker_tlv_total_size (sizeof (uint32_t )) +/* pport */ +rocker_tlv_total_size (ETH_ALEN ) +/* mac addr */ +rocker_tlv_total_size (sizeof (uint16_t ));/* vlan_id */ + +if (tlv_size >desc_buf_size (info)) { + err = -EMSGSIZE ; + goto err_too_big; + } + + buf =desc_get_buf (info, false); +if (!buf) { + err = -ENOMEM ;
hw/net/rocker/rocker.c line 528
Quoted 10 lines
hw/net/rocker/rocker.c new file +10
-0+ goto err_no_mem; + } + + pos =0 ; +rocker_tlv_put_le32 (buf, &pos,ROCKER_TLV_EVENT_TYPE , +ROCKER_TLV_EVENT_TYPE_MAC_VLAN_SEEN ); + nest =rocker_tlv_nest_start (buf, &pos,ROCKER_TLV_EVENT_INFO ); +rocker_tlv_put_le32 (buf, &pos,ROCKER_TLV_EVENT_MAC_VLAN_PPORT , pport); +rocker_tlv_put (buf, &pos,ROCKER_TLV_EVENT_MAC_VLAN_MAC ,ETH_ALEN , addr); +rocker_tlv_put_u16 (buf, &pos,ROCKER_TLV_EVENT_MAC_VLAN_VLAN_ID , vlan_id);
Undocumented types.
Quoted 41 lines
hw/net/rocker/rocker.c new file +41
-0+rocker_tlv_nest_end (buf, &pos, nest); + + err =desc_set_buf (info, tlv_size); + +err_too_big: +err_no_mem: +if (desc_ring_post_desc (ring, err)) { +rocker_msix_irq (r,ROCKER_MSIX_VEC_EVENT ); + } + +return err; +} + +static DescRing *rocker_get_rx_ring_by_pport (Rocker *r, +uint32_t pport) +{ +return r->rings[(pport -1 ) *2 +3 ]; +} + +int rx_produce (World *world,uint32_t pport, +const struct iovec *iov,int iovcnt) +{ +Rocker *r =world_rocker (world); +PCIDevice *dev = (PCIDevice *)r; +DescRing *ring =rocker_get_rx_ring_by_pport (r, pport); +DescInfo *info =desc_ring_fetch_desc (ring); +char *data; +size_t data_size =iov_size (iov, iovcnt); +char *buf; +uint16_t rx_flags =0 ; +uint16_t rx_csum =0 ; +size_t tlv_size; +RockerTlv *tlvs[ROCKER_TLV_RX_MAX +1 ]; +hwaddr frag_addr; +uint16_t frag_max_len; +int pos; +int err; + +if (!info) { +return -ENOBUFS ; + }
hw/net/rocker/rocker.c line 579
Quoted 10 lines
hw/net/rocker/rocker.c new file +10
-0+ + buf =desc_get_buf (info, false); +if (!buf) { + err = -ENXIO ; + goto out; + } +rocker_tlv_parse (tlvs,ROCKER_TLV_RX_MAX , buf,desc_tlv_size (info)); + +if (!tlvs[ROCKER_TLV_RX_FRAG_ADDR ] || + !tlvs[ROCKER_TLV_RX_FRAG_MAX_LEN ]) {
This conflicts with the spec which only describes RX_PACKET.
Quoted 33 lines
hw/net/rocker/rocker.c new file +33
-0+ err = -EINVAL ; + goto out; + } + + frag_addr =rocker_tlv_get_le64 (tlvs[ROCKER_TLV_RX_FRAG_ADDR ]); + frag_max_len =rocker_tlv_get_le16 (tlvs[ROCKER_TLV_RX_FRAG_MAX_LEN ]); + +if (data_size > frag_max_len) { + err = -EMSGSIZE ; + goto out; + } + +/* XXX calc rx flags/csum */ + + tlv_size =rocker_tlv_total_size (sizeof (uint16_t )) +/* flags */ +rocker_tlv_total_size (sizeof (uint16_t )) +/* scum */ +rocker_tlv_total_size (sizeof (uint64_t )) +/* frag addr */ +rocker_tlv_total_size (sizeof (uint16_t )) +/* frag max len */ +rocker_tlv_total_size (sizeof (uint16_t ));/* frag len */ + +if (tlv_size >desc_buf_size (info)) { + err = -EMSGSIZE ; + goto out; + } + +/* TODO: +* iov dma write can be optimized in similar way e1000 does it in +* e1000_receive_iov. But maybe if would make sense to introduce +* generic helper iov_dma_write. +*/ + + data =g_malloc (data_size); +if (!data) {
hw/net/rocker/rocker.c line 622
Quoted 10 lines
hw/net/rocker/rocker.c new file +10
-0+ err = -ENOMEM ; + goto out; + } +iov_to_buf (iov, iovcnt,0 , data, data_size); +pci_dma_write (dev, frag_addr, data, data_size); +g_free (data); + + pos =0 ; +rocker_tlv_put_le16 (buf, &pos,ROCKER_TLV_RX_FLAGS , rx_flags); +rocker_tlv_put_le16 (buf, &pos,ROCKER_TLV_RX_CSUM , rx_csum);
Note: Some backend (e.g tap) can do offloading, may consider to add the support in the future.
hw/net/rocker/rocker.c line 624
Quoted 2 lines
hw/net/rocker/rocker.c new file +2
-0+rocker_tlv_put_le64 (buf, &pos,ROCKER_TLV_RX_FRAG_ADDR , frag_addr); +rocker_tlv_put_le16 (buf, &pos,ROCKER_TLV_RX_FRAG_MAX_LEN , frag_max_len);
The above 2 types were not documented. Please make sure all types were documented.
Quoted 12 lines
hw/net/rocker/rocker.c new file +12
-0+rocker_tlv_put_le16 (buf, &pos,ROCKER_TLV_RX_FRAG_LEN , data_size); + + err =desc_set_buf (info, tlv_size); + +out: +if (desc_ring_post_desc (ring, err)) { +rocker_msix_irq (r,ROCKER_MSIX_VEC_RX (pport -1 )); + } + +return err; +} +
[...]
hw/net/rocker/rocker_fp.c line 102
Quoted 13 lines
hw/net/rocker/rocker_fp.c new file +13
-0+ +bool fp_port_from_pport (uint32_t pport,uint32_t *port) +{ +if (pport <1 || pport >ROCKER_FP_PORTS_MAX ) { +return false; + } + *port = pport -1 ; +return true; +} + +int fp_port_eg (FpPort *port,const struct iovec *iov,int iovcnt) +{ +NetClientState *nc =qemu_get_queue (port->nic);
Using only 1 queues is ok for multiqueue backend. In the future may consider to use all.
hw/net/rocker/rocker_fp.c line 110
Quoted 8 lines
hw/net/rocker/rocker_fp.c new file +8
-0+ +if (port->enabled) { +qemu_sendv_packet (nc, iov, iovcnt); + } + +return 0 ; +} +
[...]
Thanks
Re: [Qemu-devel] [PATCH v3 6/9] rocker: add new rocker switch device
Quoted 10 lines · Jason Wang
Quoted 5 lines · On 01/11/2015 11:57 AM, [email protected] wrote:
Each port is a netdev and can be paired with using -netdev id=<port name>.
Signed-off-by Scott Feldman <[email protected]>Signed-off-by Jiri Pirko <[email protected]>---
Looks like the devices does not support state saving. How about tagging it with unmigratable first?
State saving would be nice to add in the future. How do we tag is unmigratable for now?
Quoted 3 lines
Quoted 1 line
+
uint64_tswitch_id; /* switch id */Looks like the function of name ad
switch_idare duplicated?
Don't follow...
Quoted 5 lines
hw/net/rocker/rocker.c line 206
Quoted 3 lines
hw/net/rocker/rocker.c new file +3
-0+if (iovcnt) { +/* XXX perform Tx offloads */ +/* XXX silence compiler for now */ Need add TSO here (e1000 is a good reference) or disable TSO in driver.
TSO is not enabled in driver, currently. This is lower priority now since the I/O path for traffic to/from the guest CPU is not performance critical. The forwarding path offloaded by the device is the hot path, but that doesn't involve I/O to guest CPU, so Tx/Rx offloads aren't in play.
But, someday, it would be nice to enable Rx/Tx offloads.
Quoted 8 lines
hw/net/rocker/rocker.c line 465
Quoted 6 lines
hw/net/rocker/rocker.c new file +6
-0+rocker_tlv_put_le32 (buf, &pos,ROCKER_TLV_EVENT_TYPE , +ROCKER_TLV_EVENT_TYPE_LINK_CHANGED ); + nest =rocker_tlv_nest_start (buf, &pos,ROCKER_TLV_EVENT_INFO ); +rocker_tlv_put_le32 (buf, &pos,ROCKER_TLV_EVENT_LINK_CHANGED_PPORT , pport); +rocker_tlv_put_u8 (buf, &pos,ROCKER_TLV_EVENT_LINK_CHANGED_LINKUP , + link_up ?1 :0 );Looks like those types are not documented.
Ok, I'll double check spec to make sure we're covered, for the items you found.
Quoted 5 lines
hw/net/rocker/rocker.c line 622
Quoted 2 lines
hw/net/rocker/rocker.c new file +2
-0+rocker_tlv_put_le16 (buf, &pos,ROCKER_TLV_RX_FLAGS , rx_flags); +rocker_tlv_put_le16 (buf, &pos,ROCKER_TLV_RX_CSUM , rx_csum);Note: Some backend (e.g tap) can do offloading, may consider to add the support in the future.
Yup, on TODO list for Rx/Tx offloads.
Quoted 2 lines
Using only 1 queues is ok for multiqueue backend. In the future may consider to use all.
When we get to QoS for working, I think we'll want to enable these multiqueues. QoS support is not implemented in rocker, currently, but there is support defined in the OF-DPA spec as part of ACL processing. So this is future work.
Quoted 1 line
Thanks
Thanks for reviewing.
Re: [Qemu-devel] [PATCH v3 6/9] rocker: add new rocker switch device
Quoted 10 lines · Scott Feldman
Quoted 9 lines · Jason Wang
Quoted 6 lines · On 01/11/2015 11:57 AM, [email protected] wrote:
Each port is a netdev and can be paired with using -netdev
id=<port name>.Signed-off-by Scott Feldman <[email protected]>Signed-off-by Jiri Pirko <[email protected]>---
Quoted 6 lines
Quoted 3 lines
Looks like the devices does not support state saving. How about
tagging
it with unmigratable first?State saving would be nice to add in the future. How do we tag is unmigratable for now?
E.g For VFIO it does:
static const VMStateDescription vfio_pci_vmstate = {
.name = "vfio-pci",
.unmigratable = 1,
};
Quoted 7 lines
Quoted 5 lines
Quoted 3 lines
+
uint64_tswitch_id; /* switch id */Looks like the function of name ad
switch_idare duplicated?Don't follow...
I mean it looks to me that name is used to find a rocker through qmp. Can't we just do this through switch_id (many devices or netdev just have an 'id' property to do this)?
Quoted 9 lines
Quoted 8 lines
Quoted 5 lines
+ if (iovcnt) {
+ /* XXX perform Tx offloads */
+ /* XXX silence compiler for now */Need add TSO here (e1000 is a good reference) or disable TSO in
driver.
Quoted 7 lines
TSO is not enabled in driver, currently. This is lower priority now since the I/O path for traffic to/from the guest CPU is not performance critical. The forwarding path offloaded by the device is the hot path, but that doesn't involve I/O to guest CPU, so Tx/Rx offloads aren't in play.
But, someday, it would be nice to enable Rx/Tx offloads.
I see, thanks.
Quoted 25 lines
Quoted 12 lines
Quoted 11 lines
+ rocker_tlv_put_le32(buf, &pos,
ROCKER_TLV_EVENT_TYPE,
+ROCKER_TLV_EVENT_TYPE_LINK_CHANGED);
+ nest = rocker_tlv_nest_start(buf, &pos,ROCKER_TLV_EVENT_INFO);
+ rocker_tlv_put_le32(buf, &pos,ROCKER_TLV_EVENT_LINK_CHANGED_PPORT, pport);
+ rocker_tlv_put_u8(buf, &pos,ROCKER_TLV_EVENT_LINK_CHANGED_LINKUP,
+link_up? 1 : 0);Quoted 1 line
Looks like those types are not documented.
Ok, I'll double check spec to make sure we're covered, for the items you found.
Quoted 6 lines
Quoted 2 lines
+
rocker_tlv_put_le16(buf, &pos, ROCKER_TLV_RX_FLAGS, rx_flags);
+rocker_tlv_put_le16(buf, &pos, ROCKER_TLV_RX_CSUM, rx_csum);Note: Some backend (e.g tap) can do offloading, may consider to add
the
support in the future.Yup, on TODO list for Rx/Tx offloads.
Quoted 7 lines
Quoted 2 lines
Using only 1 queues is ok for multiqueue backend. In the future may consider to use all.
When we get to QoS for working, I think we'll want to enable these multiqueues. QoS support is not implemented in rocker, currently, but there is support defined in the OF-DPA spec as part of ACL processing. So this is future work.
Yes.
Notes: some netdev backend (e.g tap) can be a multiple queue device. But since performance is not a major consideration now. It's ok to just use one queue.
Quoted 5 lines
Quoted 3 lines
Thanks
Thanks for reviewing.
PATCH v3 7/9 qmp: add rocker device support
In reply to [email protected]From: Scott Feldman <[email protected]>
Add QMP/HMP support for rocker devices. This is mostly for debugging purposes to see inside the device's tables and port configurations. Some examples:
(qemu) info rocker sw1
name: sw1
id: 0x0000013512005452
ports: 4
(qemu) info rocker-ports sw1
ena/ speed/ auto
port link duplex neg?
sw1.1 up 10G FD No
sw1.2 up 10G FD No
sw1.3 !ena 10G FD No
sw1.4 !ena 10G FD No
(qemu) info rocker-of-dpa-flows sw1
prio tbl hits key(mask) --> actions
2 60 lport 1 vlan 1 LLDP src 00:02:00:00:02:00 dst 01:80:c2:00:00:0e 2 60 lport 1 vlan 1 ARP src 00:02:00:00:02:00 dst 00:02:00:00:03:00 2 60 lport 2 vlan 2 IPv6 src 00:02:00:00:03:00 dst 33:33:ff:00:00:02 proto 58 3 50 vlan 2 dst 33:33:ff:00:00:02 --> write group 0x32000001 goto tbl 60 2 60 lport 2 vlan 2 IPv6 src 00:02:00:00:03:00 dst 33:33:ff:00:03:00 proto 58 3 50 1 vlan 2 dst 33:33:ff:00:03:00 --> write group 0x32000001 goto tbl 60 2 60 lport 2 vlan 2 ARP src 00:02:00:00:03:00 dst 00:02:00:00:02:00 3 50 2 vlan 2 dst 00:02:00:00:02:00 --> write group 0x02000001 goto tbl 60 2 60 1 lport 2 vlan 2 IP src 00:02:00:00:03:00 dst 00:02:00:00:02:00 proto 1 3 50 2 vlan 1 dst 00:02:00:00:03:00 --> write group 0x01000002 goto tbl 60 2 60 1 lport 1 vlan 1 IP src 00:02:00:00:02:00 dst 00:02:00:00:03:00 proto 1 2 60 lport 1 vlan 1 IPv6 src 00:02:00:00:02:00 dst 33:33:ff:00:00:01 proto 58 3 50 vlan 1 dst 33:33:ff:00:00:01 --> write group 0x31000000 goto tbl 60 2 60 lport 1 vlan 1 IPv6 src 00:02:00:00:02:00 dst 33:33:ff:00:02:00 proto 58 3 50 1 vlan 1 dst 33:33:ff:00:02:00 --> write group 0x31000000 goto tbl 60 1 60 173 lport 2 vlan 2 LLDP src <any> dst 01:80:c2:00:00:0e --> write group 0x02000000 1 60 6 lport 2 vlan 2 IPv6 src <any> dst <any> --> write group 0x02000000 1 60 174 lport 1 vlan 1 LLDP src <any> dst 01:80:c2:00:00:0e --> write group 0x01000000 1 60 174 lport 2 vlan 2 IP src <any> dst <any> --> write group 0x02000000 1 60 6 lport 1 vlan 1 IPv6 src <any> dst <any> --> write group 0x01000000 1 60 181 lport 2 vlan 2 ARP src <any> dst <any> --> write group 0x02000000 1 10 715 lport 2 --> apply new vlan 2 goto tbl 20 1 60 177 lport 1 vlan 1 ARP src <any> dst <any> --> write group 0x01000000 1 60 174 lport 1 vlan 1 IP src <any> dst <any> --> write group 0x01000000 1 10 717 lport 1 --> apply new vlan 1 goto tbl 20 1 0 1432 lport 0(0xffff) --> goto tbl 10
(qemu) info rocker-of-dpa-groups sw1
id (decode) --> buckets0x32000001 (type L2 multicast vlan 2 index 1) --> groups [0x02000001,0x02000000] 0x02000001 (type L2 interface vlan 2 lport 1) --> pop vlan out lport 1 0x01000002 (type L2 interface vlan 1 lport 2) --> pop vlan out lport 2 0x02000000 (type L2 interface vlan 2 lport 0) --> pop vlan out lport 0 0x01000000 (type L2 interface vlan 1 lport 0) --> pop vlan out lport 0 0x31000000 (type L2 multicast vlan 1 index 0) --> groups [0x01000002,0x01000000]
--- hmp-commands.hx | 24 ++++ hmp.c | 303 ++++++++++++++++++++++++++++++++++++++++ hmp.h | 4 + hw/net/rocker/rocker.c | 45 ++++++ hw/net/rocker/rocker_fp.c | 10 ++ hw/net/rocker/rocker_fp.h | 1 + hw/net/rocker/rocker_of_dpa.c | 308 +++++++++++++++++++++++++++++++++++++++++ monitor.c | 28 ++++ qapi-schema.json | 3 + qapi/rocker.json | 259 ++++++++++++++++++++++++++++++++++ qmp-commands.hx | 97 +++++++++++++ 11 files changed, 1082 insertions(+) create mode 100644 qapi/rocker.json
hmp-commands.hx +24 -0
@@ -1787,5 +1787,29 @@ show available trace events and their state ETEXI STEXI +@item rocker @var{name} +@findex rocker +Show Rocker(s) +ETEXI + +STEXI +@item rocker_ports @var{name} +@findex rocker_ports +Show Rocker ports +ETEXI + +STEXI +@item rocker_of_dpa_flows @var{name} [@var{tbl_id}] +@findex rocker_of_dpa_flows +Show Rocker OF-DPA flow tables +ETEXI + +STEXI +@item rocker_of_dpa_groups @var{name} [@var{type}] +@findex rocker_of_dpa_groups +Show Rocker OF-DPA groups +ETEXI + +STEXI @end table ETEXI
hmp.c +303 -0
312 lines not on this page · raw message
hmp.h +4 -0
@@ -116,5 +116,9 @@ void host_net_remove_completion(ReadLineState *rs, int nb_args, const char *str);void delvm_completion (ReadLineState *rs,int nb_args,const char *str);void loadvm_completion (ReadLineState *rs,int nb_args,const char *str); +void hmp_rocker (Monitor *mon,const QDict *qdict); +void hmp_rocker_ports (Monitor *mon,const QDict *qdict); +void hmp_rocker_of_dpa_flows (Monitor *mon,const QDict *qdict); +void hmp_rocker_of_dpa_groups (Monitor *mon,const QDict *qdict);#endif
hw/net/rocker/rocker.c +45 -0
51 lines not on this page · raw message
hw/net/rocker/rocker_fp.c +10 -0
@@ -46,6 +46,16 @@ bool fp_port_get_link_up(FpPort *port)return !qemu_get_queue (port->nic)->link_down; } +void fp_port_get_info (FpPort *port,RockerPortList *info) +{ + info->value->name =g_strdup (port->name); + info->value->enabled = port->enabled; + info->value->link_up =fp_port_get_link_up (port); + info->value->speed = port->speed; + info->value->duplex = port->duplex; + info->value->autoneg = port->autoneg; +} +void fp_port_get_macaddr (FpPort *port,MACAddr *macaddr) {memcpy (macaddr->a, port->conf.macaddr.a,sizeof (macaddr->a));
hw/net/rocker/rocker_fp.h +1 -0
@@ -29,6 +29,7 @@ typedef struct world World;int fp_port_eg (FpPort *port,const struct iovec *iov,int iovcnt);bool fp_port_get_link_up (FpPort *port); +void fp_port_get_info (FpPort *port,RockerPortList *info);void fp_port_get_macaddr (FpPort *port,MACAddr *macaddr);void fp_port_set_macaddr (FpPort *port,MACAddr *macaddr);uint8_t fp_port_get_learning (FpPort *port);
hw/net/rocker/rocker_of_dpa.c +308 -0
314 lines not on this page · raw message
monitor.c +28 -0
@@ -2935,6 +2935,34 @@ static mon_cmd_t info_cmds[] = { .mhandler.cmd = hmp_info_memory_devices, }, { + .name = "rocker", + .args_type = "name:s", + .params = "name", + .help = "Show rocker switch", + .mhandler.cmd = hmp_rocker, + }, + { + .name = "rocker-ports", + .args_type = "name:s", + .params = "name", + .help = "Show rocker ports", + .mhandler.cmd = hmp_rocker_ports, + }, + { + .name = "rocker-of-dpa-flows", + .args_type = "name:s,tbl_id:i?", + .params = "name [tbl_id]", + .help = "Show rocker OF-DPA flow tables", + .mhandler.cmd = hmp_rocker_of_dpa_flows, + }, + { + .name = "rocker-of-dpa-groups", + .args_type = "name:s,type:i?", + .params = "name [type]", + .help = "Show rocker OF-DPA groups", + .mhandler.cmd = hmp_rocker_of_dpa_groups, + }, + { .name = NULL, }, };
qapi-schema.json +3 -0
@@ -3515,3 +3515,6 @@ # Since: 2.1 ## { 'command': 'rtc-reset-reinjection' } + +# Rocker ethernet network switch +{ 'include': 'qapi/rocker.json' }
qapi/rocker.json new file +259 -0
259 lines not on this page · raw message
qmp-commands.hx +97 -0
100 lines not on this page · raw message
Signature · 1 line
1.7.10.4
Re: [Qemu-devel] [PATCH v3 7/9] qmp: add rocker device support
Quoted 58 lines · On 01/11/2015 11:57 AM, [email protected] wrote:
From: Scott Feldman <[email protected]>
Add QMP/HMP support for rocker devices. This is mostly for debugging purposes to see inside the device's tables and port configurations. Some examples:
(qemu) info rocker sw1
name: sw1
id:0x0000013512005452
ports: 4(qemu) info rocker-ports sw1
ena/ speed/ auto
port link duplex neg?
sw1.1 up 10G FD No
sw1.2 up 10G FD No
sw1.3 !ena 10G FD No
sw1.4 !ena 10G FD No(qemu) info rocker-of-dpa-flows sw1
prio tbl hits key(mask) --> actions2 60 lport 1 vlan 1 LLDP src 00:02:00:00:02:00 dst 01:80:c2:00:00:0e 2 60 lport 1 vlan 1 ARP src 00:02:00:00:02:00 dst 00:02:00:00:03:00 2 60 lport 2 vlan 2 IPv6 src 00:02:00:00:03:00 dst 33:33:ff:00:00:02 proto 58 3 50 vlan 2 dst 33:33:ff:00:00:02 --> write group 0x32000001 goto tbl 60 2 60 lport 2 vlan 2 IPv6 src 00:02:00:00:03:00 dst 33:33:ff:00:03:00 proto 58 3 50 1 vlan 2 dst 33:33:ff:00:03:00 --> write group 0x32000001 goto tbl 60 2 60 lport 2 vlan 2 ARP src 00:02:00:00:03:00 dst 00:02:00:00:02:00 3 50 2 vlan 2 dst 00:02:00:00:02:00 --> write group 0x02000001 goto tbl 60 2 60 1 lport 2 vlan 2 IP src 00:02:00:00:03:00 dst 00:02:00:00:02:00 proto 1 3 50 2 vlan 1 dst 00:02:00:00:03:00 --> write group 0x01000002 goto tbl 60 2 60 1 lport 1 vlan 1 IP src 00:02:00:00:02:00 dst 00:02:00:00:03:00 proto 1 2 60 lport 1 vlan 1 IPv6 src 00:02:00:00:02:00 dst 33:33:ff:00:00:01 proto 58 3 50 vlan 1 dst 33:33:ff:00:00:01 --> write group 0x31000000 goto tbl 60 2 60 lport 1 vlan 1 IPv6 src 00:02:00:00:02:00 dst 33:33:ff:00:02:00 proto 58 3 50 1 vlan 1 dst 33:33:ff:00:02:00 --> write group 0x31000000 goto tbl 60 1 60 173 lport 2 vlan 2 LLDP src <any> dst 01:80:c2:00:00:0e --> write group 0x02000000 1 60 6 lport 2 vlan 2 IPv6 src <any> dst <any> --> write group 0x02000000 1 60 174 lport 1 vlan 1 LLDP src <any> dst 01:80:c2:00:00:0e --> write group 0x01000000 1 60 174 lport 2 vlan 2 IP src <any> dst <any> --> write group 0x02000000 1 60 6 lport 1 vlan 1 IPv6 src <any> dst <any> --> write group 0x01000000 1 60 181 lport 2 vlan 2 ARP src <any> dst <any> --> write group 0x02000000 1 10 715 lport 2 --> apply new vlan 2 goto tbl 20 1 60 177 lport 1 vlan 1 ARP src <any> dst <any> --> write group 0x01000000 1 60 174 lport 1 vlan 1 IP src <any> dst <any> --> write group 0x01000000 1 10 717 lport 1 --> apply new vlan 1 goto tbl 20 1 0 1432 lport 0(0xffff) --> goto tbl 10(qemu) info rocker-of-dpa-groups sw1
id (decode) --> buckets0x32000001(type L2 multicast vlan 2 index 1) --> groups [0x02000001,0x02000000]0x02000001(type L2 interface vlan 2 lport 1) --> pop vlan out lport 10x01000002(type L2 interface vlan 1 lport 2) --> pop vlan out lport 20x02000000(type L2 interface vlan 2 lport 0) --> pop vlan out lport 00x01000000(type L2 interface vlan 1 lport 0) --> pop vlan out lport 00x31000000(type L2 multicast vlan 1 index 0) --> groups [0x01000002,0x01000000]Signed-off-by Scott Feldman <[email protected]>Signed-off-by Jiri Pirko <[email protected]>
Quoted 14 lines
--- hmp-commands.hx | 24 ++++ hmp.c | 303 ++++++++++++++++++++++++++++++++++++++++ hmp.h | 4 + hw/net/rocker/rocker.c | 45 ++++++ hw/net/rocker/rocker_fp.c | 10 ++ hw/net/rocker/rocker_fp.h | 1 + hw/net/rocker/rocker_of_dpa.c | 308 +++++++++++++++++++++++++++++++++++++++++ monitor.c | 28 ++++ qapi-schema.json | 3 + qapi/rocker.json | 259 ++++++++++++++++++++++++++++++++++ qmp-commands.hx | 97 +++++++++++++ 11 files changed, 1082 insertions(+) create mode 100644 qapi/rocker.json
I don't object this method but not sure it was worth (especially consider it needs nearly a thousand lines of codes).
Could we just do this through remote controller or agent?
Thanks
Re: [Qemu-devel] [PATCH v3 7/9] qmp: add rocker device support
Quoted 75 lines · Jason Wang
Quoted 58 lines · On 01/11/2015 11:57 AM, [email protected] wrote:
From: Scott Feldman <[email protected]>
Add QMP/HMP support for rocker devices. This is mostly for debugging purposes to see inside the device's tables and port configurations. Some examples:
(qemu) info rocker sw1
name: sw1
id:0x0000013512005452
ports: 4(qemu) info rocker-ports sw1
ena/ speed/ auto
port link duplex neg?
sw1.1 up 10G FD No
sw1.2 up 10G FD No
sw1.3 !ena 10G FD No
sw1.4 !ena 10G FD No(qemu) info rocker-of-dpa-flows sw1
prio tbl hits key(mask) --> actions2 60 lport 1 vlan 1 LLDP src 00:02:00:00:02:00 dst 01:80:c2:00:00:0e 2 60 lport 1 vlan 1 ARP src 00:02:00:00:02:00 dst 00:02:00:00:03:00 2 60 lport 2 vlan 2 IPv6 src 00:02:00:00:03:00 dst 33:33:ff:00:00:02 proto 58 3 50 vlan 2 dst 33:33:ff:00:00:02 --> write group 0x32000001 goto tbl 60 2 60 lport 2 vlan 2 IPv6 src 00:02:00:00:03:00 dst 33:33:ff:00:03:00 proto 58 3 50 1 vlan 2 dst 33:33:ff:00:03:00 --> write group 0x32000001 goto tbl 60 2 60 lport 2 vlan 2 ARP src 00:02:00:00:03:00 dst 00:02:00:00:02:00 3 50 2 vlan 2 dst 00:02:00:00:02:00 --> write group 0x02000001 goto tbl 60 2 60 1 lport 2 vlan 2 IP src 00:02:00:00:03:00 dst 00:02:00:00:02:00 proto 1 3 50 2 vlan 1 dst 00:02:00:00:03:00 --> write group 0x01000002 goto tbl 60 2 60 1 lport 1 vlan 1 IP src 00:02:00:00:02:00 dst 00:02:00:00:03:00 proto 1 2 60 lport 1 vlan 1 IPv6 src 00:02:00:00:02:00 dst 33:33:ff:00:00:01 proto 58 3 50 vlan 1 dst 33:33:ff:00:00:01 --> write group 0x31000000 goto tbl 60 2 60 lport 1 vlan 1 IPv6 src 00:02:00:00:02:00 dst 33:33:ff:00:02:00 proto 58 3 50 1 vlan 1 dst 33:33:ff:00:02:00 --> write group 0x31000000 goto tbl 60 1 60 173 lport 2 vlan 2 LLDP src <any> dst 01:80:c2:00:00:0e --> write group 0x02000000 1 60 6 lport 2 vlan 2 IPv6 src <any> dst <any> --> write group 0x02000000 1 60 174 lport 1 vlan 1 LLDP src <any> dst 01:80:c2:00:00:0e --> write group 0x01000000 1 60 174 lport 2 vlan 2 IP src <any> dst <any> --> write group 0x02000000 1 60 6 lport 1 vlan 1 IPv6 src <any> dst <any> --> write group 0x01000000 1 60 181 lport 2 vlan 2 ARP src <any> dst <any> --> write group 0x02000000 1 10 715 lport 2 --> apply new vlan 2 goto tbl 20 1 60 177 lport 1 vlan 1 ARP src <any> dst <any> --> write group 0x01000000 1 60 174 lport 1 vlan 1 IP src <any> dst <any> --> write group 0x01000000 1 10 717 lport 1 --> apply new vlan 1 goto tbl 20 1 0 1432 lport 0(0xffff) --> goto tbl 10(qemu) info rocker-of-dpa-groups sw1
id (decode) --> buckets0x32000001(type L2 multicast vlan 2 index 1) --> groups [0x02000001,0x02000000]0x02000001(type L2 interface vlan 2 lport 1) --> pop vlan out lport 10x01000002(type L2 interface vlan 1 lport 2) --> pop vlan out lport 20x02000000(type L2 interface vlan 2 lport 0) --> pop vlan out lport 00x01000000(type L2 interface vlan 1 lport 0) --> pop vlan out lport 00x31000000(type L2 multicast vlan 1 index 0) --> groups [0x01000002,0x01000000]Signed-off-by Scott Feldman <[email protected]>Signed-off-by Jiri Pirko <[email protected]>Quoted 14 lines
--- hmp-commands.hx | 24 ++++ hmp.c | 303 ++++++++++++++++++++++++++++++++++++++++ hmp.h | 4 + hw/net/rocker/rocker.c | 45 ++++++ hw/net/rocker/rocker_fp.c | 10 ++ hw/net/rocker/rocker_fp.h | 1 + hw/net/rocker/rocker_of_dpa.c | 308 +++++++++++++++++++++++++++++++++++++++++ monitor.c | 28 ++++ qapi-schema.json | 3 + qapi/rocker.json | 259 ++++++++++++++++++++++++++++++++++ qmp-commands.hx | 97 +++++++++++++ 11 files changed, 1082 insertions(+) create mode 100644 qapi/rocker.json
Quoted 2 lines
I don't object this method but not sure it was worth (especially consider it needs nearly a thousand lines of codes).
I wasn't happy about touching core files to add rocker support. Splitting device-specific stuff out into qapi/rocker.json helped. Seems qmp/hmp aren't really setup for devices to "plug-in" their stuff in in a modular way. I couldn't find other examples of devices using qmp/hmp to the extent rocker is, but maybe I didn't look hard enough.
However, QMP/HMP support is very handy for debugging rocker device since there is tons of state stored in the switch forwarding tables, and it can be quite dynamic depending on what's going on on the guest OS w.r.t networking.
Quoted 1 line
Could we just do this through remote controller or agent?
I'm open to ideas. qmp/hmp work great for getting an instantaneous snapshot of the device state. The JSON format goodness come for free with qmp, so that's nice.
-scott
PATCH v3 8/9 rocker: add tests
In reply to [email protected]From: Scott Feldman <[email protected]>
Add some basic test for rocker to test L2/L3/L4 functionality. Requires an external test environment, simp, located here:
https://github.com/scottfeldman/simp
To run tests, simp environment must be installed and a suitable VM image built and installed with a Linux 3.18 (or greater) kernel with rocker driver support enabled.
--- hw/net/rocker/test/README | 5 +++ hw/net/rocker/test/all | 19 +++++++++++ hw/net/rocker/test/bridge | 43 ++++++++++++++++++++++++ hw/net/rocker/test/bridge-stp | 52 +++++++++++++++++++++++++++++ hw/net/rocker/test/bridge-vlan | 52 +++++++++++++++++++++++++++++ hw/net/rocker/test/bridge-vlan-stp | 64 ++++++++++++++++++++++++++++++++++++ hw/net/rocker/test/port | 22 +++++++++++++ hw/net/rocker/test/tut.dot | 8 +++++ 8 files changed, 265 insertions(+) create mode 100644 hw/net/rocker/test/README create mode 100755 hw/net/rocker/test/all create mode 100755 hw/net/rocker/test/bridge create mode 100755 hw/net/rocker/test/bridge-stp create mode 100755 hw/net/rocker/test/bridge-vlan create mode 100755 hw/net/rocker/test/bridge-vlan-stp create mode 100755 hw/net/rocker/test/port create mode 100644 hw/net/rocker/test/tut.dot
hw/net/rocker/test/README new file +5 -0
@@ -0,0 +1,5 @@ +Tests require simp (simple network simulator) found here: + +https://github.com/scottfeldman/simp + +Run 'all' to run all tests.
hw/net/rocker/test/all new file +19 -0
@@ -0,0 +1,19 @@ +echo -n "Running port test... " +./port +if [ $? -eq 0 ]; then echo "pass"; else echo "FAILED"; exit 1; fi + +echo -n "Running bridge test... " +./bridge +if [ $? -eq 0 ]; then echo "pass"; else echo "FAILED"; exit 1; fi + +echo -n "Running bridge STP test... " +./bridge-stp +if [ $? -eq 0 ]; then echo "pass"; else echo "FAILED"; exit 1; fi + +echo -n "Running bridge VLAN test... " +./bridge-vlan +if [ $? -eq 0 ]; then echo "pass"; else echo "FAILED"; exit 1; fi + +echo -n "Running bridge VLAN STP test... " +./bridge-vlan-stp +if [ $? -eq 0 ]; then echo "pass"; else echo "FAILED"; exit 1; fi
hw/net/rocker/test/bridge new file +43 -0
43 lines not on this page · raw message
hw/net/rocker/test/bridge-stp new file +52 -0
52 lines not on this page · raw message
hw/net/rocker/test/bridge-vlan new file +52 -0
52 lines not on this page · raw message
hw/net/rocker/test/bridge-vlan-stp new file +64 -0
64 lines not on this page · raw message
hw/net/rocker/test/port new file +22 -0
@@ -0,0 +1,22 @@ +simp destroy ".*" +simp create -o sw1:rocker:sw1 tut tut.dot +simp start tut +while ! simp ssh tut sw1 --cmd "ping -c 1 localhost >/dev/null"; do sleep 1; done +while ! simp ssh tut h1 --cmd "ping -c 1 localhost >/dev/null"; do sleep 1; done +while ! simp ssh tut h2 --cmd "ping -c 1 localhost >/dev/null"; do sleep 1; done + +# bring up DUT ports + +simp ssh tut sw1 --cmd "sudo ifconfig swp1 11.0.0.1/24" +simp ssh tut sw1 --cmd "sudo ifconfig swp2 12.0.0.1/24" + +# config IP on hosts + +simp ssh tut h1 --cmd "sudo ifconfig swp1 11.0.0.2/24" +simp ssh tut h2 --cmd "sudo ifconfig swp1 12.0.0.2/24" + +# test... + +simp ssh tut h1 --cmd "ping -c10 11.0.0.1 >/dev/null" +if [ $? -eq 1 ]; then exit 1; fi +simp ssh tut h2 --cmd "ping -c10 12.0.0.1 >/dev/null"
hw/net/rocker/test/tut.dot new file +8 -0
@@ -0,0 +1,8 @@ +graph G { + graph [hostidtype="hostname", version="1:0", date="04/12/2013"]; + edge [dir=none, notify="log"]; + sw1:swp1 -- h1:swp1; + sw1:swp2 -- h2:swp1; + sw1:swp3 -- h3:swp1; + sw1:swp4 -- h4:swp1; +}
Signature · 1 line
1.7.10.4
PATCH v3 9/9 MAINTAINERS: add rocker
In reply to [email protected]From: Scott Feldman <[email protected]>
--- MAINTAINERS | 6 ++++++ 1 file changed, 6 insertions(+)
MAINTAINERS +6 -0
@@ -734,6 +734,12 @@ S: Maintained F: hw/net/vmxnet* F: hw/scsi/vmw_pvscsi* +Rocker +M: Scott Feldman <[email protected]> +M: Jiri Pirko <[email protected]> +S: Maintained +F: hw/net/rocker/ + Subsystems ---------- Audio
Signature · 1 line
1.7.10.4