background image

Rev 3  9/21/17

25

41110479

6

6: Connect To Mobile Networks

In this chapter, you will learn how to connect the mangOH Red to a mobile network. When the mangOH_Red has 
a data connection, you can transmit data, including on-board sensor readings, to the IoT cloud.

6.1 Connect To a Mobile Network

To connect to a mobile network, you must have an activated micro-SIM in the mangOH Red.

1.

If you do not have a micro-SIM in the mangOH Red, insert one before continuing:

a.

Disconnect the power from the mangOH Red (remove the jumper from the power header, or 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 another micro-SIM that has been activated by a mobile network 
provider.

c.

Reconnect the power (plug in the micro-USB cable or insert the jumper on the power header on the same 
pins it was removed from in 

step a

. The Power LED will light immediately.

2.

Connect to the target:

a.

On the dev machine, open a terminal window.

b.

Connect to the target:

$ ssh [email protected]

Note:

You must disconnect the power before switching SIMs so the mangOH_Red can detect the SIM 

while powering on.

Note the location of the notched corner.

Inserted in bottom part of slot

Содержание mangOH Red

Страница 1: ...mangOH Red Getting Started WPx5xx Windows VM CLI 41110479 Rev 3 Contents subject to change...

Страница 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...

Страница 3: ...Rev 3 9 21 17 3 41110479 Revision History Revision number Release date Changes 1 August 2017 Document created...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Страница 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...

Отзывы: