Component: I2S Master/Slave ESP32 (Comms: Interface): Difference between revisions

Latest revision as of 14:36, 13 July 2026

Provides access to the onboard inter-IC sound (I2S) peripheras allowing for simple digital audio input and output.

Please click here to download the component source project: FC_Comp_Source_I2S.fcfx

Please click here to view the component source code (Beta): FC_Comp_Source_I2S.fcfx

No detailed description exists yet for this component

No additional examples

	CheckQueue
Checks the I2S Event queue for a DMA Buffer full or empty event. For an output returns true when there is an empty DMA buffer available. For an input return true when there is a full DMA buffer available.
- BOOL	Return

	Initialise
Configures the I2C peripheral ready for data.
- VOID	Return

	Read
Wait timeout ticks to receive length number of samples, returns samples received. 24 and 32-bit data must be split into two integer values per sample.
- INT	Data
Data array to populate with incoming data
- UINT	Length
Max number of samples to try and receive
- UINT	Timeout
Max number of ticks to wait for incoming samples
- UINT	Return

	Start
Starts the I2S audio stream, auto started by the initialise function.
- VOID	Return

	Write
Wait timeout ticks to send length number of samples, returns samples sent 24 and 32-bit data must be split into two integer values per sample.
- INT	Data
Data array containing outgoing data
- UINT	Length
Max number of samples to try and send
- UINT	Timeout
Max number of ticks to wait for space in the outgoing buffer
- UINT	Return

	Properties
	Channel
DAC Channel number
	Clock Pin
I2S Clock Pin
	Serial Data Pin
I2S Serial Data (SD) Pin
	Word Select Pin
I2S Word Select (WS) Pin
	Mode
Configures if the I2S peripheral is a master or slave on the bus.
	Data Direction
Controls if the I2S data is coming in or out of the microcontroller
	Audio Channels
Number of distinct audio channels in the data stream
	Sample Rate
Audio sample rate in Hz
	Data Bits
Nmber of bits in each audio sample
	DMA Buffer Count
I2S DMA Buffer Count
	DMA Buffer Size
I2S DMA Buffer Size
	Simulation

@@ Line 268: / Line 268: @@
 | colspan="2" | I2S DMA Buffer Size&nbsp;
 |-
-| width="10%" align="center" style="background-color:#EAE1EA;" | [[File:Fc9-conn-icon.png]]
+| width="10%" align="center" class="mtx-class-propfolder" | [[File:Fc9-conn-icon.png]]
 | width="90%" class="mtx-class-propfolder" | Simulation
 |-
 |}