xlnx-bbram.c (15251B)
1/* 2 * QEMU model of the Xilinx BBRAM Battery Backed RAM 3 * 4 * Copyright (c) 2014-2021 Xilinx Inc. 5 * 6 * Permission is hereby granted, free of charge, to any person obtaining a copy 7 * of this software and associated documentation files (the "Software"), to deal 8 * in the Software without restriction, including without limitation the rights 9 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell 10 * copies of the Software, and to permit persons to whom the Software is 11 * furnished to do so, subject to the following conditions: 12 * 13 * The above copyright notice and this permission notice shall be included in 14 * all copies or substantial portions of the Software. 15 * 16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR 17 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER 20 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, 21 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN 22 * THE SOFTWARE. 23 */ 24 25#include "qemu/osdep.h" 26#include "hw/nvram/xlnx-bbram.h" 27 28#include "qemu/error-report.h" 29#include "qemu/log.h" 30#include "qapi/error.h" 31#include "sysemu/blockdev.h" 32#include "migration/vmstate.h" 33#include "hw/qdev-properties.h" 34#include "hw/qdev-properties-system.h" 35#include "hw/nvram/xlnx-efuse.h" 36 37#ifndef XLNX_BBRAM_ERR_DEBUG 38#define XLNX_BBRAM_ERR_DEBUG 0 39#endif 40 41REG32(BBRAM_STATUS, 0x0) 42 FIELD(BBRAM_STATUS, AES_CRC_PASS, 9, 1) 43 FIELD(BBRAM_STATUS, AES_CRC_DONE, 8, 1) 44 FIELD(BBRAM_STATUS, BBRAM_ZEROIZED, 4, 1) 45 FIELD(BBRAM_STATUS, PGM_MODE, 0, 1) 46REG32(BBRAM_CTRL, 0x4) 47 FIELD(BBRAM_CTRL, ZEROIZE, 0, 1) 48REG32(PGM_MODE, 0x8) 49REG32(BBRAM_AES_CRC, 0xc) 50REG32(BBRAM_0, 0x10) 51REG32(BBRAM_1, 0x14) 52REG32(BBRAM_2, 0x18) 53REG32(BBRAM_3, 0x1c) 54REG32(BBRAM_4, 0x20) 55REG32(BBRAM_5, 0x24) 56REG32(BBRAM_6, 0x28) 57REG32(BBRAM_7, 0x2c) 58REG32(BBRAM_8, 0x30) 59REG32(BBRAM_SLVERR, 0x34) 60 FIELD(BBRAM_SLVERR, ENABLE, 0, 1) 61REG32(BBRAM_ISR, 0x38) 62 FIELD(BBRAM_ISR, APB_SLVERR, 0, 1) 63REG32(BBRAM_IMR, 0x3c) 64 FIELD(BBRAM_IMR, APB_SLVERR, 0, 1) 65REG32(BBRAM_IER, 0x40) 66 FIELD(BBRAM_IER, APB_SLVERR, 0, 1) 67REG32(BBRAM_IDR, 0x44) 68 FIELD(BBRAM_IDR, APB_SLVERR, 0, 1) 69REG32(BBRAM_MSW_LOCK, 0x4c) 70 FIELD(BBRAM_MSW_LOCK, VAL, 0, 1) 71 72#define R_MAX (R_BBRAM_MSW_LOCK + 1) 73 74#define RAM_MAX (A_BBRAM_8 + 4 - A_BBRAM_0) 75 76#define BBRAM_PGM_MAGIC 0x757bdf0d 77 78QEMU_BUILD_BUG_ON(R_MAX != ARRAY_SIZE(((XlnxBBRam *)0)->regs)); 79 80static bool bbram_msw_locked(XlnxBBRam *s) 81{ 82 return ARRAY_FIELD_EX32(s->regs, BBRAM_MSW_LOCK, VAL) != 0; 83} 84 85static bool bbram_pgm_enabled(XlnxBBRam *s) 86{ 87 return ARRAY_FIELD_EX32(s->regs, BBRAM_STATUS, PGM_MODE) != 0; 88} 89 90static void bbram_bdrv_error(XlnxBBRam *s, int rc, gchar *detail) 91{ 92 Error *errp; 93 94 error_setg_errno(&errp, -rc, "%s: BBRAM backstore %s failed.", 95 blk_name(s->blk), detail); 96 error_report("%s", error_get_pretty(errp)); 97 error_free(errp); 98 99 g_free(detail); 100} 101 102static void bbram_bdrv_read(XlnxBBRam *s, Error **errp) 103{ 104 uint32_t *ram = &s->regs[R_BBRAM_0]; 105 int nr = RAM_MAX; 106 107 if (!s->blk) { 108 return; 109 } 110 111 s->blk_ro = !blk_supports_write_perm(s->blk); 112 if (!s->blk_ro) { 113 int rc; 114 115 rc = blk_set_perm(s->blk, 116 (BLK_PERM_CONSISTENT_READ | BLK_PERM_WRITE), 117 BLK_PERM_ALL, NULL); 118 if (rc) { 119 s->blk_ro = true; 120 } 121 } 122 if (s->blk_ro) { 123 warn_report("%s: Skip saving updates to read-only BBRAM backstore.", 124 blk_name(s->blk)); 125 } 126 127 if (blk_pread(s->blk, 0, ram, nr) < 0) { 128 error_setg(errp, 129 "%s: Failed to read %u bytes from BBRAM backstore.", 130 blk_name(s->blk), nr); 131 return; 132 } 133 134 /* Convert from little-endian backstore for each 32-bit word */ 135 nr /= 4; 136 while (nr--) { 137 ram[nr] = le32_to_cpu(ram[nr]); 138 } 139} 140 141static void bbram_bdrv_sync(XlnxBBRam *s, uint64_t hwaddr) 142{ 143 uint32_t le32; 144 unsigned offset; 145 int rc; 146 147 assert(A_BBRAM_0 <= hwaddr && hwaddr <= A_BBRAM_8); 148 149 /* Backstore is always in little-endian */ 150 le32 = cpu_to_le32(s->regs[hwaddr / 4]); 151 152 /* Update zeroized flag */ 153 if (le32 && (hwaddr != A_BBRAM_8 || s->bbram8_wo)) { 154 ARRAY_FIELD_DP32(s->regs, BBRAM_STATUS, BBRAM_ZEROIZED, 0); 155 } 156 157 if (!s->blk || s->blk_ro) { 158 return; 159 } 160 161 offset = hwaddr - A_BBRAM_0; 162 rc = blk_pwrite(s->blk, offset, &le32, 4, 0); 163 if (rc < 0) { 164 bbram_bdrv_error(s, rc, g_strdup_printf("write to offset %u", offset)); 165 } 166} 167 168static void bbram_bdrv_zero(XlnxBBRam *s) 169{ 170 int rc; 171 172 ARRAY_FIELD_DP32(s->regs, BBRAM_STATUS, BBRAM_ZEROIZED, 1); 173 174 if (!s->blk || s->blk_ro) { 175 return; 176 } 177 178 rc = blk_make_zero(s->blk, 0); 179 if (rc < 0) { 180 bbram_bdrv_error(s, rc, g_strdup("zeroizing")); 181 } 182 183 /* Restore bbram8 if it is non-zero */ 184 if (s->regs[R_BBRAM_8]) { 185 bbram_bdrv_sync(s, A_BBRAM_8); 186 } 187} 188 189static void bbram_zeroize(XlnxBBRam *s) 190{ 191 int nr = RAM_MAX - (s->bbram8_wo ? 0 : 4); /* only wo bbram8 is cleared */ 192 193 memset(&s->regs[R_BBRAM_0], 0, nr); 194 bbram_bdrv_zero(s); 195} 196 197static void bbram_update_irq(XlnxBBRam *s) 198{ 199 bool pending = s->regs[R_BBRAM_ISR] & ~s->regs[R_BBRAM_IMR]; 200 201 qemu_set_irq(s->irq_bbram, pending); 202} 203 204static void bbram_ctrl_postw(RegisterInfo *reg, uint64_t val64) 205{ 206 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 207 uint32_t val = val64; 208 209 if (val & R_BBRAM_CTRL_ZEROIZE_MASK) { 210 bbram_zeroize(s); 211 /* The bit is self clearing */ 212 s->regs[R_BBRAM_CTRL] &= ~R_BBRAM_CTRL_ZEROIZE_MASK; 213 } 214} 215 216static void bbram_pgm_mode_postw(RegisterInfo *reg, uint64_t val64) 217{ 218 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 219 uint32_t val = val64; 220 221 if (val == BBRAM_PGM_MAGIC) { 222 bbram_zeroize(s); 223 224 /* The status bit is cleared only by POR */ 225 ARRAY_FIELD_DP32(s->regs, BBRAM_STATUS, PGM_MODE, 1); 226 } 227} 228 229static void bbram_aes_crc_postw(RegisterInfo *reg, uint64_t val64) 230{ 231 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 232 uint32_t calc_crc; 233 234 if (!bbram_pgm_enabled(s)) { 235 /* We are not in programming mode, don't do anything */ 236 return; 237 } 238 239 /* Perform the AES integrity check */ 240 s->regs[R_BBRAM_STATUS] |= R_BBRAM_STATUS_AES_CRC_DONE_MASK; 241 242 /* 243 * Set check status. 244 * 245 * ZynqMP BBRAM check has a zero-u32 prepended; see: 246 * https://github.com/Xilinx/embeddedsw/blob/release-2019.2/lib/sw_services/xilskey/src/xilskey_bbramps_zynqmp.c#L311 247 */ 248 calc_crc = xlnx_efuse_calc_crc(&s->regs[R_BBRAM_0], 249 (R_BBRAM_8 - R_BBRAM_0), s->crc_zpads); 250 251 ARRAY_FIELD_DP32(s->regs, BBRAM_STATUS, AES_CRC_PASS, 252 (s->regs[R_BBRAM_AES_CRC] == calc_crc)); 253} 254 255static uint64_t bbram_key_prew(RegisterInfo *reg, uint64_t val64) 256{ 257 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 258 uint32_t original_data = *(uint32_t *) reg->data; 259 260 if (bbram_pgm_enabled(s)) { 261 return val64; 262 } else { 263 /* We are not in programming mode, don't do anything */ 264 qemu_log_mask(LOG_GUEST_ERROR, 265 "Not in programming mode, dropping the write\n"); 266 return original_data; 267 } 268} 269 270static void bbram_key_postw(RegisterInfo *reg, uint64_t val64) 271{ 272 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 273 274 bbram_bdrv_sync(s, reg->access->addr); 275} 276 277static uint64_t bbram_wo_postr(RegisterInfo *reg, uint64_t val) 278{ 279 return 0; 280} 281 282static uint64_t bbram_r8_postr(RegisterInfo *reg, uint64_t val) 283{ 284 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 285 286 return s->bbram8_wo ? bbram_wo_postr(reg, val) : val; 287} 288 289static bool bbram_r8_readonly(XlnxBBRam *s) 290{ 291 return !bbram_pgm_enabled(s) || bbram_msw_locked(s); 292} 293 294static uint64_t bbram_r8_prew(RegisterInfo *reg, uint64_t val64) 295{ 296 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 297 298 if (bbram_r8_readonly(s)) { 299 val64 = *(uint32_t *)reg->data; 300 } 301 302 return val64; 303} 304 305static void bbram_r8_postw(RegisterInfo *reg, uint64_t val64) 306{ 307 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 308 309 if (!bbram_r8_readonly(s)) { 310 bbram_bdrv_sync(s, A_BBRAM_8); 311 } 312} 313 314static uint64_t bbram_msw_lock_prew(RegisterInfo *reg, uint64_t val64) 315{ 316 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 317 318 /* Never lock if bbram8 is wo; and, only POR can clear the lock */ 319 if (s->bbram8_wo) { 320 val64 = 0; 321 } else { 322 val64 |= s->regs[R_BBRAM_MSW_LOCK]; 323 } 324 325 return val64; 326} 327 328static void bbram_isr_postw(RegisterInfo *reg, uint64_t val64) 329{ 330 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 331 332 bbram_update_irq(s); 333} 334 335static uint64_t bbram_ier_prew(RegisterInfo *reg, uint64_t val64) 336{ 337 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 338 uint32_t val = val64; 339 340 s->regs[R_BBRAM_IMR] &= ~val; 341 bbram_update_irq(s); 342 return 0; 343} 344 345static uint64_t bbram_idr_prew(RegisterInfo *reg, uint64_t val64) 346{ 347 XlnxBBRam *s = XLNX_BBRAM(reg->opaque); 348 uint32_t val = val64; 349 350 s->regs[R_BBRAM_IMR] |= val; 351 bbram_update_irq(s); 352 return 0; 353} 354 355static RegisterAccessInfo bbram_ctrl_regs_info[] = { 356 { .name = "BBRAM_STATUS", .addr = A_BBRAM_STATUS, 357 .rsvd = 0xee, 358 .ro = 0x3ff, 359 },{ .name = "BBRAM_CTRL", .addr = A_BBRAM_CTRL, 360 .post_write = bbram_ctrl_postw, 361 },{ .name = "PGM_MODE", .addr = A_PGM_MODE, 362 .post_write = bbram_pgm_mode_postw, 363 },{ .name = "BBRAM_AES_CRC", .addr = A_BBRAM_AES_CRC, 364 .post_write = bbram_aes_crc_postw, 365 .post_read = bbram_wo_postr, 366 },{ .name = "BBRAM_0", .addr = A_BBRAM_0, 367 .pre_write = bbram_key_prew, 368 .post_write = bbram_key_postw, 369 .post_read = bbram_wo_postr, 370 },{ .name = "BBRAM_1", .addr = A_BBRAM_1, 371 .pre_write = bbram_key_prew, 372 .post_write = bbram_key_postw, 373 .post_read = bbram_wo_postr, 374 },{ .name = "BBRAM_2", .addr = A_BBRAM_2, 375 .pre_write = bbram_key_prew, 376 .post_write = bbram_key_postw, 377 .post_read = bbram_wo_postr, 378 },{ .name = "BBRAM_3", .addr = A_BBRAM_3, 379 .pre_write = bbram_key_prew, 380 .post_write = bbram_key_postw, 381 .post_read = bbram_wo_postr, 382 },{ .name = "BBRAM_4", .addr = A_BBRAM_4, 383 .pre_write = bbram_key_prew, 384 .post_write = bbram_key_postw, 385 .post_read = bbram_wo_postr, 386 },{ .name = "BBRAM_5", .addr = A_BBRAM_5, 387 .pre_write = bbram_key_prew, 388 .post_write = bbram_key_postw, 389 .post_read = bbram_wo_postr, 390 },{ .name = "BBRAM_6", .addr = A_BBRAM_6, 391 .pre_write = bbram_key_prew, 392 .post_write = bbram_key_postw, 393 .post_read = bbram_wo_postr, 394 },{ .name = "BBRAM_7", .addr = A_BBRAM_7, 395 .pre_write = bbram_key_prew, 396 .post_write = bbram_key_postw, 397 .post_read = bbram_wo_postr, 398 },{ .name = "BBRAM_8", .addr = A_BBRAM_8, 399 .pre_write = bbram_r8_prew, 400 .post_write = bbram_r8_postw, 401 .post_read = bbram_r8_postr, 402 },{ .name = "BBRAM_SLVERR", .addr = A_BBRAM_SLVERR, 403 .rsvd = ~1, 404 },{ .name = "BBRAM_ISR", .addr = A_BBRAM_ISR, 405 .w1c = 0x1, 406 .post_write = bbram_isr_postw, 407 },{ .name = "BBRAM_IMR", .addr = A_BBRAM_IMR, 408 .ro = 0x1, 409 },{ .name = "BBRAM_IER", .addr = A_BBRAM_IER, 410 .pre_write = bbram_ier_prew, 411 },{ .name = "BBRAM_IDR", .addr = A_BBRAM_IDR, 412 .pre_write = bbram_idr_prew, 413 },{ .name = "BBRAM_MSW_LOCK", .addr = A_BBRAM_MSW_LOCK, 414 .pre_write = bbram_msw_lock_prew, 415 .ro = ~R_BBRAM_MSW_LOCK_VAL_MASK, 416 } 417}; 418 419static void bbram_ctrl_reset(DeviceState *dev) 420{ 421 XlnxBBRam *s = XLNX_BBRAM(dev); 422 unsigned int i; 423 424 for (i = 0; i < ARRAY_SIZE(s->regs_info); ++i) { 425 if (i < R_BBRAM_0 || i > R_BBRAM_8) { 426 register_reset(&s->regs_info[i]); 427 } 428 } 429 430 bbram_update_irq(s); 431} 432 433static const MemoryRegionOps bbram_ctrl_ops = { 434 .read = register_read_memory, 435 .write = register_write_memory, 436 .endianness = DEVICE_LITTLE_ENDIAN, 437 .valid = { 438 .min_access_size = 4, 439 .max_access_size = 4, 440 }, 441}; 442 443static void bbram_ctrl_realize(DeviceState *dev, Error **errp) 444{ 445 XlnxBBRam *s = XLNX_BBRAM(dev); 446 447 if (s->crc_zpads) { 448 s->bbram8_wo = true; 449 } 450 451 bbram_bdrv_read(s, errp); 452} 453 454static void bbram_ctrl_init(Object *obj) 455{ 456 XlnxBBRam *s = XLNX_BBRAM(obj); 457 SysBusDevice *sbd = SYS_BUS_DEVICE(obj); 458 RegisterInfoArray *reg_array; 459 460 reg_array = 461 register_init_block32(DEVICE(obj), bbram_ctrl_regs_info, 462 ARRAY_SIZE(bbram_ctrl_regs_info), 463 s->regs_info, s->regs, 464 &bbram_ctrl_ops, 465 XLNX_BBRAM_ERR_DEBUG, 466 R_MAX * 4); 467 468 sysbus_init_mmio(sbd, ®_array->mem); 469 sysbus_init_irq(sbd, &s->irq_bbram); 470} 471 472static void bbram_prop_set_drive(Object *obj, Visitor *v, const char *name, 473 void *opaque, Error **errp) 474{ 475 DeviceState *dev = DEVICE(obj); 476 477 qdev_prop_drive.set(obj, v, name, opaque, errp); 478 479 /* Fill initial data if backend is attached after realized */ 480 if (dev->realized) { 481 bbram_bdrv_read(XLNX_BBRAM(obj), errp); 482 } 483} 484 485static void bbram_prop_get_drive(Object *obj, Visitor *v, const char *name, 486 void *opaque, Error **errp) 487{ 488 qdev_prop_drive.get(obj, v, name, opaque, errp); 489} 490 491static void bbram_prop_release_drive(Object *obj, const char *name, 492 void *opaque) 493{ 494 qdev_prop_drive.release(obj, name, opaque); 495} 496 497static const PropertyInfo bbram_prop_drive = { 498 .name = "str", 499 .description = "Node name or ID of a block device to use as BBRAM backend", 500 .realized_set_allowed = true, 501 .get = bbram_prop_get_drive, 502 .set = bbram_prop_set_drive, 503 .release = bbram_prop_release_drive, 504}; 505 506static const VMStateDescription vmstate_bbram_ctrl = { 507 .name = TYPE_XLNX_BBRAM, 508 .version_id = 1, 509 .minimum_version_id = 1, 510 .fields = (VMStateField[]) { 511 VMSTATE_UINT32_ARRAY(regs, XlnxBBRam, R_MAX), 512 VMSTATE_END_OF_LIST(), 513 } 514}; 515 516static Property bbram_ctrl_props[] = { 517 DEFINE_PROP("drive", XlnxBBRam, blk, bbram_prop_drive, BlockBackend *), 518 DEFINE_PROP_UINT32("crc-zpads", XlnxBBRam, crc_zpads, 1), 519 DEFINE_PROP_END_OF_LIST(), 520}; 521 522static void bbram_ctrl_class_init(ObjectClass *klass, void *data) 523{ 524 DeviceClass *dc = DEVICE_CLASS(klass); 525 526 dc->reset = bbram_ctrl_reset; 527 dc->realize = bbram_ctrl_realize; 528 dc->vmsd = &vmstate_bbram_ctrl; 529 device_class_set_props(dc, bbram_ctrl_props); 530} 531 532static const TypeInfo bbram_ctrl_info = { 533 .name = TYPE_XLNX_BBRAM, 534 .parent = TYPE_SYS_BUS_DEVICE, 535 .instance_size = sizeof(XlnxBBRam), 536 .class_init = bbram_ctrl_class_init, 537 .instance_init = bbram_ctrl_init, 538}; 539 540static void bbram_ctrl_register_types(void) 541{ 542 type_register_static(&bbram_ctrl_info); 543} 544 545type_init(bbram_ctrl_register_types)