summaryrefstree
path: root/kernel/techpack/audio/include/ipc/apr_tal.h
blob: 6a4fbdfc5ef0d0888c0637560c96815b04d7287a (plain)
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
/* SPDX-License-Identifier: GPL-2.0-only */
/*
 * Copyright (c) 2010-2011, 2016-2018 The Linux Foundation. All rights reserved.
 */
#ifndef __APR_TAL_H_
#define __APR_TAL_H_

#include <linux/kernel.h>
#include <linux/kthread.h>
#include <linux/uaccess.h>

/* APR Client IDs */
#define APR_CLIENT_AUDIO	0x0
#define APR_CLIENT_VOICE	0x1
#define APR_CLIENT_MAX		0x2

#define APR_DL_SMD    0
#define APR_DL_MAX    1

#define APR_DEST_MODEM 0
#define APR_DEST_QDSP6 1
#define APR_DEST_MAX   2

#if defined(CONFIG_MSM_QDSP6_APRV2_GLINK) || \
	defined(CONFIG_MSM_QDSP6_APRV3_GLINK)
#define APR_MAX_BUF			512
#else
#define APR_MAX_BUF			8092
#endif

#define APR_DEFAULT_NUM_OF_INTENTS 20

#define APR_OPEN_TIMEOUT_MS 5000

enum {
	/* If client sets the pkt_owner to APR_PKT_OWNER_DRIVER, APR
	 * driver will allocate a buffer, where the user packet is
	 * copied into, for each and every single Tx transmission.
	 * The buffer is thereafter passed to underlying link layer
	 * and freed upon the notification received from the link layer
	 * that the packet has been consumed.
	 */
	APR_PKT_OWNER_DRIVER,
	/* If client sets the pkt_owner to APR_PKT_OWNER_CLIENT, APR
	 * will pass the user packet memory address directly to underlying
	 * link layer. In this case it is the client's responsibility to
	 * make sure the packet is intact until being notified that the
	 * packet has been consumed.
	 */
	APR_PKT_OWNER_CLIENT,
};

struct apr_pkt_priv {
	/* This property is only applicable for APR over Glink.
	 * It is ignored in APR over SMD cases.
	 */
	uint8_t pkt_owner;
};

typedef void (*apr_svc_cb_fn)(void *buf, int len, void *priv);
struct apr_svc_ch_dev *apr_tal_open(uint32_t svc, uint32_t dest,
			uint32_t dl, apr_svc_cb_fn func, void *priv);
int apr_tal_write(struct apr_svc_ch_dev *apr_ch, void *data,
		struct apr_pkt_priv *pkt_priv, int len);
int apr_tal_close(struct apr_svc_ch_dev *apr_ch);
int apr_tal_rx_intents_config(struct apr_svc_ch_dev *apr_ch,
		int num_of_intents, uint32_t size);
int apr_tal_init(void);
void apr_tal_exit(void);
int apr_tal_start_rx_rt(struct apr_svc_ch_dev *apr_ch);
int apr_tal_end_rx_rt(struct apr_svc_ch_dev *apr_ch);

struct apr_svc_ch_dev {
	void               *handle;
	spinlock_t         w_lock;
	spinlock_t         r_lock;
	struct mutex       m_lock;
	apr_svc_cb_fn      func;
	wait_queue_head_t  wait;
	void               *priv;
	unsigned int       channel_state;
	bool               if_remote_intent_ready;
};

#endif