Skip to content

Building the Legato "system" (apps) for mangOH Yellow

Jen Chitty edited this page Jan 2, 2020 · 3 revisions

Start by installing leaf, if you haven't already, and add the mangOH Yellow leaf "remote" repository URL to your leaf configuration:

leaf remote add mangOH https://downloads.sierrawireless.com/mangOH/leaf/mangOH-yellow.json

You only have to do that once, and future releases that we post there will automatically become available to you and appear when you search for mangOH packages.

To "search" for the latest mangOH leaf packages:

$ leaf search -t mangOH
┌──────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────────┐
│                                                             2 packages - Filter: only master and +mangOH                                                             │
├────────────────────────────┬──────────────────────────────────────────────────────────────────────────────────────────┬──────────────────────────────────────────────┤
│         Identifier         │                                       Description                                        │                     Tags                     │
╞════════════════════════════╪══════════════════════════════════════════════════════════════════════════════════════════╪══════════════════════════════════════════════╡
│ mangOH-yellow-wp77xx_0.2.3 │ SDK for mangOH yellow with wp77xx, based on Legato version 19.07.0 and wp77xx release 12 │ installed,mangOH,yellow,wp77xx,Octave        │
│ mangOH-yellow-wp77xx_0.3.0 │ SDK for mangOH yellow with wp77xx, based on Legato version 19.10.0 and wp77xx release 12 │ latest,installed,mangOH,yellow,wp77xx,Octave │
└────────────────────────────┴──────────────────────────────────────────────────────────────────────────────────────────┴──────────────────────────────────────────────┘

To set up the current directory as a workspace for mangOH yellow development:

  1. Make it a leaf workspace, configured with the mangOH Yellow development package:

    $ leaf setup -p mangOH-yellow-wp77xx_0.2.3

  2. Clone the mangOH source code into it:

    $ git clone --recursive https://github.com/mangOH/mangOH

  3. Download a copy of the Bosch Bsec library (which is needed by the environmental sensor app) and unpack it under mangOH/components/boschBsec:

    $ cd mangOH/components/boschBsec

    $ wget https://community.bosch-sensortec.com/varuj77995/attachments/varuj77995/bst_community-mems-forum/44/1/BSEC_1.4.7.2_GCC_CortexA7_20190225.zip

    $ unzip BSEC_1.4.7.2_GCC_CortexA7_20190225.zip

Now you've got everything you need onto your PC, but before you run the build, you need to set up your shell environment correctly. You can do this by entering the leaf shell:

$ leaf shell

This will automatically configure your shell to know where your Legato, toolchain, etc. are all located.

Now you're ready to build. Change directory to the root of the mangOH directory and run

$ make yellow

...Or, to build without the apps that provide support for Sierra Wireless Octave(tm), set the OCTAVE environment variable to 0 when building.

$ OCTAVE=0 make yellow

The built file will appear under build/update_files. It will have a name like yellow.wp77xx.update. To install it onto the mangOH's WP module via ssh over USB, use Legato's update tool. E.g.,

$ update build/update_files/yellow.wp77xx.update