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 "qemu/osdep.h"
22 #include "hw/char/imx_serial.h"
23 #include "sysemu/sysemu.h"
25 #include "qemu/module.h"
27 #ifndef DEBUG_IMX_UART
28 #define DEBUG_IMX_UART 0
31 #define DPRINTF(fmt, args...) \
33 if (DEBUG_IMX_UART) { \
34 fprintf(stderr, "[%s]%s: " fmt , TYPE_IMX_SERIAL, \
39 static const VMStateDescription vmstate_imx_serial
= {
40 .name
= TYPE_IMX_SERIAL
,
42 .minimum_version_id
= 2,
43 .fields
= (VMStateField
[]) {
44 VMSTATE_INT32(readbuff
, IMXSerialState
),
45 VMSTATE_UINT32(usr1
, IMXSerialState
),
46 VMSTATE_UINT32(usr2
, IMXSerialState
),
47 VMSTATE_UINT32(ucr1
, IMXSerialState
),
48 VMSTATE_UINT32(uts1
, IMXSerialState
),
49 VMSTATE_UINT32(onems
, IMXSerialState
),
50 VMSTATE_UINT32(ufcr
, IMXSerialState
),
51 VMSTATE_UINT32(ubmr
, IMXSerialState
),
52 VMSTATE_UINT32(ubrc
, IMXSerialState
),
53 VMSTATE_UINT32(ucr3
, IMXSerialState
),
54 VMSTATE_UINT32(ucr4
, IMXSerialState
),
59 static void imx_update(IMXSerialState
*s
)
66 * Lucky for us TRDY and RRDY has the same offset in both USR1 and
67 * UCR1, so we can get away with something as simple as the
70 usr1
= s
->usr1
& s
->ucr1
& (USR1_TRDY
| USR1_RRDY
);
72 * Bits that we want in USR2 are not as conveniently laid out,
75 mask
= (s
->ucr1
& UCR1_TXMPTYEN
) ? USR2_TXFE
: 0;
77 * TCEN and TXDC are both bit 3
78 * RDR and DREN are both bit 0
80 mask
|= s
->ucr4
& (UCR4_TCEN
| UCR4_DREN
);
82 usr2
= s
->usr2
& mask
;
84 qemu_set_irq(s
->irq
, usr1
|| usr2
);
87 static void imx_serial_reset(IMXSerialState
*s
)
90 s
->usr1
= USR1_TRDY
| USR1_RXDS
;
92 * Fake attachment of a terminal: assert RTS.
95 s
->usr2
= USR2_TXFE
| USR2_TXDC
| USR2_DCDIN
;
96 s
->uts1
= UTS1_RXEMPTY
| UTS1_TXEMPTY
;
102 s
->readbuff
= URXD_ERR
;
105 static void imx_serial_reset_at_boot(DeviceState
*dev
)
107 IMXSerialState
*s
= IMX_SERIAL(dev
);
112 * enable the uart on boot, so messages from the linux decompresser
113 * are visible. On real hardware this is done by the boot rom
114 * before anything else is loaded.
116 s
->ucr1
= UCR1_UARTEN
;
121 static uint64_t imx_serial_read(void *opaque
, hwaddr offset
,
124 IMXSerialState
*s
= (IMXSerialState
*)opaque
;
127 DPRINTF("read(offset=0x%" HWADDR_PRIx
")\n", offset
);
129 switch (offset
>> 2) {
132 if (!(s
->uts1
& UTS1_RXEMPTY
)) {
133 /* Character is valid */
135 s
->usr1
&= ~USR1_RRDY
;
136 s
->usr2
&= ~USR2_RDR
;
137 s
->uts1
|= UTS1_RXEMPTY
;
139 qemu_chr_fe_accept_input(&s
->chr
);
143 case 0x20: /* UCR1 */
146 case 0x21: /* UCR2 */
149 case 0x25: /* USR1 */
152 case 0x26: /* USR2 */
155 case 0x2A: /* BRM Modulator */
158 case 0x2B: /* Baud Rate Count */
161 case 0x2d: /* Test register */
164 case 0x24: /* UFCR */
170 case 0x22: /* UCR3 */
173 case 0x23: /* UCR4 */
176 case 0x29: /* BRM Incremental */
177 return 0x0; /* TODO */
180 qemu_log_mask(LOG_GUEST_ERROR
, "[%s]%s: Bad register at offset 0x%"
181 HWADDR_PRIx
"\n", TYPE_IMX_SERIAL
, __func__
, offset
);
186 static void imx_serial_write(void *opaque
, hwaddr offset
,
187 uint64_t value
, unsigned size
)
189 IMXSerialState
*s
= (IMXSerialState
*)opaque
;
190 Chardev
*chr
= qemu_chr_fe_get_driver(&s
->chr
);
193 DPRINTF("write(offset=0x%" HWADDR_PRIx
", value = 0x%x) to %s\n",
194 offset
, (unsigned int)value
, chr
? chr
->label
: "NODEV");
196 switch (offset
>> 2) {
197 case 0x10: /* UTXD */
199 if (s
->ucr2
& UCR2_TXEN
) {
200 /* XXX this blocks entire thread. Rewrite to use
201 * qemu_chr_fe_write and background I/O callbacks */
202 qemu_chr_fe_write_all(&s
->chr
, &ch
, 1);
203 s
->usr1
&= ~USR1_TRDY
;
204 s
->usr2
&= ~USR2_TXDC
;
206 s
->usr1
|= USR1_TRDY
;
207 s
->usr2
|= USR2_TXDC
;
212 case 0x20: /* UCR1 */
213 s
->ucr1
= value
& 0xffff;
215 DPRINTF("write(ucr1=%x)\n", (unsigned int)value
);
220 case 0x21: /* UCR2 */
222 * Only a few bits in control register 2 are implemented as yet.
223 * If it's intended to use a real serial device as a back-end, this
224 * register will have to be implemented more fully.
226 if (!(value
& UCR2_SRST
)) {
231 if (value
& UCR2_RXEN
) {
232 if (!(s
->ucr2
& UCR2_RXEN
)) {
233 qemu_chr_fe_accept_input(&s
->chr
);
236 s
->ucr2
= value
& 0xffff;
239 case 0x25: /* USR1 */
240 value
&= USR1_AWAKE
| USR1_AIRINT
| USR1_DTRD
| USR1_AGTIM
|
241 USR1_FRAMERR
| USR1_ESCF
| USR1_RTSD
| USR1_PARTYER
;
245 case 0x26: /* USR2 */
247 * Writing 1 to some bits clears them; all other
250 value
&= USR2_ADET
| USR2_DTRF
| USR2_IDLE
| USR2_ACST
|
251 USR2_RIDELT
| USR2_IRINT
| USR2_WAKE
|
252 USR2_DCDDELT
| USR2_RTSF
| USR2_BRCD
| USR2_ORE
;
257 * Linux expects to see what it writes to these registers
258 * We don't currently alter the baud rate
260 case 0x29: /* UBIR */
261 s
->ubrc
= value
& 0xffff;
264 case 0x2a: /* UBMR */
265 s
->ubmr
= value
& 0xffff;
268 case 0x2c: /* One ms reg */
269 s
->onems
= value
& 0xffff;
272 case 0x24: /* FIFO control register */
273 s
->ufcr
= value
& 0xffff;
276 case 0x22: /* UCR3 */
277 s
->ucr3
= value
& 0xffff;
280 case 0x23: /* UCR4 */
281 s
->ucr4
= value
& 0xffff;
285 case 0x2d: /* UTS1 */
286 qemu_log_mask(LOG_UNIMP
, "[%s]%s: Unimplemented reg 0x%"
287 HWADDR_PRIx
"\n", TYPE_IMX_SERIAL
, __func__
, offset
);
292 qemu_log_mask(LOG_GUEST_ERROR
, "[%s]%s: Bad register at offset 0x%"
293 HWADDR_PRIx
"\n", TYPE_IMX_SERIAL
, __func__
, offset
);
297 static int imx_can_receive(void *opaque
)
299 IMXSerialState
*s
= (IMXSerialState
*)opaque
;
300 return !(s
->usr1
& USR1_RRDY
);
303 static void imx_put_data(void *opaque
, uint32_t value
)
305 IMXSerialState
*s
= (IMXSerialState
*)opaque
;
307 DPRINTF("received char\n");
309 s
->usr1
|= USR1_RRDY
;
311 s
->uts1
&= ~UTS1_RXEMPTY
;
313 if (value
& URXD_BRK
) {
314 s
->usr2
|= USR2_BRCD
;
319 static void imx_receive(void *opaque
, const uint8_t *buf
, int size
)
321 imx_put_data(opaque
, *buf
);
324 static void imx_event(void *opaque
, int event
)
326 if (event
== CHR_EVENT_BREAK
) {
327 imx_put_data(opaque
, URXD_BRK
| URXD_FRMERR
| URXD_ERR
);
332 static const struct MemoryRegionOps imx_serial_ops
= {
333 .read
= imx_serial_read
,
334 .write
= imx_serial_write
,
335 .endianness
= DEVICE_NATIVE_ENDIAN
,
338 static void imx_serial_realize(DeviceState
*dev
, Error
**errp
)
340 IMXSerialState
*s
= IMX_SERIAL(dev
);
342 DPRINTF("char dev for uart: %p\n", qemu_chr_fe_get_driver(&s
->chr
));
344 qemu_chr_fe_set_handlers(&s
->chr
, imx_can_receive
, imx_receive
,
345 imx_event
, NULL
, s
, NULL
, true);
348 static void imx_serial_init(Object
*obj
)
350 SysBusDevice
*sbd
= SYS_BUS_DEVICE(obj
);
351 IMXSerialState
*s
= IMX_SERIAL(obj
);
353 memory_region_init_io(&s
->iomem
, obj
, &imx_serial_ops
, s
,
354 TYPE_IMX_SERIAL
, 0x1000);
355 sysbus_init_mmio(sbd
, &s
->iomem
);
356 sysbus_init_irq(sbd
, &s
->irq
);
359 static Property imx_serial_properties
[] = {
360 DEFINE_PROP_CHR("chardev", IMXSerialState
, chr
),
361 DEFINE_PROP_END_OF_LIST(),
364 static void imx_serial_class_init(ObjectClass
*klass
, void *data
)
366 DeviceClass
*dc
= DEVICE_CLASS(klass
);
368 dc
->realize
= imx_serial_realize
;
369 dc
->vmsd
= &vmstate_imx_serial
;
370 dc
->reset
= imx_serial_reset_at_boot
;
371 set_bit(DEVICE_CATEGORY_INPUT
, dc
->categories
);
372 dc
->desc
= "i.MX series UART";
373 dc
->props
= imx_serial_properties
;
376 static const TypeInfo imx_serial_info
= {
377 .name
= TYPE_IMX_SERIAL
,
378 .parent
= TYPE_SYS_BUS_DEVICE
,
379 .instance_size
= sizeof(IMXSerialState
),
380 .instance_init
= imx_serial_init
,
381 .class_init
= imx_serial_class_init
,
384 static void imx_serial_register_types(void)
386 type_register_static(&imx_serial_info
);
389 type_init(imx_serial_register_types
)