root/sys/dev/audio/audio_dai.h
/* $NetBSD: audio_dai.h,v 1.2 2019/05/08 13:40:17 isaki Exp $ */

/*-
 * Copyright (c) 2018 Jared McNeill <jmcneill@invisible.ca>
 * 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 ``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 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.
 */

#ifndef _DEV_AUDIO_AUDIO_DAI_H
#define _DEV_AUDIO_AUDIO_DAI_H

#include <sys/errno.h>
#include <dev/audio/audio_if.h>

#define AUDIO_DAI_FORMAT_MASK           __BITS(3,0)
#define AUDIO_DAI_FORMAT_I2S            0
#define AUDIO_DAI_FORMAT_RJ             1
#define AUDIO_DAI_FORMAT_LJ             2
#define AUDIO_DAI_FORMAT_DSPA           3
#define AUDIO_DAI_FORMAT_DSPB           4
#define AUDIO_DAI_FORMAT_AC97           5
#define AUDIO_DAI_FORMAT_PDM            6

#define AUDIO_DAI_POLARITY_MASK         __BITS(5,4)
#define AUDIO_DAI_POLARITY_NB_NF        0
#define AUDIO_DAI_POLARITY_NB_IF        1
#define AUDIO_DAI_POLARITY_IB_NF        2
#define AUDIO_DAI_POLARITY_IB_IF        3
#define AUDIO_DAI_POLARITY_F(n)         (((n) & 0x1) != 0)
#define AUDIO_DAI_POLARITY_B(n)         (((n) & 0x2) != 0)

#define AUDIO_DAI_CLOCK_MASK            __BITS(9,8)
#define AUDIO_DAI_CLOCK_CBM_CFM         0
#define AUDIO_DAI_CLOCK_CBS_CFM         1
#define AUDIO_DAI_CLOCK_CBM_CFS         2
#define AUDIO_DAI_CLOCK_CBS_CFS         3

#define AUDIO_DAI_CLOCK_IN              0
#define AUDIO_DAI_CLOCK_OUT             1

#define AUDIO_DAI_JACK_HP               0
#define AUDIO_DAI_JACK_MIC              1

typedef struct audio_dai_device {
        int     (*dai_set_sysclk)(struct audio_dai_device *, u_int, int);
        int     (*dai_set_format)(struct audio_dai_device *, u_int);
        int     (*dai_add_device)(struct audio_dai_device *, struct audio_dai_device *);
        int     (*dai_jack_detect)(struct audio_dai_device *, u_int, int);

        const struct audio_hw_if *dai_hw_if;            /* audio driver callbacks */

        device_t                dai_dev;                /* device */
        void                    *dai_priv;              /* driver private data */
} *audio_dai_tag_t;

static inline device_t
audio_dai_device(audio_dai_tag_t dai)
{
        return dai->dai_dev;
}

static inline void *
audio_dai_private(audio_dai_tag_t dai)
{
        return dai->dai_priv;
}

static inline int
audio_dai_set_sysclk(audio_dai_tag_t dai, u_int rate, int dir)
{
        if (!dai->dai_set_sysclk)
                return 0;

        return dai->dai_set_sysclk(dai, rate, dir);
}

static inline int
audio_dai_set_format(audio_dai_tag_t dai, u_int format)
{
        if (!dai->dai_set_format)
                return 0;

        return dai->dai_set_format(dai, format);
}

static inline int
audio_dai_add_device(audio_dai_tag_t dai, audio_dai_tag_t aux)
{
        if (!dai->dai_add_device)
                return 0;

        return dai->dai_add_device(dai, aux);
}

static inline int
audio_dai_jack_detect(audio_dai_tag_t dai, u_int jack, bool present)
{
        if (!dai->dai_jack_detect)
                return 0;

        return dai->dai_jack_detect(dai, jack, present);
}

static inline int
audio_dai_open(audio_dai_tag_t dai, int flags)
{
        if (!dai->dai_hw_if->open)
                return 0;
        return dai->dai_hw_if->open(dai->dai_priv, flags);
}

static inline void
audio_dai_close(audio_dai_tag_t dai)
{
        if (!dai->dai_hw_if->close)
                return;
        dai->dai_hw_if->close(dai->dai_priv);
}

static inline int
audio_dai_query_format(audio_dai_tag_t dai, audio_format_query_t *afp)
{
        if (!dai->dai_hw_if->query_format)
                return 0;
        return dai->dai_hw_if->query_format(dai->dai_priv, afp);
}

static inline int
audio_dai_mi_set_format(audio_dai_tag_t dai, int setmode,
    const audio_params_t *play, const audio_params_t *rec,
    audio_filter_reg_t *pfil, audio_filter_reg_t *rfil)
{
        if (!dai->dai_hw_if->set_format)
                return 0;
        return dai->dai_hw_if->set_format(dai->dai_priv, setmode,
            play, rec, pfil, rfil);
}

static inline int
audio_dai_round_blocksize(audio_dai_tag_t dai, int bs, int mode,
    const audio_params_t *params)
{
        if (!dai->dai_hw_if->round_blocksize)
                return bs;
        return dai->dai_hw_if->round_blocksize(dai->dai_priv, bs,
            mode, params);
}

static inline int
audio_dai_commit_settings(audio_dai_tag_t dai)
{
        if (!dai->dai_hw_if->commit_settings)
                return 0;
        return dai->dai_hw_if->commit_settings(dai->dai_priv);
}

static inline int
audio_dai_halt(audio_dai_tag_t dai, int dir)
{
        switch (dir) {
        case AUMODE_PLAY:
                if (!dai->dai_hw_if->halt_output)
                        return 0;
                return dai->dai_hw_if->halt_output(dai->dai_priv);
        case AUMODE_RECORD:
                if (!dai->dai_hw_if->halt_input)
                        return 0;
                return dai->dai_hw_if->halt_input(dai->dai_priv);
        default:
                return EINVAL;
        }
}

static inline int
audio_dai_trigger(audio_dai_tag_t dai, void *start, void *end, int blksize,
    void (*intr)(void *), void *intrarg, const audio_params_t *params,
    int dir)
{
        switch (dir) {
        case AUMODE_PLAY:
                if (!dai->dai_hw_if->trigger_output)
                        return 0;
                return dai->dai_hw_if->trigger_output(dai->dai_priv, start,
                    end, blksize, intr, intrarg, params);
        case AUMODE_RECORD:
                if (!dai->dai_hw_if->trigger_input)
                        return 0;
                return dai->dai_hw_if->trigger_input(dai->dai_priv, start,
                    end, blksize, intr, intrarg, params);
        default:
                return EINVAL;
        }
}

static inline void *
audio_dai_allocm(audio_dai_tag_t dai, int dir, size_t size)
{
        if (!dai->dai_hw_if->allocm)
                return NULL;
        return dai->dai_hw_if->allocm(dai->dai_priv, dir, size);
}

static inline void
audio_dai_freem(audio_dai_tag_t dai, void *addr, size_t size)
{
        if (!dai->dai_hw_if->freem)
                return;
        dai->dai_hw_if->freem(dai->dai_priv, addr, size);
}

static inline size_t
audio_dai_round_buffersize(audio_dai_tag_t dai, int dir, size_t bufsize)
{
        if (!dai->dai_hw_if->round_buffersize)
                return bufsize;
        return dai->dai_hw_if->round_buffersize(dai->dai_priv, dir, bufsize);
}

static inline int
audio_dai_get_props(audio_dai_tag_t dai)
{
        if (!dai->dai_hw_if->get_props)
                return 0;
        return dai->dai_hw_if->get_props(dai->dai_priv);
}

static inline int
audio_dai_getdev(audio_dai_tag_t dai, struct audio_device *adev)
{
        if (!dai->dai_hw_if->getdev)
                return ENXIO;
        return dai->dai_hw_if->getdev(dai->dai_priv, adev);
}

static inline int
audio_dai_get_port(audio_dai_tag_t dai, mixer_ctrl_t *mc)
{
        if (!dai->dai_hw_if->get_port)
                return ENXIO;
        return dai->dai_hw_if->get_port(dai->dai_priv, mc);
}

static inline int
audio_dai_set_port(audio_dai_tag_t dai, mixer_ctrl_t *mc)
{
        if (!dai->dai_hw_if->set_port)
                return ENXIO;
        return dai->dai_hw_if->set_port(dai->dai_priv, mc);
}

static inline int
audio_dai_query_devinfo(audio_dai_tag_t dai, mixer_devinfo_t *di)
{
        if (!dai->dai_hw_if->query_devinfo)
                return ENXIO;
        return dai->dai_hw_if->query_devinfo(dai->dai_priv, di);
}

static inline void
audio_dai_get_locks(audio_dai_tag_t dai, kmutex_t **intr, kmutex_t **thread)
{
        if (!dai->dai_hw_if->get_locks) {
                *intr = NULL;
                *thread = NULL;
                return;
        }

        dai->dai_hw_if->get_locks(dai->dai_priv, intr, thread);
}

#endif /* _DEV_AUDIO_AUDIO_DAI_H */