dai.h

Go to the documentation of this file.

/*
 * Copyright (c) 2022 Intel Corporation
 *
 * SPDX-License-Identifier: Apache-2.0
 */
 
#ifndef ZEPHYR_INCLUDE_DRIVERS_DAI_H_
#define ZEPHYR_INCLUDE_DRIVERS_DAI_H_
 
#include <errno.h>
 
#include <zephyr/types.h>
#include <zephyr/device.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define DAI_FORMAT_CLOCK_PROVIDER_MASK 0xf000
#define DAI_FORMAT_PROTOCOL_MASK 0x000f
#define DAI_FORMAT_CLOCK_INVERSION_MASK 0x0f00
 
enum dai_clock_provider {
 DAI_CBP_CFP = (0 << 12),
 DAI_CBC_CFP = (2 << 12),
 DAI_CBP_CFC = (3 << 12),
 DAI_CBC_CFC = (4 << 12),
};
 
enum dai_protocol {
 DAI_PROTO_I2S = 1, 
 DAI_PROTO_RIGHT_J, 
 DAI_PROTO_LEFT_J, 
 DAI_PROTO_DSP_A, 
 DAI_PROTO_DSP_B, 
 DAI_PROTO_PDM, 
};
 
enum dai_clock_inversion {
 DAI_INVERSION_NB_NF = 0,
 DAI_INVERSION_NB_IF = (2 << 8),
 DAI_INVERSION_IB_NF = (3 << 8),
 DAI_INVERSION_IB_IF = (4 << 8),
};
 
enum dai_type {
 DAI_LEGACY_I2S = 0, 
 DAI_INTEL_SSP, 
 DAI_INTEL_DMIC, 
 DAI_INTEL_HDA, 
 DAI_INTEL_ALH, 
 DAI_IMX_SAI, 
 DAI_IMX_ESAI, 
 DAI_AMD_BT, 
 DAI_AMD_SP, 
 DAI_AMD_DMIC, 
 DAI_MEDIATEK_AFE, 
 DAI_INTEL_SSP_NHLT, 
 DAI_INTEL_DMIC_NHLT, 
 DAI_INTEL_HDA_NHLT, 
 DAI_INTEL_ALH_NHLT, 
};
 
enum dai_dir {
 DAI_DIR_TX = 0,
 DAI_DIR_RX,
 DAI_DIR_BOTH,
};
 
enum dai_state {
 DAI_STATE_NOT_READY = 0,
 DAI_STATE_READY,
 DAI_STATE_RUNNING,
 DAI_STATE_PRE_RUNNING,
 DAI_STATE_PAUSED,
 DAI_STATE_STOPPING,
 DAI_STATE_ERROR,
};
 
enum dai_trigger_cmd {
 DAI_TRIGGER_START = 0,
 DAI_TRIGGER_PRE_START,
 DAI_TRIGGER_STOP,
 DAI_TRIGGER_PAUSE,
 DAI_TRIGGER_POST_STOP,
 DAI_TRIGGER_DRAIN,
 DAI_TRIGGER_DROP,
 DAI_TRIGGER_PREPARE,
 DAI_TRIGGER_RESET,
 DAI_TRIGGER_COPY,
};
 
struct dai_properties {
 uint32_t fifo_address;
 uint32_t fifo_depth;
 uint32_t dma_hs_id;
 uint32_t reg_init_delay;
 int stream_id;
};
 
struct dai_config {
 enum dai_type type;
 uint32_t dai_index;
 uint8_t channels;
 uint32_t rate;
 uint16_t format;
 uint8_t options;
 uint8_t word_size;
 size_t block_size;
 uint16_t link_config;
};
 
struct dai_ts_cfg {
 uint32_t walclk_rate;
 int type;
 int direction;
 int index;
 int dma_id;
 int dma_chan_index;
 int dma_chan_count;
};
 
struct dai_ts_data {
 uint64_t walclk;
 uint64_t sample;
 uint32_t walclk_rate;
};
 
__subsystem struct dai_driver_api {
 int (*probe)(const struct device *dev);
 int (*remove)(const struct device *dev);
 int (*config_set)(const struct device *dev, const struct dai_config *cfg,
 const void *bespoke_cfg);
 int (*config_get)(const struct device *dev, struct dai_config *cfg,
 enum dai_dir dir);
 
 const struct dai_properties *(*get_properties)(const struct device *dev,
 enum dai_dir dir,
 int stream_id);
 
 int (*trigger)(const struct device *dev, enum dai_dir dir,
 enum dai_trigger_cmd cmd);
 
 /* optional methods */
 int (*ts_config)(const struct device *dev, struct dai_ts_cfg *cfg);
 int (*ts_start)(const struct device *dev, struct dai_ts_cfg *cfg);
 int (*ts_stop)(const struct device *dev, struct dai_ts_cfg *cfg);
 int (*ts_get)(const struct device *dev, struct dai_ts_cfg *cfg,
 struct dai_ts_data *tsd);
};
 
static inline int dai_probe(const struct device *dev)
{
 const struct dai_driver_api *api = (const struct dai_driver_api *)dev->api;
 
 return api->probe(dev);
}
 
static inline int dai_remove(const struct device *dev)
{
 const struct dai_driver_api *api = (const struct dai_driver_api *)dev->api;
 
 return api->remove(dev);
}
 
static inline int dai_config_set(const struct device *dev,
 const struct dai_config *cfg,
 const void *bespoke_cfg)
{
 const struct dai_driver_api *api = (const struct dai_driver_api *)dev->api;
 
 return api->config_set(dev, cfg, bespoke_cfg);
}
 
static inline int dai_config_get(const struct device *dev,
 struct dai_config *cfg,
 enum dai_dir dir)
{
 const struct dai_driver_api *api = (const struct dai_driver_api *)dev->api;
 
 return api->config_get(dev, cfg, dir);
}
 
static inline const struct dai_properties *dai_get_properties(const struct device *dev,
 enum dai_dir dir,
 int stream_id)
{
 const struct dai_driver_api *api = (const struct dai_driver_api *)dev->api;
 
 return api->get_properties(dev, dir, stream_id);
}
 
static inline int dai_trigger(const struct device *dev,
 enum dai_dir dir,
 enum dai_trigger_cmd cmd)
{
 const struct dai_driver_api *api = (const struct dai_driver_api *)dev->api;
 
 return api->trigger(dev, dir, cmd);
}
 
static inline int dai_ts_config(const struct device *dev, struct dai_ts_cfg *cfg)
{
 const struct dai_driver_api *api = (const struct dai_driver_api *)dev->api;
 
 if (!api->ts_config)
 return -EINVAL;
 
 return api->ts_config(dev, cfg);
}
 
static inline int dai_ts_start(const struct device *dev, struct dai_ts_cfg *cfg)
{
 const struct dai_driver_api *api = (const struct dai_driver_api *)dev->api;
 
 if (!api->ts_start)
 return -EINVAL;
 
 return api->ts_start(dev, cfg);
}
 
static inline int dai_ts_stop(const struct device *dev, struct dai_ts_cfg *cfg)
{
 const struct dai_driver_api *api = (const struct dai_driver_api *)dev->api;
 
 if (!api->ts_stop)
 return -EINVAL;
 
 return api->ts_stop(dev, cfg);
}
 
static inline int dai_ts_get(const struct device *dev, struct dai_ts_cfg *cfg,
 struct dai_ts_data *tsd)
{
 const struct dai_driver_api *api = (const struct dai_driver_api *)dev->api;
 
 if (!api->ts_get)
 return -EINVAL;
 
 return api->ts_get(dev, cfg, tsd);
}
 
#ifdef __cplusplus
}
#endif
 
#endif /* ZEPHYR_INCLUDE_DRIVERS_DAI_H_ */