mirror of
https://github.com/brain-hackers/u-boot-brain
synced 2024-06-09 23:36:03 +09:00
d490189865
The sound driver pulls together the audio codec and i2s drivers in order to actually make sounds. It supports setup() and play() methods. The sound_find_codec_i2s() function allows locating the linked codec and i2s devices. They can be referred to from uclass-private data. Add a uclass and a test for sound. Signed-off-by: Simon Glass <sjg@chromium.org>
115 lines
2.7 KiB
C
115 lines
2.7 KiB
C
/* SPDX-License-Identifier: GPL-2.0+ */
|
|
/*
|
|
* Copyright (C) 2012 Samsung Electronics
|
|
* R. Chandrasekar < rcsekar@samsung.com>
|
|
*/
|
|
|
|
#ifndef __SOUND_H__
|
|
#define __SOUND_H__
|
|
|
|
/* sound codec enum */
|
|
enum sound_compat {
|
|
AUDIO_COMPAT_SPI,
|
|
AUDIO_COMPAT_I2C,
|
|
};
|
|
|
|
/* Codec information structure to store the info from device tree */
|
|
struct sound_codec_info {
|
|
int i2c_bus;
|
|
int i2c_dev_addr;
|
|
};
|
|
|
|
/**
|
|
* struct sound_uc_priv - private uclass information about each sound device
|
|
*
|
|
* This is used to line the codec and i2s together
|
|
*
|
|
* @codec: Codec that is used for this sound device
|
|
* @i2s: I2S bus that is used for this sound device
|
|
* @setup_done: true if setup() has been called
|
|
*/
|
|
struct sound_uc_priv {
|
|
struct udevice *codec;
|
|
struct udevice *i2s;
|
|
int setup_done;
|
|
};
|
|
|
|
/**
|
|
* Generates square wave sound data for 1 second
|
|
*
|
|
* @param sample_rate Sample rate in Hz
|
|
* @param data data buffer pointer
|
|
* @param size size of the buffer in bytes
|
|
* @param freq frequency of the wave
|
|
*/
|
|
void sound_create_square_wave(uint sample_rate, unsigned short *data, int size,
|
|
uint freq);
|
|
|
|
/*
|
|
* Initialises audio sub system
|
|
* @param blob Pointer of device tree node or NULL if none.
|
|
* @return int value 0 for success, -1 for error
|
|
*/
|
|
int sound_init(const void *blob);
|
|
|
|
#ifdef CONFIG_DM_SOUND
|
|
/*
|
|
* The sound uclass brings together a data transport (currently only I2C) and a
|
|
* codec (currently connected over I2C).
|
|
*/
|
|
|
|
/* Operations for sound */
|
|
struct sound_ops {
|
|
/**
|
|
* setup() - Set up to play a sound
|
|
*/
|
|
int (*setup)(struct udevice *dev);
|
|
|
|
/**
|
|
* play() - Play a beep
|
|
*
|
|
* @dev: Sound device
|
|
* @data: Data buffer to play
|
|
* @data_size: Size of data buffer in bytes
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int (*play)(struct udevice *dev, void *data, uint data_size);
|
|
};
|
|
|
|
#define sound_get_ops(dev) ((struct sound_ops *)(dev)->driver->ops)
|
|
|
|
/**
|
|
* setup() - Set up to play a sound
|
|
*/
|
|
int sound_setup(struct udevice *dev);
|
|
|
|
/**
|
|
* play() - Play a beep
|
|
*
|
|
* @dev: Sound device
|
|
* @msecs: Duration of beep in milliseconds
|
|
* @frequency_hz: Frequency of the beep in Hertz
|
|
* @return 0 if OK, -ve on error
|
|
*/
|
|
int sound_beep(struct udevice *dev, int msecs, int frequency_hz);
|
|
|
|
/**
|
|
* sound_find_codec_i2s() - Called by sound drivers to locate codec and i2s
|
|
*
|
|
* This finds the audio codec and i2s devices and puts them in the uclass's
|
|
* private data for this device.
|
|
*/
|
|
int sound_find_codec_i2s(struct udevice *dev);
|
|
|
|
#else
|
|
/*
|
|
* plays the pcm data buffer in pcm_data.h through i2s1 to make the
|
|
* sine wave sound
|
|
*
|
|
* @return int 0 for success, -1 for error
|
|
*/
|
|
int sound_play(uint32_t msec, uint32_t frequency);
|
|
#endif /* CONFIG_DM_SOUND */
|
|
|
|
#endif /* __SOUND__H__ */
|