kw_fixes

Klocwork fixes for v0 driver

PRSDK-6460: Fixing doxygen issues

Klocwork fixes on J7

Klocwork Fixes for J7/AM65x

6.1 doc/ver update

PDK-2666: c++ build fix

Signed-off-by: Prasad Konnur <prasadkonnur@ti.com>

PRSDK-7097: Assigning .text to DDR_0 to fit the examples in memory

PRSDK-6302: Updates for KW fixes done on OSAL

PDK-2879: Added digital audio example for J7 EVM infotaiment board

 - Observing noise in the audio output which needs some tuning for the clocks

PDK-2851: Added analog audio loopback test for J7 EVM infotainment board

PDK-4278: Fix for Board control API failure for IO Expander config

McASP loopback task statically created

This is done to match other devices in test app for cleanliness.

Cleaning up Board_control hack

Adding comments to remove when Board library issue has been resolved

Reverting buffer size change

Forcing ring size alignment

Rings must be aligned and also carved on the UDMA cache line size
multiple.  Otherwise, linker may place sections in the holes and result in
memory corruption.

Converting C66x IntrRouter config to use SYSFW

Using default OSAL MMU function

Validated driver on A72

Selecting NAVSS instance based on CPU

No Main NAVSS resources are allocated to MCU R5F by default. Instead of
overriding with parameters, we use MCU NAVSS for MCU R5F

Converting clock mux config to use SYSFW API

Changing to Sciclient Clocking calls - WIP.

Work in progress for using Sciclient Clocking calls instead of
direct register writes.

Removed RX/TX channel workaround for C66 build.

For MCU ARM R5 core, a workaround is needed for the RX/TX channel
assignments.  Made this workaround only for the MCU ARM R5 build
of the Audio loopback examples.

Audio Loopback functional on MCU Cortex R5F.

Audio inputs through PCM3168A ADC to MCU Cortex R5F, and
then is routed to PCM3168A DAC's.
Line input -> J38 jack on motherboard.
Output -> Top jack on J41.

Attempted to use Board library for Board_control() setting
the Audio Codec Reset Pin (via I2C3), but was not able to
successfully get this to work.
Instead, the application opens and closes the I2C3 handle,
and needed to set i2cCfg.baseAddr to CSL_I2C3_CFG_BASE to
get this functional.

Cleaned example makefiles.

Also, experimenting with UDMA configurations.

Removing setting unneeded IO Exp signal

Adding a few comments for clarity

Updating IO exp init code

TMP: C66x CTRL MMR config through VA/RAT

This should be reverted once functions are triggered in SYSFW

Adding I2C IO Expander configuration

Needed for EVM JTAG mux selection to pass through necessary McASP and
AUDIO_REFCLK2 signals

Updating clock selection for EVM

Updating McASP configuration for EVM

Modifying McASP instance for EVM

6.0 doc/ver update

PRSDK-4730: enable testing of mcaspControlChan by default in McASP LLD unit test
so that no manual testing is needed for PRSDK-3342.

PRSDK-4453 Addressing review comments

 Removed redundant config file for Device loopback SMP example.
 Update existing config file to enable support for SMP and non SMP
 mode.

PRSDK-4453 Add SMP enabled support for A53 and A15 core

 Update makefile and component makefile to add entry for SMP enabled
 examples
 Add project text file and config file to add SMP enabled support for
 AM572x A15 core

Fixed I2C dependency for J7 board include

Signed-off-by: Sivaraj R <sivaraj@ti.com>

PDK-4085: Add j721e_evm build support

Signed-off-by: Sivaraj R <sivaraj@ti.com>

Fixing McASP initialization error

Fixing Audio loopback build error from AIC header

Release notes & documentation update

Adding support for C66x 1/2

Merge pull request #110 in PROCESSOR-SDK/mcasp-lld from kedarc_updates to master

* commit 'baae757cad011ec720d97e83b4953446d93d0273':
  Added .gitignore to ignore generated files

Added .gitignore to ignore generated files

Merge pull request #108 in PROCESSOR-SDK/mcasp-lld from PDK-2396_Adding-A72 to master

* commit '09acff9cce11e580c86d8f5ed0961fcd88293221':
  Supporting A72 build

Supporting A72 build

Merge branch 'master' of ssh://bitbucket.itg.ti.com/processor-sdk/mcasp-lld into PDK-2396

Merge pull request #107 in PROCESSOR-SDK/mcasp-lld from PDK-2396_R5f-only_HOTFIX to master

* commit '7b33ab44c4f15675aec1646ee9484c2a81860796':
  Fixing uninitialized variable build error with GCC

Fixing uninitialized variable build error with GCC

Merge pull request #106 in PROCESSOR-SDK/mcasp-lld from PDK-2396_R5F-only to master

* commit 'fc1535b2d2a09d8ae934fe32377158815c4ab269':
  Fixing packaging issues for Jenkins build
  Only building for relevant cores right now
  Renaming J7 to J721E
  Enabling Audio Loopback example
  Fixing hard-coded UART print
  Adding QT platform for J7
  WIP - testing latest VLAB toolbox
  Updating McASP config to match J7ES spec
  Adding sciclient integration
  Adding configuration override for McASP example
  Removing pinmux code copied from Maxwell
  Updating J7 SOC details
  Enabling A72 buildsfor J7
  Adding C66x support on J7
  Reverting Board/UART code for J7 build
  Updating DMA event definitions
  J7 example building and running into main task
  Building J7 device loopback for mcu1_0
  Adding J7 build support based on AM65xx

Fixing packaging issues for Jenkins build

Only building for relevant cores right now

Renaming J7 to J721E

Enabling Audio Loopback example

Fixing hard-coded UART print

Need to use MCASP_log so that if the log is configured for CIO and UART
is removed from the application that we don't get a crash for
uninitialized UART stdio

Adding QT platform for J7

WIP - testing latest VLAB toolbox

Updating McASP config to match J7ES spec

Previous clock source was reused from Maxwell configuration.  On J7ES,
this clock source does not exist, but somehow the simulator ignores
this, so it was not detected.

Now, we use a real clock source with a typical frequency to allow for
easy 48 kHz configuration

Adding sciclient integration

Adding configuration override for McASP example

Removing pinmux code copied from Maxwell

Will update later when defined for J7

Updating J7 SOC details

- Including proper number of McASP instances and number of serializers
- Removing CPU-dependent muxing info until the path is tested and the muxing
  info is more well-established

Enabling A72 buildsfor J7

Needed to add MMU config for all aarch64 builds.  Nothing else needed

Adding C66x support on J7

Reverting Board/UART code for J7 build

Based on latest updated to enable these modules for J7 configurations

Updating DMA event definitions

Based on CSL definitions for McASP PDMA channels.

Resolves application crash and allows the main thread to run with
overrun errors

J7 example building and running into main task

Building J7 device loopback for mcu1_0

Adding J7 build support based on AM65xx

Merge pull request #105 in PROCESSOR-SDK/mcasp-lld from review-PRSDK-5273 to master

* commit '895c83243c73b59fb9e9b75dce8f4dd32b30aab7':
  PRSDK-5273: RTSC depdencies added

Merge pull request #101 in PROCESSOR-SDK/mcasp-lld from PRSDK-4108 to master

* commit 'aeb328855cc8774e93f672e06d21110053444090':
  PRSDK-4108 Fix linking issue for AM57xx platform
  PRSDK-4108 Add API to adjust/change volum in Codec

PRSDK-4108 Fix linking issue for AM57xx platform

 Issue: update volume function added for aic3106 codec which is called
 from aic31.c which is common for aic3104 and aic3106 codec.

 Fix: Updated aic3104.c codec file with the update volume function.

PRSDK-4108 Add API to adjust/change volum in Codec

 Add APIs to adjust or change volume in codec

PRSDK-5273: RTSC depdencies added

Signed-off-by: Aravind Batni <aravindbr@ti.com>

Merge pull request #104 in PROCESSOR-SDK/mcasp-lld from 5.2_doc_update to master

* commit '3fc9345d6a93eb2b8a67731d4cbb40ca1f451285':
  5.2_doc_relnotes_update

5.2_doc_relnotes_update

Merge pull request #99 in PROCESSOR-SDK/mcasp-lld from PRSDK-4982 to master

* commit '4442415421bae0d522dca570bb5f9f6b725581c8':
  Fixing bad typecasting at interrupt unregister

Merge pull request #102 in PROCESSOR-SDK/mcasp-lld from PRSDK-4704 to master

* commit '4ed51b09539121e2f00c13ee33868c8b3be75525':
  PRSDK-4704: MPU R5 examples. Increase size of region 1 to 32K

Merge pull request #103 in PROCESSOR-SDK/mcasp-lld from PRSDK-297 to master

* commit '98f14c69c5ecb98a0d9df41311a340f0644cea84':
  PRSDK-297 Fix example waning for AM57x

PRSDK-297 Fix example waning for AM57x

 Update exmaple config file to remove code which allocates heap memory
 to L2SRAM which is not applicaple for AM57xx

 Update example code to take care of typecasting issue of signed and
 unsigned variable differences.

PRSDK-4704: MPU R5 examples. Increase size of region 1 to 32K

Merge pull request #100 in PROCESSOR-SDK/mcasp-lld from PRSDK-4879_followup to master

* commit '014146b00cc88c4a6ff8a18ea245f04beb78331c':
  Fixing A53 build error after test refactor rebase

Fixing A53 build error after test refactor rebase

Fixing bad typecasting at interrupt unregister

Merge pull request #98 in PROCESSOR-SDK/mcasp-lld from PRSDK-4879 to master

* commit '07cb2068ab337aace4d50fcac29567e0a32106b1':
  Moving cache wb operation for Tx channel
  Device loopback test redesign

Moving cache wb operation for Tx channel

Cache operation needs to be performed after the new buffer has been
created in cached memory and before submitting back to the channel.

Device loopback test redesign

Based on recommendation by design team, the device loopback should be
restructured to prevent Rx and Tx channels blocking each other's
transfers, which should otherwise be independent.  The current test
increases potential for Tx underrun, and is especially magnified when
using PDMA, which introduces an extra layer of buffering.

The changes are valid for EDMA as well.

Exta restucturing was required to allow device and audio loopback to work
with the same audioSample_io.c code.  Ideally, the device loopback should
be removed from this and kept only in the regression test for simplicity.

Merge pull request #97 in PROCESSOR-SDK/mcasp-lld from PRSDK-4217 to master

* commit 'bc5391ac3be35314b9acc6e321e662268d95822b':
  Partially revert "Updating EDMA handle to pass in like UDMA"
  Fixes to regression test after driver merge
  Generalizing maximum active buffer count
  Removing temp DMA object definition
  Further cleanup
  Enabling UDMA enable/disable sequences
  Altering FIFO enable/disable sequences
  Merging redundant UDMA functions
  Refactoring Pwrm handler into main driver
  Generalizing DMA callback (non-loopjob)
  Updating EDMA handle to pass in like UDMA
  Beginning merge of Mcasp_HwInfo and Mcasp_HwObj
  Abstracting EDMA PaRAM set index through API
  Finished merging all driver code.
  Updating localAbortIO function
  Implementing deleteChan
  Generalizing mcaspCreateChan
  Updating mcaspBindDev function
  Refactoring driver source files

Partially revert "Updating EDMA handle to pass in like UDMA"

We enable the driver to accept both legacy and new ways to pass EDMA
handle.

This partially reverts commit 4eede7b28a82b99e7979ec2eaa641ea699ff9eb5.

Conflicts:
src/dma/V0/mcasp_dma.c

Fixes to regression test after driver merge

Generalizing maximum active buffer count

EDMA and UDMA may handle resources differently, so we need to have a
DMA-dependent setting for this check in the driver code

Removing temp DMA object definition

Further cleanup

- Removing dead code and irrelevant comments in UDMA code
- Updating submit packet to DMA function to be more generic

Enabling UDMA enable/disable sequences

Commenting out enable/disable routines.  Enable still requires a "hack" to
enable before rings are pushed to the free queue and requires further
investigation.  Disable works as expected but doesn't include any teardown or
PDMA flush yet.

Altering FIFO enable/disable sequences

Previously FIFO was enabled only at channel creation, and then upon
submission of the first packet, where FIFO is promptly disabled and
then re-enabled to clear FIFO contents.  This has the ill effect when
using UDMA and some data is pre-loaded to the FIFO before the McASP
state machine is active, and data in the first packet gets lost.
Depending on timing, this could occur mid-PDMA write and cause the
data synchronization detection to fail.  Also, we don't need to discard
any of the first packet.

Now we only enable FIFO every time we restart the state machine and disable the
FIFO every time we stop the state machine.  This has the effect of clearing the
FIFO in any stop/start condition as desired without the ill effect of dropping
some of the first packet when using UDMA.

Merging redundant UDMA functions

Generalizing common code with a few dereferenced parameters to
distinguish between receive and transmit channels

Refactoring Pwrm handler into main driver

Removing duplicate versions in DMA code

Generalizing DMA callback (non-loopjob)

EDMA/UDMA ISR call a general DMA callback which satisfies feeding both engines

Updating EDMA handle to pass in like UDMA

Both DMA handles should be passed in through the hardware parameters to be
consistent.  We migrate the EDMA handle out of the channel parametes.

!!! NOTE: This represents a break from the application over previous
    releases and needs to be documented and handled with care.

Beginning merge of Mcasp_HwInfo and Mcasp_HwObj

These are used between the driver API and driver internal object.  However,
their definitions are almost identical.  Eventually, the internal object
should just point to the HwInfo, but for now we can memcpy the two so that
we don't need so much code to initialize.

Abstracting EDMA PaRAM set index through API