1 /* SPDX-License-Identifier: GPL-2.0+ */ 2 /* 3 * Copyright (C) 2012 Samsung Electronics 4 * R. Chandrasekar < rcsekar@samsung.com> 5 */ 6 7 #ifndef __SOUND_H__ 8 #define __SOUND_H__ 9 10 /* sound codec enum */ 11 enum sound_compat { 12 AUDIO_COMPAT_SPI, 13 AUDIO_COMPAT_I2C, 14 }; 15 16 /* Codec information structure to store the info from device tree */ 17 struct sound_codec_info { 18 int i2c_bus; 19 int i2c_dev_addr; 20 }; 21 22 /** 23 * struct sound_uc_priv - private uclass information about each sound device 24 * 25 * This is used to line the codec and i2s together 26 * 27 * @codec: Codec that is used for this sound device 28 * @i2s: I2S bus that is used for this sound device 29 * @setup_done: true if setup() has been called 30 */ 31 struct sound_uc_priv { 32 struct udevice *codec; 33 struct udevice *i2s; 34 int setup_done; 35 }; 36 37 /** 38 * Generates square wave sound data for 1 second 39 * 40 * @sample_rate: Sample rate in Hz 41 * @data: data buffer pointer 42 * @size: size of the buffer in bytes 43 * @freq: frequency of the wave 44 * @channels: Number of channels to use 45 */ 46 void sound_create_square_wave(uint sample_rate, unsigned short *data, int size, 47 uint freq, uint channels); 48 49 /* 50 * The sound uclass brings together a data transport (currently only I2C) and a 51 * codec (currently connected over I2C). 52 */ 53 54 /* Operations for sound */ 55 struct sound_ops { 56 /** 57 * setup() - Set up to play a sound (optional) 58 */ 59 int (*setup)(struct udevice *dev); 60 61 /** 62 * play() - Play a beep 63 * 64 * @dev: Sound device 65 * @data: Data buffer to play 66 * @data_size: Size of data buffer in bytes 67 * @return 0 if OK, -ve on error 68 */ 69 int (*play)(struct udevice *dev, void *data, uint data_size); 70 71 /** 72 * stop_play() - Indicate that there is no more data coming 73 * 74 * This is called once play() has finished sending all the data to the 75 * output device. This may be used to tell the hardware to turn off the 76 * codec, for example. 77 * 78 * @dev: Sound device 79 * @return 0 if OK, -ve on error 80 */ 81 int (*stop_play)(struct udevice *dev); 82 83 /** 84 * start_beep() - Start beeping (optional) 85 * 86 * This tells the sound hardware to start a beep. It will continue until 87 * stopped by sound_stop_beep(). 88 * 89 * @dev: Sound device 90 * @frequency_hz: Beep frequency in hertz 91 * @return if OK, -ENOSYS if not supported, -ve on error 92 */ 93 int (*start_beep)(struct udevice *dev, int frequency_hz); 94 95 /** 96 * stop_beep() - Stop beeping (optional) 97 * 98 * This tells the sound hardware to stop a previously started beep. 99 * 100 * @dev: Sound device 101 * @return if OK, -ve on error 102 */ 103 int (*stop_beep)(struct udevice *dev); 104 }; 105 106 #define sound_get_ops(dev) ((struct sound_ops *)(dev)->driver->ops) 107 108 /** 109 * setup() - Set up to play a sound 110 */ 111 int sound_setup(struct udevice *dev); 112 113 /** 114 * play() - Play a beep 115 * 116 * @dev: Sound device 117 * @msecs: Duration of beep in milliseconds 118 * @frequency_hz: Frequency of the beep in Hertz 119 * @return 0 if OK, -ve on error 120 */ 121 int sound_beep(struct udevice *dev, int msecs, int frequency_hz); 122 123 /** 124 * sound_start_beep() - Start beeping 125 * 126 * This tells the sound hardware to start a beep. It will continue until stopped 127 * by sound_stop_beep(). 128 * 129 * @dev: Sound device 130 * @frequency_hz: Beep frequency in hertz 131 * @return if OK, -ve on error 132 */ 133 int sound_start_beep(struct udevice *dev, int frequency_hz); 134 135 /** 136 * sound_stop_beep() - Stop beeping 137 * 138 * This tells the sound hardware to stop a previously started beep. 139 * 140 * @dev: Sound device 141 * @return if OK, -ve on error 142 */ 143 int sound_stop_beep(struct udevice *dev); 144 145 /** 146 * sound_find_codec_i2s() - Called by sound drivers to locate codec and i2s 147 * 148 * This finds the audio codec and i2s devices and puts them in the uclass's 149 * private data for this device. 150 */ 151 int sound_find_codec_i2s(struct udevice *dev); 152 153 #endif /* __SOUND__H__ */ 154