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

Revision as of 14:22, 13 July 2026

Author	Matrix TSL
Version	2.0
Category	Comms: Interface

I2S Master/Slave ESP32 component

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

Component Source Code

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

Detailed description

No detailed description exists yet for this component

Examples

No additional examples

Macro reference

CheckQueue

	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

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

Read

	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

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

Stop

	Stop
Stops the I2S audio stream
- VOID	Return

Write

	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

Property reference

	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 95: / Line 95: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''CheckQueue'''
+| width="90%" class="mtx-class-macrohead" | '''CheckQueue'''
 |-
 | colspan="2" | 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.&nbsp;
@@ Line 109: / Line 109: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Initialise'''
+| width="90%" class="mtx-class-macrohead" | '''Initialise'''
 |-
 | colspan="2" | Configures the I2C peripheral ready for data.&nbsp;
@@ Line 123: / Line 123: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Read'''
+| width="90%" class="mtx-class-macrohead" | '''Read'''
 |-
 | colspan="2" | 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.&nbsp;
@@ Line 152: / Line 152: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Start'''
+| width="90%" class="mtx-class-macrohead" | '''Start'''
 |-
 | colspan="2" | Starts the I2S audio stream, auto started by the initialise function.&nbsp;
@@ Line 166: / Line 166: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Stop'''
+| width="90%" class="mtx-class-macrohead" | '''Stop'''
 |-
 | colspan="2" | Stops the I2S audio stream&nbsp;
@@ Line 180: / Line 180: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-comp-macro.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Write'''
+| width="90%" class="mtx-class-macrohead" | '''Write'''
 |-
 | colspan="2" | 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.&nbsp;
@@ Line 210: / Line 210: @@
 |-
 | width="10%" align="center" class="mtx-class-macrohead" | [[File:Fc9-prop-icon.png]]
-| width="90%" style="background-color:#D8C9D8; color:#4B008D;" | '''Properties'''
+| width="90%" class="mtx-class-macrohead" | '''Properties'''
 |-
 |-

SteveT (talk | contribs)