DRIVER=serial8250 MODALIAS=platform:serial8250 +l4( (  fB- [e_I|+-/* SPDX-License-Identifier: GPL-2.0-only */ /* * cs_dsp.h -- Cirrus Logic DSP firmware support * * Based on sound/soc/codecs/wm_adsp.h * * Copyright 2012 Wolfson Microelectronics plc * Copyright (C) 2015-2021 Cirrus Logic, Inc. and * Cirrus Logic International Semiconductor Ltd. */ #ifndef __CS_DSP_H #define __CS_DSP_H #include #include #include #include #include #define CS_ADSP2_REGION_0 BIT(0) #define CS_ADSP2_REGION_1 BIT(1) #define CS_ADSP2_REGION_2 BIT(2) #define CS_ADSP2_REGION_3 BIT(3) #define CS_ADSP2_REGION_4 BIT(4) #define CS_ADSP2_REGION_5 BIT(5) #define CS_ADSP2_REGION_6 BIT(6) #define CS_ADSP2_REGION_7 BIT(7) #define CS_ADSP2_REGION_8 BIT(8) #define CS_ADSP2_REGION_9 BIT(9) #define CS_ADSP2_REGION_1_9 (CS_ADSP2_REGION_1 | \ CS_ADSP2_REGION_2 | CS_ADSP2_REGION_3 | \ CS_ADSP2_REGION_4 | CS_ADSP2_REGION_5 | \ CS_ADSP2_REGION_6 | CS_ADSP2_REGION_7 | \ CS_ADSP2_REGION_8 | CS_ADSP2_REGION_9) #define CS_ADSP2_REGION_ALL (CS_ADSP2_REGION_0 | CS_ADSP2_REGION_1_9) #define CS_DSP_DATA_WORD_SIZE 3 #define CS_DSP_DATA_WORD_BITS (3 * BITS_PER_BYTE) #define CS_DSP_ACKED_CTL_TIMEOUT_MS 100 #define CS_DSP_ACKED_CTL_N_QUICKPOLLS 10 #define CS_DSP_ACKED_CTL_MIN_VALUE 0 #define CS_DSP_ACKED_CTL_MAX_VALUE 0xFFFFFF /* * Write sequence operation codes */ #define CS_DSP_WSEQ_FULL 0x00 #define CS_DSP_WSEQ_ADDR8 0x02 #define CS_DSP_WSEQ_L16 0x04 #define CS_DSP_WSEQ_H16 0x05 #define CS_DSP_WSEQ_UNLOCK 0xFD #define CS_DSP_WSEQ_END 0xFF /** * struct cs_dsp_region - Describes a logical memory region in DSP address space * @type: Memory region type * @base: Address of region */ struct cs_dsp_region { int type; unsigned int base; }; /** * struct cs_dsp_alg_region - Describes a logical algorithm region in DSP address space * @alg: Algorithm id * @ver: Expected algorithm version * @type: Memory region type * @base: Address of region */ struct cs_dsp_alg_region { unsigned int alg; unsigned int ver; int type; unsigned int base; }; /** * struct cs_dsp_coeff_ctl - Describes a coefficient control * @fw_name: Name of the firmware * @subname: Name of the control parsed from the WMFW * @subname_len: Length of subname * @alg_region: Logical region associated with this control * @dsp: DSP instance associated with this control * @enabled: Flag indicating whether control is enabled * @list: List node for internal use * @cache: Cached value of the control * @offset: Offset of control within alg_region in words * @len: Length of the cached value in bytes * @set: Flag indicating the value has been written by the user * @flags: Bitfield of WMFW_CTL_FLAG_ control flags defined in wmfw.h * @type: One of the WMFW_CTL_TYPE_ control types defined in wmfw.h * @priv: For use by the client */ struct cs_dsp_coeff_ctl { const char *fw_name; /* Subname is needed to match with firmware */ const char *subname; unsigned int subname_len; struct cs_dsp_alg_region alg_region; struct cs_dsp *dsp; unsigned int enabled:1; struct list_head list; void *cache; unsigned int offset; size_t len; unsigned int set:1; unsigned int flags; unsigned int type; void *priv; }; struct cs_dsp_ops; struct cs_dsp_client_ops; /** * struct cs_dsp - Configuration and state of a Cirrus Logic DSP * @name: The name of the DSP instance * @rev: Revision of the DSP * @num: DSP instance number * @type: Type of DSP * @dev: Driver model representation of the device * @regmap: Register map of the device * @ops: Function pointers for internal callbacks * @client_ops: Function pointers for client callbacks * @base: Address of the DSP registers * @base_sysinfo: Address of the sysinfo register (Halo only) * @sysclk_reg: Address of the sysclk register (ADSP1 only) * @sysclk_mask: Mask of frequency bits within sysclk regist