When the Device Configurator is used outside of the ModusToolbox™ environment, such as TLEXXX, it will not have the ModusToolbox™ application context. In the current stand-alone use case, the personalities and device-db are intended to be shipped in a CMSIS pack, typically distributed via Infineon Developer Center, that is used in Keil µVision and IAR Embedded Workbench. The Device Configurator can be run as a GUI and via the command line.

Install Infineon Device Configurator​

The installer for the Infineon Device Configurator is provided on Linux, macOS, and Windows. At this time, using the tool with Keil µVision IDE or IAR Embedded Workbench outside of the ModusToolbox™ environment is only supported on Windows, as these are only available for that operating system. The installer can be downloaded here: http://www.infineon.com/idc

Launch the

deviceconfigurator_[version].[build #]_windows_x64.exe

installer and follow the installer wizard steps. We recommend installing as current user. By default, the tool is installed here:

C:\Users[user-home]\Infineon\Tools\InfineonDeviceConfigurator-[version]

Note:

The installer has options to open the Device Configurator tool and the text file release notes. Opening the tool this way will not be in the context of a supported project loaded in Keil µVision or IAR Embedded Workbench, and tool will open without any configuration information with a message to that effect. We recommend deselecting this option on the installer, and opening the tool from the IDE in the context of a supported project. See theRun Device Configuratorsection.

CMSIS Pack​

In order to use devices such as TLE994x_5x, you need to install the appropriate CMSIS pack. For example, the

MOTIX_TLE994x_5x_PDL.pack

. You can find the pack on the Infineon Developer Center webpage: http://www.infineon.com/idc

Run Device Configurator​

Keil µVision​

The installer adds the

Run Device Configurator [version]

item to the

Tools

menu when the

Add a menu item to run Device Configurator

task (by default) is selected on the Custom Installation page. If needed, you can

Add menu item to µVision (script)

after the installer finishes.



Using the GUI​

To run the Device Configurator GUI tool, open the Keil µVision IDE with a project. Then, select the

Tools

>

Run Infineon Device Configurator [version]

. If you don't see the menu item, refer to

section 2.4

.



Note:

This menu entry is for use with projects created out of supported CMSIS packs andnotfor applications exported from the ModusToolbox™ ecosystem. The CMSIS packs include the relevant files to be used via that menu entry. If you launch the Device Configurator without having a supported project loaded in Keil µVision, it may fail to open, and there may not be any warning or message.

With a supported project loaded, the IDE launches the Device Configurator with the opened

design.modus

file located in the current project:



When you save updates, the Device Configurator generates/updates source code in the

GeneratedSource

directory next to the

design.modus

file. See the

Code generation

section for more details.

Add menu item to µVision (script)​

In most cases, the installer adds the menu item to the Keil µVision IDE automatically. It also extracts a

IntegrateToKeil.ps1

script to the

[installation folder]\resources

folder. If the

Tools

menu in the Keil µVision IDE does not contain the items to launch the Infineon Device Configurator, you can execute the script manually.

To run the script, open Windows Explorer and navigate to the resources folder (for example,

C:\Users[user-home]\Infineon\Tools\InfineonDeviceConfigurator-[version]

), type "powershell" in address bar.



In the Windows PowerShell window, run the following command to change the Restricted (by default) execution policy to AllSigned to allow running signed script:

Set-ExecutionPolicy AllSigned -scope Process -Confirm:$False

And confirm changes by [

A

] and [

Enter

].



Then run the script:

.\IntegrateToKeil.ps1


The CLI can require confirmation of script run owned by Infineon Technologies publisher.

Please verify if the added Mag<Id>, Mfg<Id>, Mtx<Id>, Mid<Id> and Mex<Id> registry values are in the script output.

Remove menu item from µVision (script)​

If you use the Device Configurator uninstaller, it will remove the

Run Device Configurator

menu item from the Keil µVision IDE automatically. To remove the item manually, follow these steps:

Open Windows Explorer and navigate to the resources folder (for example,

C:\Users[user-home]\Infineon\Tools\InfineonDeviceConfigurator-[version]

), type "powershell" in address bar.



In the Windows PowerShell window, run the following command to change the Restricted (by default) execution policy to AllSigned to allow running signed script:

Set-ExecutionPolicy AllSigned -scope Process -Confirm:$False

And confirm changes by [

A

] and [

Enter

].



Then run the script:

.\IntegrateToKeil.ps1 -u

Please verify the script output:



Using the command line​

The Device Configurator executable can be run from the command line, and it also has a "cli" version of the executable as well. Running the executable from the command line can be useful as part of batch files or shell scripts to re-generate the source code based on the latest configuration settings. The exit code for the executable is zero if the operation is successful, or non-zero if the operation encounters an error. For more information about the command-line options, run the executable using the

-h

option.

IAR Embedded Workbench​

The installer does not add any settings for IAR Embedded Workbench. You need to configure the GUI to add a menu item. You can also run the Device Configurator from the command line.

Create design.modus file​

If you have a project without a

design.modus

file, follow these steps to allow configuration of your project with the Device Configurator:

  1. Create a new text file called “design.modus” inside your project directory with the following minimal configuration:

    &lt;?xml version="1.0" encoding="UTF-8"?&gt;
    &lt;Configuration app="BACKEND" formatVersion="14" lastSavedWith="Configurator Backend" lastSavedWithVersion="3.50.0" xmlns="http://cypress.com/xsd/cydesignfile_v5"&gt;
    &lt;Devices&gt;
    &lt;Device mpn="TLE9954EQA40"&gt;
      &lt;BlockConfig/&gt;
      &lt;Netlist/&gt;
    &lt;/Device&gt;
    &lt;/Devices&gt;
    &lt;/Configuration&gt;

  2. Replace the “mpn” attribute with the part number of the used device in your project.

  3. Save the “design.modus” file.

Run Device Configurator​

Run the tool as described in

Using the GUI

or

Using the command line

.

  1. Upon first opening the Device Configurator for a project. resolve all pending tasks listed in the Notice List to achieve a valid configuration for the selected device. See

    Notice List

    for more details.

  2. Set a configuration for your device by enabling desired blocks from the

    Peripherals

    ,

    Pins

    , and

    System tab

    .

  3. Save the configuration.

  4. Add the newly created

    GeneratedSource

    folder to your build environment in the same location as your

    design.modus

    file.

  5. Include the

    ifxcfg.h

    header file from the

    GeneratedSource

    folder, and insert an

    init_ifxcfg_all()

    call inside your application start-up routine.

Using the GUI​

Configure menu​

You need to configure IAR Embedded Workbench GUI manually to add Device Configurator to the menu, as follows:

  1. On the main menu, select

    Tools > Configure Tools...

    to open the dialog.



  2. On the dialog, enter the following:

    • Menu Text

      : Device Configurator

    • Command

      :

      [

      path-to-device-configurator

      ]\resources\launch-tool.exe

      You can navigate to the executable using the [

      Browse…

      ] button.

    • Argument

      :

      "--library "[

      path-to-IAR-CMSIS-Packs

      ]\Infineon\TLE994x_5x_DFP\1.0.0\props.json","[

      path-to-IAR-CMSIS-Packs

      ]\Infineon\TLE994x_5x_DFP\1.0.0\device-info\device-db\props.json" --design "$PROJ_DIR$\config\design.modus" --set-device TLE9954EQA40"

      This passes a command to the Device Configurator to use the specified library, device-db, and

      design.modus

      file, and set the device.

      The variable

      $PROJ_DIR$

      is the IAR Embedded Workbench project directory.

  3. Click

    OK

    to close the dialog, and the menu item will be added:



Using the command line​

You can use the command line to run the Device Configurator with project context by providing specific arguments. For example (replace "[...]" with real values):

C:\Users\[user-home]\Infineon\Tools\InfineonDeviceConfigurator-[version]\resources\launch-tool.exe --library "C:\Users\[user-home]\IAR-CMSIS-Packs\Infineon\TLE994x_5x_DFP\1.0.0\props.json","C:\Users\[user-home]\IAR-CMSIS-Packs\Infineon\TLE994x_5x_DFP\1.0.0\device-info\device-db\props.json" --design "[IAR EW project path]\config\design.modus" --set-device TLE9954EQA40

The following describe the arguments in detail:

  • Mandatory:

    --library "[lib-file1]","[lib-file2]"

    Replace [lib-file1] with the local path to the top-level CMSIS pack

    props.json

    file. For example:

    "C:\Users\[user-home]\IAR-CMSIS-Packs\Infineon\TLE994x_5x_DFP\1.0.0\props.json"

    Replace [lib-file2] with the local path to the device-db

    props.json

    file in the CMSIS pack. For example:

    "C:\Users\[user-home]\IAR-CMSIS-Packs\Infineon\TLE994x_5x_DFP\1.0.0\device-info\device-db\props.json"

  • Mandatory:

    --design "[design-file]"

    Replace [design-file] with the local path to the

    design.modus

    file, usually located inside the project folder. For example:

    "[your IAR EW project path]\config\design.modus"

    For a template of a minimal

    design.modus

    file, see ___.

  • Optional: --set-device [part-no]

    Providing a valid [part-no] will update the device in the provided the

    design.modus

    file. For example,

    TLE9954EQA40