Tools

Legato contains Tools that will help you configure and diagnose your target or dev machine and build Systems, Apps and Components for Legato.

They are broken down into 3 categories:

Section Description
Target Tools Tools that run on the target device
Target Management Tools Tools for managing target devices (run on Linux dev machine)
Build Tools Tools for building software (run on Linux dev machine)

Before running tools on your host machine you will need to configure your shell.

Configuring your Shell

Some of the Legato tools need certain environment variables to be set. There are two quick shortcuts to set up your shell's environment:

Both of these files reside in the bin directory under your legato root directory (where the legato framework is installed). If the bin directory is missing or empty, it's because the framework has not been built yet.

bin/legs

You can run an interactive bash shell configured for Legato by running legs (short for "legato shell") every time you open a new shell.

$ bin/legs

After running legs, you can exit the shell at any time to terminate legs and restore your shell's environment.

Warning
If you have two Legato framework versions installed on your PC, to switch versions you MUST exit out of legs and run the legs script again from the other version.

bin/configlegatoenv

You can use configlegatoenv as alternative to bin/legs:

$ source bin/configlegatoenv

configlegatoenv does not spawn an new shell, instead it imports the Legato configuration within your current shell session. This is useful if you want to use bash alternatives like zsh.

Warning
If you have two Legato framework versions installed on your PC, to switch versions you MUST source the configlegatoenv script from the other version.