a580b31a54
in every sense.
General
-------
- Multichannel safe, endian safe, format safe
* Large part of critical pcm filters such as vchan.c, feeder_rate.c,
feeder_volume.c, feeder_fmt.c and feeder.c has been rewritten so that
using them does not cause the pcm data to be converted to 16bit little
endian.
* Macrosses for accessing pcm data safely are defined within sound.h in
the form of PCM_READ_* / PCM_WRITE_*
* Currently, most of them are probably limited for mono/stereo handling,
but the future addition of true multichannel will be much easier.
- Low latency operation
* Well, this require lot more works to do not just within sound driver,
but we're heading towards right direction. Buffer/block sizing within
channel.c is rewritten to calculate precise allocation for various
combination of sample/data/rate size. As a result, applying correct
SNDCTL_DSP_POLICY value will achive expected latency behaviour simmilar
to what commercial 4front driver do.
* Signal handling fix. ctrl+c of "cat /dev/zero > /dev/dsp" does not
result long delay.
* Eliminate sound truncation if the sound data is too small.
DIY:
1) Download / extract
http://people.freebsd.org/~ariff/lowlatency/shortfiles.tar.gz
2) Do a comparison between "cat state*.au > /dev/dsp" and
"for x in state*.au ; do cat $x > /dev/dsp ; done"
- there should be no "perceivable" differences.
Double close for PR kern/31445.
CAVEAT: Low latency come with (unbearable) price especially for poorly
written applications. Applications that trying to act smarter
by requesting (wrong) blocksize/blockcount will suffer the most.
Fixup samples/patches can be found at:
http://people.freebsd.org/~ariff/ports/
- Switch minimum/maximum sampling rate limit to "1" and "2016000" (48k * 42)
due to closer compatibility with 4front driver.
Discussed with: marcus@ (long time ago?)
- All driver specific sysctls in the form of "hw.snd.pcm%d.*" have been
moved to their own dev sysctl nodes, notably:
hw.snd.pcm%d.vchans -> dev.pcm.%d.vchans
Bump __FreeBSD_version.
Driver specific
---------------
- Ditto for sysctls.
- snd_atiixp, snd_es137x, snd_via8233, snd_hda
* Numerous cleanups and fixes.
* _EXPERIMENTAL_ polling mode support using simple callout_* mechanisme.
This was intended for pure debugging and latency measurement, but proven
good enough in few unexpected and rare cases (such as problematic shared
IRQ with GIANT devices - USB). Polling can be enabled/disabled through
dev.pcm.0.polling. Disabled by default.
- snd_ich
* Fix possible overflow during speed calibration. Delay final
initialization (pcm_setstatus) after calibration finished.
PR: kern/100169
Tested by: Kevin Overman <oberman@es.net>
* Inverted EAPD for few Nec VersaPro.
PR: kern/104715
Submitted by: KAWATA Masahiko <kawata@mta.biglobe.ne.jp>
Thanks to various people, notably Joel Dahl, Yuriy Tsibizov, Kevin Oberman,
those at #freebsd-azalia @ freenode and others for testing.
Joel Dahl will do the manpage update.
271 lines
8.5 KiB
C
271 lines
8.5 KiB
C
/*-
|
|
* Copyright (c) 1999 Cameron Grant <cg@freebsd.org>
|
|
* All rights reserved.
|
|
*
|
|
* Redistribution and use in source and binary forms, with or without
|
|
* modification, are permitted provided that the following conditions
|
|
* are met:
|
|
* 1. Redistributions of source code must retain the above copyright
|
|
* notice, this list of conditions and the following disclaimer.
|
|
* 2. Redistributions in binary form must reproduce the above copyright
|
|
* notice, this list of conditions and the following disclaimer in the
|
|
* documentation and/or other materials provided with the distribution.
|
|
*
|
|
* THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
|
|
* ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
|
|
* IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
|
|
* ARE DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
|
|
* FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
|
|
* DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
|
|
* OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
|
|
* HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
|
|
* LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
|
|
* OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
|
|
* SUCH DAMAGE.
|
|
*
|
|
* $FreeBSD$
|
|
*/
|
|
|
|
struct pcmchan_children {
|
|
SLIST_ENTRY(pcmchan_children) link;
|
|
struct pcm_channel *channel;
|
|
};
|
|
|
|
struct pcmchan_caps {
|
|
u_int32_t minspeed, maxspeed;
|
|
u_int32_t *fmtlist;
|
|
u_int32_t caps;
|
|
};
|
|
|
|
/* Forward declarations */
|
|
struct pcm_channel;
|
|
struct pcmchan_syncgroup;
|
|
struct pcmchan_syncmember;
|
|
|
|
extern struct mtx snd_pcm_syncgroups_mtx;
|
|
extern SLIST_HEAD(pcm_synclist, pcmchan_syncgroup) snd_pcm_syncgroups;
|
|
|
|
#define PCM_SG_LOCK() mtx_lock(&snd_pcm_syncgroups_mtx)
|
|
#define PCM_SG_TRYLOCK() mtx_trylock(&snd_pcm_syncgroups_mtx)
|
|
#define PCM_SG_UNLOCK() mtx_unlock(&snd_pcm_syncgroups_mtx)
|
|
#define PCM_SG_LOCKASSERT(arg) mtx_assert(&snd_pcm_syncgroups_mtx, arg)
|
|
|
|
/**
|
|
* @brief Specifies an audio device sync group
|
|
*/
|
|
struct pcmchan_syncgroup {
|
|
SLIST_ENTRY(pcmchan_syncgroup) link;
|
|
SLIST_HEAD(, pcmchan_syncmember) members;
|
|
int id; /**< Group identifier; set to address of group. */
|
|
};
|
|
|
|
/**
|
|
* @brief Specifies a container for members of a sync group
|
|
*/
|
|
struct pcmchan_syncmember {
|
|
SLIST_ENTRY(pcmchan_syncmember) link;
|
|
struct pcmchan_syncgroup *parent; /**< group head */
|
|
struct pcm_channel *ch;
|
|
};
|
|
|
|
#define CHN_NAMELEN 32
|
|
struct pcm_channel {
|
|
kobj_t methods;
|
|
|
|
int num;
|
|
pid_t pid;
|
|
int refcount;
|
|
struct pcm_feeder *feeder;
|
|
u_int32_t align;
|
|
|
|
int volume;
|
|
int latency;
|
|
u_int32_t speed;
|
|
u_int32_t format;
|
|
u_int32_t flags;
|
|
u_int32_t feederflags;
|
|
u_int32_t blocks;
|
|
|
|
int direction;
|
|
unsigned int interrupts, xruns, feedcount;
|
|
unsigned int timeout;
|
|
struct snd_dbuf *bufhard, *bufsoft;
|
|
struct snddev_info *parentsnddev;
|
|
struct pcm_channel *parentchannel;
|
|
void *devinfo;
|
|
device_t dev;
|
|
char name[CHN_NAMELEN];
|
|
struct mtx *lock;
|
|
/**
|
|
* Increment,decrement this around operations that temporarily yield
|
|
* lock.
|
|
*/
|
|
unsigned int inprog;
|
|
/**
|
|
* Special channel operations should examine @c inprog after acquiring
|
|
* lock. If zero, operations may continue. Else, thread should
|
|
* wait on this cv for previous operation to finish.
|
|
*/
|
|
struct cv cv;
|
|
/**
|
|
* Low water mark for select()/poll().
|
|
*
|
|
* This is initialized to the channel's fragment size, and will be
|
|
* overwritten if a new fragment size is set. Users may alter this
|
|
* value directly with the @c SNDCTL_DSP_LOW_WATER ioctl.
|
|
*/
|
|
unsigned int lw;
|
|
/**
|
|
* If part of a sync group, this will point to the syncmember
|
|
* container.
|
|
*/
|
|
struct pcmchan_syncmember *sm;
|
|
#ifdef OSSV4_EXPERIMENT
|
|
u_int16_t lpeak, rpeak; /**< Peak value from 0-32767. */
|
|
#endif
|
|
SLIST_HEAD(, pcmchan_children) children;
|
|
};
|
|
|
|
#include "channel_if.h"
|
|
|
|
int chn_reinit(struct pcm_channel *c);
|
|
int chn_write(struct pcm_channel *c, struct uio *buf);
|
|
int chn_read(struct pcm_channel *c, struct uio *buf);
|
|
u_int32_t chn_start(struct pcm_channel *c, int force);
|
|
int chn_sync(struct pcm_channel *c, int threshold);
|
|
int chn_flush(struct pcm_channel *c);
|
|
int chn_poll(struct pcm_channel *c, int ev, struct thread *td);
|
|
|
|
int chn_init(struct pcm_channel *c, void *devinfo, int dir, int direction);
|
|
int chn_kill(struct pcm_channel *c);
|
|
int chn_setdir(struct pcm_channel *c, int dir);
|
|
int chn_reset(struct pcm_channel *c, u_int32_t fmt);
|
|
int chn_setvolume(struct pcm_channel *c, int left, int right);
|
|
int chn_setspeed(struct pcm_channel *c, int speed);
|
|
int chn_setformat(struct pcm_channel *c, u_int32_t fmt);
|
|
int chn_setblocksize(struct pcm_channel *c, int blkcnt, int blksz);
|
|
int chn_setlatency(struct pcm_channel *c, int latency);
|
|
int chn_trigger(struct pcm_channel *c, int go);
|
|
int chn_getptr(struct pcm_channel *c);
|
|
struct pcmchan_caps *chn_getcaps(struct pcm_channel *c);
|
|
u_int32_t chn_getformats(struct pcm_channel *c);
|
|
|
|
void chn_resetbuf(struct pcm_channel *c);
|
|
void chn_intr(struct pcm_channel *c);
|
|
int chn_wrfeed(struct pcm_channel *c);
|
|
int chn_rdfeed(struct pcm_channel *c);
|
|
int chn_abort(struct pcm_channel *c);
|
|
|
|
void chn_wrupdate(struct pcm_channel *c);
|
|
void chn_rdupdate(struct pcm_channel *c);
|
|
|
|
int chn_notify(struct pcm_channel *c, u_int32_t flags);
|
|
void chn_lock(struct pcm_channel *c);
|
|
void chn_unlock(struct pcm_channel *c);
|
|
|
|
int chn_getrates(struct pcm_channel *c, int **rates);
|
|
int chn_syncdestroy(struct pcm_channel *c);
|
|
|
|
#ifdef OSSV4_EXPERIMENT
|
|
int chn_getpeaks(struct pcm_channel *c, int *lpeak, int *rpeak);
|
|
#endif
|
|
|
|
#ifdef USING_MUTEX
|
|
#define CHN_LOCK(c) mtx_lock((struct mtx *)((c)->lock))
|
|
#define CHN_UNLOCK(c) mtx_unlock((struct mtx *)((c)->lock))
|
|
#define CHN_TRYLOCK(c) mtx_trylock((struct mtx *)((c)->lock))
|
|
#define CHN_LOCKASSERT(c) mtx_assert((struct mtx *)((c)->lock), MA_OWNED)
|
|
#else
|
|
#define CHN_LOCK(c)
|
|
#define CHN_UNLOCK(c)
|
|
#define CHN_TRYLOCK(c)
|
|
#define CHN_LOCKASSERT(c)
|
|
#endif
|
|
|
|
int fmtvalid(u_int32_t fmt, u_int32_t *fmtlist);
|
|
|
|
#define AFMTSTR_NONE 0 /* "s16le" */
|
|
#define AFMTSTR_SIMPLE 1 /* "s16le:s" */
|
|
#define AFMTSTR_NUM 2 /* "s16le:2" */
|
|
#define AFMTSTR_FULL 3 /* "s16le:stereo" */
|
|
|
|
#define AFMTSTR_MAXSZ 13 /* include null terminator */
|
|
|
|
#define AFMTSTR_MONO_RETURN 0
|
|
#define AFMTSTR_STEREO_RETURN 1
|
|
|
|
struct afmtstr_table {
|
|
char *fmtstr;
|
|
u_int32_t format;
|
|
};
|
|
|
|
int afmtstr_swap_sign(char *);
|
|
int afmtstr_swap_endian(char *);
|
|
u_int32_t afmtstr2afmt(struct afmtstr_table *, const char *, int);
|
|
u_int32_t afmt2afmtstr(struct afmtstr_table *, u_int32_t, char *, size_t, int, int);
|
|
|
|
extern int chn_latency;
|
|
extern int chn_latency_profile;
|
|
extern int report_soft_formats;
|
|
|
|
#define PCMDIR_VIRTUAL 2
|
|
#define PCMDIR_PLAY 1
|
|
#define PCMDIR_REC -1
|
|
|
|
#define PCMTRIG_START 1
|
|
#define PCMTRIG_EMLDMAWR 2
|
|
#define PCMTRIG_EMLDMARD 3
|
|
#define PCMTRIG_STOP 0
|
|
#define PCMTRIG_ABORT -1
|
|
|
|
#define CHN_F_CLOSING 0x00000004 /* a pending close */
|
|
#define CHN_F_ABORTING 0x00000008 /* a pending abort */
|
|
#define CHN_F_RUNNING 0x00000010 /* dma is running */
|
|
#define CHN_F_TRIGGERED 0x00000020
|
|
#define CHN_F_NOTRIGGER 0x00000040
|
|
|
|
#define CHN_F_BUSY 0x00001000 /* has been opened */
|
|
#define CHN_F_HAS_SIZE 0x00002000 /* user set block size */
|
|
#define CHN_F_NBIO 0x00004000 /* do non-blocking i/o */
|
|
#define CHN_F_MAPPED 0x00010000 /* has been mmap()ed */
|
|
#define CHN_F_DEAD 0x00020000
|
|
#define CHN_F_BADSETTING 0x00040000
|
|
#define CHN_F_SETBLOCKSIZE 0x00080000
|
|
#define CHN_F_HAS_VCHAN 0x00100000
|
|
|
|
#define CHN_F_VIRTUAL 0x10000000 /* not backed by hardware */
|
|
|
|
#define CHN_F_RESET (CHN_F_BUSY | CHN_F_DEAD | \
|
|
CHN_F_HAS_VCHAN | CHN_F_VIRTUAL)
|
|
|
|
|
|
#define CHN_N_RATE 0x00000001
|
|
#define CHN_N_FORMAT 0x00000002
|
|
#define CHN_N_VOLUME 0x00000004
|
|
#define CHN_N_BLOCKSIZE 0x00000008
|
|
#define CHN_N_TRIGGER 0x00000010
|
|
|
|
#define CHN_LATENCY_MIN 0
|
|
#define CHN_LATENCY_MAX 10
|
|
#define CHN_LATENCY_DEFAULT 5
|
|
#define CHN_POLICY_MIN CHN_LATENCY_MIN
|
|
#define CHN_POLICY_MAX CHN_LATENCY_MAX
|
|
#define CHN_POLICY_DEFAULT CHN_LATENCY_DEFAULT
|
|
|
|
#define CHN_LATENCY_PROFILE_MIN 0
|
|
#define CHN_LATENCY_PROFILE_MAX 1
|
|
#define CHN_LATENCY_PROFILE_DEFAULT CHN_LATENCY_PROFILE_MAX
|
|
|
|
/*
|
|
* This should be large enough to hold all pcm data between
|
|
* tsleeps in chn_{read,write} at the highest sample rate.
|
|
* (which is usually 48kHz * 16bit * stereo = 192000 bytes/sec)
|
|
*/
|
|
#define CHN_2NDBUFBLKSIZE (2 * 1024)
|
|
/* The total number of blocks per secondary bufhard. */
|
|
#define CHN_2NDBUFBLKNUM (32)
|
|
/* The size of a whole secondary bufhard. */
|
|
#define CHN_2NDBUFMAXSIZE (131072)
|
|
|
|
#define CHANNEL_DECLARE(name) static DEFINE_CLASS(name, name ## _methods, sizeof(struct kobj))
|