Build low-power LTE-M IoT applications that can run for up to 10 years on a battery with the newest and smallest mangOH platform and Orange LTE-M network in Europe, and send your IoT sensor data to Orange Live Objects cloud.

• Credit card size form-factor ideal for rapidly building proof-of-concepts;
• A snap-in socket to add any CF3™-compatible modules, including wireless modules (4G & LTE-M/NB-IoT) to achieve up to 10 years of battery life;
• An IoT Expansion Card slot to plug in any technology based on the IoT Expansion Card open standard;
• Works with Orange SIM cards (LTE-M, 2G) for most European countries, and can also be used with any commercially available SIM (LTE-M, 2G);
• Integrates with the Orange Live Objects cloud platform;
• Built-in Wi-Fi b/g/n and Bluetooth 4.2 BLE with a Cortex M4 to provide real-time access to I/O; and
• Built-in Accelerometer/Gyroscope, Pressure and Light sensors and a 26-pin Raspberry Pi-compatible connector.

Please complete SIM registration and activation at Orange and create a Live Objects account and generate an APIKEY, prior to returning to this page and continue with the rest of the getting started process.

STEP 1 – Fast Getting Started (no development skill required)

1.1 Windows driver for Sierra Wireless WP7702 modem

If you’re running a Windows PC, download and install the Windows Driver for WP77 module first.

1.2 Set up your mangOH Red:

• Insert the SIM card into its slot (if not done already)
• plug the ultra wide band antenna into the “main” u.fl connector (round),
• plug the GPS antenna into the “GNSS” u.fl connector (round),
• plug the USB connector into your PC and into the “cf3” micro-USB connector of the mangOH Red.

→ pictures with detailed instructions

1.3 mangOH Virtual Machine

If needed, download and install Virtualbox for your system (or any other compatible alternative).

Then, download and run mangOH Virtual Machine for Orange LTE-M Starter Kit and follow the instructions on the page. Please note that the download can take some time.

Notes: In your virtual machine,

• the default keyboard is English (qwerty). Several French keyboards are pre-configured and can be selected with the icon “en▼” in the top right corner of the screen. Additionnaly, many other keyboards are available in the settings.
• use “mangoh” as the password for your “mangoh” account

1.4 Set up your mangOH Red with the latest LiveObjects sample code application

In the Virtual Machine, open a terminal and enter the following command:

./setup-Orange.sh

This command will download from Github the OrangeStarterKit sample code application, compile it, and install it on your mangOH Red/WP7702.

1.5 Log into LiveObjects

• Connect to your Live Objects account
• Data visualization: select “data” top menu:

• Send a command “hello” that will trigger a data “world” to be sent :

Save to send the command.

For this section of the tutorial, you can either use Linux commands in the terminal or launch the Developer Studio IDE. Start with either 2.1 or jump to 2.2 depending on the development environment you are willing to use.

2.1 Legato Hello World (Unix command line)

Create and deploy your first Legato Hello World application — note: this sample code is also provided in ~/legato_framework/legato/apps/sample/helloWorld.

→ for more information on main Legato concepts, please read: Legato concepts

2.2 Legato Hello World (Developer Studio)

Open the Developer Studio that you’ll find in the left quick access bar of your Virtual Machine.
From the top menu select: Help > Welcome page > Build hello world app
More usefull tutorials and documentation are accessible from this Welcome page.

2.3 OrangeStarterKit sample code

The execution of the “setup” command at step 1.4 has downloaded and installed the following code sample in the home directory:

• mqttClient-for-Legato : MQTT client services
• OrangeStarterKit : Orange LTE-M Starter Kit code sample

Note 1: You can update the MQTT Client service anytime with the following commands:

cd ~/mqttClient-for-Legato
git pull origin master
cd mqttClientApi
make wp77xx
update mqttClient.wp77xx.update 192.168.2.2

Note 2: You can update the OrangeStarterKit code sample anytime with the following commands:

cd ~/OrangeStarterKit
git pull origin master
make wp77xx
update OrangeStarterKit.wp77xx.update 192.168.2.2

The project can also be opened in the Developer Studio at /home/mangoh/OrangeStarterKit (follow the same instructions as for 2.2)

Now that’s your turn: go and modify the code, build and install your changes!

Get support on mangOH Forum (Orange Starter Kit)