1 /* 2 * Copyright (c) 2009 Laurent Vivier 3 * 4 * Permission is hereby granted, free of charge, to any person obtaining a copy 5 * of this software and associated documentation files (the "Software"), to deal 6 * in the Software without restriction, including without limitation the rights 7 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 8 * copies of the Software, and to permit persons to whom the Software is 9 * furnished to do so, subject to the following conditions: 10 * 11 * The above copyright notice and this permission notice shall be included in 12 * all copies or substantial portions of the Software. 13 * 14 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 15 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 16 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 17 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 18 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 19 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 20 * THE SOFTWARE. 21 */ 22 23 #ifndef HW_MAC_DBDMA_H 24 #define HW_MAC_DBDMA_H 25 26 #include "exec/memory.h" 27 #include "qemu/iov.h" 28 #include "sysemu/dma.h" 29 #include "hw/sysbus.h" 30 31 typedef struct DBDMA_io DBDMA_io; 32 33 typedef void (*DBDMA_flush)(DBDMA_io *io); 34 typedef void (*DBDMA_rw)(DBDMA_io *io); 35 typedef void (*DBDMA_end)(DBDMA_io *io); 36 struct DBDMA_io { 37 void *opaque; 38 void *channel; 39 hwaddr addr; 40 int len; 41 int is_last; 42 int is_dma_out; 43 DBDMA_end dma_end; 44 /* DMA is in progress, don't start another one */ 45 bool processing; 46 /* DMA request */ 47 void *dma_mem; 48 dma_addr_t dma_len; 49 DMADirection dir; 50 }; 51 52 /* 53 * DBDMA control/status registers. All little-endian. 54 */ 55 56 #define DBDMA_CONTROL 0x00 57 #define DBDMA_STATUS 0x01 58 #define DBDMA_CMDPTR_HI 0x02 59 #define DBDMA_CMDPTR_LO 0x03 60 #define DBDMA_INTR_SEL 0x04 61 #define DBDMA_BRANCH_SEL 0x05 62 #define DBDMA_WAIT_SEL 0x06 63 #define DBDMA_XFER_MODE 0x07 64 #define DBDMA_DATA2PTR_HI 0x08 65 #define DBDMA_DATA2PTR_LO 0x09 66 #define DBDMA_RES1 0x0A 67 #define DBDMA_ADDRESS_HI 0x0B 68 #define DBDMA_BRANCH_ADDR_HI 0x0C 69 #define DBDMA_RES2 0x0D 70 #define DBDMA_RES3 0x0E 71 #define DBDMA_RES4 0x0F 72 73 #define DBDMA_REGS 16 74 #define DBDMA_SIZE (DBDMA_REGS * sizeof(uint32_t)) 75 76 #define DBDMA_CHANNEL_SHIFT 7 77 #define DBDMA_CHANNEL_SIZE (1 << DBDMA_CHANNEL_SHIFT) 78 79 #define DBDMA_CHANNELS (0x1000 >> DBDMA_CHANNEL_SHIFT) 80 81 /* Bits in control and status registers */ 82 83 #define RUN 0x8000 84 #define PAUSE 0x4000 85 #define FLUSH 0x2000 86 #define WAKE 0x1000 87 #define DEAD 0x0800 88 #define ACTIVE 0x0400 89 #define BT 0x0100 90 #define DEVSTAT 0x00ff 91 92 /* 93 * DBDMA command structure. These fields are all little-endian! 94 */ 95 96 typedef struct dbdma_cmd { 97 uint16_t req_count; /* requested byte transfer count */ 98 uint16_t command; /* command word (has bit-fields) */ 99 uint32_t phy_addr; /* physical data address */ 100 uint32_t cmd_dep; /* command-dependent field */ 101 uint16_t res_count; /* residual count after completion */ 102 uint16_t xfer_status; /* transfer status */ 103 } dbdma_cmd; 104 105 /* DBDMA command values in command field */ 106 107 #define COMMAND_MASK 0xf000 108 #define OUTPUT_MORE 0x0000 /* transfer memory data to stream */ 109 #define OUTPUT_LAST 0x1000 /* ditto followed by end marker */ 110 #define INPUT_MORE 0x2000 /* transfer stream data to memory */ 111 #define INPUT_LAST 0x3000 /* ditto, expect end marker */ 112 #define STORE_WORD 0x4000 /* write word (4 bytes) to device reg */ 113 #define LOAD_WORD 0x5000 /* read word (4 bytes) from device reg */ 114 #define DBDMA_NOP 0x6000 /* do nothing */ 115 #define DBDMA_STOP 0x7000 /* suspend processing */ 116 117 /* Key values in command field */ 118 119 #define KEY_MASK 0x0700 120 #define KEY_STREAM0 0x0000 /* usual data stream */ 121 #define KEY_STREAM1 0x0100 /* control/status stream */ 122 #define KEY_STREAM2 0x0200 /* device-dependent stream */ 123 #define KEY_STREAM3 0x0300 /* device-dependent stream */ 124 #define KEY_STREAM4 0x0400 /* reserved */ 125 #define KEY_REGS 0x0500 /* device register space */ 126 #define KEY_SYSTEM 0x0600 /* system memory-mapped space */ 127 #define KEY_DEVICE 0x0700 /* device memory-mapped space */ 128 129 /* Interrupt control values in command field */ 130 131 #define INTR_MASK 0x0030 132 #define INTR_NEVER 0x0000 /* don't interrupt */ 133 #define INTR_IFSET 0x0010 /* intr if condition bit is 1 */ 134 #define INTR_IFCLR 0x0020 /* intr if condition bit is 0 */ 135 #define INTR_ALWAYS 0x0030 /* always interrupt */ 136 137 /* Branch control values in command field */ 138 139 #define BR_MASK 0x000c 140 #define BR_NEVER 0x0000 /* don't branch */ 141 #define BR_IFSET 0x0004 /* branch if condition bit is 1 */ 142 #define BR_IFCLR 0x0008 /* branch if condition bit is 0 */ 143 #define BR_ALWAYS 0x000c /* always branch */ 144 145 /* Wait control values in command field */ 146 147 #define WAIT_MASK 0x0003 148 #define WAIT_NEVER 0x0000 /* don't wait */ 149 #define WAIT_IFSET 0x0001 /* wait if condition bit is 1 */ 150 #define WAIT_IFCLR 0x0002 /* wait if condition bit is 0 */ 151 #define WAIT_ALWAYS 0x0003 /* always wait */ 152 153 typedef struct DBDMA_channel { 154 int channel; 155 uint32_t regs[DBDMA_REGS]; 156 qemu_irq irq; 157 DBDMA_io io; 158 DBDMA_rw rw; 159 DBDMA_flush flush; 160 dbdma_cmd current; 161 } DBDMA_channel; 162 163 typedef struct { 164 SysBusDevice parent_obj; 165 166 MemoryRegion mem; 167 DBDMA_channel channels[DBDMA_CHANNELS]; 168 QEMUBH *bh; 169 } DBDMAState; 170 171 /* Externally callable functions */ 172 173 void DBDMA_register_channel(void *dbdma, int nchan, qemu_irq irq, 174 DBDMA_rw rw, DBDMA_flush flush, 175 void *opaque); 176 void DBDMA_kick(DBDMAState *dbdma); 177 178 #define TYPE_MAC_DBDMA "mac-dbdma" 179 #define MAC_DBDMA(obj) OBJECT_CHECK(DBDMAState, (obj), TYPE_MAC_DBDMA) 180 181 #endif 182