1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
|
/*
* Copyright (c) 2016, The Linux Foundation. All rights reserved.
*
* This program is free software; you can redistribute it and/or modify
* it under the terms of the GNU General Public License version 2 and
* only version 2 as published by the Free Software Foundation.
*
* This program is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
* GNU General Public License for more details.
*/
#ifndef __WCD_DSP_MGR_H__
#define __WCD_DSP_MGR_H__
#include <linux/types.h>
/*
* These enums correspond to the component types
* that wcd-dsp-manager driver will use. The order
* of the enums specifies the order in which the
* manager driver will perform the sequencing.
* Changing this will cause the sequencing order
* to be changed as well.
*/
enum wdsp_cmpnt_type {
/* Component to control the DSP */
WDSP_CMPNT_CONTROL = 0,
/* Component to perform data transfer to/from DSP */
WDSP_CMPNT_TRANSPORT,
/* Component that performs high level IPC */
WDSP_CMPNT_IPC,
WDSP_CMPNT_TYPE_MAX,
};
enum wdsp_event_type {
/* Initialization related */
WDSP_EVENT_POST_INIT,
/* Image download related */
WDSP_EVENT_PRE_DLOAD_CODE,
WDSP_EVENT_DLOAD_SECTION,
WDSP_EVENT_POST_DLOAD_CODE,
WDSP_EVENT_PRE_DLOAD_DATA,
WDSP_EVENT_POST_DLOAD_DATA,
WDSP_EVENT_DLOAD_FAILED,
WDSP_EVENT_READ_SECTION,
/* DSP boot related */
WDSP_EVENT_PRE_BOOTUP,
WDSP_EVENT_DO_BOOT,
WDSP_EVENT_POST_BOOTUP,
WDSP_EVENT_PRE_SHUTDOWN,
WDSP_EVENT_DO_SHUTDOWN,
WDSP_EVENT_POST_SHUTDOWN,
/* IRQ handling related */
WDSP_EVENT_IPC1_INTR,
/* Suspend/Resume related */
WDSP_EVENT_SUSPEND,
WDSP_EVENT_RESUME,
};
enum wdsp_signal {
/* Hardware generated interrupts signalled to manager */
WDSP_IPC1_INTR,
WDSP_ERR_INTR,
/* Other signals */
WDSP_CDC_DOWN_SIGNAL,
WDSP_CDC_UP_SIGNAL,
};
/*
* wdsp_cmpnt_ops: ops/function callbacks for components
* @init: called by manager driver, component is expected
* to initialize itself in this callback
* @deinit: called by manager driver, component should
* de-initialize itself in this callback
* @event_handler: Event handler for each component, called
* by the manager as per sequence
*/
struct wdsp_cmpnt_ops {
int (*init)(struct device *, void *priv_data);
int (*deinit)(struct device *, void *priv_data);
int (*event_handler)(struct device *, void *priv_data,
enum wdsp_event_type, void *data);
};
struct wdsp_img_section {
u32 addr;
size_t size;
u8 *data;
};
struct wdsp_err_signal_arg {
bool mem_dumps_enabled;
u32 remote_start_addr;
size_t dump_size;
};
/*
* wdsp_ops: ops/function callbacks for manager driver
* @register_cmpnt_ops: components will use this to register
* their own ops to manager driver
* @get_dev_for_cmpnt: components can use this to get handle
* to struct device * of any other component
* @signal_handler: callback to notify manager driver that signal
* has occurred. Cannot be called from interrupt
* context as this can sleep
* @vote_for_dsp: notifies manager that dsp should be booted up
* @suspend: notifies manager that one component wants to suspend.
* Manager will make sure to suspend all components in order
* @resume: notifies manager that one component wants to resume.
* Manager will make sure to resume all components in order
*/
struct wdsp_mgr_ops {
int (*register_cmpnt_ops)(struct device *wdsp_dev,
struct device *cdev,
void *priv_data,
struct wdsp_cmpnt_ops *ops);
struct device *(*get_dev_for_cmpnt)(struct device *wdsp_dev,
enum wdsp_cmpnt_type type);
int (*signal_handler)(struct device *wdsp_dev,
enum wdsp_signal signal, void *arg);
int (*vote_for_dsp)(struct device *wdsp_dev, bool vote);
int (*suspend)(struct device *wdsp_dev);
int (*resume)(struct device *wdsp_dev);
};
#endif /* end of __WCD_DSP_MGR_H__ */
|
