u-boot.git/include/sound.h, branch master

doc: replace @return by Return:

2022-01-19T17:11:34+00:00

Sphinx expects Return: and not @return to indicate a return value.

find . -name '*.c' -exec \
sed -i 's/^\(\s\)\*\(\s*\)@return\(\s\)/\1*\2Return:\3/' {} \;

find . -name '*.h' -exec \
sed -i 's/^\(\s\)\*\(\s*\)@return\(\s\)/\1*\2Return:\3/' {} \;

Signed-off-by: Heinrich Schuchardt

sound: Add a new stop_play() method

2020-02-06T02:33:46+00:00

At present there is no positive indication that U-Boot has finished
sending sound data. This means that it is not possible to power down an
audio codec, for example. Add a new method that is called once all sound
data has been sent.

Add a new method for this, called when the sound_play() call is done.

Signed-off-by: Simon Glass

sound: Add uclass operations for beeping

2019-02-20T07:27:08+00:00

Some audio codecs such as Intel HDA do not need to use digital data to
play sounds, but instead have a way to emit beeps. Add this interface as
an option. If the beep interface is not supported, then the sound uclass
falls back to the I2S interface.

Signed-off-by: Simon Glass 
Reviewed-by: Bin Meng

sound: Mark sound_setup() as optional

2019-02-20T07:27:08+00:00

This method in the sound API is optional since some drivers can do this
when probing or as part of SoC init. Mark it as such.

Signed-off-by: Simon Glass 
Reviewed-by: Bin Meng

dm: sound: Use the correct number of channels for sound

2018-12-13T23:37:10+00:00

At present the 'beep' sound generates a waveform for only one channel even
if two are being used. This means that the beep is twice the frequency it
should be. Correct this by making it a parameter.

The fix in a previous commit was correct for sandbox but not for other
boards.

Fixes: 03f11e87a8 ("sound: Correct data output in sound_create_square_wave()")
Signed-off-by: Simon Glass

dm: sound: Complete migration to driver model

2018-12-13T23:36:41+00:00

All users of sound are converted to use driver model. Drop the old code
and the CONFIG_DM_SOUND option.

Signed-off-by: Simon Glass

dm: sound: Create a uclass for sound

2018-12-13T23:32:49+00:00

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

dm: sound: Drop codec_type

2018-12-13T23:32:49+00:00

This field is not really used. It is always set to a known value. Drop it
to simplify the code.

Signed-off-by: Simon Glass

dm: sound: Rename en_sound_codec to sound_codec

2018-12-13T23:32:49+00:00

The en_ prefix is confusing and not needed. Drop it.

Signed-off-by: Simon Glass

sound: Add sample rate as a parameter for square wave

2018-11-29T16:30:05+00:00

At present this value is hard-coded in the function that generates a
square wave. Since sample rates vary between different hardware, it makes
more sense to have this as a parameter.

Update the function and its users.

Signed-off-by: Simon Glass