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
|
/*
* 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 {
/* 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,
/* 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_intr {
WDSP_IPC1_INTR,
};
/*
* 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;
};
/*
* 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
* @intr_handler: callback to notify manager driver that interrupt
* has occurred.
* @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 (*intr_handler)(struct device *wdsp_dev,
enum wdsp_intr intr);
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__ */
|
