| /* |
| * IMX31 UARTS |
| * |
| * Copyright (c) 2008 OKL |
| * Originally Written by Hans Jiang |
| * Copyright (c) 2011 NICTA Pty Ltd. |
| * Updated by Jean-Christophe Dubois <jcd@tribudubois.net> |
| * |
| * This work is licensed under the terms of the GNU GPL, version 2 or later. |
| * See the COPYING file in the top-level directory. |
| * |
| * This is a `bare-bones' implementation of the IMX series serial ports. |
| * TODO: |
| * -- implement FIFOs. The real hardware has 32 word transmit |
| * and receive FIFOs; we currently use a 1-char buffer |
| * -- implement DMA |
| * -- implement BAUD-rate and modem lines, for when the backend |
| * is a real serial device. |
| */ |
| |
| #include "qemu/osdep.h" |
| #include "hw/char/imx_serial.h" |
| #include "hw/irq.h" |
| #include "hw/qdev-properties.h" |
| #include "hw/qdev-properties-system.h" |
| #include "migration/vmstate.h" |
| #include "qemu/log.h" |
| #include "qemu/module.h" |
| #include "qemu/fifo32.h" |
| |
| #ifndef DEBUG_IMX_UART |
| #define DEBUG_IMX_UART 0 |
| #endif |
| |
| #define DPRINTF(fmt, args...) \ |
| do { \ |
| if (DEBUG_IMX_UART) { \ |
| fprintf(stderr, "[%s]%s: " fmt , TYPE_IMX_SERIAL, \ |
| __func__, ##args); \ |
| } \ |
| } while (0) |
| |
| static const VMStateDescription vmstate_imx_serial = { |
| .name = TYPE_IMX_SERIAL, |
| .version_id = 3, |
| .minimum_version_id = 3, |
| .fields = (const VMStateField[]) { |
| VMSTATE_FIFO32(rx_fifo, IMXSerialState), |
| VMSTATE_TIMER(ageing_timer, IMXSerialState), |
| VMSTATE_UINT32(usr1, IMXSerialState), |
| VMSTATE_UINT32(usr2, IMXSerialState), |
| VMSTATE_UINT32(ucr1, IMXSerialState), |
| VMSTATE_UINT32(uts1, IMXSerialState), |
| VMSTATE_UINT32(onems, IMXSerialState), |
| VMSTATE_UINT32(ufcr, IMXSerialState), |
| VMSTATE_UINT32(ubmr, IMXSerialState), |
| VMSTATE_UINT32(ubrc, IMXSerialState), |
| VMSTATE_UINT32(ucr3, IMXSerialState), |
| VMSTATE_UINT32(ucr4, IMXSerialState), |
| VMSTATE_END_OF_LIST() |
| }, |
| }; |
| |
| static void imx_update(IMXSerialState *s) |
| { |
| uint32_t usr1; |
| uint32_t usr2; |
| uint32_t mask; |
| |
| /* |
| * Lucky for us TRDY and RRDY has the same offset in both USR1 and |
| * UCR1, so we can get away with something as simple as the |
| * following: |
| */ |
| usr1 = s->usr1 & s->ucr1 & (USR1_TRDY | USR1_RRDY); |
| /* |
| * Interrupt if AGTIM is set (ageing timer interrupt in RxFIFO) |
| */ |
| usr1 |= (s->ucr2 & UCR2_ATEN) ? (s->usr1 & USR1_AGTIM) : 0; |
| /* |
| * Bits that we want in USR2 are not as conveniently laid out, |
| * unfortunately. |
| */ |
| mask = (s->ucr1 & UCR1_TXMPTYEN) ? USR2_TXFE : 0; |
| /* |
| * TCEN and TXDC are both bit 3 |
| * ORE and OREN are both bit 1 |
| * RDR and DREN are both bit 0 |
| */ |
| mask |= s->ucr4 & (UCR4_WKEN | UCR4_TCEN | UCR4_DREN | UCR4_OREN); |
| |
| usr2 = s->usr2 & mask; |
| |
| qemu_set_irq(s->irq, usr1 || usr2); |
| } |
| |
| static void imx_serial_rx_fifo_push(IMXSerialState *s, uint32_t value) |
| { |
| uint32_t pushed_value = value; |
| if (fifo32_is_full(&s->rx_fifo)) { |
| /* Set ORE if FIFO is already full */ |
| s->usr2 |= USR2_ORE; |
| } else { |
| if (fifo32_num_used(&s->rx_fifo) == FIFO_SIZE - 1) { |
| /* Set OVRRUN on 32nd character in FIFO */ |
| pushed_value |= URXD_ERR | URXD_OVRRUN; |
| } |
| fifo32_push(&s->rx_fifo, pushed_value); |
| } |
| } |
| |
| static uint32_t imx_serial_rx_fifo_pop(IMXSerialState *s) |
| { |
| if (fifo32_is_empty(&s->rx_fifo)) { |
| return 0; |
| } |
| return fifo32_pop(&s->rx_fifo); |
| } |
| |
| static void imx_serial_rx_fifo_ageing_timer_int(void *opaque) |
| { |
| IMXSerialState *s = (IMXSerialState *) opaque; |
| s->usr1 |= USR1_AGTIM; |
| imx_update(s); |
| } |
| |
| static void imx_serial_rx_fifo_ageing_timer_restart(void *opaque) |
| { |
| /* |
| * Ageing timer starts ticking when |
| * RX FIFO is non empty and below trigger level. |
| * Timer is reset if new character is received or |
| * a FIFO read occurs. |
| * Timer triggers an interrupt when duration of |
| * 8 characters has passed (assuming 115200 baudrate). |
| */ |
| IMXSerialState *s = (IMXSerialState *) opaque; |
| |
| if (!(s->usr1 & USR1_RRDY) && !(s->uts1 & UTS1_RXEMPTY)) { |
| timer_mod_ns(&s->ageing_timer, |
| qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL) + AGE_DURATION_NS); |
| } else { |
| timer_del(&s->ageing_timer); |
| } |
| } |
| |
| static void imx_serial_reset(IMXSerialState *s) |
| { |
| |
| s->usr1 = USR1_TRDY | USR1_RXDS; |
| /* |
| * Fake attachment of a terminal: assert RTS. |
| */ |
| s->usr1 |= USR1_RTSS; |
| s->usr2 = USR2_TXFE | USR2_TXDC | USR2_DCDIN; |
| s->uts1 = UTS1_RXEMPTY | UTS1_TXEMPTY; |
| s->ucr1 = 0; |
| s->ucr2 = UCR2_SRST; |
| s->ucr3 = 0x700; |
| s->ubmr = 0; |
| s->ubrc = 4; |
| |
| fifo32_reset(&s->rx_fifo); |
| timer_del(&s->ageing_timer); |
| } |
| |
| static void imx_serial_reset_at_boot(DeviceState *dev) |
| { |
| IMXSerialState *s = IMX_SERIAL(dev); |
| |
| imx_serial_reset(s); |
| |
| /* |
| * enable the uart on boot, so messages from the linux decompressor |
| * are visible. On real hardware this is done by the boot rom |
| * before anything else is loaded. |
| */ |
| s->ucr1 = UCR1_UARTEN; |
| s->ucr2 = UCR2_TXEN; |
| |
| } |
| |
| static uint64_t imx_serial_read(void *opaque, hwaddr offset, |
| unsigned size) |
| { |
| IMXSerialState *s = (IMXSerialState *)opaque; |
| uint32_t c, rx_used; |
| uint8_t rxtl = s->ufcr & TL_MASK; |
| |
| DPRINTF("read(offset=0x%" HWADDR_PRIx ")\n", offset); |
| |
| switch (offset >> 2) { |
| case 0x0: /* URXD */ |
| c = imx_serial_rx_fifo_pop(s); |
| if (!(s->uts1 & UTS1_RXEMPTY)) { |
| /* Character is valid */ |
| c |= URXD_CHARRDY; |
| rx_used = fifo32_num_used(&s->rx_fifo); |
| /* Clear RRDY if below threshold */ |
| if (rx_used < rxtl) { |
| s->usr1 &= ~USR1_RRDY; |
| } |
| if (rx_used == 0) { |
| s->usr2 &= ~USR2_RDR; |
| s->uts1 |= UTS1_RXEMPTY; |
| } |
| imx_update(s); |
| imx_serial_rx_fifo_ageing_timer_restart(s); |
| qemu_chr_fe_accept_input(&s->chr); |
| } |
| return c; |
| |
| case 0x20: /* UCR1 */ |
| return s->ucr1; |
| |
| case 0x21: /* UCR2 */ |
| return s->ucr2; |
| |
| case 0x25: /* USR1 */ |
| return s->usr1; |
| |
| case 0x26: /* USR2 */ |
| return s->usr2; |
| |
| case 0x2A: /* BRM Modulator */ |
| return s->ubmr; |
| |
| case 0x2B: /* Baud Rate Count */ |
| return s->ubrc; |
| |
| case 0x2d: /* Test register */ |
| return s->uts1; |
| |
| case 0x24: /* UFCR */ |
| return s->ufcr; |
| |
| case 0x2c: |
| return s->onems; |
| |
| case 0x22: /* UCR3 */ |
| return s->ucr3; |
| |
| case 0x23: /* UCR4 */ |
| return s->ucr4; |
| |
| case 0x29: /* BRM Incremental */ |
| return 0x0; /* TODO */ |
| |
| default: |
| qemu_log_mask(LOG_GUEST_ERROR, "[%s]%s: Bad register at offset 0x%" |
| HWADDR_PRIx "\n", TYPE_IMX_SERIAL, __func__, offset); |
| return 0; |
| } |
| } |
| |
| static void imx_serial_write(void *opaque, hwaddr offset, |
| uint64_t value, unsigned size) |
| { |
| IMXSerialState *s = (IMXSerialState *)opaque; |
| Chardev *chr = qemu_chr_fe_get_driver(&s->chr); |
| unsigned char ch; |
| |
| DPRINTF("write(offset=0x%" HWADDR_PRIx ", value = 0x%x) to %s\n", |
| offset, (unsigned int)value, chr ? chr->label : "NODEV"); |
| |
| switch (offset >> 2) { |
| case 0x10: /* UTXD */ |
| ch = value; |
| if (s->ucr2 & UCR2_TXEN) { |
| /* XXX this blocks entire thread. Rewrite to use |
| * qemu_chr_fe_write and background I/O callbacks */ |
| qemu_chr_fe_write_all(&s->chr, &ch, 1); |
| s->usr1 &= ~USR1_TRDY; |
| s->usr2 &= ~USR2_TXDC; |
| imx_update(s); |
| s->usr1 |= USR1_TRDY; |
| s->usr2 |= USR2_TXDC; |
| imx_update(s); |
| } |
| break; |
| |
| case 0x20: /* UCR1 */ |
| s->ucr1 = value & 0xffff; |
| |
| DPRINTF("write(ucr1=%x)\n", (unsigned int)value); |
| |
| imx_update(s); |
| break; |
| |
| case 0x21: /* UCR2 */ |
| /* |
| * Only a few bits in control register 2 are implemented as yet. |
| * If it's intended to use a real serial device as a back-end, this |
| * register will have to be implemented more fully. |
| */ |
| if (!(value & UCR2_SRST)) { |
| imx_serial_reset(s); |
| imx_update(s); |
| value |= UCR2_SRST; |
| } |
| if (value & UCR2_RXEN) { |
| if (!(s->ucr2 & UCR2_RXEN)) { |
| qemu_chr_fe_accept_input(&s->chr); |
| } |
| } |
| s->ucr2 = value & 0xffff; |
| break; |
| |
| case 0x25: /* USR1 */ |
| value &= USR1_AWAKE | USR1_AIRINT | USR1_DTRD | USR1_AGTIM | |
| USR1_FRAMERR | USR1_ESCF | USR1_RTSD | USR1_PARTYER; |
| s->usr1 &= ~value; |
| break; |
| |
| case 0x26: /* USR2 */ |
| /* |
| * Writing 1 to some bits clears them; all other |
| * values are ignored |
| */ |
| value &= USR2_ADET | USR2_DTRF | USR2_IDLE | USR2_ACST | |
| USR2_RIDELT | USR2_IRINT | USR2_WAKE | |
| USR2_DCDDELT | USR2_RTSF | USR2_BRCD | USR2_ORE; |
| s->usr2 &= ~value; |
| break; |
| |
| /* |
| * Linux expects to see what it writes to these registers |
| * We don't currently alter the baud rate |
| */ |
| case 0x29: /* UBIR */ |
| s->ubrc = value & 0xffff; |
| break; |
| |
| case 0x2a: /* UBMR */ |
| s->ubmr = value & 0xffff; |
| break; |
| |
| case 0x2c: /* One ms reg */ |
| s->onems = value & 0xffff; |
| break; |
| |
| case 0x24: /* FIFO control register */ |
| s->ufcr = value & 0xffff; |
| break; |
| |
| case 0x22: /* UCR3 */ |
| s->ucr3 = value & 0xffff; |
| break; |
| |
| case 0x23: /* UCR4 */ |
| s->ucr4 = value & 0xffff; |
| imx_update(s); |
| break; |
| |
| case 0x2d: /* UTS1 */ |
| qemu_log_mask(LOG_UNIMP, "[%s]%s: Unimplemented reg 0x%" |
| HWADDR_PRIx "\n", TYPE_IMX_SERIAL, __func__, offset); |
| /* TODO */ |
| break; |
| |
| default: |
| qemu_log_mask(LOG_GUEST_ERROR, "[%s]%s: Bad register at offset 0x%" |
| HWADDR_PRIx "\n", TYPE_IMX_SERIAL, __func__, offset); |
| } |
| } |
| |
| static int imx_can_receive(void *opaque) |
| { |
| IMXSerialState *s = (IMXSerialState *)opaque; |
| return s->ucr2 & UCR2_RXEN && fifo32_num_used(&s->rx_fifo) < FIFO_SIZE; |
| } |
| |
| static void imx_put_data(void *opaque, uint32_t value) |
| { |
| IMXSerialState *s = (IMXSerialState *)opaque; |
| uint8_t rxtl = s->ufcr & TL_MASK; |
| |
| DPRINTF("received char\n"); |
| imx_serial_rx_fifo_push(s, value); |
| if (fifo32_num_used(&s->rx_fifo) >= rxtl) { |
| s->usr1 |= USR1_RRDY; |
| } |
| |
| imx_serial_rx_fifo_ageing_timer_restart(s); |
| |
| s->usr2 |= USR2_RDR; |
| s->uts1 &= ~UTS1_RXEMPTY; |
| if (value & URXD_BRK) { |
| s->usr2 |= USR2_BRCD; |
| } |
| imx_update(s); |
| } |
| |
| static void imx_receive(void *opaque, const uint8_t *buf, int size) |
| { |
| IMXSerialState *s = (IMXSerialState *)opaque; |
| |
| s->usr2 |= USR2_WAKE; |
| imx_put_data(opaque, *buf); |
| } |
| |
| static void imx_event(void *opaque, QEMUChrEvent event) |
| { |
| if (event == CHR_EVENT_BREAK) { |
| imx_put_data(opaque, URXD_BRK | URXD_FRMERR | URXD_ERR); |
| } |
| } |
| |
| |
| static const struct MemoryRegionOps imx_serial_ops = { |
| .read = imx_serial_read, |
| .write = imx_serial_write, |
| .endianness = DEVICE_NATIVE_ENDIAN, |
| }; |
| |
| static void imx_serial_realize(DeviceState *dev, Error **errp) |
| { |
| IMXSerialState *s = IMX_SERIAL(dev); |
| |
| fifo32_create(&s->rx_fifo, FIFO_SIZE); |
| timer_init_ns(&s->ageing_timer, QEMU_CLOCK_VIRTUAL, |
| imx_serial_rx_fifo_ageing_timer_int, s); |
| |
| DPRINTF("char dev for uart: %p\n", qemu_chr_fe_get_driver(&s->chr)); |
| |
| qemu_chr_fe_set_handlers(&s->chr, imx_can_receive, imx_receive, |
| imx_event, NULL, s, NULL, true); |
| } |
| |
| static void imx_serial_init(Object *obj) |
| { |
| SysBusDevice *sbd = SYS_BUS_DEVICE(obj); |
| IMXSerialState *s = IMX_SERIAL(obj); |
| |
| memory_region_init_io(&s->iomem, obj, &imx_serial_ops, s, |
| TYPE_IMX_SERIAL, 0x1000); |
| sysbus_init_mmio(sbd, &s->iomem); |
| sysbus_init_irq(sbd, &s->irq); |
| } |
| |
| static Property imx_serial_properties[] = { |
| DEFINE_PROP_CHR("chardev", IMXSerialState, chr), |
| DEFINE_PROP_END_OF_LIST(), |
| }; |
| |
| static void imx_serial_class_init(ObjectClass *klass, void *data) |
| { |
| DeviceClass *dc = DEVICE_CLASS(klass); |
| |
| dc->realize = imx_serial_realize; |
| dc->vmsd = &vmstate_imx_serial; |
| dc->reset = imx_serial_reset_at_boot; |
| set_bit(DEVICE_CATEGORY_INPUT, dc->categories); |
| dc->desc = "i.MX series UART"; |
| device_class_set_props(dc, imx_serial_properties); |
| } |
| |
| static const TypeInfo imx_serial_info = { |
| .name = TYPE_IMX_SERIAL, |
| .parent = TYPE_SYS_BUS_DEVICE, |
| .instance_size = sizeof(IMXSerialState), |
| .instance_init = imx_serial_init, |
| .class_init = imx_serial_class_init, |
| }; |
| |
| static void imx_serial_register_types(void) |
| { |
| type_register_static(&imx_serial_info); |
| } |
| |
| type_init(imx_serial_register_types) |