sound/pci/ctxfi/ctsrc.h

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