Documentation: Add docummentation for Infineon’s AURIX TriCore architecture

This commit add documentation for the Infineon’s AURIX TriCore architecture.

Signed-off-by: chao an <anchao@lixiang.com>
This commit is contained in:
chao an 2024-02-20 13:56:36 +08:00 committed by Xiang Xiao
parent 09aede87ee
commit 930ad64a0c
3 changed files with 125 additions and 0 deletions

View File

@ -0,0 +1,41 @@
=======
TriCore
=======
All TriCore source reside in lower-level common, chip-specific, and architecture-specific
directories.
arch/tricore/src/common/ Directory
==================================
This directory holds source files common to all TriCore architectures.
Architecture-Specific Directories
=================================
Architecture-specific directories hold common source files shared for by
implementations of specific TriCore architectures.
``TriCore``
This directory holds logic appropriate for any instantiation of the 32-bit
TriCore architecture.
Chip-Specific directories
=========================
For SoC chips, in particular, on-chip devices and differing interrupt
structures may require special, chip-specific definitions in these chip-
specific directories.
The core Chip implementation is based on Infineon Low Level Drivers (iLLDs).
The unified API is more friendly to developers familiar with Infineon SDK/HAL.
We can get more code examples on Infineon's official Github: `AURIX_code_examples <https://github.com/Infineon/AURIX_code_examples>`__
``TC3xx``
This is the implementation of NuttX on the Infineons AURIX™- TC3xx microcontroller family.
.. toctree::
:maxdepth: 1
:glob:
*/*

View File

@ -0,0 +1,61 @@
=================
KIT_A2G_TC397_TFT
=================
This page file describes the contents of the build configurations available
for the NuttX TriCore port.
Infineons AURIX™- TC3xx `KIT_A2G_TC397_TFT <https://www.infineon.com/cms/en/product/evaluation-boards/kit_a2g_tc397_5v_tft>`__ Board
=====================================================================================================================================
This port should work on KIT_A2G_TC397_TFT with a proper CPU.
The mandatory CPU features are:
* System Timer (STM)
* Asynchronous Serial Interface(ASCLIN) UART
* IRQs are managed by Interrupt Router(INT), IR Service Request Control Registers(SRC).
Toolchains
==========
Currently, only the Infineons AURIX™ Tasking toolchain is tested.
Configurations
==============
Common Configuration Notes
--------------------------
1. Each Tricore TC397 configuration is maintained in a sub-directory
and can be selected as follow::
tools/configure.sh tc397:<subdir>
Where ``<subdir>`` is one of the configuration sub-directories described in
the following paragraph.
NuttX Shell::
tools/configure.sh tc397:nsh
2. These configurations use the mconf-based configuration tool. To
change a configurations using that tool, you should:
a. Build and install the kconfig-mconf tool. See nuttx/README.txt
see additional README.txt files in the NuttX tools repository.
b. Execute ``make menuconfig`` in nuttx/ in order to start the
reconfiguration process.
3. By default, all configurations assume the Linux. This is easily
reconfigured::
CONFIG_HOST_LINUX=y
Configuration Sub-Directories
-----------------------------
ostest
------
The "standard" NuttX examples/ostest configuration.

View File

@ -0,0 +1,23 @@
=============
TriCore/TC397
=============
**TriCore/TC397** An TriCore flat address port was ported in NuttX-12.0. It
consists of the following feautres:
- Runs in Supervisor Mode.
- IRQs are managed by Interrupt Router (INT), IR Service Request Control Registers (SRC).
- Used System timer (STM) for systick.
This kernel with ostest have been tested with
- Infineon's AURIX™ TC397 Evaluation Board: KIT_A2G_TC397_5V_TFT
Supported Boards
================
.. toctree::
:glob:
:maxdepth: 1
boards/*/*