1/* SPDX-License-Identifier: GPL-2.0-only */
2/*
3 * Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved.
4 *
5 * @File ctsrc.h
6 *
7 * @Brief
8 * This file contains the definition of the Sample Rate Convertor
9 * resource management object.
10 *
11 * @Author Liu Chun
12 * @Date May 13 2008
13 */
14
15#ifndef CTSRC_H
16#define CTSRC_H
17
18#include "ctresource.h"
19#include "ctimap.h"
20#include <linux/spinlock.h>
21#include <linux/list.h>
22#include <sound/core.h>
23
24#define SRC_STATE_OFF 0x0
25#define SRC_STATE_INIT 0x4
26#define SRC_STATE_RUN 0x5
27
28#define SRC_SF_U8 0x0
29#define SRC_SF_S16 0x1
30#define SRC_SF_S24 0x2
31#define SRC_SF_S32 0x3
32#define SRC_SF_F32 0x4
33
34/* Define the descriptor of a src resource */
35enum SRCMODE {
36 MEMRD, /* Read data from host memory */
37 MEMWR, /* Write data to host memory */
38 ARCRW, /* Read from and write to audio ring channel */
39 NUM_SRCMODES
40};
41
42struct src_rsc_ops;
43
44struct src {
45 struct rsc rsc; /* Basic resource info */
46 struct src *intlv; /* Pointer to next interleaved SRC in a series */
47 const struct src_rsc_ops *ops; /* SRC specific operations */
48 /* Number of contiguous srcs for interleaved usage */
49 unsigned char multi;
50 unsigned char mode; /* Working mode of this SRC resource */
51};
52
53struct src_rsc_ops {
54 int (*set_state)(struct src *src, unsigned int state);
55 int (*set_bm)(struct src *src, unsigned int bm);
56 int (*set_sf)(struct src *src, unsigned int sf);
57 int (*set_pm)(struct src *src, unsigned int pm);
58 int (*set_rom)(struct src *src, unsigned int rom);
59 int (*set_vo)(struct src *src, unsigned int vo);
60 int (*set_st)(struct src *src, unsigned int st);
61 int (*set_bp)(struct src *src, unsigned int bp);
62 int (*set_cisz)(struct src *src, unsigned int cisz);
63 int (*set_ca)(struct src *src, unsigned int ca);
64 int (*set_sa)(struct src *src, unsigned int sa);
65 int (*set_la)(struct src *src, unsigned int la);
66 int (*set_pitch)(struct src *src, unsigned int pitch);
67 int (*set_clr_zbufs)(struct src *src);
68 int (*commit_write)(struct src *src);
69 int (*get_ca)(struct src *src);
70 int (*init)(struct src *src);
71 struct src* (*next_interleave)(struct src *src);
72};
73
74/* Define src resource request description info */
75struct src_desc {
76 /* Number of contiguous master srcs for interleaved usage */
77 unsigned char multi;
78 unsigned char msr;
79 unsigned char mode; /* Working mode of the requested srcs */
80};
81
82/* Define src manager object */
83struct src_mgr {
84 struct rsc_mgr mgr; /* Basic resource manager info */
85 struct snd_card *card; /* pointer to this card */
86 spinlock_t mgr_lock;
87
88 /* request src resource */
89 int (*get_src)(struct src_mgr *mgr,
90 const struct src_desc *desc, struct src **rsrc);
91 /* return src resource */
92 int (*put_src)(struct src_mgr *mgr, struct src *src);
93 int (*src_enable_s)(struct src_mgr *mgr, struct src *src);
94 int (*src_enable)(struct src_mgr *mgr, struct src *src);
95 int (*src_disable)(struct src_mgr *mgr, struct src *src);
96 int (*commit_write)(struct src_mgr *mgr);
97};
98
99/* Define the descriptor of a SRC Input Mapper resource */
100struct srcimp_mgr;
101struct srcimp_rsc_ops;
102
103struct srcimp {
104 struct rsc rsc;
105 unsigned char idx[8];
106 struct imapper *imappers;
107 unsigned int mapped; /* A bit-map indicating which conj rsc is mapped */
108 struct srcimp_mgr *mgr;
109 const struct srcimp_rsc_ops *ops;
110};
111
112struct srcimp_rsc_ops {
113 int (*map)(struct srcimp *srcimp, struct src *user, struct rsc *input);
114 int (*unmap)(struct srcimp *srcimp);
115};
116
117/* Define SRCIMP resource request description info */
118struct srcimp_desc {
119 unsigned int msr;
120};
121
122struct srcimp_mgr {
123 struct rsc_mgr mgr; /* Basic resource manager info */
124 struct snd_card *card; /* pointer to this card */
125 spinlock_t mgr_lock;
126 spinlock_t imap_lock;
127 struct list_head imappers;
128 struct imapper *init_imap;
129 unsigned int init_imap_added;
130
131 /* request srcimp resource */
132 int (*get_srcimp)(struct srcimp_mgr *mgr,
133 const struct srcimp_desc *desc,
134 struct srcimp **rsrcimp);
135 /* return srcimp resource */
136 int (*put_srcimp)(struct srcimp_mgr *mgr, struct srcimp *srcimp);
137 int (*imap_add)(struct srcimp_mgr *mgr, struct imapper *entry);
138 int (*imap_delete)(struct srcimp_mgr *mgr, struct imapper *entry);
139};
140
141/* Constructor and destructor of SRC resource manager */
142int src_mgr_create(struct hw *hw, void **ptr);
143int src_mgr_destroy(void *ptr);
144/* Constructor and destructor of SRCIMP resource manager */
145int srcimp_mgr_create(struct hw *hw, void **ptr);
146int srcimp_mgr_destroy(void *ptr);
147
148#endif /* CTSRC_H */
149

source code of linux/sound/pci/ctxfi/ctsrc.h