Linux Audio

Check our new training course

Loading...
v5.9
  1/* SPDX-License-Identifier: GPL-2.0-only */
  2/**
  3 * Copyright (C) 2008, Creative Technology Ltd. All Rights Reserved.
  4 *
 
 
 
 
  5 * @File	ctatc.h
  6 *
  7 * @Brief
  8 * This file contains the definition of the device resource management object.
  9 *
 10 * @Author	Liu Chun
 11 * @Date 	Mar 28 2008
 
 12 */
 13
 14#ifndef CTATC_H
 15#define CTATC_H
 16
 17#include <linux/types.h>
 18#include <linux/mutex.h>
 19#include <linux/pci.h>
 20#include <linux/timer.h>
 21#include <sound/core.h>
 22
 23#include "ctvmem.h"
 24#include "cthardware.h"
 25#include "ctresource.h"
 26
 27enum CTALSADEVS {		/* Types of alsa devices */
 28	FRONT,
 29	SURROUND,
 30	CLFE,
 31	SIDE,
 32	IEC958,
 33	MIXER,
 34	NUM_CTALSADEVS		/* This should always be the last */
 35};
 36
 37struct ct_atc_chip_sub_details {
 38	u16 subsys;
 39	const char *nm_model;
 40};
 41
 42struct ct_atc_chip_details {
 43	u16 vendor;
 44	u16 device;
 45	const struct ct_atc_chip_sub_details *sub_details;
 46	const char *nm_card;
 47};
 48
 49struct ct_atc;
 50struct ct_timer;
 51struct ct_timer_instance;
 52
 53/* alsa pcm stream descriptor */
 54struct ct_atc_pcm {
 55	struct snd_pcm_substream *substream;
 56	void (*interrupt)(struct ct_atc_pcm *apcm);
 57	struct ct_timer_instance *timer;
 58	unsigned int started:1;
 59
 60	/* Only mono and interleaved modes are supported now. */
 61	struct ct_vm_block *vm_block;
 62	void *src;		/* SRC for interacting with host memory */
 63	void **srccs;		/* SRCs for sample rate conversion */
 64	void **srcimps;		/* SRC Input Mappers */
 65	void **amixers;		/* AMIXERs for routing converted data */
 66	void *mono;		/* A SUM resource for mixing chs to one */
 67	unsigned char n_srcc;	/* Number of converting SRCs */
 68	unsigned char n_srcimp;	/* Number of SRC Input Mappers */
 69	unsigned char n_amixer;	/* Number of AMIXERs */
 70};
 71
 72/* Chip resource management object */
 73struct ct_atc {
 74	struct pci_dev *pci;
 75	struct snd_card *card;
 76	unsigned int rsr; /* reference sample rate in Hz */
 77	unsigned int msr; /* master sample rate in rsr */
 78	unsigned int pll_rate; /* current rate of Phase Lock Loop */
 79
 80	int chip_type;
 81	int model;
 82	const char *chip_name;
 83	const char *model_name;
 84
 85	struct ct_vm *vm; /* device virtual memory manager for this card */
 86	int (*map_audio_buffer)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
 87	void (*unmap_audio_buffer)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
 88	unsigned long (*get_ptp_phys)(struct ct_atc *atc, int index);
 89
 90	struct mutex atc_mutex;
 91
 92	int (*pcm_playback_prepare)(struct ct_atc *atc,
 93				    struct ct_atc_pcm *apcm);
 94	int (*pcm_playback_start)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
 95	int (*pcm_playback_stop)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
 96	int (*pcm_playback_position)(struct ct_atc *atc,
 97				     struct ct_atc_pcm *apcm);
 98	int (*spdif_passthru_playback_prepare)(struct ct_atc *atc,
 99					       struct ct_atc_pcm *apcm);
100	int (*pcm_capture_prepare)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
101	int (*pcm_capture_start)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
102	int (*pcm_capture_stop)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
103	int (*pcm_capture_position)(struct ct_atc *atc,
104				    struct ct_atc_pcm *apcm);
105	int (*pcm_release_resources)(struct ct_atc *atc,
106				     struct ct_atc_pcm *apcm);
107	int (*select_line_in)(struct ct_atc *atc);
108	int (*select_mic_in)(struct ct_atc *atc);
109	int (*select_digit_io)(struct ct_atc *atc);
110	int (*line_front_unmute)(struct ct_atc *atc, unsigned char state);
111	int (*line_surround_unmute)(struct ct_atc *atc, unsigned char state);
112	int (*line_clfe_unmute)(struct ct_atc *atc, unsigned char state);
113	int (*line_rear_unmute)(struct ct_atc *atc, unsigned char state);
114	int (*line_in_unmute)(struct ct_atc *atc, unsigned char state);
115	int (*mic_unmute)(struct ct_atc *atc, unsigned char state);
116	int (*spdif_out_unmute)(struct ct_atc *atc, unsigned char state);
117	int (*spdif_in_unmute)(struct ct_atc *atc, unsigned char state);
118	int (*spdif_out_get_status)(struct ct_atc *atc, unsigned int *status);
119	int (*spdif_out_set_status)(struct ct_atc *atc, unsigned int status);
120	int (*spdif_out_passthru)(struct ct_atc *atc, unsigned char state);
121	struct capabilities (*capabilities)(struct ct_atc *atc);
122	int (*output_switch_get)(struct ct_atc *atc);
123	int (*output_switch_put)(struct ct_atc *atc, int position);
124	int (*mic_source_switch_get)(struct ct_atc *atc);
125	int (*mic_source_switch_put)(struct ct_atc *atc, int position);
126
127	/* Don't touch! Used for internal object. */
128	void *rsc_mgrs[NUM_RSCTYP]; /* chip resource managers */
129	void *mixer;		/* internal mixer object */
130	struct hw *hw;		/* chip specific hardware access object */
131	void **daios;		/* digital audio io resources */
132	void **pcm;		/* SUMs for collecting all pcm stream */
133	void **srcs;		/* Sample Rate Converters for input signal */
134	void **srcimps;		/* input mappers for SRCs */
135	unsigned char n_daio;
136	unsigned char n_src;
137	unsigned char n_srcimp;
138	unsigned char n_pcm;
139
140	struct ct_timer *timer;
141
142#ifdef CONFIG_PM_SLEEP
143	int (*suspend)(struct ct_atc *atc);
144	int (*resume)(struct ct_atc *atc);
145#define NUM_PCMS (NUM_CTALSADEVS - 1)
146	struct snd_pcm *pcms[NUM_PCMS];
147#endif
148};
149
150
151int ct_atc_create(struct snd_card *card, struct pci_dev *pci,
152		  unsigned int rsr, unsigned int msr, int chip_type,
153		  unsigned int subsysid, struct ct_atc **ratc);
154int ct_atc_create_alsa_devs(struct ct_atc *atc);
155
156#endif /* CTATC_H */
v3.1
 
  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	ctatc.h
  9 *
 10 * @Brief
 11 * This file contains the definition of the device resource management object.
 12 *
 13 * @Author	Liu Chun
 14 * @Date 	Mar 28 2008
 15 *
 16 */
 17
 18#ifndef CTATC_H
 19#define CTATC_H
 20
 21#include <linux/types.h>
 22#include <linux/mutex.h>
 23#include <linux/pci.h>
 24#include <linux/timer.h>
 25#include <sound/core.h>
 26
 27#include "ctvmem.h"
 28#include "cthardware.h"
 29#include "ctresource.h"
 30
 31enum CTALSADEVS {		/* Types of alsa devices */
 32	FRONT,
 33	SURROUND,
 34	CLFE,
 35	SIDE,
 36	IEC958,
 37	MIXER,
 38	NUM_CTALSADEVS		/* This should always be the last */
 39};
 40
 41struct ct_atc_chip_sub_details {
 42	u16 subsys;
 43	const char *nm_model;
 44};
 45
 46struct ct_atc_chip_details {
 47	u16 vendor;
 48	u16 device;
 49	const struct ct_atc_chip_sub_details *sub_details;
 50	const char *nm_card;
 51};
 52
 53struct ct_atc;
 54struct ct_timer;
 55struct ct_timer_instance;
 56
 57/* alsa pcm stream descriptor */
 58struct ct_atc_pcm {
 59	struct snd_pcm_substream *substream;
 60	void (*interrupt)(struct ct_atc_pcm *apcm);
 61	struct ct_timer_instance *timer;
 62	unsigned int started:1;
 63
 64	/* Only mono and interleaved modes are supported now. */
 65	struct ct_vm_block *vm_block;
 66	void *src;		/* SRC for interacting with host memory */
 67	void **srccs;		/* SRCs for sample rate conversion */
 68	void **srcimps;		/* SRC Input Mappers */
 69	void **amixers;		/* AMIXERs for routing converted data */
 70	void *mono;		/* A SUM resource for mixing chs to one */
 71	unsigned char n_srcc;	/* Number of converting SRCs */
 72	unsigned char n_srcimp;	/* Number of SRC Input Mappers */
 73	unsigned char n_amixer;	/* Number of AMIXERs */
 74};
 75
 76/* Chip resource management object */
 77struct ct_atc {
 78	struct pci_dev *pci;
 79	struct snd_card *card;
 80	unsigned int rsr; /* reference sample rate in Hz */
 81	unsigned int msr; /* master sample rate in rsr */
 82	unsigned int pll_rate; /* current rate of Phase Lock Loop */
 83
 84	int chip_type;
 85	int model;
 86	const char *chip_name;
 87	const char *model_name;
 88
 89	struct ct_vm *vm; /* device virtual memory manager for this card */
 90	int (*map_audio_buffer)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
 91	void (*unmap_audio_buffer)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
 92	unsigned long (*get_ptp_phys)(struct ct_atc *atc, int index);
 93
 94	struct mutex atc_mutex;
 95
 96	int (*pcm_playback_prepare)(struct ct_atc *atc,
 97				    struct ct_atc_pcm *apcm);
 98	int (*pcm_playback_start)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
 99	int (*pcm_playback_stop)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
100	int (*pcm_playback_position)(struct ct_atc *atc,
101				     struct ct_atc_pcm *apcm);
102	int (*spdif_passthru_playback_prepare)(struct ct_atc *atc,
103					       struct ct_atc_pcm *apcm);
104	int (*pcm_capture_prepare)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
105	int (*pcm_capture_start)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
106	int (*pcm_capture_stop)(struct ct_atc *atc, struct ct_atc_pcm *apcm);
107	int (*pcm_capture_position)(struct ct_atc *atc,
108				    struct ct_atc_pcm *apcm);
109	int (*pcm_release_resources)(struct ct_atc *atc,
110				     struct ct_atc_pcm *apcm);
111	int (*select_line_in)(struct ct_atc *atc);
112	int (*select_mic_in)(struct ct_atc *atc);
113	int (*select_digit_io)(struct ct_atc *atc);
114	int (*line_front_unmute)(struct ct_atc *atc, unsigned char state);
115	int (*line_surround_unmute)(struct ct_atc *atc, unsigned char state);
116	int (*line_clfe_unmute)(struct ct_atc *atc, unsigned char state);
117	int (*line_rear_unmute)(struct ct_atc *atc, unsigned char state);
118	int (*line_in_unmute)(struct ct_atc *atc, unsigned char state);
119	int (*mic_unmute)(struct ct_atc *atc, unsigned char state);
120	int (*spdif_out_unmute)(struct ct_atc *atc, unsigned char state);
121	int (*spdif_in_unmute)(struct ct_atc *atc, unsigned char state);
122	int (*spdif_out_get_status)(struct ct_atc *atc, unsigned int *status);
123	int (*spdif_out_set_status)(struct ct_atc *atc, unsigned int status);
124	int (*spdif_out_passthru)(struct ct_atc *atc, unsigned char state);
125	struct capabilities (*capabilities)(struct ct_atc *atc);
126	int (*output_switch_get)(struct ct_atc *atc);
127	int (*output_switch_put)(struct ct_atc *atc, int position);
128	int (*mic_source_switch_get)(struct ct_atc *atc);
129	int (*mic_source_switch_put)(struct ct_atc *atc, int position);
130
131	/* Don't touch! Used for internal object. */
132	void *rsc_mgrs[NUM_RSCTYP]; /* chip resource managers */
133	void *mixer;		/* internal mixer object */
134	void *hw;		/* chip specific hardware access object */
135	void **daios;		/* digital audio io resources */
136	void **pcm;		/* SUMs for collecting all pcm stream */
137	void **srcs;		/* Sample Rate Converters for input signal */
138	void **srcimps;		/* input mappers for SRCs */
139	unsigned char n_daio;
140	unsigned char n_src;
141	unsigned char n_srcimp;
142	unsigned char n_pcm;
143
144	struct ct_timer *timer;
145
146#ifdef CONFIG_PM
147	int (*suspend)(struct ct_atc *atc, pm_message_t state);
148	int (*resume)(struct ct_atc *atc);
149#define NUM_PCMS (NUM_CTALSADEVS - 1)
150	struct snd_pcm *pcms[NUM_PCMS];
151#endif
152};
153
154
155int __devinit ct_atc_create(struct snd_card *card, struct pci_dev *pci,
156			    unsigned int rsr, unsigned int msr, int chip_type,
157			    unsigned int subsysid, struct ct_atc **ratc);
158int __devinit ct_atc_create_alsa_devs(struct ct_atc *atc);
159
160#endif /* CTATC_H */