xref: /qemu/hw/rtc/pl031.c (revision 19f9c044)
1 /*
2  * ARM AMBA PrimeCell PL031 RTC
3  *
4  * Copyright (c) 2007 CodeSourcery
5  *
6  * This file is free software; you can redistribute it and/or modify
7  * it under the terms of the GNU General Public License version 2 as
8  * published by the Free Software Foundation.
9  *
10  * Contributions after 2012-01-13 are licensed under the terms of the
11  * GNU GPL, version 2 or (at your option) any later version.
12  */
13 
14 #include "qemu/osdep.h"
15 #include "hw/rtc/pl031.h"
16 #include "migration/vmstate.h"
17 #include "hw/irq.h"
18 #include "hw/qdev-properties.h"
19 #include "hw/sysbus.h"
20 #include "qemu/timer.h"
21 #include "sysemu/sysemu.h"
22 #include "sysemu/rtc.h"
23 #include "qemu/cutils.h"
24 #include "qemu/log.h"
25 #include "qemu/module.h"
26 #include "trace.h"
27 #include "qapi/qapi-events-misc.h"
28 
29 #define RTC_DR      0x00    /* Data read register */
30 #define RTC_MR      0x04    /* Match register */
31 #define RTC_LR      0x08    /* Data load register */
32 #define RTC_CR      0x0c    /* Control register */
33 #define RTC_IMSC    0x10    /* Interrupt mask and set register */
34 #define RTC_RIS     0x14    /* Raw interrupt status register */
35 #define RTC_MIS     0x18    /* Masked interrupt status register */
36 #define RTC_ICR     0x1c    /* Interrupt clear register */
37 
38 static const unsigned char pl031_id[] = {
39     0x31, 0x10, 0x14, 0x00,         /* Device ID        */
40     0x0d, 0xf0, 0x05, 0xb1          /* Cell ID      */
41 };
42 
43 static void pl031_update(PL031State *s)
44 {
45     uint32_t flags = s->is & s->im;
46 
47     trace_pl031_irq_state(flags);
48     qemu_set_irq(s->irq, flags);
49 }
50 
51 static void pl031_interrupt(void * opaque)
52 {
53     PL031State *s = (PL031State *)opaque;
54 
55     s->is = 1;
56     trace_pl031_alarm_raised();
57     pl031_update(s);
58 }
59 
60 static uint32_t pl031_get_count(PL031State *s)
61 {
62     int64_t now = qemu_clock_get_ns(rtc_clock);
63     return s->tick_offset + now / NANOSECONDS_PER_SECOND;
64 }
65 
66 static void pl031_set_alarm(PL031State *s)
67 {
68     uint32_t ticks;
69 
70     /* The timer wraps around.  This subtraction also wraps in the same way,
71        and gives correct results when alarm < now_ticks.  */
72     ticks = s->mr - pl031_get_count(s);
73     trace_pl031_set_alarm(ticks);
74     if (ticks == 0) {
75         timer_del(s->timer);
76         pl031_interrupt(s);
77     } else {
78         int64_t now = qemu_clock_get_ns(rtc_clock);
79         timer_mod(s->timer, now + (int64_t)ticks * NANOSECONDS_PER_SECOND);
80     }
81 }
82 
83 static uint64_t pl031_read(void *opaque, hwaddr offset,
84                            unsigned size)
85 {
86     PL031State *s = (PL031State *)opaque;
87     uint64_t r;
88 
89     switch (offset) {
90     case RTC_DR:
91         r = pl031_get_count(s);
92         break;
93     case RTC_MR:
94         r = s->mr;
95         break;
96     case RTC_IMSC:
97         r = s->im;
98         break;
99     case RTC_RIS:
100         r = s->is;
101         break;
102     case RTC_LR:
103         r = s->lr;
104         break;
105     case RTC_CR:
106         /* RTC is permanently enabled.  */
107         r = 1;
108         break;
109     case RTC_MIS:
110         r = s->is & s->im;
111         break;
112     case 0xfe0 ... 0xfff:
113         r = pl031_id[(offset - 0xfe0) >> 2];
114         break;
115     case RTC_ICR:
116         qemu_log_mask(LOG_GUEST_ERROR,
117                       "pl031: read of write-only register at offset 0x%x\n",
118                       (int)offset);
119         r = 0;
120         break;
121     default:
122         qemu_log_mask(LOG_GUEST_ERROR,
123                       "pl031_read: Bad offset 0x%x\n", (int)offset);
124         r = 0;
125         break;
126     }
127 
128     trace_pl031_read(offset, r);
129     return r;
130 }
131 
132 static void pl031_write(void * opaque, hwaddr offset,
133                         uint64_t value, unsigned size)
134 {
135     PL031State *s = (PL031State *)opaque;
136 
137     trace_pl031_write(offset, value);
138 
139     switch (offset) {
140     case RTC_LR: {
141         g_autofree const char *qom_path = object_get_canonical_path(opaque);
142         struct tm tm;
143 
144         s->lr = value;
145         s->tick_offset += value - pl031_get_count(s);
146 
147         qemu_get_timedate(&tm, s->tick_offset);
148         qapi_event_send_rtc_change(qemu_timedate_diff(&tm), qom_path);
149 
150         pl031_set_alarm(s);
151         break;
152     }
153     case RTC_MR:
154         s->mr = value;
155         pl031_set_alarm(s);
156         break;
157     case RTC_IMSC:
158         s->im = value & 1;
159         pl031_update(s);
160         break;
161     case RTC_ICR:
162         s->is &= ~value;
163         pl031_update(s);
164         break;
165     case RTC_CR:
166         /* Written value is ignored.  */
167         break;
168 
169     case RTC_DR:
170     case RTC_MIS:
171     case RTC_RIS:
172         qemu_log_mask(LOG_GUEST_ERROR,
173                       "pl031: write to read-only register at offset 0x%x\n",
174                       (int)offset);
175         break;
176 
177     default:
178         qemu_log_mask(LOG_GUEST_ERROR,
179                       "pl031_write: Bad offset 0x%x\n", (int)offset);
180         break;
181     }
182 }
183 
184 static const MemoryRegionOps pl031_ops = {
185     .read = pl031_read,
186     .write = pl031_write,
187     .endianness = DEVICE_NATIVE_ENDIAN,
188 };
189 
190 static void pl031_init(Object *obj)
191 {
192     PL031State *s = PL031(obj);
193     SysBusDevice *dev = SYS_BUS_DEVICE(obj);
194     struct tm tm;
195 
196     memory_region_init_io(&s->iomem, obj, &pl031_ops, s, "pl031", 0x1000);
197     sysbus_init_mmio(dev, &s->iomem);
198 
199     sysbus_init_irq(dev, &s->irq);
200     qemu_get_timedate(&tm, 0);
201     s->tick_offset = mktimegm(&tm) -
202         qemu_clock_get_ns(rtc_clock) / NANOSECONDS_PER_SECOND;
203 
204     s->timer = timer_new_ns(rtc_clock, pl031_interrupt, s);
205 }
206 
207 static void pl031_finalize(Object *obj)
208 {
209     PL031State *s = PL031(obj);
210 
211     timer_free(s->timer);
212 }
213 
214 static int pl031_pre_save(void *opaque)
215 {
216     PL031State *s = opaque;
217 
218     /*
219      * The PL031 device model code uses the tick_offset field, which is
220      * the offset between what the guest RTC should read and what the
221      * QEMU rtc_clock reads:
222      *  guest_rtc = rtc_clock + tick_offset
223      * and so
224      *  tick_offset = guest_rtc - rtc_clock
225      *
226      * We want to migrate this offset, which sounds straightforward.
227      * Unfortunately older versions of QEMU migrated a conversion of this
228      * offset into an offset from the vm_clock. (This was in turn an
229      * attempt to be compatible with even older QEMU versions, but it
230      * has incorrect behaviour if the rtc_clock is not the same as the
231      * vm_clock.) So we put the actual tick_offset into a migration
232      * subsection, and the backwards-compatible time-relative-to-vm_clock
233      * in the main migration state.
234      *
235      * Calculate base time relative to QEMU_CLOCK_VIRTUAL:
236      */
237     int64_t delta = qemu_clock_get_ns(rtc_clock) - qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL);
238     s->tick_offset_vmstate = s->tick_offset + delta / NANOSECONDS_PER_SECOND;
239 
240     return 0;
241 }
242 
243 static int pl031_pre_load(void *opaque)
244 {
245     PL031State *s = opaque;
246 
247     s->tick_offset_migrated = false;
248     return 0;
249 }
250 
251 static int pl031_post_load(void *opaque, int version_id)
252 {
253     PL031State *s = opaque;
254 
255     /*
256      * If we got the tick_offset subsection, then we can just use
257      * the value in that. Otherwise the source is an older QEMU and
258      * has given us the offset from the vm_clock; convert it back to
259      * an offset from the rtc_clock. This will cause time to incorrectly
260      * go backwards compared to the host RTC, but this is unavoidable.
261      */
262 
263     if (!s->tick_offset_migrated) {
264         int64_t delta = qemu_clock_get_ns(rtc_clock) -
265             qemu_clock_get_ns(QEMU_CLOCK_VIRTUAL);
266         s->tick_offset = s->tick_offset_vmstate -
267             delta / NANOSECONDS_PER_SECOND;
268     }
269     pl031_set_alarm(s);
270     return 0;
271 }
272 
273 static int pl031_tick_offset_post_load(void *opaque, int version_id)
274 {
275     PL031State *s = opaque;
276 
277     s->tick_offset_migrated = true;
278     return 0;
279 }
280 
281 static bool pl031_tick_offset_needed(void *opaque)
282 {
283     PL031State *s = opaque;
284 
285     return s->migrate_tick_offset;
286 }
287 
288 static const VMStateDescription vmstate_pl031_tick_offset = {
289     .name = "pl031/tick-offset",
290     .version_id = 1,
291     .minimum_version_id = 1,
292     .needed = pl031_tick_offset_needed,
293     .post_load = pl031_tick_offset_post_load,
294     .fields = (const VMStateField[]) {
295         VMSTATE_UINT32(tick_offset, PL031State),
296         VMSTATE_END_OF_LIST()
297     }
298 };
299 
300 static const VMStateDescription vmstate_pl031 = {
301     .name = "pl031",
302     .version_id = 1,
303     .minimum_version_id = 1,
304     .pre_save = pl031_pre_save,
305     .pre_load = pl031_pre_load,
306     .post_load = pl031_post_load,
307     .fields = (const VMStateField[]) {
308         VMSTATE_UINT32(tick_offset_vmstate, PL031State),
309         VMSTATE_UINT32(mr, PL031State),
310         VMSTATE_UINT32(lr, PL031State),
311         VMSTATE_UINT32(cr, PL031State),
312         VMSTATE_UINT32(im, PL031State),
313         VMSTATE_UINT32(is, PL031State),
314         VMSTATE_END_OF_LIST()
315     },
316     .subsections = (const VMStateDescription * const []) {
317         &vmstate_pl031_tick_offset,
318         NULL
319     }
320 };
321 
322 static Property pl031_properties[] = {
323     /*
324      * True to correctly migrate the tick offset of the RTC. False to
325      * obtain backward migration compatibility with older QEMU versions,
326      * at the expense of the guest RTC going backwards compared with the
327      * host RTC when the VM is saved/restored if using -rtc host.
328      * (Even if set to 'true' older QEMU can migrate forward to newer QEMU;
329      * 'false' also permits newer QEMU to migrate to older QEMU.)
330      */
331     DEFINE_PROP_BOOL("migrate-tick-offset",
332                      PL031State, migrate_tick_offset, true),
333     DEFINE_PROP_END_OF_LIST()
334 };
335 
336 static void pl031_class_init(ObjectClass *klass, void *data)
337 {
338     DeviceClass *dc = DEVICE_CLASS(klass);
339 
340     dc->vmsd = &vmstate_pl031;
341     device_class_set_props(dc, pl031_properties);
342 }
343 
344 static const TypeInfo pl031_info = {
345     .name          = TYPE_PL031,
346     .parent        = TYPE_SYS_BUS_DEVICE,
347     .instance_size = sizeof(PL031State),
348     .instance_init = pl031_init,
349     .instance_finalize = pl031_finalize,
350     .class_init    = pl031_class_init,
351 };
352 
353 static void pl031_register_types(void)
354 {
355     type_register_static(&pl031_info);
356 }
357 
358 type_init(pl031_register_types)
359