b6b62d942b
The parts supported by this driver can have product-specific
firmware and tunings files. Typically these have been used on
embedded systems where the manufacturer is responsible for
installing the correct product-specific firmware files into
/lib/firmware. However, the linux-firmware repository places all
available firmwares into /lib/firmware and it is up to the driver to
select the correct product-specific firmware from that directory.
For example a product containing four smart amplifiers may provide
firmware specific for that product and each of the amplifiers may
have coefficient files containing tunings for their placement in the
mechanical design.
This change extends firmware (wmfw) and coefficient (bin) filenames
to be of the general form:
<cirrus/>part-dspN-fwtype<-system_name<-asoc_component_prefix>>.type
Where the cirrus subdirectory, system_name and asoc_component_prefix
are optional.
New files will be placed in the cirrus subdirectory to avoid
polluting the main /lib/firmware/ location. The generic name must be
searched in /lib/firmware before /lib/firmware/cirrus so that a
generic file in the new location does not override existing
product-specific files in the legacy location.
The search order for firmware files is:
- cirrus/part-dspN-fwtype-system_name-asoc_component_prefix.wmfw
- cirrus/part-dspN-fwtype-system_name.wmfw
- part-dspN-fwtype.wmfw
- cirrus/part-dspN-fwtype.wmfw
- Qualifications are added to the filename so that rightwards is more
specific.
- The system_name is provided by the codec driver.
- The asoc_component_prefix is used to identify tunings for individual
parts because it would already exist to disambiguate the controls
and it makes it obvious which firmware file applies to which device.
The optional coefficient file must have the same filename
construction as the discovered wmfw except:
- where the wmfw has only system_name then the bin file can
optionally include the asoc_component_prefix. This is to allow a
common wmfw for all amps but separate tunings per amp.
Signed-off-by: Simon Trimmer <simont@opensource.cirrus.com>
Acked-by: Charles Keepax <ckeepax@opensource.cirrus.com>
Link: https://lore.kernel.org/r/20220303155016.122125-1-simont@opensource.cirrus.com
Signed-off-by: Mark Brown <broonie@kernel.org>
134 lines
4.5 KiB
C
134 lines
4.5 KiB
C
/* SPDX-License-Identifier: GPL-2.0-only */
|
|
/*
|
|
* wm_adsp.h -- Wolfson ADSP support
|
|
*
|
|
* Copyright 2012 Wolfson Microelectronics plc
|
|
*
|
|
* Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
|
|
*/
|
|
|
|
#ifndef __WM_ADSP_H
|
|
#define __WM_ADSP_H
|
|
|
|
#include <linux/firmware/cirrus/cs_dsp.h>
|
|
#include <linux/firmware/cirrus/wmfw.h>
|
|
|
|
#include <sound/soc.h>
|
|
#include <sound/soc-dapm.h>
|
|
#include <sound/compress_driver.h>
|
|
|
|
/* Return values for wm_adsp_compr_handle_irq */
|
|
#define WM_ADSP_COMPR_OK 0
|
|
#define WM_ADSP_COMPR_VOICE_TRIGGER 1
|
|
|
|
struct wm_adsp_compr;
|
|
struct wm_adsp_compr_buf;
|
|
|
|
struct wm_adsp {
|
|
struct cs_dsp cs_dsp;
|
|
const char *part;
|
|
const char *fwf_name;
|
|
const char *system_name;
|
|
struct snd_soc_component *component;
|
|
|
|
unsigned int sys_config_size;
|
|
|
|
int fw;
|
|
|
|
struct work_struct boot_work;
|
|
|
|
bool preloaded;
|
|
bool fatal_error;
|
|
|
|
struct list_head compr_list;
|
|
struct list_head buffer_list;
|
|
|
|
/*
|
|
* Flag indicating the preloader widget only needs power toggled
|
|
* on state change rather than held on for the duration of the
|
|
* preload, useful for devices that can retain firmware memory
|
|
* across power down.
|
|
*/
|
|
bool toggle_preload;
|
|
};
|
|
|
|
#define WM_ADSP1(wname, num) \
|
|
SND_SOC_DAPM_PGA_E(wname, SND_SOC_NOPM, num, 0, NULL, 0, \
|
|
wm_adsp1_event, SND_SOC_DAPM_POST_PMU | SND_SOC_DAPM_PRE_PMD)
|
|
|
|
#define WM_ADSP2_PRELOAD_SWITCH(wname, num) \
|
|
SOC_SINGLE_EXT(wname " Preload Switch", SND_SOC_NOPM, num, 1, 0, \
|
|
wm_adsp2_preloader_get, wm_adsp2_preloader_put)
|
|
|
|
#define WM_ADSP2(wname, num, event_fn) \
|
|
SND_SOC_DAPM_SPK(wname " Preload", NULL), \
|
|
{ .id = snd_soc_dapm_supply, .name = wname " Preloader", \
|
|
.reg = SND_SOC_NOPM, .shift = num, .event = event_fn, \
|
|
.event_flags = SND_SOC_DAPM_PRE_PMU | SND_SOC_DAPM_PRE_PMD, \
|
|
.subseq = 100, /* Ensure we run after SYSCLK supply widget */ }, \
|
|
{ .id = snd_soc_dapm_out_drv, .name = wname, \
|
|
.reg = SND_SOC_NOPM, .shift = num, .event = wm_adsp_event, \
|
|
.event_flags = SND_SOC_DAPM_POST_PMU | SND_SOC_DAPM_PRE_PMD }
|
|
|
|
#define WM_ADSP_FW_CONTROL(dspname, num) \
|
|
SOC_ENUM_EXT(dspname " Firmware", wm_adsp_fw_enum[num], \
|
|
wm_adsp_fw_get, wm_adsp_fw_put)
|
|
|
|
extern const struct soc_enum wm_adsp_fw_enum[];
|
|
|
|
int wm_adsp1_init(struct wm_adsp *dsp);
|
|
int wm_adsp2_init(struct wm_adsp *dsp);
|
|
void wm_adsp2_remove(struct wm_adsp *dsp);
|
|
int wm_adsp2_component_probe(struct wm_adsp *dsp, struct snd_soc_component *component);
|
|
int wm_adsp2_component_remove(struct wm_adsp *dsp, struct snd_soc_component *component);
|
|
int wm_halo_init(struct wm_adsp *dsp);
|
|
|
|
int wm_adsp1_event(struct snd_soc_dapm_widget *w,
|
|
struct snd_kcontrol *kcontrol, int event);
|
|
|
|
int wm_adsp_early_event(struct snd_soc_dapm_widget *w,
|
|
struct snd_kcontrol *kcontrol, int event);
|
|
|
|
irqreturn_t wm_adsp2_bus_error(int irq, void *data);
|
|
irqreturn_t wm_halo_bus_error(int irq, void *data);
|
|
irqreturn_t wm_halo_wdt_expire(int irq, void *data);
|
|
|
|
int wm_adsp_event(struct snd_soc_dapm_widget *w,
|
|
struct snd_kcontrol *kcontrol, int event);
|
|
|
|
int wm_adsp2_set_dspclk(struct snd_soc_dapm_widget *w, unsigned int freq);
|
|
|
|
int wm_adsp2_preloader_get(struct snd_kcontrol *kcontrol,
|
|
struct snd_ctl_elem_value *ucontrol);
|
|
int wm_adsp2_preloader_put(struct snd_kcontrol *kcontrol,
|
|
struct snd_ctl_elem_value *ucontrol);
|
|
int wm_adsp_fw_get(struct snd_kcontrol *kcontrol,
|
|
struct snd_ctl_elem_value *ucontrol);
|
|
int wm_adsp_fw_put(struct snd_kcontrol *kcontrol,
|
|
struct snd_ctl_elem_value *ucontrol);
|
|
|
|
int wm_adsp_compr_open(struct wm_adsp *dsp, struct snd_compr_stream *stream);
|
|
int wm_adsp_compr_free(struct snd_soc_component *component,
|
|
struct snd_compr_stream *stream);
|
|
int wm_adsp_compr_set_params(struct snd_soc_component *component,
|
|
struct snd_compr_stream *stream,
|
|
struct snd_compr_params *params);
|
|
int wm_adsp_compr_get_caps(struct snd_soc_component *component,
|
|
struct snd_compr_stream *stream,
|
|
struct snd_compr_caps *caps);
|
|
int wm_adsp_compr_trigger(struct snd_soc_component *component,
|
|
struct snd_compr_stream *stream, int cmd);
|
|
int wm_adsp_compr_handle_irq(struct wm_adsp *dsp);
|
|
int wm_adsp_compr_pointer(struct snd_soc_component *component,
|
|
struct snd_compr_stream *stream,
|
|
struct snd_compr_tstamp *tstamp);
|
|
int wm_adsp_compr_copy(struct snd_soc_component *component,
|
|
struct snd_compr_stream *stream,
|
|
char __user *buf, size_t count);
|
|
int wm_adsp_write_ctl(struct wm_adsp *dsp, const char *name, int type,
|
|
unsigned int alg, void *buf, size_t len);
|
|
int wm_adsp_read_ctl(struct wm_adsp *dsp, const char *name, int type,
|
|
unsigned int alg, void *buf, size_t len);
|
|
|
|
#endif
|