monitor/qmp: Update comment for commit 4eaca8de268
[qemu/armbru.git] / hw / net / xgmac.c
blob2ea8d2ec721632ecd13026eedf0337f1045cac71
1 /*
2 * QEMU model of XGMAC Ethernet.
4 * derived from the Xilinx AXI-Ethernet by Edgar E. Iglesias.
6 * Copyright (c) 2011 Calxeda, Inc.
8 * Permission is hereby granted, free of charge, to any person obtaining a copy
9 * of this software and associated documentation files (the "Software"), to deal
10 * in the Software without restriction, including without limitation the rights
11 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
12 * copies of the Software, and to permit persons to whom the Software is
13 * furnished to do so, subject to the following conditions:
15 * The above copyright notice and this permission notice shall be included in
16 * all copies or substantial portions of the Software.
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
23 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
24 * THE SOFTWARE.
27 #include "qemu/osdep.h"
28 #include "hw/irq.h"
29 #include "hw/qdev-properties.h"
30 #include "hw/sysbus.h"
31 #include "migration/vmstate.h"
32 #include "qemu/log.h"
33 #include "qemu/module.h"
34 #include "net/net.h"
36 #ifdef DEBUG_XGMAC
37 #define DEBUGF_BRK(message, args...) do { \
38 fprintf(stderr, (message), ## args); \
39 } while (0)
40 #else
41 #define DEBUGF_BRK(message, args...) do { } while (0)
42 #endif
44 #define XGMAC_CONTROL 0x00000000 /* MAC Configuration */
45 #define XGMAC_FRAME_FILTER 0x00000001 /* MAC Frame Filter */
46 #define XGMAC_FLOW_CTRL 0x00000006 /* MAC Flow Control */
47 #define XGMAC_VLAN_TAG 0x00000007 /* VLAN Tags */
48 #define XGMAC_VERSION 0x00000008 /* Version */
49 /* VLAN tag for insertion or replacement into tx frames */
50 #define XGMAC_VLAN_INCL 0x00000009
51 #define XGMAC_LPI_CTRL 0x0000000a /* LPI Control and Status */
52 #define XGMAC_LPI_TIMER 0x0000000b /* LPI Timers Control */
53 #define XGMAC_TX_PACE 0x0000000c /* Transmit Pace and Stretch */
54 #define XGMAC_VLAN_HASH 0x0000000d /* VLAN Hash Table */
55 #define XGMAC_DEBUG 0x0000000e /* Debug */
56 #define XGMAC_INT_STATUS 0x0000000f /* Interrupt and Control */
57 /* HASH table registers */
58 #define XGMAC_HASH(n) ((0x00000300/4) + (n))
59 #define XGMAC_NUM_HASH 16
60 /* Operation Mode */
61 #define XGMAC_OPMODE (0x00000400/4)
62 /* Remote Wake-Up Frame Filter */
63 #define XGMAC_REMOTE_WAKE (0x00000700/4)
64 /* PMT Control and Status */
65 #define XGMAC_PMT (0x00000704/4)
67 #define XGMAC_ADDR_HIGH(reg) (0x00000010+((reg) * 2))
68 #define XGMAC_ADDR_LOW(reg) (0x00000011+((reg) * 2))
70 #define DMA_BUS_MODE 0x000003c0 /* Bus Mode */
71 #define DMA_XMT_POLL_DEMAND 0x000003c1 /* Transmit Poll Demand */
72 #define DMA_RCV_POLL_DEMAND 0x000003c2 /* Received Poll Demand */
73 #define DMA_RCV_BASE_ADDR 0x000003c3 /* Receive List Base */
74 #define DMA_TX_BASE_ADDR 0x000003c4 /* Transmit List Base */
75 #define DMA_STATUS 0x000003c5 /* Status Register */
76 #define DMA_CONTROL 0x000003c6 /* Ctrl (Operational Mode) */
77 #define DMA_INTR_ENA 0x000003c7 /* Interrupt Enable */
78 #define DMA_MISSED_FRAME_CTR 0x000003c8 /* Missed Frame Counter */
79 /* Receive Interrupt Watchdog Timer */
80 #define DMA_RI_WATCHDOG_TIMER 0x000003c9
81 #define DMA_AXI_BUS 0x000003ca /* AXI Bus Mode */
82 #define DMA_AXI_STATUS 0x000003cb /* AXI Status */
83 #define DMA_CUR_TX_DESC_ADDR 0x000003d2 /* Current Host Tx Descriptor */
84 #define DMA_CUR_RX_DESC_ADDR 0x000003d3 /* Current Host Rx Descriptor */
85 #define DMA_CUR_TX_BUF_ADDR 0x000003d4 /* Current Host Tx Buffer */
86 #define DMA_CUR_RX_BUF_ADDR 0x000003d5 /* Current Host Rx Buffer */
87 #define DMA_HW_FEATURE 0x000003d6 /* Enabled Hardware Features */
89 /* DMA Status register defines */
90 #define DMA_STATUS_GMI 0x08000000 /* MMC interrupt */
91 #define DMA_STATUS_GLI 0x04000000 /* GMAC Line interface int */
92 #define DMA_STATUS_EB_MASK 0x00380000 /* Error Bits Mask */
93 #define DMA_STATUS_EB_TX_ABORT 0x00080000 /* Error Bits - TX Abort */
94 #define DMA_STATUS_EB_RX_ABORT 0x00100000 /* Error Bits - RX Abort */
95 #define DMA_STATUS_TS_MASK 0x00700000 /* Transmit Process State */
96 #define DMA_STATUS_TS_SHIFT 20
97 #define DMA_STATUS_RS_MASK 0x000e0000 /* Receive Process State */
98 #define DMA_STATUS_RS_SHIFT 17
99 #define DMA_STATUS_NIS 0x00010000 /* Normal Interrupt Summary */
100 #define DMA_STATUS_AIS 0x00008000 /* Abnormal Interrupt Summary */
101 #define DMA_STATUS_ERI 0x00004000 /* Early Receive Interrupt */
102 #define DMA_STATUS_FBI 0x00002000 /* Fatal Bus Error Interrupt */
103 #define DMA_STATUS_ETI 0x00000400 /* Early Transmit Interrupt */
104 #define DMA_STATUS_RWT 0x00000200 /* Receive Watchdog Timeout */
105 #define DMA_STATUS_RPS 0x00000100 /* Receive Process Stopped */
106 #define DMA_STATUS_RU 0x00000080 /* Receive Buffer Unavailable */
107 #define DMA_STATUS_RI 0x00000040 /* Receive Interrupt */
108 #define DMA_STATUS_UNF 0x00000020 /* Transmit Underflow */
109 #define DMA_STATUS_OVF 0x00000010 /* Receive Overflow */
110 #define DMA_STATUS_TJT 0x00000008 /* Transmit Jabber Timeout */
111 #define DMA_STATUS_TU 0x00000004 /* Transmit Buffer Unavailable */
112 #define DMA_STATUS_TPS 0x00000002 /* Transmit Process Stopped */
113 #define DMA_STATUS_TI 0x00000001 /* Transmit Interrupt */
115 /* DMA Control register defines */
116 #define DMA_CONTROL_ST 0x00002000 /* Start/Stop Transmission */
117 #define DMA_CONTROL_SR 0x00000002 /* Start/Stop Receive */
118 #define DMA_CONTROL_DFF 0x01000000 /* Disable flush of rx frames */
120 struct desc {
121 uint32_t ctl_stat;
122 uint16_t buffer1_size;
123 uint16_t buffer2_size;
124 uint32_t buffer1_addr;
125 uint32_t buffer2_addr;
126 uint32_t ext_stat;
127 uint32_t res[3];
130 #define R_MAX 0x400
132 typedef struct RxTxStats {
133 uint64_t rx_bytes;
134 uint64_t tx_bytes;
136 uint64_t rx;
137 uint64_t rx_bcast;
138 uint64_t rx_mcast;
139 } RxTxStats;
141 #define TYPE_XGMAC "xgmac"
142 #define XGMAC(obj) OBJECT_CHECK(XgmacState, (obj), TYPE_XGMAC)
144 typedef struct XgmacState {
145 SysBusDevice parent_obj;
147 MemoryRegion iomem;
148 qemu_irq sbd_irq;
149 qemu_irq pmt_irq;
150 qemu_irq mci_irq;
151 NICState *nic;
152 NICConf conf;
154 struct RxTxStats stats;
155 uint32_t regs[R_MAX];
156 } XgmacState;
158 static const VMStateDescription vmstate_rxtx_stats = {
159 .name = "xgmac_stats",
160 .version_id = 1,
161 .minimum_version_id = 1,
162 .fields = (VMStateField[]) {
163 VMSTATE_UINT64(rx_bytes, RxTxStats),
164 VMSTATE_UINT64(tx_bytes, RxTxStats),
165 VMSTATE_UINT64(rx, RxTxStats),
166 VMSTATE_UINT64(rx_bcast, RxTxStats),
167 VMSTATE_UINT64(rx_mcast, RxTxStats),
168 VMSTATE_END_OF_LIST()
172 static const VMStateDescription vmstate_xgmac = {
173 .name = "xgmac",
174 .version_id = 1,
175 .minimum_version_id = 1,
176 .fields = (VMStateField[]) {
177 VMSTATE_STRUCT(stats, XgmacState, 0, vmstate_rxtx_stats, RxTxStats),
178 VMSTATE_UINT32_ARRAY(regs, XgmacState, R_MAX),
179 VMSTATE_END_OF_LIST()
183 static void xgmac_read_desc(XgmacState *s, struct desc *d, int rx)
185 uint32_t addr = rx ? s->regs[DMA_CUR_RX_DESC_ADDR] :
186 s->regs[DMA_CUR_TX_DESC_ADDR];
187 cpu_physical_memory_read(addr, d, sizeof(*d));
190 static void xgmac_write_desc(XgmacState *s, struct desc *d, int rx)
192 int reg = rx ? DMA_CUR_RX_DESC_ADDR : DMA_CUR_TX_DESC_ADDR;
193 uint32_t addr = s->regs[reg];
195 if (!rx && (d->ctl_stat & 0x00200000)) {
196 s->regs[reg] = s->regs[DMA_TX_BASE_ADDR];
197 } else if (rx && (d->buffer1_size & 0x8000)) {
198 s->regs[reg] = s->regs[DMA_RCV_BASE_ADDR];
199 } else {
200 s->regs[reg] += sizeof(*d);
202 cpu_physical_memory_write(addr, d, sizeof(*d));
205 static void xgmac_enet_send(XgmacState *s)
207 struct desc bd;
208 int frame_size;
209 int len;
210 uint8_t frame[8192];
211 uint8_t *ptr;
213 ptr = frame;
214 frame_size = 0;
215 while (1) {
216 xgmac_read_desc(s, &bd, 0);
217 if ((bd.ctl_stat & 0x80000000) == 0) {
218 /* Run out of descriptors to transmit. */
219 break;
221 len = (bd.buffer1_size & 0xfff) + (bd.buffer2_size & 0xfff);
223 if ((bd.buffer1_size & 0xfff) > 2048) {
224 DEBUGF_BRK("qemu:%s:ERROR...ERROR...ERROR... -- "
225 "xgmac buffer 1 len on send > 2048 (0x%x)\n",
226 __func__, bd.buffer1_size & 0xfff);
228 if ((bd.buffer2_size & 0xfff) != 0) {
229 DEBUGF_BRK("qemu:%s:ERROR...ERROR...ERROR... -- "
230 "xgmac buffer 2 len on send != 0 (0x%x)\n",
231 __func__, bd.buffer2_size & 0xfff);
233 if (len >= sizeof(frame)) {
234 DEBUGF_BRK("qemu:%s: buffer overflow %d read into %zu "
235 "buffer\n" , __func__, len, sizeof(frame));
236 DEBUGF_BRK("qemu:%s: buffer1.size=%d; buffer2.size=%d\n",
237 __func__, bd.buffer1_size, bd.buffer2_size);
240 cpu_physical_memory_read(bd.buffer1_addr, ptr, len);
241 ptr += len;
242 frame_size += len;
243 if (bd.ctl_stat & 0x20000000) {
244 /* Last buffer in frame. */
245 qemu_send_packet(qemu_get_queue(s->nic), frame, len);
246 ptr = frame;
247 frame_size = 0;
248 s->regs[DMA_STATUS] |= DMA_STATUS_TI | DMA_STATUS_NIS;
250 bd.ctl_stat &= ~0x80000000;
251 /* Write back the modified descriptor. */
252 xgmac_write_desc(s, &bd, 0);
256 static void enet_update_irq(XgmacState *s)
258 int stat = s->regs[DMA_STATUS] & s->regs[DMA_INTR_ENA];
259 qemu_set_irq(s->sbd_irq, !!stat);
262 static uint64_t enet_read(void *opaque, hwaddr addr, unsigned size)
264 XgmacState *s = opaque;
265 uint64_t r = 0;
266 addr >>= 2;
268 switch (addr) {
269 case XGMAC_VERSION:
270 r = 0x1012;
271 break;
272 default:
273 if (addr < ARRAY_SIZE(s->regs)) {
274 r = s->regs[addr];
276 break;
278 return r;
281 static void enet_write(void *opaque, hwaddr addr,
282 uint64_t value, unsigned size)
284 XgmacState *s = opaque;
286 addr >>= 2;
287 switch (addr) {
288 case DMA_BUS_MODE:
289 s->regs[DMA_BUS_MODE] = value & ~0x1;
290 break;
291 case DMA_XMT_POLL_DEMAND:
292 xgmac_enet_send(s);
293 break;
294 case DMA_STATUS:
295 s->regs[DMA_STATUS] = s->regs[DMA_STATUS] & ~value;
296 break;
297 case DMA_RCV_BASE_ADDR:
298 s->regs[DMA_RCV_BASE_ADDR] = s->regs[DMA_CUR_RX_DESC_ADDR] = value;
299 break;
300 case DMA_TX_BASE_ADDR:
301 s->regs[DMA_TX_BASE_ADDR] = s->regs[DMA_CUR_TX_DESC_ADDR] = value;
302 break;
303 default:
304 if (addr < ARRAY_SIZE(s->regs)) {
305 s->regs[addr] = value;
307 break;
309 enet_update_irq(s);
312 static const MemoryRegionOps enet_mem_ops = {
313 .read = enet_read,
314 .write = enet_write,
315 .endianness = DEVICE_LITTLE_ENDIAN,
318 static int eth_can_rx(XgmacState *s)
320 /* RX enabled? */
321 return s->regs[DMA_CONTROL] & DMA_CONTROL_SR;
324 static ssize_t eth_rx(NetClientState *nc, const uint8_t *buf, size_t size)
326 XgmacState *s = qemu_get_nic_opaque(nc);
327 static const unsigned char sa_bcast[6] = {0xff, 0xff, 0xff,
328 0xff, 0xff, 0xff};
329 int unicast, broadcast, multicast;
330 struct desc bd;
331 ssize_t ret;
333 if (!eth_can_rx(s)) {
334 return -1;
336 unicast = ~buf[0] & 0x1;
337 broadcast = memcmp(buf, sa_bcast, 6) == 0;
338 multicast = !unicast && !broadcast;
339 if (size < 12) {
340 s->regs[DMA_STATUS] |= DMA_STATUS_RI | DMA_STATUS_NIS;
341 ret = -1;
342 goto out;
345 xgmac_read_desc(s, &bd, 1);
346 if ((bd.ctl_stat & 0x80000000) == 0) {
347 s->regs[DMA_STATUS] |= DMA_STATUS_RU | DMA_STATUS_AIS;
348 ret = size;
349 goto out;
352 cpu_physical_memory_write(bd.buffer1_addr, buf, size);
354 /* Add in the 4 bytes for crc (the real hw returns length incl crc) */
355 size += 4;
356 bd.ctl_stat = (size << 16) | 0x300;
357 xgmac_write_desc(s, &bd, 1);
359 s->stats.rx_bytes += size;
360 s->stats.rx++;
361 if (multicast) {
362 s->stats.rx_mcast++;
363 } else if (broadcast) {
364 s->stats.rx_bcast++;
367 s->regs[DMA_STATUS] |= DMA_STATUS_RI | DMA_STATUS_NIS;
368 ret = size;
370 out:
371 enet_update_irq(s);
372 return ret;
375 static NetClientInfo net_xgmac_enet_info = {
376 .type = NET_CLIENT_DRIVER_NIC,
377 .size = sizeof(NICState),
378 .receive = eth_rx,
381 static void xgmac_enet_realize(DeviceState *dev, Error **errp)
383 SysBusDevice *sbd = SYS_BUS_DEVICE(dev);
384 XgmacState *s = XGMAC(dev);
386 memory_region_init_io(&s->iomem, OBJECT(s), &enet_mem_ops, s,
387 "xgmac", 0x1000);
388 sysbus_init_mmio(sbd, &s->iomem);
389 sysbus_init_irq(sbd, &s->sbd_irq);
390 sysbus_init_irq(sbd, &s->pmt_irq);
391 sysbus_init_irq(sbd, &s->mci_irq);
393 qemu_macaddr_default_if_unset(&s->conf.macaddr);
394 s->nic = qemu_new_nic(&net_xgmac_enet_info, &s->conf,
395 object_get_typename(OBJECT(dev)), dev->id, s);
396 qemu_format_nic_info_str(qemu_get_queue(s->nic), s->conf.macaddr.a);
398 s->regs[XGMAC_ADDR_HIGH(0)] = (s->conf.macaddr.a[5] << 8) |
399 s->conf.macaddr.a[4];
400 s->regs[XGMAC_ADDR_LOW(0)] = (s->conf.macaddr.a[3] << 24) |
401 (s->conf.macaddr.a[2] << 16) |
402 (s->conf.macaddr.a[1] << 8) |
403 s->conf.macaddr.a[0];
406 static Property xgmac_properties[] = {
407 DEFINE_NIC_PROPERTIES(XgmacState, conf),
408 DEFINE_PROP_END_OF_LIST(),
411 static void xgmac_enet_class_init(ObjectClass *klass, void *data)
413 DeviceClass *dc = DEVICE_CLASS(klass);
415 dc->realize = xgmac_enet_realize;
416 dc->vmsd = &vmstate_xgmac;
417 dc->props = xgmac_properties;
420 static const TypeInfo xgmac_enet_info = {
421 .name = TYPE_XGMAC,
422 .parent = TYPE_SYS_BUS_DEVICE,
423 .instance_size = sizeof(XgmacState),
424 .class_init = xgmac_enet_class_init,
427 static void xgmac_enet_register_types(void)
429 type_register_static(&xgmac_enet_info);
432 type_init(xgmac_enet_register_types)