Skip to content

3. Hello, World! Example Tutorial

This example demonstrates the basic Libtropic API and can be used to verify that the chip works correctly. In this example, you will learn about the following functions:

  • lt_init(): function used to initialize context for communication with the TROPIC01,
  • lt_verify_chip_and_start_secure_session(): helper function to start Secure Session and allow L3 communication,
  • lt_ping(): L3 command to verify communication with the TROPIC01,
  • lt_session_abort(): L3 command to abort Secure Session,
  • lt_deinit(): function used to deinitialize context.

Build and Run

Building and running the example

Go to the example's project directory: 

cd examples/esp32/<your_board>/hello_world/

Build, flash and run the serial monitor using this command: 

idf.py build flash monitor
After this, you should see a colored output in your terminal.

Closing the ESP-IDF serial monitor

To close the ESP-IDF serial monitor, press Ctrl + ]. Refer to the ESP-IDF monitor documentation for a full list of available keyboard shortcuts.

TBA

TBA

Configuration

In addition to the Libtropic CMake options used to configure Libtropic, this example provides the following CMake option:

  • LT_SH0_KEYS (default: "prod0") selects which pairing keys in slot 0 are used. Switch to engineering-sample pairing keys if your TROPIC01 is provisioned with them:

    Switching to engineering sample pairing keys 
    idf.py -DLT_SH0_KEYS="eng_sample" build flash monitor

    TBA

    TBA

    Additionally, see Default Pairing Keys for a Secure Channel Handshake for more information.