® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) 2.50 Features Master only 8 to 32 data bits per sample 16-, 32-, 48-, or 64-bit word select period Data rate up to 96 kHz with 64-bit word select period: 6.144 MHz Tx and Rx FIFO interrupts DMA support Independent left and right channel FIFOs or interleaved stereo FIFOs Independent enable of Rx and Tx General Description The Integrated Inter-IC Sound Bus (I2S) is a serial bus interface standard used for connecting digital audio devices together. The specification is from Philips® Semiconductor (I2S bus specification; February 1986, revised June 5, 1996). The I2S component operates in master mode only. It also operates in two directions, as a transmitter (Tx) and a receiver (Rx). The data for Tx and Rx are independent byte streams. The byte streams are packed with the most significant byte first and the most significant bit in bit 7 of the first word. The number of bytes used for each sample (a sample for the left or right channel) is the minimum number of bytes to hold a sample. When to Use an I2S The component provides a serial bus interface for stereo audio data. This interface is most commonly used by audio ADC and DAC components. Cypress Semiconductor Corporation • 198 Champion Court • San Jose, CA 95134-1709 • 408-943-2600 Document Number: 001-88609 Rev. ** Revised July 29, 2013 Inter-IC Sound Bus (I2S) ® PSoC Creator™ Component Datasheet Input/Output Connections This section describes the various input and output connections for the I2S component. An asterisk (*) in the list of I/Os indicates that the I/O may be hidden on the symbol under the conditions listed in the description of that I/O. sdi – Input * Serial data input. Displays if an Rx option is selected for the Direction parameter. If this signal is connected to an input pin, then the "Input Synchronized" selection for this pin should be disabled. This signal should already be synchronized to SCK, so delaying the signal with the input pin synchronizer could cause the signal to be shifted into the next clock cycle. clock – Input The clock rate provided must be two times the desired clock rate for the output serial clock (SCK). For example, to produce 48-kHz audio with a 64-bit word select period the clock frequency is: 2 × 48 kHz × 64 = 6.144 MHz sdo – Output * Serial data output. Displays if a Tx option is selected for the Direction parameter. sck – Output Output serial clock. ws – Output Word select output indicates the channel being transmitted. rx_interrupt – Output * Rx direction interrupt. Displays if an Rx option is selected for the Direction parameter. tx_interrupt – Output * Tx direction interrupt. Displays if a Tx option is selected for the Direction parameter. rx_DMA0 – Output * Rx direction DMA request for FIFO 0 (Left or Interleaved). Displays if a Rx DMA is selected under the DMA Request parameter. Page 2 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) rx_DMA1 – Output * Rx direction DMA request for FIFO 1 (Right). Displays if a Rx DMA is selected under the DMA Request parameter and Separated L/R under the Data Interleaving parameter for Rx. tx_DMA0– Output * Tx direction DMA request for FIFO 0 (Left or Interleaved). Displays if a Tx DMA is selected under the DMA Request parameter. tx_DMA1 – Output * Tx direction DMA request for FIFO 1 (Right). Displays if a Tx DMA is selected under the DMA Request parameter and Separated L/R under the Data Interleaving parameter for Tx. Schematic Macro Information By default, the PSoC Creator Component Catalog contains three Schematic Macro implementations for the I2S component. These macros contain the I2S component already connected to digital pin components. The “Input Synchronized” option is unchecked on the SDI pin, and the generation of APIs for all of the pins is turned off. The Schematic Macros use the I2S component configured for Rx only, Tx only, and both Rx and Tx directions, as shown in the following diagrams. I2S Rx Only Document Number: 001-88609 Rev. ** I2S Tx Only Page 3 of 24 Inter-IC Sound Bus (I2S) ® PSoC Creator™ Component Datasheet I2S Rx and Tx Component Parameters Drag an I2S component onto your design and double-click it to open the Configure dialog. This dialog has two tabs used for the process of setting up the I2S component. Figure 1. Basic Tab Direction Determines which direction the component operates. This value can be set to Rx Only, Tx Only, or Rx and Tx (default). Page 4 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) Data Bits Determines the number of data bits configured for each sample (hardware compiled). This value can be set between 8 and 32. The default setting is 16. Word Select Period Defines the period of a complete sample of both left and right channels. This value can be set to 16, 32 (default), 48, or 64. Figure 2. Advanced Tab Data Interleaving Used to select whether the data is Interleaved (default) or Separate L/R. Rx and Tx are selected independently. DMA Request Used to enable and disable the DMA request signals for the component. Rx and Tx are selected independently. These options are enabled by default. Interrupt Source Used to configure the interrupt sources for Rx and Tx direction. Rx and Tx directions have separate interrupt outputs. Multiple sources for each direction are ORed together. The software Document Number: 001-88609 Rev. ** Page 5 of 24 ® Inter-IC Sound Bus (I2S) PSoC Creator™ Component Datasheet can re-configure these sources at any time; these parameters simply define an initial configuration. Settings include: Rx: Rx Overflow Rx FIFO 0 not empty (Left or Interleaved) Rx FIFO 1 not empty (Right) - Only an option if not Interleaved Tx: Tx Underflow Tx FIFO 0 not full (Left or Interleaved) Tx FIFO 1 not full (Right) - Only an option if not Interleaved Clock Selection There is no internal clock in this component. You must attach a clock source. The clock rate provided must be two times the desired clock rate for the output serial clock (SCK). Application Programming Interface Application Programming Interface (API) routines allow configuration of the component using the software. The following table lists and describes the interface for each function. The subsequent sections cover each function in more detail. By default, PSoC Creator assigns the instance name “I2S_1” to the first instance of a component in a given design. The instance can be renamed to any unique value that follows the syntactic rules for identifiers. The instance name becomes the prefix of every global function name, variable, and constant symbol. For readability, the instance name used in the following table is “I2S.” Function Description I2S_Start() Starts the I2S interface I2S_Stop() Disables the I2S interface I2S_EnableTx() Enables the Tx direction of the I2S interface I2S_DisableTx() Disables the Tx direction of the I2S interface I2S_EnableRx() Enables the Rx direction of the I2S interface I2S_DisableRx() Disables the Rx direction of the I2S interface I2S_SetRxInterruptMode() Sets the interrupt source for the I2S Rx direction interrupt I2S_SetTxInterruptMode() Sets the interrupt source for the I2S Tx direction interrupt Page 6 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) Function Description I2S_ReadRxStatus() Returns state in the I2S Rx status register I2S_ReadTxStatus() Returns state in the I2S Tx status register I2S_ReadByte() Returns a single byte from the Rx FIFO I2S_WriteByte() Writes a single byte into the Tx FIFO I2S_ClearRxFIFO() Clears out the Rx FIFO I2S_ClearTxFIFO() Clears out the Tx FIFO I2S_Sleep() Saves configuration and disables the I2S interface I2S_Wakeup() Restores configuration and enables the I2S interface I2S_Init() Enables the I2S interface I2S_Enable() Initializes or restores default I2S configuration I2S_SaveConfig() Saves configuration of I2S interface I2S_RestoreConfig() Restores configuration of I2S interface Global Variables Variable Description I2S_initVar Indicates whether the I2S has been initialized. The variable is initialized to 0 and set to 1 the first time I2S_Start() is called. This allows the component to restart without reinitialization after the first call to the I2S_Start() routine. If reinitialization of the component is required, call I2S_Init() before calling I2S_Start(). Alternatively, the I2S can be reinitialized by calling the I2S_Init() and I2S_Enable() functions. void I2S_Start(void) Description: Starts the I2S interface. Enables Active mode power template bits or clock gating as appropriate. Starts the generation of the sck and ws outputs. The Tx and Rx directions remain disabled. Parameters: None Return Value: None Side Effects: None Document Number: 001-88609 Rev. ** Page 7 of 24 Inter-IC Sound Bus (I2S) ® PSoC Creator™ Component Datasheet void I2S_Stop(void) Description: Disables the I2S interface. Disables Active mode power template bits or clock gating as appropriate. The sck and ws outputs are set to 0. The Tx and Rx directions are disabled and their FIFOs are cleared. Parameters: None Return Value: None Side Effects: None void I2S_EnableTx(void) Description: Enables the Tx direction of the I2S interface. Transmission begins at the next word select falling edge. Parameters: None Return Value: None Side Effects: None void I2S_DisableTx(void) Description: Disables the Tx direction of the I2S interface. Transmission of data stops and a constant 0 value is transmitted at the next word select falling edge. Parameters: None Return Value: None Side Effects: None void I2S_EnableRx(void) Description: Enables the Rx direction of the I2S interface. Data reception begins at the next word select falling edge. Parameters: None Return Value: None Side Effects: None Page 8 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) void I2S_DisableRx(void) Description: Disables the Rx direction of the I2S interface. At the next word select falling edge, data reception is no longer sent to the receive FIFO. Parameters: None Return Value: None Side Effects: None void I2S_SetRxInterruptMode(uint8 interruptSource) Description: Sets the interrupt source for the I2S Rx direction interrupt. Multiple sources may be ORed. Parameters: uint8: Byte containing the constant for the selected interrupt sources I2S Rx Interrupt Source Value Type RX_FIFO_OVERFLOW 0x01 Clear on Read RX_FIFO_0_NOT_EMPTY 0x02 Transparent RX_FIFO_1_NOT_EMPTY 0x04 Transparent Return Value: None Side Effects: If clear on read bits are used as the sources for the interrupt generation the rx_interrupt output remains asserted until the I2S Rx status register is read. void I2S_SetTxInterruptMode(uint8 interruptSource) Description: Sets the interrupt source for the I2S Tx direction interrupt. Multiple sources may be ORed. Parameters: uint8: Byte containing the constant for the selected interrupt sources I2S Tx Interrupt Source Value Type TX_FIFO_UNDERFLOW 0x01 Clear on Read TX_FIFO_0_NOT_FULL 0x02 Transparent TX_FIFO_1_NOT_FULL 0x04 Transparent Return Value: None Side Effects: If clear on read bits are used as the sources for the interrupt generation, the tx_interrupt output remains asserted until the I2S Tx status register is read. Document Number: 001-88609 Rev. ** Page 9 of 24 ® Inter-IC Sound Bus (I2S) PSoC Creator™ Component Datasheet uint8 I2S_ReadRxStatus(void) Description: Returns state of the I2S Rx status register. Parameters: None Return Value: uint8: State of the I2S Rx status register Side Effects: I2S Rx Status Masks Value Type RX_FIFO_OVERFLOW 0x01 Clear on Read RX_FIFO_0_NOT_EMPTY 0x02 Transparent RX_FIFO_1_NOT_EMPTY 0x04 Transparent Clears the bits of the I2S Rx status register that are clear on read. uint8 I2S_ReadTxStatus(void) Description: Returns state of the I2S Tx status register. Parameters: None Return Value: uint8: State of the I2S Tx status register Side Effects: I2S Tx Status Masks Value Type TX_FIFO_UNDERFLOW 0x01 Clear on Read TX_FIFO_0_NOT_FULL 0x02 Transparent TX_FIFO_1_NOT_FULL 0x04 Transparent Clears the bits of the I2S Rx status register that are clear on read. uint8 I2S_ReadByte(uint8 wordSelect) Description: Returns a single byte from the Rx FIFO. Check the Rx status before this call to confirm that the Rx FIFO is not empty. Parameters: uint8: Indicates to read from the Left (0) or Right (1) channel. In interleaved mode, this parameter is ignored. Return Value: uint8: Byte containing the data received Side Effects: None Page 10 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) void I2S_WriteByte(uint8 wrData, uint8 wordSelect) Description: Writes a single byte into the Tx FIFO. Check the Tx status before this call to confirm that the Tx FIFO is not full. Parameters: uint8 wrData: Byte containing the data to transmit uint8 wordSelect: Indicates to write to the Left (0) or Right (1) channel. In interleaved mode, this parameter is ignored Return Value: None Side Effects: None void I2S_ClearRxFIFO(void) Description: Clears out the Rx FIFO. Any data present in the FIFO is lost. Call this function only when the Rx direction is disabled. Parameters: None Return Value: None Side Effects: None void I2S_ClearTxFIFO(void) Description: Clears out the Tx FIFO. Any data present in the FIFO is lost. Call this function only when the Tx direction is disabled. Parameters: None Return Value: None Side Effects: None void I2S_Sleep(void) Description: This is the preferred routine to prepare the component for sleep. The I2S_Sleep() routine saves the current component state. Then it calls the I2S_Stop() function and calls I2S_SaveConfig() to save the hardware configuration. Disables Active mode power template bits or clock gating as appropriate. The sck and ws outputs are set to 0. The Tx and Rx directions are disabled. Call the I2S_Sleep() function before calling the CyPmSleep() or the CyPmHibernate() function. Refer to the PSoC Creator System Reference Guide for more information about power management functions. Parameters: None Return Value: None Side Effects: None Document Number: 001-88609 Rev. ** Page 11 of 24 Inter-IC Sound Bus (I2S) ® PSoC Creator™ Component Datasheet void I2S_Wakeup(void) Description: Restores I2S configuration and nonretention register values. Enables Active mode power template bits or clock gating, as appropriate. Starts the generation of the sck and ws outputs. Enables Rx and/or Tx direction according to their states before sleep. Parameters: None Return Value: None Side Effects: Calling the I2S_Wakeup() function without first calling the I2S_Sleep() or I2S_SaveConfig() function may produce unexpected behavior. void I2S_Init(void) Description: Initializes or restores default I2S configuration provided with customizer that defines interrupt sources for the component. Parameters: None Return Value: None Side Effects: Restores only mask registers for interrupt generation. It does not clear data from the FIFOs and does not reset component hardware state machines. void I2S_Enable(void) Description: Activates the hardware and begins component operation. It is not necessary to call I2S_Enable() because the I2S_Start() routine calls this function, which is the preferred method to begin component operation. Parameters: None Return Value: None Side Effects: None void I2S_SaveConfig(void) Description: This function saves the component configuration and nonretention registers. It also saves the current component parameter values, as defined in the Configure dialog or as modified by appropriate APIs. This function is called by the I2S_Sleep() function. Parameters: None Return Value: None Side Effects: None Page 12 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) void I2S_RestoreConfig(void) Description: This function restores the component configuration and nonretention registers. It also restores the component parameter values to what they were prior to calling the I2S_Sleep() function.This routines is called by I2S_Wakeup() to restore the component when it exits sleep. Parameters: None Return Value: None Side Effects: Must be called only after I2S_SaveConfig() routine. Otherwise, the component configuration will be overwritten with its initial setting. MISRA Compliance This section describes the MISRA-C:2004 compliance and deviations for the component. There are two types of deviations defined: project deviations – deviations that are applicable for all PSoC Creator components specific deviations – deviations that are applicable only for this component This section provides information on component-specific deviations. Project deviations are described in the MISRA Compliance section of the System Reference Guide along with information on the MISRA compliance verification environment. The I2S component does not have any specific deviations. Sample Firmware Source Code PSoC Creator provides numerous example projects that include schematics and example code in the Find Example Project dialog. For component-specific examples, open the dialog from the Component Catalog or an instance of the component in a schematic. For general examples, open the dialog from the Start Page or File menu. As needed, use the Filter Options in the dialog to narrow the list of projects available to select. Refer to the “Find Example Project” topic in the PSoC Creator Help for more information. Document Number: 001-88609 Rev. ** Page 13 of 24 ® Inter-IC Sound Bus (I2S) PSoC Creator™ Component Datasheet Functional Description Left/Right and Rx/Tx Configuration The configuration for the Left and Right channels – the Rx and Tx direction, number of bits, and word-select period – are identical. If the application must have different configurations for the Rx and Tx, then use two unidirectional component instances. Data Stream Format The data for Tx and Rx is independent byte streams. The byte streams are packed with the most significant byte first and the most significant bit in bit 7 of the first word. The number of bytes used for each sample (for the left or right channel) is the minimum number of bytes to hold a sample. Any unused bits are ignored on Tx and are 0 on Rx. The data stream for one direction can be a single byte stream, or it can be two byte streams. In the case of a single byte stream, the left and right channels are interleaved with a sample for the left channel first followed by the right channel. In the two-stream case, the left and right channel byte streams use separate FIFOs. DMA The I2S interface is a continuous interface that requires an uninterrupted stream of data. For most applications, this requires the use of DMA transfers to prevent the underflow of the Tx direction or the overflow of the Rx direction. The I2S can drive up to two DMA components for each direction. Use the DMA Wizard to configure DMA operation as follows: Name of DMA Source/ Destination in the DMA Wizard Direction DMA Request DMA Request Signal Type Description I2S_RX_FIFO_0_PTR Source rx_dma0 Level Receive FIFO for Left or Interleaved channel I2S_RX_FIFO_1_PTR Source rx_dma1 Level Receive FIFO for Right channel I2S_TX_FIFO_0_PTR Destination tx_dma0 Level Transmit FIFO for Left or Interleaved channel I2S_TX_FIFO_1_PTR Destination tx_dma1 Level Transmit FIFO for Right channel In all cases, a high signal on the DMA request signal indicates that an additional single byte may be transferred. Enabling The Rx and Tx directions have separate enables. When not enabled, the Tx direction transmits all 0 values, and the Rx direction ignores all received data. The transition into and out of the enabled state occurs at a word select boundary such that a left/right sample pair is always transmitted or received. Page 14 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) Error Handling Two error conditions for the component can occur if the transmit FIFO is empty and a subsequent read occurs (transmit underflow), or if the receive FIFO is full and a subsequent write occurs (receive overflow). While transmission is enabled, if the transmit FIFO becomes empty and data is not available for transmission (Transmit underflow), the component forces the constant transmission of 0s. Before transmission begins again, transmission must be disabled, the FIFOs should be cleared, data for transmit must be buffered, and then transmission re-enabled. The CPU can monitor this underflow condition using the transmit status bit I2S_TX_FIFO_UNDERFLOW. An interrupt can also be configured for this error condition. While reception is enabled, if the receive FIFO becomes full and additional data is received (Receive overflow), the component stops capturing data. Before reception begins again, reception must be disabled, the FIFOs should be cleared, and then reception re-enabled. The CPU can monitor this overflow condition using the receive status bit I2S_RX_FIFO_OVERFLOW. An interrupt can also be configured for this error condition. Block Diagram and Configuration The I2S is implemented as a set of configured UDBs. The implementation is shown in the following block diagram. Figure 3. I2S Implementation F0_status tx state machine dpTx control signals F1_status CPU (DMA) LEFT RIGHT F0 F1 LSB MSB SDO SHIFT REGISTER (ALU) clock datapathTx counter7 SCK ws and sck generation logic count clk LSB SDI WS MSB datapathRx SHIFT REGISTER (ALU) rx state machine dpRx control signals RIGHT LEFT F0 F0_status Document Number: 001-88609 Rev. ** F1 CPU (DMA) F1_status Page 15 of 24 ® Inter-IC Sound Bus (I2S) PSoC Creator™ Component Datasheet Registers I2S_CONTROL_REG Bits 7 6 5 Value 4 3 reserved 2 1 0 enable rxenable txenable 2 1 0 F1_not_full F0_not_full underflow enable: Enable/Disable I2S component rxenable, txenable: Enable/Disable Rx and Tx directions, respectively I2S_TX_STATUS_REG Bits 7 6 Value 5 4 3 reserved F1_not_full: If set, Tx FIFO 1 is not full F0_not_full: If set, Tx FIFO 0 is not full underflow: If set, Tx FIFOs underflow event has occurred The register value can be read with the I2S_ReadTxStatus() API function. I2S_RX_STATUS_REG Bits Value 7 6 5 4 reserved 3 2 1 F1_not_empty F0_not_empty 0 overflow F1_not_empty: If set, Rx FIFO 1 is not empty F0_not_empty: If set, Rx FIFO 0 is not empty overflow: If set, Rx FIFOs overflow event has occurred The register value can be read with the I2S_ReadRxStatus() API function. Note: Bit 0 (underflow) of the Tx status register and bit 0 (overflow) of the Rx status register are configured as clear on read bits. In this mode, the input status is sampled after each cycle of the status register clock. When the input goes high, the register bit is set and stays set regardless of the subsequent state of the input. The register bit is cleared on a subsequent read by the CPU. Page 16 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) Resources The I2S component is placed throughout the UDB array. The component utilizes the following resources. Resource Type Configuration Datapath Cells Macrocells Status Cells Control Cells DMA Channels Interrupts Rx Only 1 7 1 2 – – Tx Only 1 8 1 2 – – Rx and Tx 2 13 2 4 – – API Memory Usage The component memory usage varies significantly depending on the compiler, device, number of APIs used and component configuration. The following table provides the memory usage for all APIs available in the given component configuration. The measurements have been done with an associated compiler configured in Release mode with optimization set for Size. For a specific design, the map file generated by the compiler can be analyzed to determine the memory usage. PSoC 3 (Keil_PK51) Configuration PSoC 4 (GCC) PSoC 5LP (GCC) Flash SRAM Flash SRAM Flash SRAM Bytes Bytes Bytes Bytes Bytes Bytes Rx Only 220 3 384 5 392 5 Tx Only 220 3 384 5 392 5 Rx and Tx 326 3 570 5 592 5 Document Number: 001-88609 Rev. ** Page 17 of 24 ® Inter-IC Sound Bus (I2S) PSoC Creator™ Component Datasheet DC and AC Electrical Characteristics Specifications are valid for –40 °C ≤ TA ≤ 85 °C and TJ ≤ 100 °C, except where noted. Specifications are valid for 1.71 V to 5.5 V, except where noted. DC Characteristics Parameter IDD(RX) Description [3] [4] Operating current [1] [2] Max Units – 15 – µA/MHz – 21 – µA/MHz – 15 – µA/MHz – 20 – µA/MHz – 16 – µA/MHz – 26 – µA/MHz Component current consumption (Tx Only) Idle current [3] Operating current IDD(RX_TX) Typ Component current consumption (Rx Only) Idle current IDD(TX) Min [4] Component current consumption (Rx and Tx) Idle current [3] Operating current [4] AC Characteristics Parameter Description Min Typ Max Unit fSCK Serial clock (output) frequency – – 6.144 MHz [5] fCLOCK Component clock frequency – 2 × fSCK – MHz tSCKH SCK high-level time – 0.5 – 1/fSCLK tSCKL SCK low-level time – 0.5 – 1/fSCLK tSCK_WS Delay time, SCK falling edge to WS valid –20 – 20 ns 1. Device IO and clock distribution current are not included. The values are at 25 °C. 2. Current consumption is specified with respect to the incoming component clock. 3. Current consumed by component while it is enabled but not transmitting/receiving data. 4. Current consumed by component while it is enabled and transmitting/receiving data. 5. The maximum component clock frequency is derived from tCLK_SCK in combination with the routing path delays of the SCK output and the SDI input (described later in this document). Typical values provide a maximum safe operating frequency of the component. The component can run at higher clock frequencies, at which point validation of the timing requirements with STA results is necessary Page 18 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Parameter tSCK_SDO [6] tS_SDI Inter-IC Sound Bus (I2S) Description Min Typ Max Unit Delay time, SCK falling edge to SDO valid –20 – 20 ns SDI setup time 25 – – ns Component Clock Rates for Common Audio Sampling Frequencies Component Clock Frequency (fCLOCK) MHz Sampling Frequency tWS = 16 bits tWS = 32 bits tWS = 48 bits tWS = 64 bits 8 kHz 0.2560 0.5120 0.7680 1.0240 16 kHz 0.5120 1.0240 1.5360 2.0480 32 kHz 1.0240 2.0480 3.0720 4.0960 44.1 kHz 1.4112 2.8224 4.2336 5.6448 48 kHz 1.5360 3.0720 4.6080 6.1440 88.2 kHz 2.8224 5.6448 8.4672 11.2896 96 kHz 3.0720 6.1440 9.2160 12.2880 192 kHz 6.1440 12.2880 N/A N/A Figure 4. Data Transition Timing Diagram clock sck tSCKL tSCK_WS tSCKH ws tSCK_SDO sdo LSB MSB LSB MSB tS_SDI sdi LSB Word N-1 Right Channel MSB LSB Word N Left Channel MSB Word N Right Channel 6. The VDDIO supply voltage from 3.0 V to 5.5 V. The value can vary for PSoC 5, so must be validated with STA results. Document Number: 001-88609 Rev. ** Page 19 of 24 ® Inter-IC Sound Bus (I2S) PSoC Creator™ Component Datasheet Note All of the component internal logic operates entirely from the input 2X clock. This causes the need to reference some timing constraints, such as tS_SDI and tCLK_SCK, with respect to this internal clock (described later in this document). How to Use STA results for Characteristics Data fSCK The maximum frequency of SCK (or the maximum bit rate) is not provided directly in the STA. However, the data provided in the STA results indicates some of the internal logic timing constraints. To calculate the maximum bit rate, several factors must be considered. Board layout and slave communication device specs are needed to fully understand the maximum. A limiting factor in this parameter is the round trip path delay from the falling edge of SCK at the pin of the master to the slave, and the path delay of the SDO output of the slave back to the SDI input of the master. In this case, the component must meet the setup time of SDI at the master with the following equation: Figure 5. Calculating Maximum fSCK Frequency tS_SDI(master) SDI Sample at Master CLK @ Master Internal tCLK_SCK(master) @ Master Pin SCK SCKPD_PCB @ Slave Pin SCK tSCK_SDO(slave) @ Slave Pin SDO N N-1 SDOPD_PCB @ Master Pin SDI N N-1 In this case, the fSCK frequency is calculated using the equation below: fSCK < 1 ÷ [2 × [tRT_PD + tCLK_SCK(master) + tS_SDI(master)]] Where tRT_PD = [SCKPD_PCB + tSCK_SDO(slave) + SDOPD_PCB] and, SCKPD_PCB is the PCB path delay of SCK from the pin of the master component to the pin of the slave device. Page 20 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) tSCK_SDO(slave) comes from the Slave Device datasheet tCLK_SCK(master) is the internal CLK to SCK pin path delay of the master component. This is provided in the STA results clock to output section, as shown: tS_SDI(master) is the SDI pin to the internal logic path delay of the master component. This is provided in the STA results input to clock section, as shown: The final equation that provides the maximum frequency of SCK follows; the maximum bit rate is: fSCK (Max.) = 1 ÷ [2 × [tCLK_SCK(master) + SCKPD_PCB + tSCK_SDO(slave) + SDOPD_PCB + tS_SDI(master)]] fCLOCK Maximum component clock frequency is provided in Timing results in the clock summary as the named external clock (CLK in this case). An example of the internal clock limitations from the STA report follows: tSCKH The I2S component generates a 50-percent duty cycle SCK tSCKL The I2S component generates a 50-percent duty cycle SCK tSCK_WS The delay between SCK falling edge and WS valid. This value can be calculated as the difference between clock to output times for WS and SCK pins. The data is extracted from the STA report, as shown below: Document Number: 001-88609 Rev. ** Page 21 of 24 Inter-IC Sound Bus (I2S) ® PSoC Creator™ Component Datasheet tSCK_SDO The delay between SCK falling edge and WS valid. This value can be calculated as the difference between clock to output times for SDO and SCK pins. The values are provided in the STA results clock to output times, as shown below: tS_SDI SDI setup time is the SDI pin to internal logic path delay of the master component. This is provided in the STA results Input to Clock Section, as shown below: Page 22 of 24 Document Number: 001-88609 Rev. ** ® PSoC Creator™ Component Datasheet Inter-IC Sound Bus (I2S) Component Changes This section lists the major changes in the component from the previous version. Version Description of Changes Reason for Changes / Impact 2.50 Removed PSoC 5 support PSoC 5 is no longer supported starting from PSoC Creator 3.0 release. 2.40.a Updated datasheet with memory usage for PSoC 4. 2.40 Added MISRA Compliance section. The component does not have any specific deviations. 2.30 Added all component APIs with the CYREENTRANT keyword when they are included in the .cyre file. Not all APIs are truly reentrant. Comments in the component API source files indicate which functions are candidates. This change is required to eliminate compiler warnings for functions that are not reentrant used in a safe way: protected from concurrent calls by flags or Critical Sections. Added PSoC 5LP support Added DC characteristics section to datasheet 2.20 Added internal FIFO error detection by the component. Improved error handling by the component in case of an overflow/underflow error occurs. 2.10 Resampled FIFO block status signals to DP clock. Allows component to function with the same timing results for all PSoC 3 and PSoC 5 silicons. Added characterization data to datasheet Minor datasheet edits and updates 2.0 Hardware implementation of this component Improves the control of the timing relationship between was changed to require a 2X frequency signal the SCK, WS, SDO and SDI signals. on the clock input. The SCK output signal will be generated by dividing the incoming clock by 2. I2S_Start() function updated to match changes in the implementation. The functionality is unchanged. Simplified implementation required changes to the initialization. The sleep mode APIs were added. To support low-power modes. The status bits tx_not_full and rx_not_emty were changed from clear-on-read to transparent mode. The status bits for any Full or Empty status from a FIFO need to be transparent to represent just the current live status of the FIFO. Added DMA Capabilities file to the component. This file allows I2S to be supported by the DMA Wizard tool in PSoC Creator. Document Number: 001-88609 Rev. ** Page 23 of 24 Inter-IC Sound Bus (I2S) Version Description of Changes ® PSoC Creator™ Component Datasheet Reason for Changes / Impact I2S_Stop() API was changed to clear rx and tx FIFOs after component is disabled. Resets the Tx and Rx FIFOs status to the initial values. Prevents unexpected operations after component is reenabled. Added Keil function reentrancy support. Add the capability for customers to specify individual generated functions as reentrant. © Cypress Semiconductor Corporation, 2013. The information contained herein is subject to change without notice. Cypress Semiconductor Corporation assumes no responsibility for the use of any circuitry other than circuitry embodied in a Cypress product. Nor does it convey or imply any license under patent or other rights. Cypress products are not warranted nor intended to be used for medical, life support, life saving, critical control or safety applications, unless pursuant to an express written agreement with Cypress. Furthermore, Cypress does not authorize its products for use as critical components in life-support systems where a malfunction or failure may reasonably be expected to result in significant injury to the user. The inclusion of Cypress products in lifesupport systems application implies that the manufacturer assumes all risk of such use and in doing so indemnifies Cypress against all charges. PSoC® is a registered trademark, and PSoC Creator™ and Programmable System-on-Chip™ are trademarks and of Cypress Semiconductor Corp. All other trademarks or registered trademarks referenced herein are property of the respective corporations. Any Source Code (software and/or firmware) is owned by Cypress Semiconductor Corporation (Cypress) and is protected by and subject to worldwide patent protection (United States and foreign), United States copyright laws and international treaty provisions. Cypress hereby grants to licensee a personal, non-exclusive, non-transferable license to copy, use, modify, create derivative works of, and compile the Cypress Source Code and derivative works for the sole purpose of creating custom software and or firmware in support of licensee product to be used only in conjunction with a Cypress integrated circuit as specified in the applicable agreement. Any reproduction, modification, translation, compilation, or representation of this Source Code except as specified above is prohibited without the express written permission of Cypress. Disclaimer: CYPRESS MAKES NO WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, WITH REGARD TO THIS MATERIAL, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. Cypress reserves the right to make changes without further notice to the materials described herein. Cypress does not assume any liability arising out of the application or use of any product or circuit described herein. Cypress does not authorize its products for use as critical components in lifesupport systems where a malfunction or failure may reasonably be expected to result in significant injury to the user. The inclusion of Cypress’ product in a life-support systems application implies that the manufacturer assumes all risk of such use and in doing so indemnifies Cypress against all charges. Use may be limited by and subject to the applicable Cypress software license agreement. Page 24 of 24 Document Number: 001-88609 Rev. **