Giter Club home page Giter Club logo

tricore-probe's Introduction

Tricore-Probe: Run rust effortlessly on Tricore chips

tricore-probe is an effort to deploy and debug rust programs with little effort on Tricore chips. It uses publicly available Infineon tools to interface with the chips debug controller. As its name suggests, it is inspired by probe-run and depends on the defmt framework to integrate seamlessly just as probe-run does.

Platform support

Currently only Windows and Linux are supported.

Installation

Windows

Requirements

  1. Infineon DAS tool version 8.0.5 Please make sure the DAS_HOME environment variable points to the DAS tool installation directory.
  2. Infineon AURIX™ Flasher Software Tool Please make sure the AURIX_FLASHER_PATH environment variable points to the AurixFlasher executable (<your-path>\AURIXFlasher.exe).
  3. defmt-print CLI utility
  4. objcopy CLI utility (obtain e.g. as part of the MinGW-w64 project)
  5. addr2line CLI utility (obtain e.g. as part of the MinGW-w64 project)
  6. Rust toolchain
  7. LLVM (also set LIBCLANG_PATH to <your-path>\LLVM\lib)

Installation

Install tricore-probe:

cargo install tricore-probe --git https://github.com/veecle/tricore-probe --version 0.2.0

Linux

The Linux setup is not officially supported by Infineon and thus might not work as expected. Please report any bugs or issues you encounter with the Linux setup only to this repository, not to Infineon.

Requirements

  1. Place the Infineon DAS tool version 8.0.5 installer (DAS_V8_0_5_SETUP.exe) in tricore-docker.
  2. Place the Infineon AURIX™ Flasher Software Tool installer (aurixflashersoftwaretool_1.0.10_Windows_x64.msi) in tricore-docker.
  3. objcopy CLI utility
  4. Rust toolchain
  5. libudev library (libudev-dev on Ubuntu, systemd-libs on Fedora)

Installation

Clone the repository and place the DAS tool installer and AurixFlasher installer into the tricore-docker directory. Build the docker container running the DAS tool, AurixFlasher and other utilities.

Note: The veecle/flash-tricore container will contain an AurixFlasher and DAS installation in a Wine environment. To use this setup, make sure you checked the terms and conditions of these programs and accept them by setting the required build argument with --build-arg=AGREE_INFINEON_TERMS=1 when building the docker image.

docker build . --tag veecle/flash-tricore --build-arg=AGREE_INFINEON_TERMS=1 -f tricore-docker/Dockerfile

Install tricore-probe:

cargo install tricore-probe --git https://github.com/veecle/tricore-probe --version 0.2.0

Attribution

The Linux setup is based on a modified version of the wineftd2xx project by brentr.

Quickstart

> tricore-probe <your-executable>.elf --list-devices
Found 1 devices:
Device 0: "DAS JDS AURIX LITE KIT V2.0 (TC375) LK7KFCF1"

In case of a simple example based on the Bluewind blinky the output will look something like this:

> tricore-probe blinky.elf
DEBUG power on reset
└─ bw_r_drivers_tc37x::ssw::tc0::init_clock @ C:\Users\andra\.cargo\registry\src\github.com-d2f9efa20490c5c8\bw-r-drivers-tc37x-0.2.0\src\ssw\tc0.rs:12
INFO  LED2 toggle
└─ blinky::main @ src\main.rs:46

For more sample code refer to the Bluewind bare-metal examples and to the Veecle PXROS examples.

Cargo runner

This program can be configured as a runner. Check main.rs for additional configuration options.

A simple runner config for a TC375 lite kit could look like this:

[target.tc162-htc-none]
runner = "tricore-probe"
# The default dwarf version of the HighTec compiler is version 2 in v0.2.0
# and version 3 in v1.0.0, both versions being incompatible with defmt location information.
rustflags = ["-Z", "dwarf-version=4"]

[build]
target = "tc162-htc-none"

Then you can call cargo run in your project root which will run the built .elf on your board via tricore-probe.

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.

Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.

tricore-probe's People

Contributors

alepez avatar arctic-alpaca avatar gemesa avatar therealfrauholle avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.