4 * Copyright (c) 2008 OKL
5 * Originally Written by Hans Jiang
6 * Copyright (c) 2011 NICTA Pty Ltd.
7 * Updated by Jean-Christophe Dubois <jcd@tribudubois.net>
9 * This work is licensed under the terms of the GNU GPL, version 2 or later.
10 * See the COPYING file in the top-level directory.
12 * This is a `bare-bones' implementation of the IMX series serial ports.
14 * -- implement FIFOs. The real hardware has 32 word transmit
15 * and receive FIFOs; we currently use a 1-char buffer
17 * -- implement BAUD-rate and modem lines, for when the backend
18 * is a real serial device.
21 #include "hw/char/imx_serial.h"
22 #include "sysemu/sysemu.h"
23 #include "sysemu/char.h"
25 //#define DEBUG_SERIAL 1
27 #define DPRINTF(fmt, args...) \
28 do { printf("%s: " fmt , TYPE_IMX_SERIAL, ##args); } while (0)
30 #define DPRINTF(fmt, args...) do {} while (0)
34 * Define to 1 for messages about attempts to
35 * access unimplemented registers or similar.
37 //#define DEBUG_IMPLEMENTATION 1
38 #ifdef DEBUG_IMPLEMENTATION
39 # define IPRINTF(fmt, args...) \
40 do { fprintf(stderr, "%s: " fmt, TYPE_IMX_SERIAL, ##args); } while (0)
42 # define IPRINTF(fmt, args...) do {} while (0)
45 static const VMStateDescription vmstate_imx_serial
= {
46 .name
= TYPE_IMX_SERIAL
,
48 .minimum_version_id
= 1,
49 .fields
= (VMStateField
[]) {
50 VMSTATE_INT32(readbuff
, IMXSerialState
),
51 VMSTATE_UINT32(usr1
, IMXSerialState
),
52 VMSTATE_UINT32(usr2
, IMXSerialState
),
53 VMSTATE_UINT32(ucr1
, IMXSerialState
),
54 VMSTATE_UINT32(uts1
, IMXSerialState
),
55 VMSTATE_UINT32(onems
, IMXSerialState
),
56 VMSTATE_UINT32(ufcr
, IMXSerialState
),
57 VMSTATE_UINT32(ubmr
, IMXSerialState
),
58 VMSTATE_UINT32(ubrc
, IMXSerialState
),
59 VMSTATE_UINT32(ucr3
, IMXSerialState
),
64 static void imx_update(IMXSerialState
*s
)
68 flags
= (s
->usr1
& s
->ucr1
) & (USR1_TRDY
|USR1_RRDY
);
69 if (!(s
->ucr1
& UCR1_TXMPTYEN
)) {
73 qemu_set_irq(s
->irq
, !!flags
);
76 static void imx_serial_reset(IMXSerialState
*s
)
79 s
->usr1
= USR1_TRDY
| USR1_RXDS
;
81 * Fake attachment of a terminal: assert RTS.
84 s
->usr2
= USR2_TXFE
| USR2_TXDC
| USR2_DCDIN
;
85 s
->uts1
= UTS1_RXEMPTY
| UTS1_TXEMPTY
;
91 s
->readbuff
= URXD_ERR
;
94 static void imx_serial_reset_at_boot(DeviceState
*dev
)
96 IMXSerialState
*s
= IMX_SERIAL(dev
);
101 * enable the uart on boot, so messages from the linux decompresser
102 * are visible. On real hardware this is done by the boot rom
103 * before anything else is loaded.
105 s
->ucr1
= UCR1_UARTEN
;
110 static uint64_t imx_serial_read(void *opaque
, hwaddr offset
,
113 IMXSerialState
*s
= (IMXSerialState
*)opaque
;
116 DPRINTF("read(offset=%x)\n", offset
>> 2);
117 switch (offset
>> 2) {
120 if (!(s
->uts1
& UTS1_RXEMPTY
)) {
121 /* Character is valid */
123 s
->usr1
&= ~USR1_RRDY
;
124 s
->usr2
&= ~USR2_RDR
;
125 s
->uts1
|= UTS1_RXEMPTY
;
128 qemu_chr_accept_input(s
->chr
);
133 case 0x20: /* UCR1 */
136 case 0x21: /* UCR2 */
139 case 0x25: /* USR1 */
142 case 0x26: /* USR2 */
145 case 0x2A: /* BRM Modulator */
148 case 0x2B: /* Baud Rate Count */
151 case 0x2d: /* Test register */
154 case 0x24: /* UFCR */
160 case 0x22: /* UCR3 */
163 case 0x23: /* UCR4 */
164 case 0x29: /* BRM Incremental */
165 return 0x0; /* TODO */
168 IPRINTF("%s: bad offset: 0x%x\n", __func__
, (int)offset
);
173 static void imx_serial_write(void *opaque
, hwaddr offset
,
174 uint64_t value
, unsigned size
)
176 IMXSerialState
*s
= (IMXSerialState
*)opaque
;
179 DPRINTF("write(offset=%x, value = %x) to %s\n",
181 (unsigned int)value
, s
->chr
? s
->chr
->label
: "NODEV");
183 switch (offset
>> 2) {
184 case 0x10: /* UTXD */
186 if (s
->ucr2
& UCR2_TXEN
) {
188 qemu_chr_fe_write(s
->chr
, &ch
, 1);
190 s
->usr1
&= ~USR1_TRDY
;
192 s
->usr1
|= USR1_TRDY
;
197 case 0x20: /* UCR1 */
198 s
->ucr1
= value
& 0xffff;
199 DPRINTF("write(ucr1=%x)\n", (unsigned int)value
);
203 case 0x21: /* UCR2 */
205 * Only a few bits in control register 2 are implemented as yet.
206 * If it's intended to use a real serial device as a back-end, this
207 * register will have to be implemented more fully.
209 if (!(value
& UCR2_SRST
)) {
214 if (value
& UCR2_RXEN
) {
215 if (!(s
->ucr2
& UCR2_RXEN
)) {
217 qemu_chr_accept_input(s
->chr
);
221 s
->ucr2
= value
& 0xffff;
224 case 0x25: /* USR1 */
225 value
&= USR1_AWAKE
| USR1_AIRINT
| USR1_DTRD
| USR1_AGTIM
|
226 USR1_FRAMERR
| USR1_ESCF
| USR1_RTSD
| USR1_PARTYER
;
230 case 0x26: /* USR2 */
232 * Writing 1 to some bits clears them; all other
235 value
&= USR2_ADET
| USR2_DTRF
| USR2_IDLE
| USR2_ACST
|
236 USR2_RIDELT
| USR2_IRINT
| USR2_WAKE
|
237 USR2_DCDDELT
| USR2_RTSF
| USR2_BRCD
| USR2_ORE
;
242 * Linux expects to see what it writes to these registers
243 * We don't currently alter the baud rate
245 case 0x29: /* UBIR */
246 s
->ubrc
= value
& 0xffff;
249 case 0x2a: /* UBMR */
250 s
->ubmr
= value
& 0xffff;
253 case 0x2c: /* One ms reg */
254 s
->onems
= value
& 0xffff;
257 case 0x24: /* FIFO control register */
258 s
->ufcr
= value
& 0xffff;
261 case 0x22: /* UCR3 */
262 s
->ucr3
= value
& 0xffff;
265 case 0x2d: /* UTS1 */
266 case 0x23: /* UCR4 */
267 IPRINTF("Unimplemented Register %x written to\n", offset
>> 2);
272 IPRINTF("%s: Bad offset 0x%x\n", __func__
, (int)offset
);
276 static int imx_can_receive(void *opaque
)
278 IMXSerialState
*s
= (IMXSerialState
*)opaque
;
279 return !(s
->usr1
& USR1_RRDY
);
282 static void imx_put_data(void *opaque
, uint32_t value
)
284 IMXSerialState
*s
= (IMXSerialState
*)opaque
;
285 DPRINTF("received char\n");
286 s
->usr1
|= USR1_RRDY
;
288 s
->uts1
&= ~UTS1_RXEMPTY
;
293 static void imx_receive(void *opaque
, const uint8_t *buf
, int size
)
295 imx_put_data(opaque
, *buf
);
298 static void imx_event(void *opaque
, int event
)
300 if (event
== CHR_EVENT_BREAK
) {
301 imx_put_data(opaque
, URXD_BRK
);
306 static const struct MemoryRegionOps imx_serial_ops
= {
307 .read
= imx_serial_read
,
308 .write
= imx_serial_write
,
309 .endianness
= DEVICE_NATIVE_ENDIAN
,
312 static void imx_serial_realize(DeviceState
*dev
, Error
**errp
)
314 IMXSerialState
*s
= IMX_SERIAL(dev
);
317 qemu_chr_add_handlers(s
->chr
, imx_can_receive
, imx_receive
,
320 DPRINTF("No char dev for uart at 0x%lx\n",
321 (unsigned long)s
->iomem
.ram_addr
);
325 static void imx_serial_init(Object
*obj
)
327 SysBusDevice
*sbd
= SYS_BUS_DEVICE(obj
);
328 IMXSerialState
*s
= IMX_SERIAL(obj
);
330 memory_region_init_io(&s
->iomem
, obj
, &imx_serial_ops
, s
,
331 TYPE_IMX_SERIAL
, 0x1000);
332 sysbus_init_mmio(sbd
, &s
->iomem
);
333 sysbus_init_irq(sbd
, &s
->irq
);
336 static Property imx_serial_properties
[] = {
337 DEFINE_PROP_CHR("chardev", IMXSerialState
, chr
),
338 DEFINE_PROP_END_OF_LIST(),
341 static void imx_serial_class_init(ObjectClass
*klass
, void *data
)
343 DeviceClass
*dc
= DEVICE_CLASS(klass
);
345 dc
->realize
= imx_serial_realize
;
346 dc
->vmsd
= &vmstate_imx_serial
;
347 dc
->reset
= imx_serial_reset_at_boot
;
348 set_bit(DEVICE_CATEGORY_INPUT
, dc
->categories
);
349 dc
->desc
= "i.MX series UART";
350 dc
->props
= imx_serial_properties
;
353 static const TypeInfo imx_serial_info
= {
354 .name
= TYPE_IMX_SERIAL
,
355 .parent
= TYPE_SYS_BUS_DEVICE
,
356 .instance_size
= sizeof(IMXSerialState
),
357 .instance_init
= imx_serial_init
,
358 .class_init
= imx_serial_class_init
,
361 static void imx_serial_register_types(void)
363 type_register_static(&imx_serial_info
);
366 type_init(imx_serial_register_types
)