Installing the Trust Platform Design Suite v2

Last modified by Microchip on 2023/11/09 08:54
Contents

This page shows you how to install and set up Microchip's Trust Platform Design Suite for CryptoAuthentication™. The design suite dramatically reduces the time you'll spend provisioning and using Microchip's secure elements.

Trust Family Logos

  1. Installing the Trust Platform Design Suite Graphical User Interface (GUI)
    • Includes the Trust Platform GUI, Python, and Jupyter Notebook
    • Also clones the Trust Platform repository from GitHub
      • Includes Python packages, C projects, and use case user guides
  2. Setting the Path to the MPLAB X IDE Installation Folder
    • Enables the GUI to re-program the CryptoAuth Trust Platform board

Installing the Trust Platform Design Suite GUI

The Trust Platform Design suite helps you with:

  • Selecting the appropriate secure element family for your use case
  • Provisioning the secure element for your use case
  • Prototyping your use case using C-based example projects and the CryptoAuth Trust Platform hardware prototyping kit
  • Generating an encrypted file to share your secure element's provisioning secrets with Microchip

The Trust Platform Design Suite includes Anaconda (Python distribution) and Jupyter Notebook (open-sourced Python-based application). Jupyter Notebook communicates with a secure element on the CryptoAuth Trust Platform development board to provision it for your specific use case. The CryptoAuth Trust Platform board includes all three Trust Platform devices, Trust&GO (pre-configured and pre-provisioned black box), TrustFLEX (pre-configured), and TrustCUSTOM (full custom). These devices are based on the ATECC608B CryptoAuthentication device.

​

Supported operating systems:

  • Microsoft Windows® 10 64-bit
  • Linux® Ubuntu 20.04 LTS or newer
  • macOS® Mojave 10.14.6 or newer

Supported Integrated Development Environments (for the C-based projects):

  • MPLAB® X IDE v5.25 and XC32 C compiler v2.30 or later

Supported web browsers:

  • Google Chrome
  • Apple Safari

​

Choose your operating system for installation instructions:

Windows Installation

Download and run the installer.

Windows Installation Welcome Screen

Review and accept the end-user license agreement terms. Then, select the installation type as Just Me (recommended).

Select Installation Type

Browse to the installation folder of your choice.

Browse to the Installation Folder

Leave the top two Advanced Installation Option boxes unchecked and check the Clear the package cache upon completion box.

Clear Package Cache Dialog

 

Start the Trust Platform Design Suite. Click on the Windows Start icon and search for "Trust Platform V2".

The first time you start the Trust Platform Design Suite, you will see this window open indicating the repository is being downloaded. Please be patient as this will take some time.

Start the Trust Platform Design Suite

the repository is being downloaded

Linux Installation

Download and run the installer. Open Terminal, navigate to the directory containing the downloaded installer, and extract the archive using this command: 
tar -xf trustplatform-x.x.x.tar.gz

Open Terminal

Navigate to the extracted folder and run the installer using the following command: bash tpds_install.sh

When prompted press Enter to start the installation.

Navigate to the Extracted Golder

Go through the license terms and type "yes" to agree to the license terms.

Review the License Terms

 

Installation by default will try to install in the user's $HOME directory. $HOME is the recommended installation location.

$HOME Installation Location is Recommended

Type "yes" for conda init (This is optional).

Run Conda Init

For updating the udev rules in the system, the sudo password is required. Type in your password then press Enter.

sudo Password is Required

Installation is complete.

Installation Complete

 

After installation, the Trust Platform utility launcher entry will be created.

Platform Utility Launcher Entry Created

Trust Platform Design Suit Running

macOS Installation

Download and run the installer.
When you launch the installer, you will be prompted with an alert. Click OK.

Launch the Installer

Navigate to your System Preferences and click on Security & Privacy.

System Preferences Dialog

Select Allow apps downloaded from App Store and identified developers then click Open Anyway.

Select to Allow apps downloaded from App Store

Launch the installer then click Open.

Open Dialog Box

Click Continue and follow the installation process.

Anaconda Welcome Dialog Box

Setting the Path to the MPLAB X IDE Installation Folder

If you want to re-provision the secure element after using the CryptoAuth Trust Platform board to prototype your use case, you will have to reprogram the board with factory firmware. The Trust Platform Design Suite can do this for you if you tell it where MPLAB X IDE lives on your computer. On the top left of the Trust Platform Design Suite window, select File > Preferences to specify the path to MPLAB X IDE.

Specify PATH in Preferences Dialog

The CryptoAuth Trust Platform board comes pre-programmed with firmware. This firmware enables Jupyter Notebook to provision the secure element on the CryptoAuth Trust Platform board for your specific use case. Once the secure element is provisioned, you can re-program the board to prototype your use case using one of the example projects that come with the Trust Platform Design Suite.