Sierra Wireless mangOH Red Getting Started Download Page 1

Page: 1 / 59

mangOH™ Red

Getting Started—

Windows VM + CLI

41110479

Rev 3

Contents subject to change

Summary of Contents for mangOH Red

Page 1: ...mangOH Red Getting Started WPx5xx Windows VM CLI 41110479 Rev 3 Contents subject to change...

Page 2: ...UNITIVE OR EXEMPLARY DAMAGES INCLUDING BUT NOT LIMITED TO LOSS OF PROFITS OR REVENUE OR ANTICIPATED PROFITS OR REVENUE ARISING OUT OF THE USE OR INABILITY TO USE ANY SIERRA WIRELESS PRODUCT EVEN IF SI...

Page 3: ...Rev 3 9 21 17 3 41110479 Revision History Revision number Release date Changes 1 August 2017 Document created...

Page 4: ...n Development Image 15 Prepare Your mangOH Red For Development 20 Build and Install Legato Platform and mangOH Red Platform on Target 20 Connect To Mobile Networks 25 Connect To a Mobile Network 25 Co...

Page 5: ...x Terminal program 48 Useful commands for this tutorial and more 49 Definitions 50 VirtualBox Tips 51 Modifying resources 51 Enable virtualization on a Windows computer 51 Hardware Tips 53 Dipswitch S...

Page 6: ...m suggested requirements in Table 1 1 on page 7 for mangOH Red application development Important Use this guide only if you are using a Windows computer dev elopment machine This guide includes instru...

Page 7: ...ct to the IoT Cloud on page 29 Things to check out after you finish the steps above Develop and Test applications on page 37 Update Legato Application Framework on page 45 Tips on page 48 Hardware Tip...

Page 8: ...in a terminal window These commands are shown like this ping 192 168 2 2 cd CF3 module default credentials and IP address used to connect to the target from the dev machine USB ECM IP address 192 168...

Page 9: ...rtant Do not start connecting components until told to in the instructions otherwise you may encounter problems later in the guide Connect CF3 USB port on bottom side of board Optionally connect CONSO...

Page 10: ...en the downloads folder 5 Run double click GenericDriverSetup exe and follow the prompts to install the drivers 3 1 1 Install PuTTY terminal emulator You need a terminal emulator to establish SSH conn...

Page 11: ...the mangOH Red You can use the Sierra Wireless micro SIM that is included in the kit or another micro SIM that has been activated by a mobile network provider Note If you do not have an activated micr...

Page 12: ...he mangOH Red to a mobile network in Connect To Mobile Networks on page 25 Tip If you have trouble connecting an antenna make sure it is positioned directly on the connector and push straight down The...

Page 13: ...a either USB connector CF3 USB or CONSOLE USB depending on the jumper position on the power header If an AC adapter is connected to CF3 USB SSH AT connections are not possible if it is connected to CO...

Page 14: ...Internet access because the module is not connected to a mobile network c Open a Windows terminal window press Win R or Start Run then enter cmd and press Enter d Test the connection by pinging the CF...

Page 15: ...running the downloaded file VirtualBox opens automatically when it finishes installing 4 1 2 Download Legato Application Development Image The guest OS on the VM image provided for mangOH Red is 64 bi...

Page 16: ...e b Browse to the local folder where you downloaded the VM image for example mangOH Legato 17_06 Ubuntu 16_04 ova select the file and click Open c Click Next VirtualBox opens and displays the Import V...

Page 17: ...Make sure the Legato VM is set up to use the Internet connection a In the VirtualBox window click Settings The Settings window appears b Select Network c Select Adapter 1 d Click Advanced e Select Cab...

Page 18: ...gs window appears b Select System c Try to select Acceleration If Acceleration cannot be selected grayed out i You must enable virtualization in your computer s BIOS See C 6 Enable virtualization on a...

Page 19: ...n is not available on your system you must enable virtualization in your computer s BIOS See C 6 Enable virtualization on a Windows computer on page 51 for details If the image doesn t load properly t...

Page 20: ...ng i In the Devices section click AirPrime ii Click WP series iii Click your module type iv In the Software download section click Firmware to display the list of available firmware packages v If you...

Page 21: ...cm info iv Disconnect from the mangOH Red exit 2 In the VM open a terminal window and then build the Legato Application Framework AF cd legato_framework legato make clean Optional step to remove clut...

Page 22: ...ure you have the latest versions of the files using the following git version control system commands a Get the latest files git pull b Update the git configuration with any new submodules added recen...

Page 23: ...ectly a Connect to the mangOH Red ssh root 192 168 2 2 b Show the list of installed apps to confirm the build and install succeeded app status If the following apps appear in the list the build and in...

Page 24: ...arget Rev 3 9 21 17 24 41110479 c Disconnect from the mangOH Red exit Now that the mangOH Red platform is installed you will learn how to Connect To Mobile Networks on page 25 If gpioExpanderServiceRe...

Page 25: ...unplug the micro USB cable that is providing power b Insert a micro SIM in the slot on the bottom side of the mangOH Red You can use the Sierra Wireless micro SIM that is included in the kit or anoth...

Page 26: ...own above Important Typically your module will register on a network in 1 minute However the very first time your CF3 module and Sierra SIM are used registration may take from 5 20 minutes Note The Ho...

Page 27: ...n the following command cm data apn your_apn If you do not know the APN for your SIM i Search the Internet for the APN for your Home Network Operator that you showed in Step 5 for example search for R...

Page 28: ...rk and the SIM is installed and configured with the correct APN You are now ready to transmit data to the IoT cloud In the next section Connect to the IoT Cloud on page 29 you will set up your free ac...

Page 29: ...n Platform for your CF3 module This platform provides Sierra Wireless cloud based services for over the air OTA device management and application enablement These services provide the infrastructure f...

Page 30: ...name your name etc Phone number Use international format for example for North American phone numbers use 001 plus the 10 digit area code and phone number 3 Review the Terms of Service and select I ag...

Page 31: ...assword is acceptable the AirVantage Login screen appears 8 Enter your account s email address and password and click Log In 9 If you did not record your device s FSN and IMEI earlier in Build and Ins...

Page 32: ...ction at the bottom of the screen 12 Now that your device is registered click the monitor icon at the right side of your device entry or click Monitor at the top of the screen and select Systems to go...

Page 33: ...m that you installed earlier includes an application that reports sensor data from your mangOH Red to the IoT cloud Start the application to send data to AirVantage and confirm that it started running...

Page 34: ...st Communication section shows your Registration connection or sensor data whichever was most recently received System Info Information about the CF3 module in your mangOH board Last Communication Sho...

Page 35: ...confirm the app has stopped app stop redSensorToCloud app status Note redSensorToCloud automatically closes the data connection so you do not need to use cm data connect 1 Timeline has sorting option...

Page 36: ...ted your device to AirVantage and completed the mangOH Red Getting Started tutorial For more information on the mangOH platform visit mangoh io To begin developing simple applications or modifying exi...

Page 37: ...erminal window do the following 1 Configure the window cfglegato Note You will be updating application source code in this section Use whichever editor you prefer these instructions do not refer to a...

Page 38: ...SensorToCloud 4 The source code components for this application are in two sub folders avPublisherComponent and sensorsComponent The code that controls the publishing frequency is in avPublisherCompon...

Page 39: ...t To rebuild mangOH Red platform including redSensorToCloud with your changes and install it onto your mangOH Red 6 Build and install the mangOH Red platform cd MANGOH_ROOT make red_wp85 7 Verify that...

Page 40: ...our AirVantage account you will start to see sensor reports appearing on your new schedule on the Timeline screen you can compare the timestamp intervals for new reports compared to reports received b...

Page 41: ...en you installed Legato sample application files were also stored In this section you will build and then install the hello world application on the target Build compile an application on the dev mach...

Page 42: ...when a message from hello world appears logread f grep Hello 2 Run the application a Open a terminal window to run the application referred to as APP_TERM in this procedure Note This make command uses...

Page 43: ...as built to run automatically when you write your own applications you can make them install without running if you prefer d Stop the application so you can restart it and see the output app stop hell...

Page 44: ...e LOG_TERM terminal window press Ctrl C to return to the command prompt You have now successfully compiled a working application and installed stopped and run it on the module Note To learn more about...

Page 45: ...v machine using the procedure below B 1 Update the Legato AF on Your Dev Machine To update the Legato AF in the VM on your dev machine 1 Open a terminal window 2 Configure your environment for develop...

Page 46: ...at you can restore the current framework if necessary at a later point replace version with your current Legato AF version in the following command mv legato legato_ version ii Download the framework...

Page 47: ...AF on Your Dev Machine Rev 3 9 21 17 47 41110479 6 Build and install the Legato AF cd legato make clean Optional step to remove clutter from previous builds make wp85 Build the framework cfglegato Se...

Page 48: ...erminal program Ubuntu includes a terminal emulator which is labeled as Terminal in the desktop environment The emulator allows you to execute command line programs that interact with the Legato frame...

Page 49: ...in use cm data apn yourAPN Set the APN for your profile to the APN from your SIM provider cm data connect Start a data connection cm data connect timeout Start a data connection keep trying for up to...

Page 50: ...root admin privileges Legato Application Framework AF Collection of daemons Supervisor Config tree service directory etc liblegato and tools that provide a framework for developing and installing app...

Page 51: ...he CPU and RAM settings to fine tune its performance if necessary To adjust the CPU or RAM value 1 Double click the value 2 Type your new value and press Enter C 6 Enable virtualization on a Windows c...

Page 52: ...ng to refine your results Windows 10 See http acer custhelp com app answers detail a_id 37064 windows 10 3A access the uefi bios for details You can also search online for windows 10 bios access for t...

Page 53: ...en combined with LowPower_RESET indicates that board is in HL mode Off Default When combined with LowPower_RESET indicates that board is in WP mode 5 BATT_TS On Default Enable backup battery charging...

Page 54: ...s 1 Use a micro USB cable to connect the mangOH Red s CONSOLE USB port to a USB port on the dev machine 2 Open a terminal window connected to the target s Linux console as follows a Open Windows Devic...

Page 55: ...e next step Example If you open the console terminal window before you connect power to the mangOH Red you will see the messages that are generated during the module boot process Note Only one console...

Page 56: ...1 Remove the module cover using the module cover removal tool Starting at one corner insert the tool in the pair of holes and carefully pry the cover away from the module 2 Repeat at the other locati...

Page 57: ...triangles on the module and socket The module will drop straight into the socket Position matters 2 Hold the module cover over the module and line up the circle on the cover with the triangle on the l...

Page 58: ...e environment variables used for Legato development cm Refer to http legato io legato docs latest toolsTarget_cm html for more details and command options cm data Display current connection status det...

Page 59: ...85 modules wp750x Build for wp750x modules red_wp85 Build for wp85 modules used in mangOH Red boards green_wp85 Build for wp85 modules used in mangOH Green boards make clean Remove build artifacts clu...

Search results

Summary of Contents for mangOH Red

Reviews:

Related manuals for mangOH Red

Brands by name

Popular brands

Sierra Wireless mangOH Red, Getting Started

Search results

Summary of Contents for mangOH Red

Reviews:

Related manuals for mangOH Red

Brands by name

Popular brands