xref: /qemu/hw/char/bcm2835_aux.c (revision 5be5df72)
1 /*
2  * BCM2835 (Raspberry Pi / Pi 2) Aux block (mini UART and SPI).
3  * Copyright (c) 2015, Microsoft
4  * Written by Andrew Baumann
5  * Based on pl011.c, copyright terms below:
6  *
7  * Arm PrimeCell PL011 UART
8  *
9  * Copyright (c) 2006 CodeSourcery.
10  * Written by Paul Brook
11  *
12  * This code is licensed under the GPL.
13  *
14  * At present only the core UART functions (data path for tx/rx) are
15  * implemented. The following features/registers are unimplemented:
16  *  - Line/modem control
17  *  - Scratch register
18  *  - Extra control
19  *  - Baudrate
20  *  - SPI interfaces
21  */
22 
23 #include "qemu/osdep.h"
24 #include "hw/char/bcm2835_aux.h"
25 #include "qemu/log.h"
26 
27 #define AUX_IRQ         0x0
28 #define AUX_ENABLES     0x4
29 #define AUX_MU_IO_REG   0x40
30 #define AUX_MU_IER_REG  0x44
31 #define AUX_MU_IIR_REG  0x48
32 #define AUX_MU_LCR_REG  0x4c
33 #define AUX_MU_MCR_REG  0x50
34 #define AUX_MU_LSR_REG  0x54
35 #define AUX_MU_MSR_REG  0x58
36 #define AUX_MU_SCRATCH  0x5c
37 #define AUX_MU_CNTL_REG 0x60
38 #define AUX_MU_STAT_REG 0x64
39 #define AUX_MU_BAUD_REG 0x68
40 
41 /* bits in IER/IIR registers */
42 #define RX_INT  0x1
43 #define TX_INT  0x2
44 
45 static void bcm2835_aux_update(BCM2835AuxState *s)
46 {
47     /* signal an interrupt if either:
48      * 1. rx interrupt is enabled and we have a non-empty rx fifo, or
49      * 2. the tx interrupt is enabled (since we instantly drain the tx fifo)
50      */
51     s->iir = 0;
52     if ((s->ier & RX_INT) && s->read_count != 0) {
53         s->iir |= RX_INT;
54     }
55     if (s->ier & TX_INT) {
56         s->iir |= TX_INT;
57     }
58     qemu_set_irq(s->irq, s->iir != 0);
59 }
60 
61 static uint64_t bcm2835_aux_read(void *opaque, hwaddr offset, unsigned size)
62 {
63     BCM2835AuxState *s = opaque;
64     uint32_t c, res;
65 
66     switch (offset) {
67     case AUX_IRQ:
68         return s->iir != 0;
69 
70     case AUX_ENABLES:
71         return 1; /* mini UART permanently enabled */
72 
73     case AUX_MU_IO_REG:
74         /* "DLAB bit set means access baudrate register" is NYI */
75         c = s->read_fifo[s->read_pos];
76         if (s->read_count > 0) {
77             s->read_count--;
78             if (++s->read_pos == BCM2835_AUX_RX_FIFO_LEN) {
79                 s->read_pos = 0;
80             }
81         }
82         qemu_chr_fe_accept_input(&s->chr);
83         bcm2835_aux_update(s);
84         return c;
85 
86     case AUX_MU_IER_REG:
87         /* "DLAB bit set means access baudrate register" is NYI */
88         return 0xc0 | s->ier; /* FIFO enables always read 1 */
89 
90     case AUX_MU_IIR_REG:
91         res = 0xc0; /* FIFO enables */
92         /* The spec is unclear on what happens when both tx and rx
93          * interrupts are active, besides that this cannot occur. At
94          * present, we choose to prioritise the rx interrupt, since
95          * the tx fifo is always empty. */
96         if (s->read_count != 0) {
97             res |= 0x4;
98         } else {
99             res |= 0x2;
100         }
101         if (s->iir == 0) {
102             res |= 0x1;
103         }
104         return res;
105 
106     case AUX_MU_LCR_REG:
107         qemu_log_mask(LOG_UNIMP, "%s: AUX_MU_LCR_REG unsupported\n", __func__);
108         return 0;
109 
110     case AUX_MU_MCR_REG:
111         qemu_log_mask(LOG_UNIMP, "%s: AUX_MU_MCR_REG unsupported\n", __func__);
112         return 0;
113 
114     case AUX_MU_LSR_REG:
115         res = 0x60; /* tx idle, empty */
116         if (s->read_count != 0) {
117             res |= 0x1;
118         }
119         return res;
120 
121     case AUX_MU_MSR_REG:
122         qemu_log_mask(LOG_UNIMP, "%s: AUX_MU_MSR_REG unsupported\n", __func__);
123         return 0;
124 
125     case AUX_MU_SCRATCH:
126         qemu_log_mask(LOG_UNIMP, "%s: AUX_MU_SCRATCH unsupported\n", __func__);
127         return 0;
128 
129     case AUX_MU_CNTL_REG:
130         return 0x3; /* tx, rx enabled */
131 
132     case AUX_MU_STAT_REG:
133         res = 0x30e; /* space in the output buffer, empty tx fifo, idle tx/rx */
134         if (s->read_count > 0) {
135             res |= 0x1; /* data in input buffer */
136             assert(s->read_count < BCM2835_AUX_RX_FIFO_LEN);
137             res |= ((uint32_t)s->read_count) << 16; /* rx fifo fill level */
138         }
139         return res;
140 
141     case AUX_MU_BAUD_REG:
142         qemu_log_mask(LOG_UNIMP, "%s: AUX_MU_BAUD_REG unsupported\n", __func__);
143         return 0;
144 
145     default:
146         qemu_log_mask(LOG_GUEST_ERROR, "%s: Bad offset %"HWADDR_PRIx"\n",
147                       __func__, offset);
148         return 0;
149     }
150 }
151 
152 static void bcm2835_aux_write(void *opaque, hwaddr offset, uint64_t value,
153                               unsigned size)
154 {
155     BCM2835AuxState *s = opaque;
156     unsigned char ch;
157 
158     switch (offset) {
159     case AUX_ENABLES:
160         if (value != 1) {
161             qemu_log_mask(LOG_UNIMP, "%s: unsupported attempt to enable SPI "
162                           "or disable UART\n", __func__);
163         }
164         break;
165 
166     case AUX_MU_IO_REG:
167         /* "DLAB bit set means access baudrate register" is NYI */
168         ch = value;
169         /* XXX this blocks entire thread. Rewrite to use
170          * qemu_chr_fe_write and background I/O callbacks */
171         qemu_chr_fe_write_all(&s->chr, &ch, 1);
172         break;
173 
174     case AUX_MU_IER_REG:
175         /* "DLAB bit set means access baudrate register" is NYI */
176         s->ier = value & (TX_INT | RX_INT);
177         bcm2835_aux_update(s);
178         break;
179 
180     case AUX_MU_IIR_REG:
181         if (value & 0x2) {
182             s->read_count = 0;
183         }
184         break;
185 
186     case AUX_MU_LCR_REG:
187         qemu_log_mask(LOG_UNIMP, "%s: AUX_MU_LCR_REG unsupported\n", __func__);
188         break;
189 
190     case AUX_MU_MCR_REG:
191         qemu_log_mask(LOG_UNIMP, "%s: AUX_MU_MCR_REG unsupported\n", __func__);
192         break;
193 
194     case AUX_MU_SCRATCH:
195         qemu_log_mask(LOG_UNIMP, "%s: AUX_MU_SCRATCH unsupported\n", __func__);
196         break;
197 
198     case AUX_MU_CNTL_REG:
199         qemu_log_mask(LOG_UNIMP, "%s: AUX_MU_CNTL_REG unsupported\n", __func__);
200         break;
201 
202     case AUX_MU_BAUD_REG:
203         qemu_log_mask(LOG_UNIMP, "%s: AUX_MU_BAUD_REG unsupported\n", __func__);
204         break;
205 
206     default:
207         qemu_log_mask(LOG_GUEST_ERROR, "%s: Bad offset %"HWADDR_PRIx"\n",
208                       __func__, offset);
209     }
210 
211     bcm2835_aux_update(s);
212 }
213 
214 static int bcm2835_aux_can_receive(void *opaque)
215 {
216     BCM2835AuxState *s = opaque;
217 
218     return s->read_count < BCM2835_AUX_RX_FIFO_LEN;
219 }
220 
221 static void bcm2835_aux_put_fifo(void *opaque, uint8_t value)
222 {
223     BCM2835AuxState *s = opaque;
224     int slot;
225 
226     slot = s->read_pos + s->read_count;
227     if (slot >= BCM2835_AUX_RX_FIFO_LEN) {
228         slot -= BCM2835_AUX_RX_FIFO_LEN;
229     }
230     s->read_fifo[slot] = value;
231     s->read_count++;
232     if (s->read_count == BCM2835_AUX_RX_FIFO_LEN) {
233         /* buffer full */
234     }
235     bcm2835_aux_update(s);
236 }
237 
238 static void bcm2835_aux_receive(void *opaque, const uint8_t *buf, int size)
239 {
240     bcm2835_aux_put_fifo(opaque, *buf);
241 }
242 
243 static const MemoryRegionOps bcm2835_aux_ops = {
244     .read = bcm2835_aux_read,
245     .write = bcm2835_aux_write,
246     .endianness = DEVICE_NATIVE_ENDIAN,
247     .valid.min_access_size = 4,
248     .valid.max_access_size = 4,
249 };
250 
251 static const VMStateDescription vmstate_bcm2835_aux = {
252     .name = TYPE_BCM2835_AUX,
253     .version_id = 1,
254     .minimum_version_id = 1,
255     .fields = (VMStateField[]) {
256         VMSTATE_UINT8_ARRAY(read_fifo, BCM2835AuxState,
257                             BCM2835_AUX_RX_FIFO_LEN),
258         VMSTATE_UINT8(read_pos, BCM2835AuxState),
259         VMSTATE_UINT8(read_count, BCM2835AuxState),
260         VMSTATE_UINT8(ier, BCM2835AuxState),
261         VMSTATE_UINT8(iir, BCM2835AuxState),
262         VMSTATE_END_OF_LIST()
263     }
264 };
265 
266 static void bcm2835_aux_init(Object *obj)
267 {
268     SysBusDevice *sbd = SYS_BUS_DEVICE(obj);
269     BCM2835AuxState *s = BCM2835_AUX(obj);
270 
271     memory_region_init_io(&s->iomem, OBJECT(s), &bcm2835_aux_ops, s,
272                           TYPE_BCM2835_AUX, 0x100);
273     sysbus_init_mmio(sbd, &s->iomem);
274     sysbus_init_irq(sbd, &s->irq);
275 }
276 
277 static void bcm2835_aux_realize(DeviceState *dev, Error **errp)
278 {
279     BCM2835AuxState *s = BCM2835_AUX(dev);
280 
281     qemu_chr_fe_set_handlers(&s->chr, bcm2835_aux_can_receive,
282                              bcm2835_aux_receive, NULL, NULL, s, NULL, true);
283 }
284 
285 static Property bcm2835_aux_props[] = {
286     DEFINE_PROP_CHR("chardev", BCM2835AuxState, chr),
287     DEFINE_PROP_END_OF_LIST(),
288 };
289 
290 static void bcm2835_aux_class_init(ObjectClass *oc, void *data)
291 {
292     DeviceClass *dc = DEVICE_CLASS(oc);
293 
294     dc->realize = bcm2835_aux_realize;
295     dc->vmsd = &vmstate_bcm2835_aux;
296     set_bit(DEVICE_CATEGORY_INPUT, dc->categories);
297     dc->props = bcm2835_aux_props;
298 }
299 
300 static const TypeInfo bcm2835_aux_info = {
301     .name          = TYPE_BCM2835_AUX,
302     .parent        = TYPE_SYS_BUS_DEVICE,
303     .instance_size = sizeof(BCM2835AuxState),
304     .instance_init = bcm2835_aux_init,
305     .class_init    = bcm2835_aux_class_init,
306 };
307 
308 static void bcm2835_aux_register_types(void)
309 {
310     type_register_static(&bcm2835_aux_info);
311 }
312 
313 type_init(bcm2835_aux_register_types)
314