// SPDX-License-Identifier: GPL-2.0-only // // KUnit tests for cs_dsp. // // Copyright (C) 2024 Cirrus Logic, Inc. and // Cirrus Logic International Semiconductor Ltd. #include <kunit/device.h>#include <kunit/resource.h>#include <kunit/test.h>#include <linux/build_bug.h>#include <linux/firmware/cirrus/cs_dsp.h>#include <linux/firmware/cirrus/cs_dsp_test_utils.h>#include <linux/firmware/cirrus/wmfw.h>#include <linux/list.h>#include <linux/random.h>#include <linux/regmap.h>struct device *);struct cs_dsp *);struct cs_dsp *);struct cs_dsp_test_local {struct cs_dsp_mock_xm_header *xm_header;struct cs_dsp_mock_wmfw_builder *wmfw_builder;int wmfw_version;struct cs_dsp_ctl_rw_test_param {int mem_type;int alg_id;unsigned int offs_words;unsigned int len_bytes;static const struct cs_dsp_mock_alg_def cs_dsp_ctl_rw_test_algs[] = {0 xfafa,0 x100000,60 ,1000 ,0 ,1000 ,0 ,1000 ,0 xb,0 x100001,1060 ,1000 ,1000 ,1000 ,1000 ,1000 ,0 x9f1234,0 x100500,2060 ,32 ,2000 ,32 ,2000 ,32 ,0 xff00ff,0 x300113,2100 ,32 ,2032 ,32 ,2032 ,32 ,static const struct cs_dsp_mock_coeff_def mock_coeff_template = {"Dummy Coeff" ,4 ,static int _find_alg_entry(struct kunit *test, unsigned int alg_id)int i;for (i = 0 ; i < ARRAY_SIZE(cs_dsp_ctl_rw_test_algs); ++i) {if (cs_dsp_ctl_rw_test_algs[i].id == alg_id)break ;return i;static int _get_alg_mem_base_words(struct kunit *test, int alg_index, int mem_type)switch (mem_type) {case WMFW_ADSP2_XM:return cs_dsp_ctl_rw_test_algs[alg_index].xm_base_words;case WMFW_ADSP2_YM:return cs_dsp_ctl_rw_test_algs[alg_index].ym_base_words;case WMFW_ADSP2_ZM:return cs_dsp_ctl_rw_test_algs[alg_index].zm_base_words;default :"Bug in test: illegal memory type %d\n" , mem_type);return 0 ;static struct cs_dsp_mock_wmfw_builder *_create_dummy_wmfw(struct kunit *test)struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp_mock_wmfw_builder *builder;/* Init an XM header */ 0 ,return builder;/* * Write to a control while the firmware is running . * This should write to the underlying registers . static void cs_dsp_ctl_write_running(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ 0 , param->len_bytes);/* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* * Write new data to the control , it should be written to the registers * and cs_dsp_coeff_lock_and_write_ctrl ( ) should return 1 to indicate * that the control content changed . 0 , reg_vals, param->len_bytes),1 );0 );/* Drop expected writes and the regmap cache should be clean */ true ));/* * Read from a volatile control while the firmware is running . * This should return the current state of the underlying registers . static void cs_dsp_ctl_read_volatile_running(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ 0 , param->len_bytes);/* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* Read the control, it should return the current register content */ 0 , readback, param->len_bytes),0 );/* * Change the register content and read the control , it should return * the new register content 0 );0 , readback, param->len_bytes),0 );/* * Read from a volatile control before the firmware is started . * This should return an error . static void cs_dsp_ctl_read_volatile_not_started(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );/* Read the control, it should return an error */ struct cs_dsp_coeff_ctl, list);0 , reg_vals, param->len_bytes),0 );/* * Read from a volatile control after the firmware has stopped . * This should return an error . static void cs_dsp_ctl_read_volatile_stopped(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );/* Start and stop the firmware */ 0 );/* Read the control, it should return an error */ struct cs_dsp_coeff_ctl, list);0 , reg_vals, param->len_bytes),0 );/* * Read from a volatile control after the DSP has been powered down . * This should return an error . static void cs_dsp_ctl_read_volatile_stopped_powered_down(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );/* Start and stop the firmware then power down */ 0 );/* Read the control, it should return an error */ struct cs_dsp_coeff_ctl, list);0 , reg_vals, param->len_bytes),0 );/* * Read from a volatile control when a different firmware is currently * loaded into the DSP . * Should return an error . static void cs_dsp_ctl_read_volatile_not_current_loaded_fw(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;struct cs_dsp_mock_wmfw_builder *builder2 = _create_dummy_wmfw(test);int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some DSP data to be read into the control cache */ /* Create control pointing to this data */ "dummyalg" , NULL);/* Power-up DSP */ "mock_fw" , NULL, NULL, "misc" ), 0 );/* Power-down DSP then power-up with a different firmware */ "mock_fw2" , NULL, NULL, "mbc.vss" ), 0 );/* Read the control, it should return an error */ struct cs_dsp_coeff_ctl, list);0 , reg_vals, param->len_bytes),0 );/* * Read from a volatile control when a different firmware is currently * running . * Should return an error . static void cs_dsp_ctl_read_volatile_not_current_running_fw(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;struct cs_dsp_mock_wmfw_builder *builder2 = _create_dummy_wmfw(test);int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some DSP data to be read into the control cache */ /* Create control pointing to this data */ "dummyalg" , NULL);/* Power-up DSP */ "mock_fw" , NULL, NULL, "misc" ), 0 );/* Power-down DSP then power-up with a different firmware */ "mock_fw2" , NULL, NULL, "mbc.vss" ), 0 );/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* Read the control, it should return an error */ struct cs_dsp_coeff_ctl, list);0 , reg_vals, param->len_bytes),0 );/* * Write to a volatile control before the firmware is started . * This should return an error . static void cs_dsp_ctl_write_volatile_not_started(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );/* Drop expected writes and the regmap cache should be clean */ /* Write the control, it should return an error */ struct cs_dsp_coeff_ctl, list);0 , reg_vals, param->len_bytes),0 );/* Should not have been any writes to registers */ true ));/* * Write to a volatile control after the firmware has stopped . * This should return an error . static void cs_dsp_ctl_write_volatile_stopped(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );/* Start and stop the firmware */ 0 );/* Drop expected writes and the regmap cache should be clean */ /* Write the control, it should return an error */ struct cs_dsp_coeff_ctl, list);0 , reg_vals, param->len_bytes),0 );/* Should not have been any writes to registers */ true ));/* * Write to a volatile control after the DSP has been powered down . * This should return an error . static void cs_dsp_ctl_write_volatile_stopped_powered_down(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );/* Start and stop the firmware then power down */ 0 );/* Drop expected writes and the regmap cache should be clean */ /* Write the control, it should return an error */ struct cs_dsp_coeff_ctl, list);0 , reg_vals, param->len_bytes),0 );/* Should not have been any writes to registers */ true ));/* * Write to a volatile control when a different firmware is currently * loaded into the DSP . * Should return an error . static void cs_dsp_ctl_write_volatile_not_current_loaded_fw(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;struct cs_dsp_mock_wmfw_builder *builder2 = _create_dummy_wmfw(test);int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some DSP data to be read into the control cache */ /* Create control pointing to this data */ "dummyalg" , NULL);/* Power-up DSP */ "mock_fw" , NULL, NULL, "misc" ), 0 );/* Power-down DSP then power-up with a different firmware */ "mock_fw2" , NULL, NULL, "mbc.vss" ), 0 );/* Drop expected writes and the regmap cache should be clean */ /* Write the control, it should return an error */ struct cs_dsp_coeff_ctl, list);0 , reg_vals, param->len_bytes),0 );/* Should not have been any writes to registers */ true ));/* * Write to a volatile control when a different firmware is currently * running . * Should return an error . static void cs_dsp_ctl_write_volatile_not_current_running_fw(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;struct cs_dsp_mock_wmfw_builder *builder2 = _create_dummy_wmfw(test);int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some DSP data to be read into the control cache */ /* Create control pointing to this data */ "dummyalg" , NULL);/* Power-up DSP */ "mock_fw" , NULL, NULL, "misc" ), 0 );/* Power-down DSP then power-up with a different firmware */ "mock_fw2" , NULL, NULL, "mbc.vss" ), 0 );/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* Drop expected writes and the regmap cache should be clean */ /* Write the control, it should return an error */ struct cs_dsp_coeff_ctl, list);0 , reg_vals, param->len_bytes),0 );/* Should not have been any writes to registers */ true ));/* * Read from an offset into the control data . Should return only the * portion of data from the offset position . static void cs_dsp_ctl_read_with_seek(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;unsigned int seek_words;48 ;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );for (seek_words = 1 ; seek_words < (def.length_bytes / sizeof (u32)); seek_words++) {unsigned int len_bytes = def.length_bytes - (seek_words * sizeof (u32));0 );/* * Read from an offset into the control cache . Should return only the * portion of data from the offset position . * Same as cs_dsp_ctl_read_with_seek ( ) except the control is cached * and the firmware is not running . static void cs_dsp_ctl_read_cache_with_seek(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;unsigned int seek_words;48 ;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start and stop the firmware so the read will come from the cache */ 0 );for (seek_words = 1 ; seek_words < (def.length_bytes / sizeof (u32)); seek_words++) {unsigned int len_bytes = def.length_bytes - (seek_words * sizeof (u32));0 );/* * Read less than the full length of data from a control . Should return * only the requested number of bytes . static void cs_dsp_ctl_read_truncated(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;unsigned int len_bytes;48 ;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* Reads are only allowed to be a multiple of the DSP word length */ for (len_bytes = sizeof (u32); len_bytes < def.length_bytes; len_bytes += sizeof (u32)) {0 , def.length_bytes);0 , readback, len_bytes),0 );/* * Read less than the full length of data from a cached control . * Should return only the requested number of bytes . * Same as cs_dsp_ctl_read_truncated ( ) except the control is cached * and the firmware is not running . static void cs_dsp_ctl_read_cache_truncated(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;unsigned int len_bytes;48 ;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start and stop the firmware so the read will come from the cache */ 0 );/* Reads are only allowed to be a multiple of the DSP word length */ for (len_bytes = sizeof (u32); len_bytes < def.length_bytes; len_bytes += sizeof (u32)) {0 , def.length_bytes);0 , readback, len_bytes),0 );/* * Write to an offset into the control data . Should only change the * portion of data from the offset position . static void cs_dsp_ctl_write_with_seek(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;unsigned int seek_words;48 ;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );for (seek_words = 1 ; seek_words < (def.length_bytes / sizeof (u32)); seek_words++) {unsigned int len_bytes = def.length_bytes - (seek_words * sizeof (u32));/* Reset the register values to the test data */ 1 );0 );/* Initial portion of readback should be unchanged */ sizeof (u32));/* * Write to an offset into the control cache . Should only change the * portion of data from the offset position . * Same as cs_dsp_ctl_write_with_seek ( ) except the control is cached * and the firmware is not running . static void cs_dsp_ctl_write_cache_with_seek(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;unsigned int seek_words;48 ;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start and stop the firmware so the read will come from the cache */ 0 );for (seek_words = 1 ; seek_words < (def.length_bytes / sizeof (u32)); seek_words++) {unsigned int len_bytes = def.length_bytes - (seek_words * sizeof (u32));/* Reset the cache to the test data */ 0 , reg_vals,0 );1 );0 , def.length_bytes);0 , readback,0 );/* Initial portion of readback should be unchanged */ sizeof (u32));/* * Write less than the full length of data to a control . Should only * change the requested number of bytes . static void cs_dsp_ctl_write_truncated(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;unsigned int len_bytes;48 ;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* Writes are only allowed to be a multiple of the DSP word length */ for (len_bytes = sizeof (u32); len_bytes < def.length_bytes; len_bytes += sizeof (u32)) {/* Reset the register values to the test data */ 0 , new_data, len_bytes),1 );0 , def.length_bytes);0 );/* * Write less than the full length of data to a cached control . * Should only change the requested number of bytes . * Same as cs_dsp_ctl_write_truncated ( ) except the control is cached * and the firmware is not running . static void cs_dsp_ctl_write_cache_truncated(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;unsigned int len_bytes;48 ;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start and stop the firmware so the read will come from the cache */ 0 );/* Writes are only allowed to be a multiple of the DSP word length */ for (len_bytes = sizeof (u32); len_bytes < def.length_bytes; len_bytes += sizeof (u32)) {/* Reset the cache to the test data */ 0 , reg_vals,0 );0 , new_data, len_bytes),1 );0 , def.length_bytes);0 , readback,0 );/* * Read from an offset that is beyond the end of the control data . * Should return an error . static void cs_dsp_ctl_read_with_seek_oob(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;unsigned int seek_words;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );sizeof (u32);0 );if (!(def.flags & WMFW_CTL_FLAG_VOLATILE)) {/* Stop firmware and repeat the read from the cache */ 0 );/* * Read more data than the length of the control data . * Should return an error . static void cs_dsp_ctl_read_with_length_overflow(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );0 , reg_vals, def.length_bytes + 1 ),0 );if (!(def.flags & WMFW_CTL_FLAG_VOLATILE)) {/* Stop firmware and repeat the read from the cache */ 0 , reg_vals,1 ),0 );/* * Read with a seek and length that ends beyond the end of control data . * Should return an error . static void cs_dsp_ctl_read_with_seek_and_length_oob(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* * Read full control length but at a start offset of 1 so that * offset + length exceeds the length of the control . 1 , reg_vals, def.length_bytes),0 );if (!(def.flags & WMFW_CTL_FLAG_VOLATILE)) {/* Stop firmware and repeat the read from the cache */ 1 , reg_vals,0 );/* * Write to an offset that is beyond the end of the control data . * Should return an error without touching any registers . static void cs_dsp_ctl_write_with_seek_oob(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;unsigned int seek_words;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* Drop expected writes and the regmap cache should be clean */ sizeof (u32);0 );if (!(def.flags & WMFW_CTL_FLAG_VOLATILE)) {/* Stop firmware and repeat the write to the cache */ 0 );/* Check that it didn't write any registers */ true ));/* * Write more data than the length of the control data . * Should return an error . static void cs_dsp_ctl_write_with_length_overflow(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* Drop expected writes and the regmap cache should be clean */ 0 , reg_vals, def.length_bytes + 1 ),0 );if (!(def.flags & WMFW_CTL_FLAG_VOLATILE)) {/* Stop firmware and repeat the write to the cache */ 0 , reg_vals,1 ),0 );/* Check that it didn't write any registers */ true ));/* * Write with a seek and length that ends beyond the end of control data . * Should return an error . static void cs_dsp_ctl_write_with_seek_and_length_oob(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* Drop expected writes and the regmap cache should be clean */ /* * Write full control length but at a start offset of 1 so that * offset + length exceeeds the length of the control . 1 , reg_vals, def.length_bytes),0 );if (!(def.flags & WMFW_CTL_FLAG_VOLATILE)) {/* Stop firmware and repeat the write to the cache */ 1 , reg_vals,0 );/* Check that it didn't write any registers */ true ));/* * Read from a write - only control . This is legal because controls can * always be read . Write - only only indicates that it is not useful to * populate the cache from the DSP memory . static void cs_dsp_ctl_read_from_writeonly(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Sanity check parameters */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* Write some test data to the control */ 0 , ctl_vals, def.length_bytes),1 );/* Read back the data */ 0 , readback, def.length_bytes),0 );if (!(def.flags & WMFW_CTL_FLAG_VOLATILE)) {/* Stop firmware and repeat the read from the cache */ 0 , def.length_bytes);0 , readback,0 );/* * Write to a read - only control . * This should return an error without writing registers . static void cs_dsp_ctl_write_to_readonly(struct kunit *test)const struct cs_dsp_ctl_rw_test_param *param = test->param_value;struct cs_dsp_test *priv = test->priv;struct cs_dsp_test_local *local = priv->local;struct cs_dsp *dsp = priv->dsp;struct cs_dsp_mock_coeff_def def = mock_coeff_template;int alg_idx = _find_alg_entry(test, param->alg_id);unsigned int reg, alg_base_words;struct cs_dsp_coeff_ctl *ctl;struct firmware *wmfw;/* Sanity check parameters */ /* Create some initial register content */ /* Create control pointing to this data */ "dummyalg" , NULL);"mock_fw" , NULL, NULL, "misc" ), 0 );struct cs_dsp_coeff_ctl, list);/* Start the firmware and add an action to stop it during cleanup */ 0 );0 );/* Drop expected writes and the regmap cache should be clean */ 0 , reg_vals, def.length_bytes),0 );if (!(def.flags & WMFW_CTL_FLAG_VOLATILE)) {/* Stop firmware and repeat the write to the cache */ 0 , reg_vals,0 );/* Check that it didn't write any registers */ true ));static int cs_dsp_ctl_rw_test_common_init(struct kunit *test, struct cs_dsp *dsp,int wmfw_version)struct cs_dsp_test *priv;struct cs_dsp_test_local *local;struct device *test_dev;int ret;sizeof (*priv), GFP_KERNEL);if (!priv)return -ENOMEM;sizeof (struct cs_dsp_test_local), GFP_KERNEL);if (!local)return -ENOMEM;/* Create dummy struct device */ "cs_dsp_test_drv" );if (IS_ERR(test_dev))return PTR_ERR(test_dev);if (!dsp->dev)return -ENODEV;if (ret)return ret;/* Allocate regmap */ if (ret)return ret;/* * There must always be a XM header with at least 1 algorithm , so create * a dummy one that tests can use and extract it to a data blob . /* Create wmfw builder */ /* Init cs_dsp */ sizeof (*dsp->client_ops), GFP_KERNEL);switch (dsp->type) {case WMFW_ADSP2:break ;case WMFW_HALO:break ;default :"Untested DSP type %d\n" , dsp->type);return -EINVAL;if (ret)return ret;/* Automatically call cs_dsp_remove() when test case ends */ return kunit_add_action_or_reset(priv->test, _cs_dsp_remove_wrapper, dsp);static int cs_dsp_ctl_rw_test_halo_init(struct kunit *test)struct cs_dsp *dsp;/* Fill in cs_dsp and initialize */ sizeof (*dsp), GFP_KERNEL);if (!dsp)return -ENOMEM;1 ;return cs_dsp_ctl_rw_test_common_init(test, dsp, 3 );static int cs_dsp_ctl_rw_test_adsp2_32bit_init(struct kunit *test, int wmfw_ver)struct cs_dsp *dsp;/* Fill in cs_dsp and initialize */ sizeof (*dsp), GFP_KERNEL);if (!dsp)return -ENOMEM;1 ;1 ;);return cs_dsp_ctl_rw_test_common_init(test, dsp, wmfw_ver);static int cs_dsp_ctl_rw_test_adsp2_32bit_wmfw1_init(struct kunit *test)return cs_dsp_ctl_rw_test_adsp2_32bit_init(test, 1 );static int cs_dsp_ctl_rw_test_adsp2_32bit_wmfw2_init(struct kunit *test)return cs_dsp_ctl_rw_test_adsp2_32bit_init(test, 2 );static int cs_dsp_ctl_rw_test_adsp2_16bit_init(struct kunit *test, int wmfw_ver)struct cs_dsp *dsp;/* Fill in cs_dsp and initialize */ sizeof (*dsp), GFP_KERNEL);if (!dsp)return -ENOMEM;1 ;0 ;);return cs_dsp_ctl_rw_test_common_init(test, dsp, wmfw_ver);static int cs_dsp_ctl_rw_test_adsp2_16bit_wmfw1_init(struct kunit *test)return cs_dsp_ctl_rw_test_adsp2_16bit_init(test, 1 );static int cs_dsp_ctl_rw_test_adsp2_16bit_wmfw2_init(struct kunit *test)return cs_dsp_ctl_rw_test_adsp2_16bit_init(test, 2 );static void cs_dsp_ctl_all_param_desc(const struct cs_dsp_ctl_rw_test_param *param,char *desc)"alg:%#x %s@%u len:%u flags:%#x" ,/* All parameters populated, with various lengths */ static const struct cs_dsp_ctl_rw_test_param all_pop_varying_len_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 8 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 12 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 16 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 48 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 100 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 512 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 1000 },/* All parameters populated, with various offsets */ static const struct cs_dsp_ctl_rw_test_param all_pop_varying_offset_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 0 , .len_bytes = 4 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 2 , .len_bytes = 4 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 3 , .len_bytes = 4 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 8 , .len_bytes = 4 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 10 , .len_bytes = 4 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 128 , .len_bytes = 4 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 180 , .len_bytes = 4 },/* All parameters populated, with various X and Y memory regions */ static const struct cs_dsp_ctl_rw_test_param all_pop_varying_xy_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_XM, .offs_words = 1 , .len_bytes = 4 },0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 },/* All parameters populated, using ZM */ static const struct cs_dsp_ctl_rw_test_param all_pop_z_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_ZM, .offs_words = 1 , .len_bytes = 4 },/* All parameters populated, with various algorithm ids */ static const struct cs_dsp_ctl_rw_test_param all_pop_varying_alg_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 },0 xb, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 },0 x9f1234, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 },0 xff00ff, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 },/* * All parameters populated , with all combinations of flags for a * readable control . static const struct cs_dsp_ctl_rw_test_param all_pop_readable_flags_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,/* * All parameters populated , with all combinations of flags for a * read - only control static const struct cs_dsp_ctl_rw_test_param all_pop_readonly_flags_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,/* * All parameters populated , with all combinations of flags for a * non - volatile readable control static const struct cs_dsp_ctl_rw_test_param all_pop_nonvol_readable_flags_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,/* * All parameters populated , with all combinations of flags for a * writeable control static const struct cs_dsp_ctl_rw_test_param all_pop_writeable_flags_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,/* * All parameters populated , with all combinations of flags for a * write - only control static const struct cs_dsp_ctl_rw_test_param all_pop_writeonly_flags_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,/* * All parameters populated , with all combinations of flags for a * non - volatile writeable control static const struct cs_dsp_ctl_rw_test_param all_pop_nonvol_writeable_flags_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,/* * All parameters populated , with all combinations of flags for a * volatile readable control . static const struct cs_dsp_ctl_rw_test_param all_pop_volatile_readable_flags_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 /* flags == 0 is volatile while firmware is running */ 0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,/* * All parameters populated , with all combinations of flags for a * volatile readable control . static const struct cs_dsp_ctl_rw_test_param all_pop_volatile_writeable_flags_cases[] = {0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 /* flags == 0 is volatile while firmware is running */ 0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,0 xfafa, .mem_type = WMFW_ADSP2_YM, .offs_words = 1 , .len_bytes = 4 ,static struct kunit_case cs_dsp_ctl_rw_test_cases_adsp[] = {),ams),,/* terminator */ static struct kunit_case cs_dsp_ctl_rw_test_cases_halo[] = {),ams),,/* terminator */ static struct kunit_suite cs_dsp_ctl_rw_test_halo = {"cs_dsp_ctl_rw_wmfwV3_halo" ,static struct kunit_suite cs_dsp_ctl_rw_test_adsp2_32bit_wmfw1 = {"cs_dsp_ctl_rw_wmfwV1_adsp2_32bit" ,static struct kunit_suite cs_dsp_ctl_rw_test_adsp2_32bit_wmfw2 = {"cs_dsp_ctl_rw_wmfwV2_adsp2_32bit" ,static struct kunit_suite cs_dsp_ctl_rw_test_adsp2_16bit_wmfw1 = {"cs_dsp_ctl_rw_wmfwV1_adsp2_16bit" ,static struct kunit_suite cs_dsp_ctl_rw_test_adsp2_16bit_wmfw2 = {"cs_dsp_ctl_rw_wmfwV2_adsp2_16bit" ,
Messung V0.5 in Prozent C=93 H=98 G=95
¤ Dauer der Verarbeitung: 0.51 Sekunden
(vorverarbeitet am 2026-10-02)
¤ *© Formatika GbR, Deutschland
