xref: /qemu/hw/char/sh_serial.c (revision f94bff1337ff525e2ff458b8e4cd57f9561acde3)
1 /*
2  * QEMU SCI/SCIF serial port emulation
3  *
4  * Copyright (c) 2007 Magnus Damm
5  *
6  * Based on serial.c - QEMU 16450 UART emulation
7  * Copyright (c) 2003-2004 Fabrice Bellard
8  *
9  * Permission is hereby granted, free of charge, to any person obtaining a copy
10  * of this software and associated documentation files (the "Software"), to deal
11  * in the Software without restriction, including without limitation the rights
12  * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
13  * copies of the Software, and to permit persons to whom the Software is
14  * furnished to do so, subject to the following conditions:
15  *
16  * The above copyright notice and this permission notice shall be included in
17  * all copies or substantial portions of the Software.
18  *
19  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
20  * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
22  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
23  * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
24  * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
25  * THE SOFTWARE.
26  */
27 
28 #include "qemu/osdep.h"
29 #include "hw/irq.h"
30 #include "hw/sh4/sh.h"
31 #include "chardev/char-fe.h"
32 #include "qapi/error.h"
33 #include "qemu/timer.h"
34 
35 //#define DEBUG_SERIAL
36 
37 #define SH_SERIAL_FLAG_TEND (1 << 0)
38 #define SH_SERIAL_FLAG_TDE  (1 << 1)
39 #define SH_SERIAL_FLAG_RDF  (1 << 2)
40 #define SH_SERIAL_FLAG_BRK  (1 << 3)
41 #define SH_SERIAL_FLAG_DR   (1 << 4)
42 
43 #define SH_RX_FIFO_LENGTH (16)
44 
45 typedef struct {
46     MemoryRegion iomem;
47     MemoryRegion iomem_p4;
48     MemoryRegion iomem_a7;
49     uint8_t smr;
50     uint8_t brr;
51     uint8_t scr;
52     uint8_t dr; /* ftdr / tdr */
53     uint8_t sr; /* fsr / ssr */
54     uint16_t fcr;
55     uint8_t sptr;
56 
57     uint8_t rx_fifo[SH_RX_FIFO_LENGTH]; /* frdr / rdr */
58     uint8_t rx_cnt;
59     uint8_t rx_tail;
60     uint8_t rx_head;
61 
62     int freq;
63     int feat;
64     int flags;
65     int rtrg;
66 
67     CharBackend chr;
68     QEMUTimer *fifo_timeout_timer;
69     uint64_t etu; /* Elementary Time Unit (ns) */
70 
71     qemu_irq eri;
72     qemu_irq rxi;
73     qemu_irq txi;
74     qemu_irq tei;
75     qemu_irq bri;
76 } sh_serial_state;
77 
78 static void sh_serial_clear_fifo(sh_serial_state *s)
79 {
80     memset(s->rx_fifo, 0, SH_RX_FIFO_LENGTH);
81     s->rx_cnt = 0;
82     s->rx_head = 0;
83     s->rx_tail = 0;
84 }
85 
86 static void sh_serial_write(void *opaque, hwaddr offs,
87                             uint64_t val, unsigned size)
88 {
89     sh_serial_state *s = opaque;
90     unsigned char ch;
91 
92 #ifdef DEBUG_SERIAL
93     printf("sh_serial: write offs=0x%02x val=0x%02x\n",
94            offs, val);
95 #endif
96     switch (offs) {
97     case 0x00: /* SMR */
98         s->smr = val & ((s->feat & SH_SERIAL_FEAT_SCIF) ? 0x7b : 0xff);
99         return;
100     case 0x04: /* BRR */
101         s->brr = val;
102         return;
103     case 0x08: /* SCR */
104         /* TODO : For SH7751, SCIF mask should be 0xfb. */
105         s->scr = val & ((s->feat & SH_SERIAL_FEAT_SCIF) ? 0xfa : 0xff);
106         if (!(val & (1 << 5)))
107             s->flags |= SH_SERIAL_FLAG_TEND;
108         if ((s->feat & SH_SERIAL_FEAT_SCIF) && s->txi) {
109             qemu_set_irq(s->txi, val & (1 << 7));
110         }
111         if (!(val & (1 << 6))) {
112             qemu_set_irq(s->rxi, 0);
113         }
114         return;
115     case 0x0c: /* FTDR / TDR */
116         if (qemu_chr_fe_backend_connected(&s->chr)) {
117             ch = val;
118             /*
119              * XXX this blocks entire thread. Rewrite to use
120              * qemu_chr_fe_write and background I/O callbacks
121              */
122             qemu_chr_fe_write_all(&s->chr, &ch, 1);
123         }
124         s->dr = val;
125         s->flags &= ~SH_SERIAL_FLAG_TDE;
126         return;
127 #if 0
128     case 0x14: /* FRDR / RDR */
129         ret = 0;
130         break;
131 #endif
132     }
133     if (s->feat & SH_SERIAL_FEAT_SCIF) {
134         switch (offs) {
135         case 0x10: /* FSR */
136             if (!(val & (1 << 6)))
137                 s->flags &= ~SH_SERIAL_FLAG_TEND;
138             if (!(val & (1 << 5)))
139                 s->flags &= ~SH_SERIAL_FLAG_TDE;
140             if (!(val & (1 << 4)))
141                 s->flags &= ~SH_SERIAL_FLAG_BRK;
142             if (!(val & (1 << 1)))
143                 s->flags &= ~SH_SERIAL_FLAG_RDF;
144             if (!(val & (1 << 0)))
145                 s->flags &= ~SH_SERIAL_FLAG_DR;
146 
147             if (!(val & (1 << 1)) || !(val & (1 << 0))) {
148                 if (s->rxi) {
149                     qemu_set_irq(s->rxi, 0);
150                 }
151             }
152             return;
153         case 0x18: /* FCR */
154             s->fcr = val;
155             switch ((val >> 6) & 3) {
156             case 0:
157                 s->rtrg = 1;
158                 break;
159             case 1:
160                 s->rtrg = 4;
161                 break;
162             case 2:
163                 s->rtrg = 8;
164                 break;
165             case 3:
166                 s->rtrg = 14;
167                 break;
168             }
169             if (val & (1 << 1)) {
170                 sh_serial_clear_fifo(s);
171                 s->sr &= ~(1 << 1);
172             }
173 
174             return;
175         case 0x20: /* SPTR */
176             s->sptr = val & 0xf3;
177             return;
178         case 0x24: /* LSR */
179             return;
180         }
181     } else {
182         switch (offs) {
183 #if 0
184         case 0x0c:
185             ret = s->dr;
186             break;
187         case 0x10:
188             ret = 0;
189             break;
190 #endif
191         case 0x1c:
192             s->sptr = val & 0x8f;
193             return;
194         }
195     }
196 
197     fprintf(stderr, "sh_serial: unsupported write to 0x%02"
198             HWADDR_PRIx "\n", offs);
199     abort();
200 }
201 
202 static uint64_t sh_serial_read(void *opaque, hwaddr offs,
203                                unsigned size)
204 {
205     sh_serial_state *s = opaque;
206     uint32_t ret = ~0;
207 
208 #if 0
209     switch (offs) {
210     case 0x00:
211         ret = s->smr;
212         break;
213     case 0x04:
214         ret = s->brr;
215         break;
216     case 0x08:
217         ret = s->scr;
218         break;
219     case 0x14:
220         ret = 0;
221         break;
222     }
223 #endif
224     if (s->feat & SH_SERIAL_FEAT_SCIF) {
225         switch (offs) {
226         case 0x00: /* SMR */
227             ret = s->smr;
228             break;
229         case 0x08: /* SCR */
230             ret = s->scr;
231             break;
232         case 0x10: /* FSR */
233             ret = 0;
234             if (s->flags & SH_SERIAL_FLAG_TEND)
235                 ret |= (1 << 6);
236             if (s->flags & SH_SERIAL_FLAG_TDE)
237                 ret |= (1 << 5);
238             if (s->flags & SH_SERIAL_FLAG_BRK)
239                 ret |= (1 << 4);
240             if (s->flags & SH_SERIAL_FLAG_RDF)
241                 ret |= (1 << 1);
242             if (s->flags & SH_SERIAL_FLAG_DR)
243                 ret |= (1 << 0);
244 
245             if (s->scr & (1 << 5))
246                 s->flags |= SH_SERIAL_FLAG_TDE | SH_SERIAL_FLAG_TEND;
247 
248             break;
249         case 0x14:
250             if (s->rx_cnt > 0) {
251                 ret = s->rx_fifo[s->rx_tail++];
252                 s->rx_cnt--;
253                 if (s->rx_tail == SH_RX_FIFO_LENGTH)
254                     s->rx_tail = 0;
255                 if (s->rx_cnt < s->rtrg)
256                     s->flags &= ~SH_SERIAL_FLAG_RDF;
257             }
258             break;
259         case 0x18:
260             ret = s->fcr;
261             break;
262         case 0x1c:
263             ret = s->rx_cnt;
264             break;
265         case 0x20:
266             ret = s->sptr;
267             break;
268         case 0x24:
269             ret = 0;
270             break;
271         }
272     } else {
273         switch (offs) {
274 #if 0
275         case 0x0c:
276             ret = s->dr;
277             break;
278         case 0x10:
279             ret = 0;
280             break;
281         case 0x14:
282             ret = s->rx_fifo[0];
283             break;
284 #endif
285         case 0x1c:
286             ret = s->sptr;
287             break;
288         }
289     }
290 #ifdef DEBUG_SERIAL
291     printf("sh_serial: read offs=0x%02x val=0x%x\n",
292            offs, ret);
293 #endif
294 
295     if (ret & ~((1 << 16) - 1)) {
296         fprintf(stderr, "sh_serial: unsupported read from 0x%02"
297                 HWADDR_PRIx "\n", offs);
298         abort();
299     }
300 
301     return ret;
302 }
303 
304 static int sh_serial_can_receive(sh_serial_state *s)
305 {
306     return s->scr & (1 << 4);
307 }
308 
309 static void sh_serial_receive_break(sh_serial_state *s)
310 {
311     if (s->feat & SH_SERIAL_FEAT_SCIF)
312         s->sr |= (1 << 4);
313 }
314 
315 static int sh_serial_can_receive1(void *opaque)
316 {
317     sh_serial_state *s = opaque;
318     return sh_serial_can_receive(s);
319 }
320 
321 static void sh_serial_timeout_int(void *opaque)
322 {
323     sh_serial_state *s = opaque;
324 
325     s->flags |= SH_SERIAL_FLAG_RDF;
326     if (s->scr & (1 << 6) && s->rxi) {
327         qemu_set_irq(s->rxi, 1);
328     }
329 }
330 
331 static void sh_serial_receive1(void *opaque, const uint8_t *buf, int size)
332 {
333     sh_serial_state *s = opaque;
334 
335     if (s->feat & SH_SERIAL_FEAT_SCIF) {
336         int i;
337         for (i = 0; i < size; i++) {
338             if (s->rx_cnt < SH_RX_FIFO_LENGTH) {
339                 s->rx_fifo[s->rx_head++] = buf[i];
340                 if (s->rx_head == SH_RX_FIFO_LENGTH) {
341                     s->rx_head = 0;
342                 }
343                 s->rx_cnt++;
344                 if (s->rx_cnt >= s->rtrg) {
345                     s->flags |= SH_SERIAL_FLAG_RDF;
346                     if (s->scr & (1 << 6) && s->rxi) {
347                         timer_del(s->fifo_timeout_timer);
348                         qemu_set_irq(s->rxi, 1);
349                     }
350                 } else {
351                     timer_mod(s->fifo_timeout_timer,
352                         qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL) + 15 * s->etu);
353                 }
354             }
355         }
356     } else {
357         s->rx_fifo[0] = buf[0];
358     }
359 }
360 
361 static void sh_serial_event(void *opaque, QEMUChrEvent event)
362 {
363     sh_serial_state *s = opaque;
364     if (event == CHR_EVENT_BREAK)
365         sh_serial_receive_break(s);
366 }
367 
368 static const MemoryRegionOps sh_serial_ops = {
369     .read = sh_serial_read,
370     .write = sh_serial_write,
371     .endianness = DEVICE_NATIVE_ENDIAN,
372 };
373 
374 void sh_serial_init(MemoryRegion *sysmem,
375                     hwaddr base, int feat,
376                     uint32_t freq, Chardev *chr,
377                     qemu_irq eri_source,
378                     qemu_irq rxi_source,
379                     qemu_irq txi_source,
380                     qemu_irq tei_source,
381                     qemu_irq bri_source)
382 {
383     sh_serial_state *s;
384 
385     s = g_malloc0(sizeof(sh_serial_state));
386 
387     s->feat = feat;
388     s->flags = SH_SERIAL_FLAG_TEND | SH_SERIAL_FLAG_TDE;
389     s->rtrg = 1;
390 
391     s->smr = 0;
392     s->brr = 0xff;
393     s->scr = 1 << 5; /* pretend that TX is enabled so early printk works */
394     s->sptr = 0;
395 
396     if (feat & SH_SERIAL_FEAT_SCIF) {
397         s->fcr = 0;
398     } else {
399         s->dr = 0xff;
400     }
401 
402     sh_serial_clear_fifo(s);
403 
404     memory_region_init_io(&s->iomem, NULL, &sh_serial_ops, s,
405                           "serial", 0x100000000ULL);
406 
407     memory_region_init_alias(&s->iomem_p4, NULL, "serial-p4", &s->iomem,
408                              0, 0x28);
409     memory_region_add_subregion(sysmem, P4ADDR(base), &s->iomem_p4);
410 
411     memory_region_init_alias(&s->iomem_a7, NULL, "serial-a7", &s->iomem,
412                              0, 0x28);
413     memory_region_add_subregion(sysmem, A7ADDR(base), &s->iomem_a7);
414 
415     if (chr) {
416         qemu_chr_fe_init(&s->chr, chr, &error_abort);
417         qemu_chr_fe_set_handlers(&s->chr, sh_serial_can_receive1,
418                                  sh_serial_receive1,
419                                  sh_serial_event, NULL, s, NULL, true);
420     }
421 
422     s->fifo_timeout_timer = timer_new_ns(QEMU_CLOCK_VIRTUAL,
423                                          sh_serial_timeout_int, s);
424     s->etu = NANOSECONDS_PER_SECOND / 9600;
425     s->eri = eri_source;
426     s->rxi = rxi_source;
427     s->txi = txi_source;
428     s->tei = tei_source;
429     s->bri = bri_source;
430 }
431