GNU Linux-libre 4.19.286-gnu1
[releases.git] / sound / soc / codecs / wm_adsp.h
1 /*
2  * wm_adsp.h  --  Wolfson ADSP support
3  *
4  * Copyright 2012 Wolfson Microelectronics plc
5  *
6  * Author: Mark Brown <broonie@opensource.wolfsonmicro.com>
7  *
8  * This program is free software; you can redistribute it and/or modify
9  * it under the terms of the GNU General Public License version 2 as
10  * published by the Free Software Foundation.
11  */
12
13 #ifndef __WM_ADSP_H
14 #define __WM_ADSP_H
15
16 #include <sound/soc.h>
17 #include <sound/soc-dapm.h>
18 #include <sound/compress_driver.h>
19
20 #include "wmfw.h"
21
22 /* Return values for wm_adsp_compr_handle_irq */
23 #define WM_ADSP_COMPR_OK                 0
24 #define WM_ADSP_COMPR_VOICE_TRIGGER      1
25
26 #define WM_ADSP2_REGION_0 BIT(0)
27 #define WM_ADSP2_REGION_1 BIT(1)
28 #define WM_ADSP2_REGION_2 BIT(2)
29 #define WM_ADSP2_REGION_3 BIT(3)
30 #define WM_ADSP2_REGION_4 BIT(4)
31 #define WM_ADSP2_REGION_5 BIT(5)
32 #define WM_ADSP2_REGION_6 BIT(6)
33 #define WM_ADSP2_REGION_7 BIT(7)
34 #define WM_ADSP2_REGION_8 BIT(8)
35 #define WM_ADSP2_REGION_9 BIT(9)
36 #define WM_ADSP2_REGION_1_9 (WM_ADSP2_REGION_1 | \
37                 WM_ADSP2_REGION_2 | WM_ADSP2_REGION_3 | \
38                 WM_ADSP2_REGION_4 | WM_ADSP2_REGION_5 | \
39                 WM_ADSP2_REGION_6 | WM_ADSP2_REGION_7 | \
40                 WM_ADSP2_REGION_8 | WM_ADSP2_REGION_9)
41 #define WM_ADSP2_REGION_ALL (WM_ADSP2_REGION_0 | WM_ADSP2_REGION_1_9)
42
43 struct wm_adsp_region {
44         int type;
45         unsigned int base;
46 };
47
48 struct wm_adsp_alg_region {
49         struct list_head list;
50         unsigned int alg;
51         int type;
52         unsigned int base;
53 };
54
55 struct wm_adsp_compr;
56 struct wm_adsp_compr_buf;
57
58 struct wm_adsp {
59         const char *part;
60         const char *name;
61         const char *fwf_name;
62         int rev;
63         int num;
64         int type;
65         struct device *dev;
66         struct regmap *regmap;
67         struct snd_soc_component *component;
68
69         unsigned int base;
70         unsigned int sysclk_reg;
71         unsigned int sysclk_mask;
72         unsigned int sysclk_shift;
73
74         struct list_head alg_regions;
75
76         unsigned int fw_id;
77         unsigned int fw_id_version;
78
79         const struct wm_adsp_region *mem;
80         int num_mems;
81
82         int fw;
83         int fw_ver;
84
85         bool preloaded;
86         bool booted;
87         bool running;
88
89         struct list_head ctl_list;
90
91         struct work_struct boot_work;
92
93         struct wm_adsp_compr *compr;
94         struct wm_adsp_compr_buf *buffer;
95
96         struct mutex pwr_lock;
97
98         unsigned int lock_regions;
99
100 #ifdef CONFIG_DEBUG_FS
101         struct dentry *debugfs_root;
102         char *wmfw_file_name;
103         char *bin_file_name;
104 #endif
105
106 };
107
108 #define WM_ADSP1(wname, num) \
109         SND_SOC_DAPM_PGA_E(wname, SND_SOC_NOPM, num, 0, NULL, 0, \
110                 wm_adsp1_event, SND_SOC_DAPM_POST_PMU | SND_SOC_DAPM_PRE_PMD)
111
112 #define WM_ADSP2_PRELOAD_SWITCH(wname, num) \
113         SOC_SINGLE_EXT(wname " Preload Switch", SND_SOC_NOPM, num, 1, 0, \
114                 wm_adsp2_preloader_get, wm_adsp2_preloader_put)
115
116 #define WM_ADSP2(wname, num, event_fn) \
117         SND_SOC_DAPM_SPK(wname " Preload", NULL), \
118 {       .id = snd_soc_dapm_supply, .name = wname " Preloader", \
119         .reg = SND_SOC_NOPM, .shift = num, .event = event_fn, \
120         .event_flags = SND_SOC_DAPM_PRE_PMU | SND_SOC_DAPM_PRE_PMD, \
121         .subseq = 100, /* Ensure we run after SYSCLK supply widget */ }, \
122 {       .id = snd_soc_dapm_out_drv, .name = wname, \
123         .reg = SND_SOC_NOPM, .shift = num, .event = wm_adsp2_event, \
124         .event_flags = SND_SOC_DAPM_POST_PMU | SND_SOC_DAPM_PRE_PMD }
125
126 #define WM_ADSP_FW_CONTROL(dspname, num) \
127         SOC_ENUM_EXT(dspname " Firmware", wm_adsp_fw_enum[num], \
128                      wm_adsp_fw_get, wm_adsp_fw_put)
129
130 extern const struct soc_enum wm_adsp_fw_enum[];
131
132 int wm_adsp1_init(struct wm_adsp *dsp);
133 int wm_adsp2_init(struct wm_adsp *dsp);
134 void wm_adsp2_remove(struct wm_adsp *dsp);
135 int wm_adsp2_component_probe(struct wm_adsp *dsp, struct snd_soc_component *component);
136 int wm_adsp2_component_remove(struct wm_adsp *dsp, struct snd_soc_component *component);
137 int wm_adsp1_event(struct snd_soc_dapm_widget *w,
138                    struct snd_kcontrol *kcontrol, int event);
139 int wm_adsp2_early_event(struct snd_soc_dapm_widget *w,
140                          struct snd_kcontrol *kcontrol, int event,
141                          unsigned int freq);
142
143 int wm_adsp2_lock(struct wm_adsp *adsp, unsigned int regions);
144 irqreturn_t wm_adsp2_bus_error(struct wm_adsp *adsp);
145
146 int wm_adsp2_event(struct snd_soc_dapm_widget *w,
147                    struct snd_kcontrol *kcontrol, int event);
148
149 int wm_adsp2_preloader_get(struct snd_kcontrol *kcontrol,
150                            struct snd_ctl_elem_value *ucontrol);
151 int wm_adsp2_preloader_put(struct snd_kcontrol *kcontrol,
152                            struct snd_ctl_elem_value *ucontrol);
153 int wm_adsp_fw_get(struct snd_kcontrol *kcontrol,
154                    struct snd_ctl_elem_value *ucontrol);
155 int wm_adsp_fw_put(struct snd_kcontrol *kcontrol,
156                    struct snd_ctl_elem_value *ucontrol);
157
158 int wm_adsp_compr_open(struct wm_adsp *dsp, struct snd_compr_stream *stream);
159 int wm_adsp_compr_free(struct snd_compr_stream *stream);
160 int wm_adsp_compr_set_params(struct snd_compr_stream *stream,
161                              struct snd_compr_params *params);
162 int wm_adsp_compr_get_caps(struct snd_compr_stream *stream,
163                            struct snd_compr_caps *caps);
164 int wm_adsp_compr_trigger(struct snd_compr_stream *stream, int cmd);
165 int wm_adsp_compr_handle_irq(struct wm_adsp *dsp);
166 int wm_adsp_compr_pointer(struct snd_compr_stream *stream,
167                           struct snd_compr_tstamp *tstamp);
168 int wm_adsp_compr_copy(struct snd_compr_stream *stream,
169                        char __user *buf, size_t count);
170
171 #endif