4.7. CDD_FSITX Module
4.7.1. Acronyms and Definitions
Abbreviation/Term |
Explanation |
---|---|
AUTOSAR |
Automotive Open System Architecture |
BSW |
Basic Software |
CDD |
Complex Device Driver |
FSI |
Fast Serial Interface |
DDR |
Double Data Rate |
SDR |
Single Data Rate |
SDR |
Single Data Rate |
CRC |
Cyclic Redundancy Check |
SW |
Software |
HW |
Hardware |
DEM |
Diagnostic Event Manager |
DMA |
Direct Memory Access |
MCAL |
Microcontroller Abstraction Layer |
DET |
Default Error Tracer |
PWM |
Pulse Width Modulation |
PLL |
Phase Locked Loop |
MCU |
Micro Controller Unit |
OS |
Operating System |
API |
Application Programming Interface |
4.7.2. Introduction
This document describes CDD FSI Driver functionality, its application interfaces and configuration details as per AUTOSAR version 4.3.1.
Supported AUTOSAR Release |
4.3.1 |
Supported Configuration Variants |
Pre-Compile & Post Build |
Vendor ID |
CDD_FSI_TX_VENDOR_ID (44) |
Module ID |
CDD_FSI_TX_MODULE_ID (255) |
Supported Platform |
AM263Px |
4.7.3. Functional Overview
The Fast Serial Interface (FSI) module is a serial communication peripheral capable of reliable high-speed communication across isolation devices. The FSI is designed specifically to ensure reliable high-speed communication for system scenarios that involve communication across isolation barriers without adding components. The FSI consists of independent transmitter (CDD FSI TX) and receiver (CDD FSI RX) cores. The CDD FSITX and CDD FSIRX cores are configured and operated independently. Both CDD FSI TX and FsiRx are capable of configurable frame length and can be operated via DMA. The following figure shows where the CDD Module is located in the AUTOSAR architecture. Since CDD FSI Transmitter and Receiver are CDD Module it occupies the highlighted region in the AUTOSAR architecture.

Fig. 4.33 CDD FSI (CDD Module) in AUTOSAR architecture
4.7.3.1. Functional Overview of CDD FSI Transmitter
The CDD FSI transmitter module handles the framing of data and signal generation of TXCLK, TXD0, and TXD1, as well as interrupt generation. The operation of the transmitter core is controlled and configured through programmable control registers. The transmitter control registers allow the CPU to program, control, and monitor the operation of CDD the FSI receiver. The transmit data buffer is accessible by the CPU and the DMA.
4.7.3.2. CDD FSI TX Driver Architecture

Fig. 4.34 CDD FSI TX Hardware Overview
4.7.3.3. Initialization
Cdd_FsiTx_Init() has to be called to initialize the CDD FSI TX driver before initiating a transmission. This will also set the CDD FSI Transmitter Hardware Unit to CDD_FSI_TX_IDLE STATE.
4.7.3.4. States
There are 2 states in which each CDD FSI Transmitter HW Unit can be:
CDD_FSI_TX_UNINIT: This is the state before the Fsi Transmitter is initialized.
CDD_FSI_TX_IDLE: This is the state before starting a transmission. The transmitter becomes idle only after it gets initialized.
4.7.3.5. Assumptions
None
4.7.3.6. Limitations
TXCLK which is derived from PLL Clock should never be configured to be faster than SYSCLK/2.
Data Frame Configuration of Transmitter Module should be in sync with the receiver. (frame type, data width ).
In FSI, as soon as the DMA TX trigger is started, whatever data is available in the internal FSI buffer is transferred immediately before the DMA actually transfers from external buffer to FSI internal buffer. As a workaround, first iteration we are manually copying onto internal buffer before FSI DMA event is enabled
In FSI, the DMA transfer happens only with the manual trigger mode of DMA. The event trigger mode is not supported
4.7.3.7. Design overview of Fsi Transmitter (Link to the Architecture document and Design Document)
Will be available in future release.
4.7.4. Hardware Features
CDD FSI Tx features:
4.7.4.1. IP Supported Features
Automated ping frame generation
Externally triggered ping frames
Externally triggered data frames
Software-configurable frame lengths
Data buffer underrun and overrun detection
DMA support
Double Data Rate(DDR)
4.7.4.2. CDD FSI TX Supported Features
Automated ping frame generation
Software-configurable frame lengths
Data buffer underrun and overrun detection
DMA support
One shot and continuous mode.
4.7.4.3. CDD FSI TX Not Supported Features
Externally triggered ping frames
Externally triggered data frames
Double Data Rate(DDR)
4.7.4.4. Configurable Hardware Units
User configurable parameter to define how many Tx Hardware Units (Instances) to use out of a maximum of 4
User configurable parameter to specify which Hardware Unit to use
User configurable parameter to specify Prescale value to select clock frequency at which the Hardware Unit will operate internally.
User configurable frame size which defines number of words to be copied into Tx internal Buffer and transmitted.
4.7.4.5. Configurable Development Error
User configurable error check to report development errors.
4.7.4.6. Configurable Frame Length
The number of words to be sent in each frame is user configurable. The argument TxDataLength passed into the API Cdd_FsiTx_BufferLoad will copy the required number of words from source buffer to internal Tx Buffer. The TxDataLength can be any value from the enum Cdd_FsiTx_DataLengthType which has a range of 1-16.
CDD_FSI_TX_DATA_1_WORD_LENGTH - 1 WORD will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_2_WORD_LENGTH - 2 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_3_WORD_LENGTH - 3 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_4_WORD_LENGTH - 4 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_5_WORD_LENGTH - 5 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_6_WORD_LENGTH - 6 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_7_WORD_LENGTH - 7 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_8_WORD_LENGTH - 8 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_9_WORD_LENGTH - 9 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_10_WORD_LENGTH - 10 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_11_WORD_LENGTH -11 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_12_WORD_LENGTH - 12 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_13_WORD_LENGTH - 13 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_14_WORD_LENGTH - 14 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_15_WORD_LENGTH - 15 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
CDD_FSI_TX_DATA_16_WORD_LENGTH - 16 WORDS will be copied from source buffer to Internal Tx buffer for Transmission.
4.7.4.7. Configurable User Data
The User Data is an 8 bit value which is fully user-configurable data field. There are no restrictions on how this field is used. This phase is only available in data frames.
The userData argument in Cdd_FsiTx_BufferLoad API will configure the field in frame in DMA transmission Mode.
The userData argument in Cdd_FsiTx_Transmit API will configure the field in frame in Interrupt/Polling transmission Mode.
4.7.4.8. Configurable Timeouts
User Configurable Ping Timeout value(value at which the Ping Timer timeout and it will trigger a Ping Frame transmission to check the physical connection between Tx and Rx ).
4.7.4.9. Configurable Transmission Modes
The FSI Transmitter can transmit data in three different Modes.
Interrupt Mode.
Polling Mode.
DMA Mode.
4.7.4.9.1. Interrupt Mode
Each FSI module contains multiple interrupt sources which can be assigned to two different interrupt vectors:INT1 and INT2. Each interrupt source has an associated status flag. In Interrupt Mode, the macro CddFsiTxMainApi in Cdd_FsiTx_Cfg.h will be OFF. The transmitter can generate the following interrupts:
Frame Done (FRAME_DONE) : This event indicates that FSI has completed transmitting a frame. To enable this Interrupt Event, the macro CddFsiTxFrameDoneInterrupt in Cdd_FsiTx_Cfg.h should be ON.
Buffer Underrun (BUF_UNDERRUN) : This event indicates that the transmit buffer has experienced underrun. Buffer underrun occurs when the transmitter tries to read data from a location which has not yet be written to by the CPU, or DMA. The macro CddFsiTxBufferUnderRunInterrupt* in Cdd_FsiTx_Cfg.h should be ON and CddFsiTxDMAEnable should be OFF.
Buffer Overrun (BUF_OVERRUN) : The buffer overrun interrupt is generated when the buffer has experienced overrun. Buffer overrun may occur if a piece of data is overwritten before it has been transmitted. The macro CddFsiTxBufferOverRunInterrupt in Cdd_FsiTx_Cfg.h should be ON and CddFsiTxDMAEnable should be OFF.
Ping Frame Triggered (PING_TRIGGERED) : The ping frame triggered interrupt is generated when the ping frame has been triggered. This bit will be set when the ping counter has timed out.The macro CddFsiTxFrameDoneInterrupt in Cdd_FsiTx_Cfg.h should be ON.
4.7.4.9.2. Polling Mode
In Polling Mode the once the FSI Transmitter transmits the frame, the transmission status is continuously polled using CddFsiTxMainApi API. In Polling Mode the states of different macros inside Cdd_FsiTx_Cfg.h are listed below:
CDD_FSI_TX_MAIN_FUNCTION_API -STD ON.
CDD_FSI_TX_DMA_ENABLE -STD OFF
CDD_FSI_TX_BUFFER_OVERRUN_INTERRUPT -STD OFF.
CDD_FSI_TX_BUFFER_UNDERRUN_INTERRUPT-STD OFF
CDD_FSI_TX_PING_TIMEOUT_INTERRUPT -STD OFF.
CDD_FSI_TX_FRAME_DONE_INTERRUPT -STD OFF
The macro related with each Interrupt event should be OFF if Main Function API macro is ON.
4.7.4.9.3. DMA Mode
The FSI transmitter can send data which is continuously fed with the DMA. In order to transmit continuous data with the DMA, some configurations need to be made on the transmitter:
Two DMA channels have to be triggered by the same FSI transmitter and DMA trigger.
One Channel to fill the data in transmit buffer and the other will be used to copy the userdata and frametag.
In DMA Mode the states of different macros inside Cdd_FsiTx_Cfg.h are listed below:
CDD_FSI_TX_MAIN_FUNCTION_API -STD OFF
CDD_FSI_TX_DMA_ENABLE -STD ON
CDD_FSI_TX_BUFFER_OVERRUN_INTERRUPT -STD OFF
CDD_FSI_TX_BUFFER_UNDERRUN_INTERRUPT -STD OFF
CDD_FSI_TX_PING_TIMEOUT_INTERRUPT -STD OFF
CDD_FSI_TX_FRAME_DONE_INTERRUPT -STD OFF
For the FSI Transmitter to be functional in DMA mode, some configurations to be done in DMA Plugin as well. The DMA Instance corresponding to each Tx unit should be configured in chaining Mode. For each handle, two dma channels have to be configured. In Fsi, DMA Mode transfer is possible in only the Manual Trigger Mode of DMA.
4.7.5. Source files
Description of static files is provided below:
📦AM263Px
┣ 📂build
┣ 📂mcal
┃ ┣ 📂FsiTx
┃ ┃ ┣ 📂include
┃ ┃ ┃ ┗ 📜Cdd_FsiTx.h : Contains the API’s of the CDD FSI TX driver to be used by upper layers
┃ ┃ ┣ 📂src
┃ ┃ ┃ ┗ 📜Cdd_FsiTx.c : Contains the implementation of the API’s for CDD FSI TX driver
┃ ┃ ┣ 📂V0
┃ ┃ ┃ ┣ 📜Cdd_FsiTx_Irq.h : Contains ISR function declaration
┃ ┃ ┃ ┣ 📜Cdd_FsiTx_Irq.c : Contains ISR function definitions
┃ ┃ ┃ ┣ 📜Cdd_FsiTx_Platform.h : Contains device specific function definition, data types and definitions
┃ ┃ ┃ ┣ 📜Cdd_FsiTx_Platform.c : Contains device specific function definition, data types and definitions
┃ ┃ ┃ ┣ 📜Cdd_FsiTx_Priv.h : Contains Internal functions declaration of CDD FSI TX driver
┃ ┃ ┃ ┣ 📜Cdd_FsiTx_Priv.c : Contains Internal functions definition of CDD FSI TX driver
┃ ┃ ┃ ┣ 📜Cdd_FsiTx_Reg.h : Contains CDD FSI TX Register definition
┃ ┃ ┃ ┗ 📜Cdd_FsiTx_Types.h : Contains the cdd data types and internal macro definitions .
┃ ┃ ┗ 📜Makefile
┣ 📂mcal_config
┣ 📂mcal_docs
┗ 📜README.txt
Description of generated files is provided below:
Plugin Files |
Description |
---|---|
CddFsiTx_Cfg.h |
CContains the Precompile switches, Symbolic names of hardware units and channels Configured maximum number hardware units |
CddFsiTx_PBcfg.c |
Contains all channels Post-Build Configuration parameters |
CddFsiTx_Cfg.c |
Contains all channels Pre-Compile Configuration parameters |
The below diagram shows the files structure for the FSI driver.

Fig. 4.35 CDD FSI TX header file include structure
4.7.6. Module requirements
Will be updated in future release:
4.7.6.1. Memory Mapping
Memory Mapping Sections |
CDD_FSITX_CODE |
CDD_FSITX_CODE_ISR |
CDD_FSITX_VAR_NO_INIT |
CDD_FSITX_VAR |
CDD_FSITX_CONST |
CDD_FSITX_PBCFG |
---|---|---|---|---|---|---|
CDD_FSITX_START_SEC_VAR_INIT_UNSPECIFIED(.bss) |
x |
|||||
CDD_FSITX_STOP_SEC_VAR_INIT_UNSPECIFIED |
x |
|||||
CDD_FSITX_START_SEC_CONFIG_DATA (.const) |
x |
|||||
CDD_FSITX_STOP_SEC_CONFIG_DATA |
x |
|||||
CDD_FSITX_START_SEC_CODE(.text) |
x |
|||||
CDD_FSITX_STOP_SEC_CODE |
x |
|||||
CDD_FSITX_START_SEC_VAR_INIT_32(.bss) |
x |
|||||
CDD_FSITX_STOP_SEC_VAR_INIT_32 |
x |
|||||
CDD_FSITX_START_SEC_VAR_NO_INIT_UNSPECIFIED(.data) |
x |
|||||
CDD_FSITX_STOP_SEC_VAR_NO_INIT_UNSPECIFIED |
x |
|||||
CDD_FSITX_START_SEC_ISR_CODE |
x |
|||||
CDD_FSITX_STOP_SEC_ISR_CODE |
x |
4.7.6.2. Scheduling
Schedule Function API |
Description |
---|---|
Cdd_FsiTx_MainFunction |
The MainFunction notify the application in Polling Mode |
4.7.6.3. Error handling
4.7.6.3.1. Development Error Reporting
The module CDD FSI TX depends on the DET (by default) in order to report development errors. The DET error is reported with Module ID. The reported service IDs identify the services which are described below. The errors reported to DET module are described in the following table:
4.7.6.4. Error codes
4.7.6.4.1. Development Errors
Type of Error |
Related Error code |
Value (Hex) |
---|---|---|
Error code indicating the CDD FSI TX is uninitialized |
CDD_FSI_TX_E_UNINIT |
0x01 |
Error code indicating an invalid event |
CDD_FSI_TX_E_INVALID_EVENT |
0x02 |
Error code indicating invalid parameter pointer |
CDD_FSI_TX_E_PARAM_POINTER |
0x03 |
Error code indicating Service called with invalid length |
CDD_FSI_TX_E_PARAM_LENGTH |
0x04 |
Error code indicating invalid Number of CDD FSI TX HwUnit |
CDD_FSI_TX_E_INVALID_HWUNIT |
0x05 |
4.7.6.4.2. DEM Errors
The errors reported to DEM are described in the following table:
Error Code |
Description |
|
---|---|---|
Assigned by DEM |
CDD_FSI_TX_E_BUFFER_UNDERRUN |
This error is raised when the Transmit Buffer undergoes to an underrun |
Assigned by DEM |
CDD_FSI_TX_E_BUFFER_OVERRUN |
This error is raised when the Transmit Buffer undergoes to an overrun |
4.7.7. Used resources
4.7.7.1. Interrupt Handling
For interrupt notification, ISR’s are provided in CDD FSI TX driver.There are two ISRs for each CDD FSI TX hardware unit. Depending on hardware unit configured, it will call the notify function. The interrupt service routines shall be mapped to the interrupt sources of the respective cross bar interrupt. The supported ISRs are part of the CddFsiTx_Irq.h file. Following are the ISRs for each CDD FSI TX hardware units:
Hardware Unit |
ISR |
---|---|
CDD_FSI_TX_HW_UNIT_0 |
CddFsiTx_FSIINT1_IrqUnit0() |
CDD_FSI_TX_HW_UNIT_1 |
CddFsiTx_FSIINT1_IrqUnit1() |
CDD_FSI_TX_HW_UNIT_2 |
CddFsiTx_FSIINT1_IrqUnit2() |
CDD_FSI_TX_HW_UNIT_3 |
CddFsiTx_FSIINT1_IrqUnit3() |
DMA Mode ISR |
CDD_EDMA_lld_transferCompletionMasterIsrFxn() |
1.CddFsiTxBufferOverRunInterrupt parameter enables/disables the bufferOverrun interrupt event.
This event indicates that the transmit buffer has experienced overrun.
Buffer underrun occurs when the transmitter tries to read data from a location which has not yet be written to by the CPU, or DMA.
2.CddFsiTxBufferUnderRunInterrupt parameter enables/disables the bufferUnderRun interrupt event .
This event indicates that the transmit buffer has experienced underrun.
Buffer overrun may occur if a piece of data is overwritten before it has been transmitted.
3.CddFsiTxFrameDoneInterrupt parameter enables/disables the Frame Done interrupt event .
This event indicates that FSI has completed transmitting a frame.
4.CddFsiTxPingTimeOutInterrupt parameter enables/disables the Ping Timeout interrupt event .
The ping frame triggered interrupt is generated when the ping frame has been triggered.
This bit will be set when the ping counter has timed out.
4.7.8. Integration description
4.7.8.1. The CDD FSI TX Driver dependent modules
4.7.8.1.1. MCU
The CDD FSI TX modules expects the MCU module to be powered on. The CDD_FSI_TX module depends on MCU module for PLL Clock initialization and crossbar interrupt mapping of CDD FSI TX interrupts depending on the Hardware unit being configured. Suppose the Hardware Unit 1 is configured for CDD FSI TX module:

Fig. 4.36 CDD FSI TX Hardware container
Since CDD FSI TXCLK is driven by PLL, it is configured using CONTROLSS register and the the MCU module container McuClockSettingConfiguration should be configured as shown in below figure:

Fig. 4.37 Mcu_Clock_Configuration container
Similarly, the crossbar interrupts also needs to be mapped in MCU module according to HW unit and interrupts being required.
The CDD FSI TX interrupts needs to be mapped to the corresponding cross bar interrupt required. For each CDD FSI TX instance there will be two interrupt vectors. INT1 and INT2. For each interrupt vector separate Crossbar pins should be selected in mcu configuration.

Fig. 4.38 CDD FSI TX Interrupt configuration
4.7.8.1.2. DMA
The CDD FSI TX Modules requires DMA module to be configured, when CDD FSI TX transmission is configured in DMA mode.
1.CDD FSI TX Module Configuration:
The CDD FSI TX module parameter CddFsiTxDMAEnable should be configured for TRUE.
The CDD FSI TX HW Unit parameter CddFsiTxTransmissionMethod should be configured with CDD_FSI_TX_DMA_MODE.
The DMA supports CDD FSI TX in interrupt mode only.
The transmission mode in configurator should be CDD_FSI_TX_DMA_MODE and interrupt should be enabled inside the code.
2.DMA module Configuration:
Set up two DMA channels to be triggered by the same CDD FSI transmitter and DMA trigger.
Configure one channel to fill the transmit buffer.
Configure the other channel to set the frame tag and user data fields.
Configure the DMA handleId and other parameters for each CDD FSI TX instance inside DMA configurator.
The DMA Configuration reference has given inside CDD FSI TX configurator to select the handleId for each TX Instance.

Fig. 4.39 CDD FSI TX module DMA channel ID selection
4.7.8.1.3. DET
This implementation depends on the DET in order to report development errors. The detection of development errors is configurable (ON / OFF).
4.7.8.1.4. DEM
By default, production code related errors are reported to the DEM using the service DEM_ReportErrorStatus().
Note
Dem Event is enable only if $(Module_Name)DemEventParameterRefs
is enabled.
4.7.8.1.5. SchM
If multiple AUTOSAR runnables have access to the same Data Store Memory block, the exported AUTOSAR specification enforces data consistency by using an AUTOSAR exclusive area. With this specification, the runnables have mutually exclusive access to the per-instance memory global data, which prevents data corruption. Beside the OS, the BSW Scheduler provides functions that CDD FSI TX module calls at begin and end of critical sections. This implementation requires 1 level of exclusive access to guard critical sections.
The data consistency mechanism that has to be applied to an ExclusiveArea might be domain, ECU or even project specific. The decision which mechanism has to be applied by RTE / Basic Software Scheduler is taken during ECU integration by setting the Exclusive Area configuration parameter RteExclusiveAreaImplMechanism. This parameter is an input for RTE generator.
For CDD_FSI_TX Module, data consistency and exclusive access to critical sections are required for the following sections as shown in the table below:
Exclusive Area Functions used |
CDD_FSI_TX Function calling Exclusive Area |
Need for Exclusive Area |
Recommended Exclusive Area Mapping |
---|---|---|---|
FSI_TX_EXCLUSIVE_AREA_0 |
Cdd_FsiTx_Transmit |
To protect against multiple access for shared resources |
ALL_INTERRUPT_BLOCKING : All interrupts should be blocked as this API’s can be called in the interrupts |
4.7.8.1.6. Callback Functions
The CDD FSI TX driver does not provide any call back functions.
4.7.8.1.7. Callback Notification
Notifications: Cdd_FsiTx_BufferNotifyType: This Cdd_FsiTx_BufferNotifyType which is defined in CddFsiTx_Types.h file. This is called to notify the HwUnit about the completion of the transmission and availability of Tx Buffer to transmit another frame.
4.7.8.2. Multi-core support
Not Supported
4.7.9. Configuration
4.7.9.1. CddFsiTxConfigSet
This container contains the configuration parameters and sub containers of the AUTOSAR Cdd Fsi Tx module.
4.7.9.1.1. CddFsiTxNotification
Item |
|
---|---|
Name |
CddFsiTxNotification |
Description |
Callback function for Transmission |
Multiplicity-Configuration-Class |
– |
Post-Build Time |
VARIANT-POST-BUILD |
Pre-Compile Time |
VARIANT-PRE-COMPILE |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
true |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
NULL_PTR |
4.7.9.1.2. CddFsiTxOverRunNotification
Item |
|
---|---|
Name |
CddFsiTxOverRunNotification |
Description |
Callback function for Tx Buffer OverRun |
Multiplicity-Configuration-Class |
– |
Post-Build Time |
VARIANT-POST-BUILD |
Pre-Compile Time |
VARIANT-PRE-COMPILE |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
true |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
NULL_PTR |
4.7.9.1.3. CddFsiTxUnderRunNotification
Item |
|
---|---|
Name |
CddFsiTxUnderRunNotification |
Description |
Callback function for Tx Buffer UnderRun |
Multiplicity-Configuration-Class |
– |
Post-Build Time |
VARIANT-POST-BUILD |
Pre-Compile Time |
VARIANT-PRE-COMPILE |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
true |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
NULL_PTR |
4.7.9.1.4. CddFsiTxHwUnit
This container contains the Driver configuration (parameters) depending on which FSI Hw unit is get configured
4.7.9.1.4.1. CddFsiTxHwUnitId
Item |
|
---|---|
Name |
CddFsiTxHwUnitId |
Description |
Description: Numeric ID of the HW Unit. This symbolic name allows accessing Fsi Hw Unit data. Enumeration literals are defined vendor specific. Number of instances can vary depending on SOC variant.Corresponding error checks are added in template files |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
true |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
CDD_FSI_TX_HWUNIT_0 |
Range |
CDD_FSI_TX_HWUNIT_0 |
4.7.9.1.4.2. CddFsiTxPrescale
Item |
|
---|---|
Name |
CddFsiTxPrescale |
Description |
Selects the Prescale value . |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
true |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
CDD_FSI_TX_CLK_DIV_2 |
Range |
CDD_FSI_TX_CLK_DIV_0 |
4.7.9.1.4.3. CddFsiTxPingTimerTimeout
Item |
|
---|---|
Name |
CddFsiTxPingTimerTimeout |
Description |
Timeout value for CddFsiTx Ping Timer. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
true |
Post-Build-Variant-Value |
true |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
20000 |
Max-value |
4294967295 |
Min-value |
0 |
4.7.9.1.4.4. CddFsiTxTriggerSrc
Item |
|
---|---|
Name |
CddFsiTxTriggerSrc |
Description |
Type of source event that starts a transmission. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
true |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
CDD_FSI_TX_TRIGG_SRC_SW |
Range |
CDD_FSI_TX_TRIGG_SRC_SW |
4.7.9.1.4.5. CddFsiTxTransmissionMethod
Item |
|
---|---|
Name |
CddFsiTxTransmissionMethod |
Description |
Selects the method of frame transmission. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
true |
Post-Build-Variant-Value |
true |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
CDD_FSI_TX_INTERRUPT_MODE |
Range |
CDD_FSI_TX_INTERRUPT_MODE |
4.7.9.1.4.6. CddFsiTxExtHwTrigSrc
Item |
|
---|---|
Name |
CddFsiTxExtHwTrigSrc |
Description |
Configure the external trigger source for data frame and data frame |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
true |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
CDD_FSI_TX_TRIGGER_FSI_RX_TRIG0 |
Range |
CDD_FSI_TX_TRIGGER_FSI_RX_PING_FRAME_TAG_MATCH |
4.7.9.1.4.7. CddFsiTxExtPingTrigSrc
Item |
|
---|---|
Name |
CddFsiTxExtPingTrigSrc |
Description |
Configure the external trigger source for ping frame and data frame |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
true |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
CDD_FSI_TX_TRIGGER_FSI_RX_TRIG0 |
Range |
CDD_FSI_TX_TRIGGER_FSI_RX_PING_FRAME_TAG_MATCH |
4.7.9.1.4.8. CddFsiTxDmaReference
Item |
|
---|---|
Name |
CddFsiTxDmaReference |
Description |
Reference to the DMA Group Channel |
Multiplicity-Configuration-Class |
– |
Post-Build Time |
VARIANT-POST-BUILD |
Pre-Compile Time |
VARIANT-PRE-COMPILE |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
4.7.9.2. CddFsiTxGeneral
General configuration (parameters) of the Cdd Fsi Tx Driver software module.
4.7.9.2.1. CddFsiTxDeInitApi
Item |
|
---|---|
Name |
CddFsiTxDeInitApi |
Description |
Adds / removes the service CddFsiTx_DeInit() from the code. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.2. CddFsiTxTransmitApi
Item |
|
---|---|
Name |
CddFsiTxTransmitApi |
Description |
Enable/disable the service CddFsiTx_Transmit() from the code. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
false |
4.7.9.2.3. CddFsiTxDevErrorDetectApi
Item |
|
---|---|
Name |
CddFsiTxDevErrorDetectApi |
Description |
Switches the development error detection and notification on or off. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.4. CddFsiTxPingApi
Item |
|
---|---|
Name |
CddFsiTxPingApi |
Description |
Enable/disable the service CddFsiTx_Ping() from the code. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
false |
4.7.9.2.5. CddFsiTxExtTriggerEnable
Item |
|
---|---|
Name |
CddFsiTxExtTriggerEnable |
Description |
Enable/disable the service CddFsiTx_Ping() from the code.. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
false |
4.7.9.2.6. CddFsiTxBuffLoadApi
Item |
|
---|---|
Name |
CddFsiTxBuffLoadApi |
Description |
Adds / removes the services CddFsiTx_BuffLoad() from the code. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.7. CddFsiTxResetDriver
Item |
|
---|---|
Name |
CddFsiTxResetDriver |
Description |
Adds / removes the service Cdd_FsiTx_ResetDriver() and from the code. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.8. CddFsiTxTypeofInterruptFunction
Item |
|
---|---|
Name |
CddFsiTxTypeofInterruptFunction |
Description |
Type of ISR function |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
CDD_FSI_TX_ISR_CAT1 |
Range |
CDD_FSI_TX_ISR_VOID |
4.7.9.2.9. CddFsiTxInterruptVector
Item |
|
---|---|
Name |
CddFsiTxInterruptVector |
Description |
Type of ISR function |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
CDD_FSI_TX_INT1 |
Range |
CDD_FSI_TX_INT1 |
4.7.9.2.10. CddFsiTxDeviceVariant
Item |
|
---|---|
Name |
CddFsiTxDeviceVariant |
Description |
Select SOC variant .This parameter shall be used by driver to impose device specific constraints. The user guide shall detail the device specific constraints |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Post-Build-Time |
VARIANT-POST-BUILD |
Default-value |
AM263Px |
Range |
AM263Px |
4.7.9.2.11. CddFsiTxMaxHwUnitCount
Item |
|
---|---|
Name |
CddFsiTxMaxHwUnitCount |
Description |
Maximum hw count across all hwunits configured |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
1 |
Max-value |
4 |
Min-value |
1 |
4.7.9.2.12. CddFsiTxNotifyCapability
Item |
|
---|---|
Name |
CddFsiTxNotifyCapability |
Description |
Determines, if the notification mechanism (the functions to enable and disable the notifications) is available at runtime. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.13. CddFsiTxBufferOverRunInterrupt
Item |
|
---|---|
Name |
CddFsiTxBufferOverRunInterrupt |
Description |
Enable/disable the Interrupt service for Tx Buffer OverRun. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.14. CddFsiTxBufferUnderRunInterrupt
Item |
|
---|---|
Name |
CddFsiTxBufferUnderRunInterrupt |
Description |
Enable/disable the Interrupt service for Tx Buffer UnderRun. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.15. CddFsiTxPingTimeOutInterrupt
Item |
|
---|---|
Name |
CddFsiTxPingTimeOutInterrupt |
Description |
Enable/disable the Interrupt service for Ping Timeout. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.16. CddFsiTxFrameDoneInterrupt
Item |
|
---|---|
Name |
CddFsiTxFrameDoneInterrupt |
Description |
Enable/disable the Interrupt service for Tx Frame Done. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.17. CddFsiTxMainApi
Item |
|
---|---|
Name |
CddFsiTxMainApi |
Description |
Adds / removes the service CddFsiTx_Main() and from the code. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.18. CddFsiTxGetVersionInfoApi
Item |
|
---|---|
Name |
CddFsiTxGetVersionInfoApi |
Description |
Adds / removes the service CddFsiTx_GetVersionInfo() from the code. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
true |
4.7.9.2.19. CddFsiTxDMAEnable
Item |
|
---|---|
Name |
CddFsiTxDMAEnable |
Description |
Enables DMA Access method for CddFsiTx Transmission. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
false |
4.7.9.2.20. CddFsiTxMultiLaneEnable
Item |
|
---|---|
Name |
CddFsiTxMultiLaneEnable |
Description |
Enables MultiLane Transmission for CddFsiTx. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
false |
4.7.9.2.21. CddFsiTxMaxDmaChannelId
Item |
|
---|---|
Name |
CddFsiTxMaxDmaChannelId |
Description |
Number of actual DMA channels. This is of type published information and not editable |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
63 |
4.7.9.2.22. CddFsiTxDefaultOSCounterId
Item |
|
---|---|
Name |
CddFsiTxDefaultOSCounterId |
Description |
Default Os Counter Id if node reference to OsCounter ref CddFsiTxOsCounterRef is not set |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Default-value |
0 |
Max-value |
16 |
Min-value |
0 |
4.7.9.2.23. CddFsiTxOsCounterRef
Item |
|
---|---|
Name |
CddFsiTxOsCounterRef |
Description |
This parameter contains a reference to the OsCounter, which is used by the CddFsiTx driver. |
Origin |
Texas Instruments |
Post-build-variant-multiplicity |
false |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
4.7.9.3. CddFsiTxDemEventParameterRefs
Item |
|
---|---|
Name |
CddFsiTxDemEventParameterRefs |
Description |
Reference to configured DEM event to report “Tx buffer overrun”. |
Post-build-variant-multiplicity |
false |
Multiplicity-Configuration-Class |
– |
Post-Build Time |
VARIANT-POST-BUILD |
Pre-Compile Time |
VARIANT-PRE-COMPILE |
Origin |
Texas Instruments |
Post-Build-Variant-Value |
false |
Value-Configuration-Class |
– |
Post-Build-Time |
VARIANT-POST-BUILD |
Pre-Compile-Time |
VARIANT-PRE-COMPILE |
Note
The DDR (Double Data Rate) is not supported.So CddFsiRxMultiLaneEnable Parameter will be OFF.
4.7.9.4. Symbolic Names deviations
The Symbolic names are generated for following parameters:
CddFsiTxHwUnitId : Symbolic name is generated as CddFsiTxConf_CddFsiTxHwUnit_<CddFsiTxHwUnitId>
4.7.10. Examples
Please refer Example section of Cdd_FsiRx