Skip to content

Latest commit

 

History

History
287 lines (162 loc) · 7.94 KB

speaker.rst

File metadata and controls

287 lines (162 loc) · 7.94 KB
Raw

Speaker

The Speaker is used to control the built-in speaker inside the host device. Below is the detailed support for Speaker on the host:

Controller NS4168 AW88298
AtomS3
AtomS3 Lite
AtomS3U
StampS3
CoreS3 ✔
Core2 ✔
TOUGH ✔

Micropython Example:

pass

UIFLOW2 Example:

pass

class Speaker

Important

Methods of the Speaker Class heavily rely on M5.begin() and M5.update() .

All calls to methods of Speaker objects should be placed after M5.begin() , and M5.update() should be called in the main loop.

Methods

Speaker.config([cfg]) Speaker.config('param') Speaker.config(param=value)

Get or set the parameters of the Speaker object.

UIFLOW2:

Read property:

Parameter Type Description
pin_data_out (integer) Serial data line of I2S, representing audio data in binary complement.
pin_bck (integer) Serial clock line of I2S, corresponding to each bit of digital audio data.
pin_ws (integer) Frame clock of I2S, used to switch left and right channel data.
sample_rate (integer) Target sampling rate of output audio.
stereo (boolean) Use stereo output.
buzzer (boolean) Use single GPIO buzzer.
use_dac (boolean) Use DAC speaker.
dac_zero_level (integer) Zero level reference value when using DAC.
magnification (integer) Multiplier of the input value.
dma_buf_len (integer) DMA buffer length of I2S.
dma_buf_count (integer) Number of DMA buffers of I2S.
task_priority (integer) Priority of background tasks.
task_pinned_core (integer) CPU used by background tasks.
i2s_port (integer) I2S port.

Python:

Speaker.config("pin_data_in")

Set property:

Python:

Speaker.config(pin_data_in=1)

Speaker.begin() -> bool

Start the Speaker function. Returns True if successful.

UIFLOW2:

Speaker.end() -> None

Disable the Speaker.

UIFLOW2:

Speaker.isRunning() -> bool

Check if the Speaker is running. Returns a boolean value.

UIFLOW2:

Speaker.isEnabled() -> bool

Check if the Speaker is enabled. Returns a boolean value.

UIFLOW2:

Speaker.isPlaying([channel]) -> bool

Check if the Speaker is playing sound. Returns a boolean value.

If the parameter channel is provided, it checks the playback status of the specified channel. channel accepts values from 0 to 7.

UIFLOW2:

Speaker.getPlayingChannels() -> int

Get the number of channels currently playing.

UIFLOW2:

Speaker.setVolume(volume: int) -> None

Set the master volume level for audio output. volume accepts volume levels from 0 to 255.

UIFLOW2:

Speaker.getVolume() -> int

Get the master volume level for audio output. Returns volume levels from 0 to 255.

UIFLOW2:

Speaker.setVolumePercentage(percentage: float) -> None

Set the master volume level for audio output as a percentage. percentage ranges from 0% to 100%.

UIFLOW2:

Speaker.getVolumePercentage() -> float

Get the master volume level for audio output as a percentage. Returns volume levels from 0% to 100%.

UIFLOW2:

Speaker.setAllChannelVolume(volume: int) -> None

Set the volume level for all virtual channels. volume accepts volume levels from 0 to 255.

UIFLOW2:

Speaker.setChannelVolume(channel: int, volume: int) -> None

Set the volume level for a specific virtual channel.

Parameters:

  • volume accepts volume levels from 0 to 255.
  • channel is the channel to play, ranging from 0 to 7.

UIFLOW2:

Speaker.getChannelVolume(channel) -> int

Get the volume level for a specific virtual channel. channel ranges from 0 to 7.

UIFLOW2:

Speaker.stop([channel]) -> None

Stop sound output. If channel is not specified, stop sound output for all channels. channel accepts values from 0 to 7.

UIFLOW2:

Speaker.tone(frequency, duration[, channel[, stop_current_sound]]) -> None

Play a simple tone.

Parameters:

  • frequency is the frequency of the tone in Hz.
  • duration is the duration of the tone in milliseconds.
  • channel is the channel to play, ranging from 0 to 7. By default, it is -1, which means using an available channel.
  • stop_current_sound controls whether to wait for the previous audio playback to finish. If True, start the new output without waiting for the current output to finish.

UIFLOW2:

Speaker.playRaw(wav_data: bytes|bytearray[, sample_rate: int[, stereo: bool[, repeat: int[, channel: int[, stop_current_sound: bool]]]]]) -> bool

Play PCM data.

Parameters:

  • wav_data is the buffer of audio data.
  • sample_rate is the sample rate of the audio data.
  • stereo specifies if the audio is stereo.
  • repeat is the number of times to repeat the audio. Default is 1.
  • channel is the channel to play, ranging from 0 to 7. By default, it is -1, which means using an available channel.
  • stop_current_sound controls whether to wait for the previous audio playback to finish. If True, start the new output without waiting for the current output to finish.

UIFLOW2:

Speaker.playWav(wav_data: bytes|bytearray[, repeat: int[, channel: int[, stop_current_sound: bool]]]) -> None

Play audio data in WAV format. Requires passing the raw data of the entire audio file.

Parameters:

  • wav_data is the buffer of audio data.
  • repeat is the number of times to repeat the audio. Default is 1.
  • channel is the channel to play, ranging from 0 to 7. By default, it is -1, which means using an available channel.
  • stop_current_sound controls whether to wait for the previous audio playback to finish. If True, start the new output without waiting for the current output to finish.

UIFLOW2: