// SPDX-License-Identifier: GPL-2.0 // // regmap KUnit tests // // Copyright 2023 Arm Ltd #include #include "internal.h" #define BLOCK_TEST_SIZE 12 static void get_changed_bytes(void *orig, void *new, size_t size) { char *o = orig; char *n = new; int i; get_random_bytes(new, size); /* * This could be nicer and more efficient but we shouldn't * super care. */ for (i = 0; i < size; i++) while (n[i] == o[i]) get_random_bytes(&n[i], 1); } static const struct regmap_config test_regmap_config = { .max_register = BLOCK_TEST_SIZE, .reg_stride = 1, .val_bits = sizeof(unsigned int) * 8, }; struct regcache_types { enum regcache_type type; const char *name; }; static void case_to_desc(const struct regcache_types *t, char *desc) { strcpy(desc, t->name); } static const struct regcache_types regcache_types_list[] = { { REGCACHE_NONE, "none" }, { REGCACHE_FLAT, "flat" }, { REGCACHE_RBTREE, "rbtree" }, { REGCACHE_MAPLE, "maple" }, }; KUNIT_ARRAY_PARAM(regcache_types, regcache_types_list, case_to_desc); static const struct regcache_types real_cache_types_list[] = { { REGCACHE_FLAT, "flat" }, { REGCACHE_RBTREE, "rbtree" }, { REGCACHE_MAPLE, "maple" }, }; KUNIT_ARRAY_PARAM(real_cache_types, real_cache_types_list, case_to_desc); static const struct regcache_types sparse_cache_types_list[] = { { REGCACHE_RBTREE, "rbtree" }, { REGCACHE_MAPLE, "maple" }, }; KUNIT_ARRAY_PARAM(sparse_cache_types, sparse_cache_types_list, case_to_desc); static struct regmap *gen_regmap(struct regmap_config *config, struct regmap_ram_data **data) { unsigned int *buf; struct regmap *ret; size_t size = (config->max_register + 1) * sizeof(unsigned int); int i; struct reg_default *defaults; config->disable_locking = config->cache_type == REGCACHE_RBTREE || config->cache_type == REGCACHE_MAPLE; buf = kmalloc(size, GFP_KERNEL); if (!buf) return ERR_PTR(-ENOMEM); get_random_bytes(buf, size); *data = kzalloc(sizeof(**data), GFP_KERNEL); if (!(*data)) return ERR_PTR(-ENOMEM); (*data)->vals = buf; if (config->num_reg_defaults) { defaults = kcalloc(config->num_reg_defaults, sizeof(struct reg_default), GFP_KERNEL); if (!defaults) return ERR_PTR(-ENOMEM); config->reg_defaults = defaults; for (i = 0; i < config->num_reg_defaults; i++) { defaults[i].reg = i * config->reg_stride; defaults[i].def = buf[i * config->reg_stride]; } } ret = regmap_init_ram(config, *data); if (IS_ERR(ret)) { kfree(buf); kfree(*data); } return ret; } static bool reg_5_false(struct device *context, unsigned int reg) { return reg != 5; } static void basic_read_write(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val, rval; config = test_regmap_config; config.cache_type = t->type; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; get_random_bytes(&val, sizeof(val)); /* If we write a value to a register we can read it back */ KUNIT_EXPECT_EQ(test, 0, regmap_write(map, 0, val)); KUNIT_EXPECT_EQ(test, 0, regmap_read(map, 0, &rval)); KUNIT_EXPECT_EQ(test, val, rval); /* If using a cache the cache satisfied the read */ KUNIT_EXPECT_EQ(test, t->type == REGCACHE_NONE, data->read[0]); regmap_exit(map); } static void bulk_write(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val[BLOCK_TEST_SIZE], rval[BLOCK_TEST_SIZE]; int i; config = test_regmap_config; config.cache_type = t->type; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; get_random_bytes(&val, sizeof(val)); /* * Data written via the bulk API can be read back with single * reads. */ KUNIT_EXPECT_EQ(test, 0, regmap_bulk_write(map, 0, val, BLOCK_TEST_SIZE)); for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, 0, regmap_read(map, i, &rval[i])); KUNIT_EXPECT_MEMEQ(test, val, rval, sizeof(val)); /* If using a cache the cache satisfied the read */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, t->type == REGCACHE_NONE, data->read[i]); regmap_exit(map); } static void bulk_read(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val[BLOCK_TEST_SIZE], rval[BLOCK_TEST_SIZE]; int i; config = test_regmap_config; config.cache_type = t->type; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; get_random_bytes(&val, sizeof(val)); /* Data written as single writes can be read via the bulk API */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, 0, regmap_write(map, i, val[i])); KUNIT_EXPECT_EQ(test, 0, regmap_bulk_read(map, 0, rval, BLOCK_TEST_SIZE)); KUNIT_EXPECT_MEMEQ(test, val, rval, sizeof(val)); /* If using a cache the cache satisfied the read */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, t->type == REGCACHE_NONE, data->read[i]); regmap_exit(map); } static void write_readonly(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val; int i; config = test_regmap_config; config.cache_type = t->type; config.num_reg_defaults = BLOCK_TEST_SIZE; config.writeable_reg = reg_5_false; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; get_random_bytes(&val, sizeof(val)); for (i = 0; i < BLOCK_TEST_SIZE; i++) data->written[i] = false; /* Change the value of all registers, readonly should fail */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, i != 5, regmap_write(map, i, val) == 0); /* Did that match what we see on the device? */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, i != 5, data->written[i]); regmap_exit(map); } static void read_writeonly(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val; int i; config = test_regmap_config; config.cache_type = t->type; config.readable_reg = reg_5_false; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; for (i = 0; i < BLOCK_TEST_SIZE; i++) data->read[i] = false; /* * Try to read all the registers, the writeonly one should * fail if we aren't using the flat cache. */ for (i = 0; i < BLOCK_TEST_SIZE; i++) { if (t->type != REGCACHE_FLAT) { KUNIT_EXPECT_EQ(test, i != 5, regmap_read(map, i, &val) == 0); } else { KUNIT_EXPECT_EQ(test, 0, regmap_read(map, i, &val)); } } /* Did we trigger a hardware access? */ KUNIT_EXPECT_FALSE(test, data->read[5]); regmap_exit(map); } static void reg_defaults(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int rval[BLOCK_TEST_SIZE]; int i; config = test_regmap_config; config.cache_type = t->type; config.num_reg_defaults = BLOCK_TEST_SIZE; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; /* Read back the expected default data */ KUNIT_EXPECT_EQ(test, 0, regmap_bulk_read(map, 0, rval, BLOCK_TEST_SIZE)); KUNIT_EXPECT_MEMEQ(test, data->vals, rval, sizeof(rval)); /* The data should have been read from cache if there was one */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, t->type == REGCACHE_NONE, data->read[i]); } static void reg_defaults_read_dev(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int rval[BLOCK_TEST_SIZE]; int i; config = test_regmap_config; config.cache_type = t->type; config.num_reg_defaults_raw = BLOCK_TEST_SIZE; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; /* We should have read the cache defaults back from the map */ for (i = 0; i < BLOCK_TEST_SIZE; i++) { KUNIT_EXPECT_EQ(test, t->type != REGCACHE_NONE, data->read[i]); data->read[i] = false; } /* Read back the expected default data */ KUNIT_EXPECT_EQ(test, 0, regmap_bulk_read(map, 0, rval, BLOCK_TEST_SIZE)); KUNIT_EXPECT_MEMEQ(test, data->vals, rval, sizeof(rval)); /* The data should have been read from cache if there was one */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, t->type == REGCACHE_NONE, data->read[i]); } static void register_patch(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; struct reg_sequence patch[2]; unsigned int rval[BLOCK_TEST_SIZE]; int i; /* We need defaults so readback works */ config = test_regmap_config; config.cache_type = t->type; config.num_reg_defaults = BLOCK_TEST_SIZE; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; /* Stash the original values */ KUNIT_EXPECT_EQ(test, 0, regmap_bulk_read(map, 0, rval, BLOCK_TEST_SIZE)); /* Patch a couple of values */ patch[0].reg = 2; patch[0].def = rval[2] + 1; patch[0].delay_us = 0; patch[1].reg = 5; patch[1].def = rval[5] + 1; patch[1].delay_us = 0; KUNIT_EXPECT_EQ(test, 0, regmap_register_patch(map, patch, ARRAY_SIZE(patch))); /* Only the patched registers are written */ for (i = 0; i < BLOCK_TEST_SIZE; i++) { switch (i) { case 2: case 5: KUNIT_EXPECT_TRUE(test, data->written[i]); KUNIT_EXPECT_EQ(test, data->vals[i], rval[i] + 1); break; default: KUNIT_EXPECT_FALSE(test, data->written[i]); KUNIT_EXPECT_EQ(test, data->vals[i], rval[i]); break; } } regmap_exit(map); } static void stride(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int rval; int i; config = test_regmap_config; config.cache_type = t->type; config.reg_stride = 2; config.num_reg_defaults = BLOCK_TEST_SIZE / 2; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; /* Only even registers can be accessed, try both read and write */ for (i = 0; i < BLOCK_TEST_SIZE; i++) { data->read[i] = false; data->written[i] = false; if (i % 2) { KUNIT_EXPECT_NE(test, 0, regmap_read(map, i, &rval)); KUNIT_EXPECT_NE(test, 0, regmap_write(map, i, rval)); KUNIT_EXPECT_FALSE(test, data->read[i]); KUNIT_EXPECT_FALSE(test, data->written[i]); } else { KUNIT_EXPECT_EQ(test, 0, regmap_read(map, i, &rval)); KUNIT_EXPECT_EQ(test, data->vals[i], rval); KUNIT_EXPECT_EQ(test, t->type == REGCACHE_NONE, data->read[i]); KUNIT_EXPECT_EQ(test, 0, regmap_write(map, i, rval)); KUNIT_EXPECT_TRUE(test, data->written[i]); } } regmap_exit(map); } static struct regmap_range_cfg test_range = { .selector_reg = 1, .selector_mask = 0xff, .window_start = 4, .window_len = 10, .range_min = 20, .range_max = 40, }; static bool test_range_window_volatile(struct device *dev, unsigned int reg) { if (reg >= test_range.window_start && reg <= test_range.window_start + test_range.window_len) return true; return false; } static bool test_range_all_volatile(struct device *dev, unsigned int reg) { if (test_range_window_volatile(dev, reg)) return true; if (reg >= test_range.range_min && reg <= test_range.range_max) return true; return false; } static void basic_ranges(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val; int i; config = test_regmap_config; config.cache_type = t->type; config.volatile_reg = test_range_all_volatile; config.ranges = &test_range; config.num_ranges = 1; config.max_register = test_range.range_max; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; for (i = test_range.range_min; i < test_range.range_max; i++) { data->read[i] = false; data->written[i] = false; } /* Reset the page to a non-zero value to trigger a change */ KUNIT_EXPECT_EQ(test, 0, regmap_write(map, test_range.selector_reg, test_range.range_max)); /* Check we set the page and use the window for writes */ data->written[test_range.selector_reg] = false; data->written[test_range.window_start] = false; KUNIT_EXPECT_EQ(test, 0, regmap_write(map, test_range.range_min, 0)); KUNIT_EXPECT_TRUE(test, data->written[test_range.selector_reg]); KUNIT_EXPECT_TRUE(test, data->written[test_range.window_start]); data->written[test_range.selector_reg] = false; data->written[test_range.window_start] = false; KUNIT_EXPECT_EQ(test, 0, regmap_write(map, test_range.range_min + test_range.window_len, 0)); KUNIT_EXPECT_TRUE(test, data->written[test_range.selector_reg]); KUNIT_EXPECT_TRUE(test, data->written[test_range.window_start]); /* Same for reads */ data->written[test_range.selector_reg] = false; data->read[test_range.window_start] = false; KUNIT_EXPECT_EQ(test, 0, regmap_read(map, test_range.range_min, &val)); KUNIT_EXPECT_TRUE(test, data->written[test_range.selector_reg]); KUNIT_EXPECT_TRUE(test, data->read[test_range.window_start]); data->written[test_range.selector_reg] = false; data->read[test_range.window_start] = false; KUNIT_EXPECT_EQ(test, 0, regmap_read(map, test_range.range_min + test_range.window_len, &val)); KUNIT_EXPECT_TRUE(test, data->written[test_range.selector_reg]); KUNIT_EXPECT_TRUE(test, data->read[test_range.window_start]); /* No physical access triggered in the virtual range */ for (i = test_range.range_min; i < test_range.range_max; i++) { KUNIT_EXPECT_FALSE(test, data->read[i]); KUNIT_EXPECT_FALSE(test, data->written[i]); } regmap_exit(map); } /* Try to stress dynamic creation of cache data structures */ static void stress_insert(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int rval, *vals; size_t buf_sz; int i; config = test_regmap_config; config.cache_type = t->type; config.max_register = 300; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; vals = kunit_kcalloc(test, sizeof(unsigned long), config.max_register, GFP_KERNEL); KUNIT_ASSERT_FALSE(test, vals == NULL); buf_sz = sizeof(unsigned long) * config.max_register; get_random_bytes(vals, buf_sz); /* Write data into the map/cache in ever decreasing strides */ for (i = 0; i < config.max_register; i += 100) KUNIT_EXPECT_EQ(test, 0, regmap_write(map, i, vals[i])); for (i = 0; i < config.max_register; i += 50) KUNIT_EXPECT_EQ(test, 0, regmap_write(map, i, vals[i])); for (i = 0; i < config.max_register; i += 25) KUNIT_EXPECT_EQ(test, 0, regmap_write(map, i, vals[i])); for (i = 0; i < config.max_register; i += 10) KUNIT_EXPECT_EQ(test, 0, regmap_write(map, i, vals[i])); for (i = 0; i < config.max_register; i += 5) KUNIT_EXPECT_EQ(test, 0, regmap_write(map, i, vals[i])); for (i = 0; i < config.max_register; i += 3) KUNIT_EXPECT_EQ(test, 0, regmap_write(map, i, vals[i])); for (i = 0; i < config.max_register; i += 2) KUNIT_EXPECT_EQ(test, 0, regmap_write(map, i, vals[i])); for (i = 0; i < config.max_register; i++) KUNIT_EXPECT_EQ(test, 0, regmap_write(map, i, vals[i])); /* Do reads from the cache (if there is one) match? */ for (i = 0; i < config.max_register; i ++) { KUNIT_EXPECT_EQ(test, 0, regmap_read(map, i, &rval)); KUNIT_EXPECT_EQ(test, rval, vals[i]); KUNIT_EXPECT_EQ(test, t->type == REGCACHE_NONE, data->read[i]); } regmap_exit(map); } static void cache_bypass(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val, rval; config = test_regmap_config; config.cache_type = t->type; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; get_random_bytes(&val, sizeof(val)); /* Ensure the cache has a value in it */ KUNIT_EXPECT_EQ(test, 0, regmap_write(map, 0, val)); /* Bypass then write a different value */ regcache_cache_bypass(map, true); KUNIT_EXPECT_EQ(test, 0, regmap_write(map, 0, val + 1)); /* Read the bypassed value */ KUNIT_EXPECT_EQ(test, 0, regmap_read(map, 0, &rval)); KUNIT_EXPECT_EQ(test, val + 1, rval); KUNIT_EXPECT_EQ(test, data->vals[0], rval); /* Disable bypass, the cache should still return the original value */ regcache_cache_bypass(map, false); KUNIT_EXPECT_EQ(test, 0, regmap_read(map, 0, &rval)); KUNIT_EXPECT_EQ(test, val, rval); regmap_exit(map); } static void cache_sync(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val[BLOCK_TEST_SIZE]; int i; config = test_regmap_config; config.cache_type = t->type; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; get_random_bytes(&val, sizeof(val)); /* Put some data into the cache */ KUNIT_EXPECT_EQ(test, 0, regmap_bulk_write(map, 0, val, BLOCK_TEST_SIZE)); for (i = 0; i < BLOCK_TEST_SIZE; i++) data->written[i] = false; /* Trash the data on the device itself then resync */ regcache_mark_dirty(map); memset(data->vals, 0, sizeof(val)); KUNIT_EXPECT_EQ(test, 0, regcache_sync(map)); /* Did we just write the correct data out? */ KUNIT_EXPECT_MEMEQ(test, data->vals, val, sizeof(val)); for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, true, data->written[i]); regmap_exit(map); } static void cache_sync_defaults(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val; int i; config = test_regmap_config; config.cache_type = t->type; config.num_reg_defaults = BLOCK_TEST_SIZE; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; get_random_bytes(&val, sizeof(val)); /* Change the value of one register */ KUNIT_EXPECT_EQ(test, 0, regmap_write(map, 2, val)); /* Resync */ regcache_mark_dirty(map); for (i = 0; i < BLOCK_TEST_SIZE; i++) data->written[i] = false; KUNIT_EXPECT_EQ(test, 0, regcache_sync(map)); /* Did we just sync the one register we touched? */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, i == 2, data->written[i]); regmap_exit(map); } static void cache_sync_readonly(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val; int i; config = test_regmap_config; config.cache_type = t->type; config.writeable_reg = reg_5_false; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; /* Read all registers to fill the cache */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, 0, regmap_read(map, i, &val)); /* Change the value of all registers, readonly should fail */ get_random_bytes(&val, sizeof(val)); regcache_cache_only(map, true); for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, i != 5, regmap_write(map, i, val) == 0); regcache_cache_only(map, false); /* Resync */ for (i = 0; i < BLOCK_TEST_SIZE; i++) data->written[i] = false; KUNIT_EXPECT_EQ(test, 0, regcache_sync(map)); /* Did that match what we see on the device? */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, i != 5, data->written[i]); regmap_exit(map); } static void cache_sync_patch(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; struct reg_sequence patch[2]; unsigned int rval[BLOCK_TEST_SIZE], val; int i; /* We need defaults so readback works */ config = test_regmap_config; config.cache_type = t->type; config.num_reg_defaults = BLOCK_TEST_SIZE; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; /* Stash the original values */ KUNIT_EXPECT_EQ(test, 0, regmap_bulk_read(map, 0, rval, BLOCK_TEST_SIZE)); /* Patch a couple of values */ patch[0].reg = 2; patch[0].def = rval[2] + 1; patch[0].delay_us = 0; patch[1].reg = 5; patch[1].def = rval[5] + 1; patch[1].delay_us = 0; KUNIT_EXPECT_EQ(test, 0, regmap_register_patch(map, patch, ARRAY_SIZE(patch))); /* Sync the cache */ regcache_mark_dirty(map); for (i = 0; i < BLOCK_TEST_SIZE; i++) data->written[i] = false; KUNIT_EXPECT_EQ(test, 0, regcache_sync(map)); /* The patch should be on the device but not in the cache */ for (i = 0; i < BLOCK_TEST_SIZE; i++) { KUNIT_EXPECT_EQ(test, 0, regmap_read(map, i, &val)); KUNIT_EXPECT_EQ(test, val, rval[i]); switch (i) { case 2: case 5: KUNIT_EXPECT_EQ(test, true, data->written[i]); KUNIT_EXPECT_EQ(test, data->vals[i], rval[i] + 1); break; default: KUNIT_EXPECT_EQ(test, false, data->written[i]); KUNIT_EXPECT_EQ(test, data->vals[i], rval[i]); break; } } regmap_exit(map); } static void cache_drop(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int rval[BLOCK_TEST_SIZE]; int i; config = test_regmap_config; config.cache_type = t->type; config.num_reg_defaults = BLOCK_TEST_SIZE; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; /* Ensure the data is read from the cache */ for (i = 0; i < BLOCK_TEST_SIZE; i++) data->read[i] = false; KUNIT_EXPECT_EQ(test, 0, regmap_bulk_read(map, 0, rval, BLOCK_TEST_SIZE)); for (i = 0; i < BLOCK_TEST_SIZE; i++) { KUNIT_EXPECT_FALSE(test, data->read[i]); data->read[i] = false; } KUNIT_EXPECT_MEMEQ(test, data->vals, rval, sizeof(rval)); /* Drop some registers */ KUNIT_EXPECT_EQ(test, 0, regcache_drop_region(map, 3, 5)); /* Reread and check only the dropped registers hit the device. */ KUNIT_EXPECT_EQ(test, 0, regmap_bulk_read(map, 0, rval, BLOCK_TEST_SIZE)); for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, data->read[i], i >= 3 && i <= 5); KUNIT_EXPECT_MEMEQ(test, data->vals, rval, sizeof(rval)); regmap_exit(map); } static void cache_present(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val; int i; config = test_regmap_config; config.cache_type = t->type; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; for (i = 0; i < BLOCK_TEST_SIZE; i++) data->read[i] = false; /* No defaults so no registers cached. */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_ASSERT_FALSE(test, regcache_reg_cached(map, i)); /* We didn't trigger any reads */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_ASSERT_FALSE(test, data->read[i]); /* Fill the cache */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_EXPECT_EQ(test, 0, regmap_read(map, i, &val)); /* Now everything should be cached */ for (i = 0; i < BLOCK_TEST_SIZE; i++) KUNIT_ASSERT_TRUE(test, regcache_reg_cached(map, i)); regmap_exit(map); } /* Check that caching the window register works with sync */ static void cache_range_window_reg(struct kunit *test) { struct regcache_types *t = (struct regcache_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val; int i; config = test_regmap_config; config.cache_type = t->type; config.volatile_reg = test_range_window_volatile; config.ranges = &test_range; config.num_ranges = 1; config.max_register = test_range.range_max; map = gen_regmap(&config, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; /* Write new values to the entire range */ for (i = test_range.range_min; i <= test_range.range_max; i++) KUNIT_ASSERT_EQ(test, 0, regmap_write(map, i, 0)); val = data->vals[test_range.selector_reg] & test_range.selector_mask; KUNIT_ASSERT_EQ(test, val, 2); /* Write to the first register in the range to reset the page */ KUNIT_ASSERT_EQ(test, 0, regmap_write(map, test_range.range_min, 0)); val = data->vals[test_range.selector_reg] & test_range.selector_mask; KUNIT_ASSERT_EQ(test, val, 0); /* Trigger a cache sync */ regcache_mark_dirty(map); KUNIT_ASSERT_EQ(test, 0, regcache_sync(map)); /* Write to the first register again, the page should be reset */ KUNIT_ASSERT_EQ(test, 0, regmap_write(map, test_range.range_min, 0)); val = data->vals[test_range.selector_reg] & test_range.selector_mask; KUNIT_ASSERT_EQ(test, val, 0); /* Trigger another cache sync */ regcache_mark_dirty(map); KUNIT_ASSERT_EQ(test, 0, regcache_sync(map)); /* Write to the last register again, the page should be reset */ KUNIT_ASSERT_EQ(test, 0, regmap_write(map, test_range.range_max, 0)); val = data->vals[test_range.selector_reg] & test_range.selector_mask; KUNIT_ASSERT_EQ(test, val, 2); } struct raw_test_types { const char *name; enum regcache_type cache_type; enum regmap_endian val_endian; }; static void raw_to_desc(const struct raw_test_types *t, char *desc) { strcpy(desc, t->name); } static const struct raw_test_types raw_types_list[] = { { "none-little", REGCACHE_NONE, REGMAP_ENDIAN_LITTLE }, { "none-big", REGCACHE_NONE, REGMAP_ENDIAN_BIG }, { "flat-little", REGCACHE_FLAT, REGMAP_ENDIAN_LITTLE }, { "flat-big", REGCACHE_FLAT, REGMAP_ENDIAN_BIG }, { "rbtree-little", REGCACHE_RBTREE, REGMAP_ENDIAN_LITTLE }, { "rbtree-big", REGCACHE_RBTREE, REGMAP_ENDIAN_BIG }, { "maple-little", REGCACHE_MAPLE, REGMAP_ENDIAN_LITTLE }, { "maple-big", REGCACHE_MAPLE, REGMAP_ENDIAN_BIG }, }; KUNIT_ARRAY_PARAM(raw_test_types, raw_types_list, raw_to_desc); static const struct raw_test_types raw_cache_types_list[] = { { "flat-little", REGCACHE_FLAT, REGMAP_ENDIAN_LITTLE }, { "flat-big", REGCACHE_FLAT, REGMAP_ENDIAN_BIG }, { "rbtree-little", REGCACHE_RBTREE, REGMAP_ENDIAN_LITTLE }, { "rbtree-big", REGCACHE_RBTREE, REGMAP_ENDIAN_BIG }, { "maple-little", REGCACHE_MAPLE, REGMAP_ENDIAN_LITTLE }, { "maple-big", REGCACHE_MAPLE, REGMAP_ENDIAN_BIG }, }; KUNIT_ARRAY_PARAM(raw_test_cache_types, raw_cache_types_list, raw_to_desc); static const struct regmap_config raw_regmap_config = { .max_register = BLOCK_TEST_SIZE, .reg_format_endian = REGMAP_ENDIAN_LITTLE, .reg_bits = 16, .val_bits = 16, }; static struct regmap *gen_raw_regmap(struct regmap_config *config, struct raw_test_types *test_type, struct regmap_ram_data **data) { u16 *buf; struct regmap *ret; size_t size = (config->max_register + 1) * config->reg_bits / 8; int i; struct reg_default *defaults; config->cache_type = test_type->cache_type; config->val_format_endian = test_type->val_endian; config->disable_locking = config->cache_type == REGCACHE_RBTREE || config->cache_type == REGCACHE_MAPLE; buf = kmalloc(size, GFP_KERNEL); if (!buf) return ERR_PTR(-ENOMEM); get_random_bytes(buf, size); *data = kzalloc(sizeof(**data), GFP_KERNEL); if (!(*data)) return ERR_PTR(-ENOMEM); (*data)->vals = (void *)buf; config->num_reg_defaults = config->max_register + 1; defaults = kcalloc(config->num_reg_defaults, sizeof(struct reg_default), GFP_KERNEL); if (!defaults) return ERR_PTR(-ENOMEM); config->reg_defaults = defaults; for (i = 0; i < config->num_reg_defaults; i++) { defaults[i].reg = i; switch (test_type->val_endian) { case REGMAP_ENDIAN_LITTLE: defaults[i].def = le16_to_cpu(buf[i]); break; case REGMAP_ENDIAN_BIG: defaults[i].def = be16_to_cpu(buf[i]); break; default: return ERR_PTR(-EINVAL); } } /* * We use the defaults in the tests but they don't make sense * to the core if there's no cache. */ if (config->cache_type == REGCACHE_NONE) config->num_reg_defaults = 0; ret = regmap_init_raw_ram(config, *data); if (IS_ERR(ret)) { kfree(buf); kfree(*data); } return ret; } static void raw_read_defaults_single(struct kunit *test) { struct raw_test_types *t = (struct raw_test_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int rval; int i; config = raw_regmap_config; map = gen_raw_regmap(&config, t, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; /* Check that we can read the defaults via the API */ for (i = 0; i < config.max_register + 1; i++) { KUNIT_EXPECT_EQ(test, 0, regmap_read(map, i, &rval)); KUNIT_EXPECT_EQ(test, config.reg_defaults[i].def, rval); } regmap_exit(map); } static void raw_read_defaults(struct kunit *test) { struct raw_test_types *t = (struct raw_test_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; u16 *rval; u16 def; size_t val_len; int i; config = raw_regmap_config; map = gen_raw_regmap(&config, t, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; val_len = sizeof(*rval) * (config.max_register + 1); rval = kmalloc(val_len, GFP_KERNEL); KUNIT_ASSERT_TRUE(test, rval != NULL); if (!rval) return; /* Check that we can read the defaults via the API */ KUNIT_EXPECT_EQ(test, 0, regmap_raw_read(map, 0, rval, val_len)); for (i = 0; i < config.max_register + 1; i++) { def = config.reg_defaults[i].def; if (config.val_format_endian == REGMAP_ENDIAN_BIG) { KUNIT_EXPECT_EQ(test, def, be16_to_cpu(rval[i])); } else { KUNIT_EXPECT_EQ(test, def, le16_to_cpu(rval[i])); } } kfree(rval); regmap_exit(map); } static void raw_write_read_single(struct kunit *test) { struct raw_test_types *t = (struct raw_test_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; u16 val; unsigned int rval; config = raw_regmap_config; map = gen_raw_regmap(&config, t, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; get_random_bytes(&val, sizeof(val)); /* If we write a value to a register we can read it back */ KUNIT_EXPECT_EQ(test, 0, regmap_write(map, 0, val)); KUNIT_EXPECT_EQ(test, 0, regmap_read(map, 0, &rval)); KUNIT_EXPECT_EQ(test, val, rval); regmap_exit(map); } static void raw_write(struct kunit *test) { struct raw_test_types *t = (struct raw_test_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; u16 *hw_buf; u16 val[2]; unsigned int rval; int i; config = raw_regmap_config; map = gen_raw_regmap(&config, t, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; hw_buf = (u16 *)data->vals; get_random_bytes(&val, sizeof(val)); /* Do a raw write */ KUNIT_EXPECT_EQ(test, 0, regmap_raw_write(map, 2, val, sizeof(val))); /* We should read back the new values, and defaults for the rest */ for (i = 0; i < config.max_register + 1; i++) { KUNIT_EXPECT_EQ(test, 0, regmap_read(map, i, &rval)); switch (i) { case 2: case 3: if (config.val_format_endian == REGMAP_ENDIAN_BIG) { KUNIT_EXPECT_EQ(test, rval, be16_to_cpu(val[i % 2])); } else { KUNIT_EXPECT_EQ(test, rval, le16_to_cpu(val[i % 2])); } break; default: KUNIT_EXPECT_EQ(test, config.reg_defaults[i].def, rval); break; } } /* The values should appear in the "hardware" */ KUNIT_EXPECT_MEMEQ(test, &hw_buf[2], val, sizeof(val)); regmap_exit(map); } static bool reg_zero(struct device *dev, unsigned int reg) { return reg == 0; } static bool ram_reg_zero(struct regmap_ram_data *data, unsigned int reg) { return reg == 0; } static void raw_noinc_write(struct kunit *test) { struct raw_test_types *t = (struct raw_test_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; unsigned int val; u16 val_test, val_last; u16 val_array[BLOCK_TEST_SIZE]; config = raw_regmap_config; config.volatile_reg = reg_zero; config.writeable_noinc_reg = reg_zero; config.readable_noinc_reg = reg_zero; map = gen_raw_regmap(&config, t, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; data->noinc_reg = ram_reg_zero; get_random_bytes(&val_array, sizeof(val_array)); if (config.val_format_endian == REGMAP_ENDIAN_BIG) { val_test = be16_to_cpu(val_array[1]) + 100; val_last = be16_to_cpu(val_array[BLOCK_TEST_SIZE - 1]); } else { val_test = le16_to_cpu(val_array[1]) + 100; val_last = le16_to_cpu(val_array[BLOCK_TEST_SIZE - 1]); } /* Put some data into the register following the noinc register */ KUNIT_EXPECT_EQ(test, 0, regmap_write(map, 1, val_test)); /* Write some data to the noinc register */ KUNIT_EXPECT_EQ(test, 0, regmap_noinc_write(map, 0, val_array, sizeof(val_array))); /* We should read back the last value written */ KUNIT_EXPECT_EQ(test, 0, regmap_read(map, 0, &val)); KUNIT_ASSERT_EQ(test, val_last, val); /* Make sure we didn't touch the register after the noinc register */ KUNIT_EXPECT_EQ(test, 0, regmap_read(map, 1, &val)); KUNIT_ASSERT_EQ(test, val_test, val); regmap_exit(map); } static void raw_sync(struct kunit *test) { struct raw_test_types *t = (struct raw_test_types *)test->param_value; struct regmap *map; struct regmap_config config; struct regmap_ram_data *data; u16 val[3]; u16 *hw_buf; unsigned int rval; int i; config = raw_regmap_config; map = gen_raw_regmap(&config, t, &data); KUNIT_ASSERT_FALSE(test, IS_ERR(map)); if (IS_ERR(map)) return; hw_buf = (u16 *)data->vals; get_changed_bytes(&hw_buf[2], &val[0], sizeof(val)); /* Do a regular write and a raw write in cache only mode */ regcache_cache_only(map, true); KUNIT_EXPECT_EQ(test, 0, regmap_raw_write(map, 2, val, sizeof(u16) * 2)); KUNIT_EXPECT_EQ(test, 0, regmap_write(map, 4, val[2])); /* We should read back the new values, and defaults for the rest */ for (i = 0; i < config.max_register + 1; i++) { KUNIT_EXPECT_EQ(test, 0, regmap_read(map, i, &rval)); switch (i) { case 2: case 3: if (config.val_format_endian == REGMAP_ENDIAN_BIG) { KUNIT_EXPECT_EQ(test, rval, be16_to_cpu(val[i - 2])); } else { KUNIT_EXPECT_EQ(test, rval, le16_to_cpu(val[i - 2])); } break; case 4: KUNIT_EXPECT_EQ(test, rval, val[i - 2]); break; default: KUNIT_EXPECT_EQ(test, config.reg_defaults[i].def, rval); break; } } /* * The value written via _write() was translated by the core, * translate the original copy for comparison purposes. */ if (config.val_format_endian == REGMAP_ENDIAN_BIG) val[2] = cpu_to_be16(val[2]); else val[2] = cpu_to_le16(val[2]); /* The values should not appear in the "hardware" */ KUNIT_EXPECT_MEMNEQ(test, &hw_buf[2], &val[0], sizeof(val)); for (i = 0; i < config.max_register + 1; i++) data->written[i] = false; /* Do the sync */ regcache_cache_only(map, false); regcache_mark_dirty(map); KUNIT_EXPECT_EQ(test, 0, regcache_sync(map)); /* The values should now appear in the "hardware" */ KUNIT_EXPECT_MEMEQ(test, &hw_buf[2], &val[0], sizeof(val)); regmap_exit(map); } static struct kunit_case regmap_test_cases[] = { KUNIT_CASE_PARAM(basic_read_write, regcache_types_gen_params), KUNIT_CASE_PARAM(bulk_write, regcache_types_gen_params), KUNIT_CASE_PARAM(bulk_read, regcache_types_gen_params), KUNIT_CASE_PARAM(write_readonly, regcache_types_gen_params), KUNIT_CASE_PARAM(read_writeonly, regcache_types_gen_params), KUNIT_CASE_PARAM(reg_defaults, regcache_types_gen_params), KUNIT_CASE_PARAM(reg_defaults_read_dev, regcache_types_gen_params), KUNIT_CASE_PARAM(register_patch, regcache_types_gen_params), KUNIT_CASE_PARAM(stride, regcache_types_gen_params), KUNIT_CASE_PARAM(basic_ranges, regcache_types_gen_params), KUNIT_CASE_PARAM(stress_insert, regcache_types_gen_params), KUNIT_CASE_PARAM(cache_bypass, real_cache_types_gen_params), KUNIT_CASE_PARAM(cache_sync, real_cache_types_gen_params), KUNIT_CASE_PARAM(cache_sync_defaults, real_cache_types_gen_params), KUNIT_CASE_PARAM(cache_sync_readonly, real_cache_types_gen_params), KUNIT_CASE_PARAM(cache_sync_patch, real_cache_types_gen_params), KUNIT_CASE_PARAM(cache_drop, sparse_cache_types_gen_params), KUNIT_CASE_PARAM(cache_present, sparse_cache_types_gen_params), KUNIT_CASE_PARAM(cache_range_window_reg, real_cache_types_gen_params), KUNIT_CASE_PARAM(raw_read_defaults_single, raw_test_types_gen_params), KUNIT_CASE_PARAM(raw_read_defaults, raw_test_types_gen_params), KUNIT_CASE_PARAM(raw_write_read_single, raw_test_types_gen_params), KUNIT_CASE_PARAM(raw_write, raw_test_types_gen_params), KUNIT_CASE_PARAM(raw_noinc_write, raw_test_types_gen_params), KUNIT_CASE_PARAM(raw_sync, raw_test_cache_types_gen_params), {} }; static struct kunit_suite regmap_test_suite = { .name = "regmap", .test_cases = regmap_test_cases, }; kunit_test_suite(regmap_test_suite); MODULE_LICENSE("GPL v2");