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/linux/spi/hello_world/

Create a build/ directory and switch to it: 

mkdir build/
cd build/

And finally, build and run the example: 

cmake ..
make
./libtropic_hello_world

TBA

TBA

After this, you should see an output in your terminal.

If your TROPIC01 has engineering sample pairing keys, you can switch to them using the LT_SH0_KEYS CMake option:

Switching to engineering sample pairing keys

You can pass LT_SH0_KEYS to cmake as follows: 

cmake -DLT_SH0_KEYS="eng_sample" ..
make

TBA

TBA

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