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