Repository files navigation

This repository serves as an aggregator for 3 conceptually different projects, but tightly bound to each other:

1. A containerized cross-compiler for TriCore architecture
2. A flasher for AURIX development boards (WIP)
3. A utility Python package for interacting with both of them (mimicking the Platform IO workflow: build, flash, monitor)

Both the cross-compiler container and the Python package are published "pre-coocked" on an online repository:

• tricore-dev-env on Docker Hub
• tricore-cli on PyPI

Make sure that Python3 and a Docker Engine are installed on your system and run:

docker pull francescomecatti/tricore-dev-env:1.0pip3 install tricore-cli

You shold now be able to run:

docker run -it CONTAINER_TAG

And, in case it exits:

docker start -ai CONTAINER_ID

to restore it.

This is exactly whattricorecli SUBCMD DIR runs under the hood (through the Docker SDK for Python). To mount ahost's directory into the container, abind mount is used by the script.

That's all! Move toExamples - Containerized installation for the build process.

First of all, clone this repository:

git clone --recurse-submodules --shallow-submodules https://github.com/mc-cat-tty/tricore-dev-env

In order to install the toolchain on your system, the following steps are required:

1. Buildbinutils for TC target
2. Build GCC for TC traget
3. Build, at least,libgcc for TC target
4. Buildnewlib for TC target

Apart from the third point, this sequence must be kept in order, sincebintuils (as,ar,ld, etc.) are needed bygcc; and, in turn,newlib requires a fully-functionalgcc to be bult (plus the linker and the assembler).

The build procedure is automated bybuild-toolchain/install.sh script. Feel free to tinker around with the build script.The proposed set of flags make the compilation successfull on bothDarwin/arm64 andLinux/amd64 platforms.

The install directory of the script can be customized withINSTALL_PATH environment variable:

INSTALL_PATH=/home/foo bash build-toolchain/install.sh

In case of missingnproc in your system, replaceJOBS variable with a reasonable value; typically 1.5 times the number of cores on your machine.

First of all, clone this repository:

git clone --recurse-submodules --shallow-submodules https://github.com/mc-cat-tty/tricore-dev-env

Make sure that a Docker Engine is installed and running on your system:

cd tricore-dev-envdocker build -t CONTAINER_TAG.

Thebuild subcommand requires aDockerfile to be present in the build directory. This file instructs the docker client about the building steps.

You might want to avoid the copy of some source files during the build process - for instance, because they are not ready to be embedded into the container;.dockerignore serves exactly this purpose.

Both the aforementioned files are located in the top-directory of this project, so that you can build up your own on top of them.

You shold now be able to run:

docker run -it CONTAINER_TAG

And, in case it exits:

docker start -ai CONTAINER_ID

to restore it.

Please, note that the linker script.lsl file is not the default one provided byInfineon Code Examples. It has been downloaded from thisURL, as suggested byAURIX Development Studio - Guide for HighTec Toolchains.

Make sure that the dependencies describedhere are installed - and running, in the case of the Docker Engine - on your system.

Pick and example, for instanceBlinky_LED_1_KIT_TC397_TFT:

cd examples/Blinky_LED_1_KIT_TC397_TFTtricorecli build.

If the build process is successful, a newbuild directory should appear in the project's top folder. Insidebuild you can find twocompilation artifacts:

• Blinky
• Blinky.hex

Blinky.hex is the format expected by Infineon MemTool.

If you have not already exported binutils and gcc paths into PATH env var, do the following:

export PATH=/your/path/binutils-tc/install/bin/:$PATHexport PATH=your/path/gcc-tc/install/bin/:$PATH

Be aware that your path may be different. It depends on the configuration of your environment.

cd examples/Blinky_LED_1_KIT_TC397_TFTmkdir buildcd buildcmake --toolchain tricore_toolchain.cmake ..&& make -j12

12 is the number of jobs I decided to pass tomake; find your own tuning. Usually1.5 * $(nproc).

You should now see the result of the compilation, namelyBlinky - for this specific project -, in thebuild folder:file Blinky. Iffile spits out something likeELF 32-bit [...] Siemens Tricore Embedded Processor, everything should be ok.

Now let's convert the ELF to the HEX format (already done by the build system, in the latest version of the project):tricore-elf-objcopy -j .text -j .data -O ihex Blinky Blinky.hex.

TheCMakeLists.txt andtricore_toolchain.cmake do the trick. Noteworthy directives are:

• set(CMAKE_C_COMPILER tricore-elf-gcc) chooses the right cross-compiler. Omitting this leads to the use of the system's compiler, which is not - almost for sure - a compier that supports TriCore architecture as a target.
• set(CMAKE_SYSROOT /tricore-build-tools/tricore-elf) sets the compilersysroot, namely the path where libraries (both heaers, under/include and static/dynamic libraries, under/lib) likelibc,libm,crt (C RunTime), etc. are searched. Read more about it on theGCC manual.
• project(... LANGUAGES C) disables C++ language. Enabling C++ raises some errors at the moment.
• add_compile_definitions(__HIGHTEC__) defines a macro required by iLLD libraires.
• add_compiler_options(...) and add_link_options(...) are describedhere.-mcpu=XXXX must be coherent with the CPU of your board. Runtricore-elf-gcc --target-help to get the complete list of supported CPUs and architectures.
• include_directories(... /tricore-build-tools/tricore-elf/include) includes the header files ofnewlib.

Note thatset(CMAKE_SYSROOT /tricore-build-tools/tricore-elf) andinclude_directories(... /tricore-build-tools/tricore-elf/include) are probably useless in the context of a single installation path for GCC, binutils and newlib; but, they are necessary if the installation paths of these tools differ.In particular, they should point to the install directory ofnewlib.

At the moment, projects have to be created by hand.

Some useful resources are:

• iLLD drivers
• Linker scripts
• CMakeLists.txt template
• tricore_toolchain.cmake