1 /* 2 * xlnx_dpdma.h 3 * 4 * Copyright (C) 2015 : GreenSocs Ltd 5 * http://www.greensocs.com/ , email: info@greensocs.com 6 * 7 * Developed by : 8 * Frederic Konrad <fred.konrad@greensocs.com> 9 * 10 * This program is free software; you can redistribute it and/or modify 11 * it under the terms of the GNU General Public License as published by 12 * the Free Software Foundation, either version 2 of the License, or 13 * (at your option) any later version. 14 * 15 * This program is distributed in the hope that it will be useful, 16 * but WITHOUT ANY WARRANTY; without even the implied warranty of 17 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18 * GNU General Public License for more details. 19 * 20 * You should have received a copy of the GNU General Public License along 21 * with this program; if not, see <http://www.gnu.org/licenses/>. 22 * 23 */ 24 25 #ifndef XLNX_DPDMA_H 26 #define XLNX_DPDMA_H 27 28 #include "hw/sysbus.h" 29 #include "ui/console.h" 30 #include "sysemu/dma.h" 31 #include "qom/object.h" 32 33 #define XLNX_DPDMA_REG_ARRAY_SIZE (0x1000 >> 2) 34 35 struct XlnxDPDMAState { 36 /*< private >*/ 37 SysBusDevice parent_obj; 38 /*< public >*/ 39 MemoryRegion iomem; 40 uint32_t registers[XLNX_DPDMA_REG_ARRAY_SIZE]; 41 uint8_t *data[6]; 42 bool operation_finished[6]; 43 qemu_irq irq; 44 }; 45 46 typedef struct XlnxDPDMAState XlnxDPDMAState; 47 48 #define TYPE_XLNX_DPDMA "xlnx.dpdma" 49 DECLARE_INSTANCE_CHECKER(XlnxDPDMAState, XLNX_DPDMA, 50 TYPE_XLNX_DPDMA) 51 52 /* 53 * xlnx_dpdma_start_operation: Start the operation on the specified channel. The 54 * DPDMA gets the current descriptor and retrieves 55 * data to the buffer specified by 56 * dpdma_set_host_data_location(). 57 * 58 * Returns The number of bytes transferred by the DPDMA 59 * or 0 if an error occurred. 60 * 61 * @s The DPDMA state. 62 * @channel The channel to start. 63 */ 64 size_t xlnx_dpdma_start_operation(XlnxDPDMAState *s, uint8_t channel, 65 bool one_desc); 66 67 /* 68 * xlnx_dpdma_set_host_data_location: Set the location in the host memory where 69 * to store the data out from the dma 70 * channel. 71 * 72 * @s The DPDMA state. 73 * @channel The channel associated to the pointer. 74 * @p The buffer where to store the data. 75 */ 76 /* XXX: add a maximum size arg and send an interrupt in case of overflow. */ 77 void xlnx_dpdma_set_host_data_location(XlnxDPDMAState *s, uint8_t channel, 78 void *p); 79 80 /* 81 * xlnx_dpdma_trigger_vsync_irq: Trigger a VSYNC IRQ when the display is 82 * updated. 83 * 84 * @s The DPDMA state. 85 */ 86 void xlnx_dpdma_trigger_vsync_irq(XlnxDPDMAState *s); 87 88 #endif /* XLNX_DPDMA_H */ 89