{"id":469,"date":"2017-04-20T21:26:55","date_gmt":"2017-04-20T19:26:55","guid":{"rendered":"http:\/\/systev.com\/?p=469"},"modified":"2019-06-09T20:06:14","modified_gmt":"2019-06-09T18:06:14","slug":"starting-with-a-mangoh-green-board","status":"publish","type":"post","link":"https:\/\/systev.com\/starting-with-a-mangoh-green-board\/","title":{"rendered":"Starting with a mangOH Green board"},"content":{"rendered":"<p>This post explains how to start using a <em>mangOH Green<\/em> board, and to connect it to <em>Sierra Wireless AirVantage<\/em>. Some knowledge of Linux OS is required.<\/p>\n<p>mangOH, Legato and AirVantage documentation is good, so I won&#8217;t provide all details. My aim is more to provide a broad view, so that you know how to use the existing documentation.<!--more--><\/p>\n<h2>Reference material<\/h2>\n<ul>\n<li><a href=\"http:\/\/mangoh.io\" target=\"_blank\" rel=\"noopener noreferrer\"><em>mangOH<\/em> website<\/a><\/li>\n<li><a href=\"http:\/\/mangoh.io\/docs\/4118902%20mangOH%20Green%20%28DV4%29%20User%20Guide%20v1.pdf\" target=\"_blank\" rel=\"noopener noreferrer\"><em>mangOH Green<\/em> User Guide<\/a><\/li>\n<li><a href=\"http:\/\/mangoh.io\/docs\/4118903%20mangOH%20Green%20%28DV4%29%20Developer%27s%20Guide%20v1.pdf\" target=\"_blank\" rel=\"noopener noreferrer\"><em>mangOH Green<\/em> Developer Guide<\/a><\/li>\n<li><a href=\"http:\/\/legato.io\/\" target=\"_blank\" rel=\"noopener noreferrer\"><em>Legato<\/em> website<\/a><\/li>\n<li><a href=\"http:\/\/legato.io\/legato-docs\/latest\/\" target=\"_blank\" rel=\"noopener noreferrer\"><em>Legato<\/em> documentation<\/a><\/li>\n<li><a href=\"http:\/\/forum.legato.io\/\" target=\"_blank\" rel=\"noopener noreferrer\"><em>Legato<\/em> forum<\/a><\/li>\n<li><a href=\"https:\/\/source.sierrawireless.com\/resources\/airprime\/software\/developer-studio-installinstructions\/\" target=\"_blank\" rel=\"noopener noreferrer\"><em>Developer Studio 5<\/em> Install Instructions<\/a><\/li>\n<\/ul>\n<h2>Getting started<\/h2>\n<h3>Board setup<\/h3>\n<p>The mangOH Green board I use is equipped with a WP8548 module.<\/p>\n<p>Following instructions from <em><a href=\"http:\/\/mangoh.io\/docs\/4118961_LinDS%20mangOH%20Green%20Fundamentals_r4.pdf\" target=\"_blank\" rel=\"noopener noreferrer\">mangOH Fundamentals guide<\/a>:<\/em><\/p>\n<ul>\n<li>insert the SIM card<\/li>\n<li>connect the GNSS antenna and the cellular network antenna<\/li>\n<\/ul>\n<p>[a few words about <em>GNSS<\/em> acronym: it means <em>Global Navigation Satellite System,<\/em> and refers to any satellite-based system providing location information through a receiving device. <em>GPS<\/em> is one GNSS system. <em>GLONASS, Beidou, Galileo<\/em> are other GNSS systems.]<\/p>\n<ul>\n<li>set the power select jumper to select DC power<\/li>\n<li>connect the board to the computer using the micro-USB cable<\/li>\n<li>connect the power adapter<\/li>\n<\/ul>\n<h3>Legato Development Environment installation<\/h3>\n<p>The computer I use runs <em><a href=\"https:\/\/linuxmint.com\/\" target=\"_blank\" rel=\"noopener noreferrer\">Linux Mint<\/a> 18.1<\/em>, based on <em>Ubuntu 16.04<\/em>. More precisely, this computer is a <a href=\"https:\/\/www.virtualbox.org\/\" target=\"_blank\" rel=\"noopener noreferrer\">VirtualBox<\/a> virtual machine that I run on my <em>MacBook Pro<\/em>.<\/p>\n<ul>\n<li>download <em>Legato Application Development Kit<\/em> (also named <em>Legato Development Environment) 16.10.1<\/em> for Linux 64 bits from this <a href=\"https:\/\/source.sierrawireless.com\/resources\/airprime\/software\/legato_application_development_kit_linux\/\" target=\"_blank\" rel=\"noopener noreferrer\">page<\/a><\/li>\n<li>while downloading, install required Linux packages. For Linux Mint, I have to install <em>build-essential, python-jinja2,<\/em> <em>ninja-build, lib32z1<\/em> and<em> lib32ncurses5<br \/>\n<\/em><\/li>\n<li>unzip the archive file<\/li>\n<li>finish installing Legato by running following command from Legato directory:<\/li>\n<\/ul>\n<pre>.\/legato-spm --installed --update-link<\/pre>\n<p>Legato Development Environment results from the assembly of two main components: Developer Studio, the Eclipse-based IDE (Integrated Development Environment), and Legato, the application framework.<\/p>\n<p>Start Legato Development Environment, enter information requested by the startup wizard.<\/p>\n<p>After a while, Developer studio will display a message about an available update, for Developer Studio 5.1. Install it.<\/p>\n<h3>First connectivity test<\/h3>\n<p>The mangOH board being connected to the computer with the USB cable, a new network interface (Ethernet over USB) is available. Its IP address is set to 192.168.2.3 while the mangOH IP address is 192.168.2.2.<\/p>\n<p><strong>Note<\/strong>: depending on your Linux configuration, it could happen that the network interface is created, but no IP address is assigned to it. You will realize that you are facing this problem if you can&#8217;t SSH into the board, as directed below. To correct this:<\/p>\n<ul>\n<li>find which network interface was created, thanks to the <em>ifconfig<\/em> command:<\/li>\n<\/ul>\n<pre>$ ifconfig\nenp0s3\u00a0\u00a0\u00a0 Link encap:Ethernet\u00a0 HWaddr 08:00:27:67:ab:ea \u00a0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 inet addr:10.0.2.15\u00a0 Bcast:10.0.2.255\u00a0 Mask:255.255.255.0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 inet6 addr: fe80::ef54:6da4:3b59:206e\/64 Scope:Link\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 UP BROADCAST RUNNING MULTICAST\u00a0 MTU:1500\u00a0 Metric:1\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 RX packets:2739635 errors:0 dropped:0 overruns:0 frame:0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 TX packets:1313190 errors:0 dropped:0 overruns:0 carrier:0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 collisions:0 txqueuelen:1000 \n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 RX bytes:2246513691 (2.2 GB)\u00a0 TX bytes:89647536 (89.6 MB)\n\nenp0s12u2i19 Link encap:Ethernet\u00a0 HWaddr 1e:86:2e:4b:33:68\u00a0 \n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 UP BROADCAST RUNNING MULTICAST\u00a0 MTU:1500\u00a0 Metric:1\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 RX packets:44 errors:0 dropped:0 overruns:0 frame:0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 TX packets:62 errors:0 dropped:0 overruns:0 carrier:0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 collisions:0 txqueuelen:1000 \n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 RX bytes:11086 (11.0 KB)\u00a0 TX bytes:8635 (8.6 KB)\n\nlo\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 Link encap:Local Loopback \u00a0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 inet addr:127.0.0.1\u00a0 Mask:255.0.0.0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 inet6 addr: ::1\/128 Scope:Host\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 UP LOOPBACK RUNNING\u00a0 MTU:65536\u00a0 Metric:1\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 RX packets:24365 errors:0 dropped:0 overruns:0 frame:0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 TX packets:24365 errors:0 dropped:0 overruns:0 carrier:0\n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 collisions:0 txqueuelen:1 \n\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 RX bytes:9628143 (9.6 MB)\u00a0 TX bytes:9628143 (9.6 MB)<\/pre>\n<p>First network interface is the one that allows my virtual machine to communicate with the host machine. Last network interface is the loopback interface, always present. The second network interface is the one in trouble.<\/p>\n<ul>\n<li>assign the right IP address to it:<\/li>\n<\/ul>\n<pre>sudo ifconfig enp0s12u2i19 192.168.2.3 netmask 255.255.255.0<\/pre>\n<p>Open an SSH session with the board, using <tt>root<\/tt> username. There is no password by default, but you are advised either to define one, or to define keys. I choose the password method.<\/p>\n<p>Follow instructions from section 6 of <em><a href=\"http:\/\/mangoh.io\/docs\/4118961_LinDS%20mangOH%20Green%20Fundamentals_r4.pdf\" target=\"_blank\" rel=\"noopener noreferrer\">mangOH Fundamentals guide<\/a>,<\/em> to connect to a mobile network and test a data connection.<\/p>\n<h3>Connecting to AirVantage cloud platform<\/h3>\n<p>Follow instructions from section 7 of <em><a href=\"http:\/\/mangoh.io\/docs\/4118961_LinDS%20mangOH%20Green%20Fundamentals_r4.pdf\" target=\"_blank\" rel=\"noopener noreferrer\">mangOH Fundamentals guide<\/a>,<\/em> to connect to AirVantage, the Sierra Wireless cloud platform.<\/p>\n<h2>Coding with Legato<\/h2>\n<h3>First application: send an SMS with current location<\/h3>\n<p>We will start from an existing sample, provided by Legato Development Environment, that sends an SMS containing mangOH board location:<\/p>\n<ul>\n<li>in the IDE, select <strong>File \/ New \/ Legato Application<\/strong><\/li>\n<li>enter <tt>testLocSms<\/tt> (for instance) for <strong>Project name<\/strong> and click on <strong>Next &gt;<\/strong> button<\/li>\n<li>on next window page, target platform configuration should be valid, so click again on <strong>Next &gt;<\/strong> button<\/li>\n<li>in the list of samples, tick <strong>textLoc<\/strong> and click on <strong>Next &gt;<\/strong> button<\/li>\n<li>in last page, click on <strong>Finish<\/strong> button<\/li>\n<li>in the <strong>Project Explorer<\/strong> view, double-click on <tt>testLocSms.adef<\/tt> file, in order to display its contents<\/li>\n<li>set <tt>DEST_CELL_NO<\/tt> to your mobile phone number (using the international format, with + sign and country code)<\/li>\n<li>save the file (with CTRL+S for instance)<\/li>\n<li>build the project: <strong>Project \/ Build Project<\/strong><\/li>\n<li>switch to device perspective: <strong>Window \/ Perspective \/ Open Perspective \/ Device<\/strong> (if <strong>Device<\/strong> is not displayed, look for it via <strong>Other&#8230;<\/strong>)<\/li>\n<li>in the <strong>Applications<\/strong> view, click on the <strong>Install Application<\/strong> icon:<\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-485 size-full\" src=\"http:\/\/systev.com\/wp-content\/uploads\/2017\/04\/legatodeInstallApp01.png\" alt=\"\" width=\"740\" height=\"389\" srcset=\"https:\/\/systev.com\/wp-content\/uploads\/2017\/04\/legatodeInstallApp01.png 740w, https:\/\/systev.com\/wp-content\/uploads\/2017\/04\/legatodeInstallApp01-300x158.png 300w\" sizes=\"(max-width: 706px) 89vw, (max-width: 767px) 82vw, 740px\" \/><\/p>\n<ul>\n<li>choose the <tt>testlocSms.wp750x.update<\/tt> file from the workspace and click on the <strong>OK<\/strong> button<\/li>\n<li>the application is loaded in the WP module and started<\/li>\n<li>after a short while, my mobile phone receives an SMS containing my current location<\/li>\n<\/ul>\n<h3>Second application: Legato and AirVantage<\/h3>\n<p>The second application is borrowed from the <a href=\"http:\/\/legato.io\/legato-docs\/latest\/howToAirVantageExchangeData.html\" target=\"_blank\" rel=\"noopener noreferrer\"><em>Exchange Data<\/em> sample application<\/a>. I follow these steps:<\/p>\n<ul>\n<li>download the <a href=\"https:\/\/github.com\/nhonchu\/LegatoAssetData\" target=\"_blank\" rel=\"noopener noreferrer\">sample code from GitHub<\/a><\/li>\n<li>create an new Legato application project, named <tt>assetDataTutorial<\/tt><\/li>\n<li>modify project files names and contents in accordance with downloaded sample code. You will get some errors in file <tt>assetDataMain.c<\/tt><\/li>\n<li>build the project. This step should remove above errors<\/li>\n<li>login to the AirVantage portal<\/li>\n<li>go to <strong>Develop \/ My Apps<\/strong><\/li>\n<li>click on the <strong>Release<\/strong> button:<\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-493 size-full\" src=\"http:\/\/systev.com\/wp-content\/uploads\/2017\/04\/airVantageRelease01.png\" alt=\"\" width=\"876\" height=\"462\" srcset=\"https:\/\/systev.com\/wp-content\/uploads\/2017\/04\/airVantageRelease01.png 876w, https:\/\/systev.com\/wp-content\/uploads\/2017\/04\/airVantageRelease01-300x158.png 300w, https:\/\/systev.com\/wp-content\/uploads\/2017\/04\/airVantageRelease01-768x405.png 768w\" sizes=\"(max-width: 767px) 89vw, (max-width: 1000px) 54vw, (max-width: 1071px) 543px, 580px\" \/><\/p>\n<ul>\n<li>select the file <tt>assetDataTutorial.zip<\/tt> which can be found in the <tt>Target_Legato_Debug<\/tt> directory. In <strong>Advance settings<\/strong>, tick <strong>I want to publish my application after releasing it<\/strong><\/li>\n<li>click on <strong>Start<\/strong> button<\/li>\n<li>then go to <strong>Inventory \/ Systems<\/strong><\/li>\n<li>select mangOH board, and click on the <strong>Edit<\/strong> icon:<\/li>\n<\/ul>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-494 size-full\" src=\"http:\/\/systev.com\/wp-content\/uploads\/2017\/04\/airVantageEdit01.png\" alt=\"\" width=\"401\" height=\"128\" srcset=\"https:\/\/systev.com\/wp-content\/uploads\/2017\/04\/airVantageEdit01.png 401w, https:\/\/systev.com\/wp-content\/uploads\/2017\/04\/airVantageEdit01-300x96.png 300w\" sizes=\"(max-width: 401px) 100vw, 401px\" \/><\/p>\n<ul>\n<li>using the <strong>Applications<\/strong> field, assign the <tt>assetDataTutorial<\/tt> application to the board. Click on <strong>Save<\/strong> button<\/li>\n<li>let&#8217;s go back to Legato Development Environment: load the application into the board, and start it<\/li>\n<li>the <strong>Logs<\/strong> view should display trace messages similar to these ones:<\/li>\n<\/ul>\n<pre>Apr 23 17:48:05 | assetDataTutorial[12878]\/componentAssetData T=main | assetDataMain.c updateTemperature() 127 | Legato AssetData: update, bedroom temperature is 30.199997 \u00b0C\nApr 23 17:48:05 | assetDataTutorial[12878]\/framework T=main | le_avdata_client.c le_avdata_SetFloat() 1091 | Sending message to server and waiting for response : 27 bytes sent\nApr 23 17:48:05 | assetDataTutorial[12878]\/componentAssetData T=main | assetDataMain.c updateTemperature() 127 | Legato AssetData: update, living-room temperature is 30.000000 \u00b0C\nApr 23 17:48:05 | assetDataTutorial[12878]\/framework T=main | le_avdata_client.c le_avdata_SetFloat() 1091 | Sending message to server and waiting for response : 27 bytes sent<\/pre>\n<p>One way to display data received by AirVantage is to got to <strong>Monitor \/ Systems<\/strong>, then to click on mangOH board. In the <strong>System Applications<\/strong> rectangle, click on <tt>assetDataTutorial<\/tt>. Then click on <tt>Room<\/tt> and select <tt>bedroom<\/tt> for instance. Click on the clock icon to the right of temperature. You get a chart similar to this one:<\/p>\n<p><img loading=\"lazy\" decoding=\"async\" class=\"aligncenter wp-image-495 size-full\" src=\"http:\/\/systev.com\/wp-content\/uploads\/2017\/04\/airVantageChart01.png\" alt=\"\" width=\"600\" height=\"333\" srcset=\"https:\/\/systev.com\/wp-content\/uploads\/2017\/04\/airVantageChart01.png 600w, https:\/\/systev.com\/wp-content\/uploads\/2017\/04\/airVantageChart01-300x167.png 300w\" sizes=\"(max-width: 600px) 100vw, 600px\" \/><\/p>\n","protected":false},"excerpt":{"rendered":"<p>This post explains how to start using a mangOH Green board, and to connect it to Sierra Wireless AirVantage. Some knowledge of Linux OS is required. mangOH, Legato and AirVantage documentation is good, so I won&#8217;t provide all details. My aim is more to provide a broad view, so that you know how to use &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/systev.com\/starting-with-a-mangoh-green-board\/\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;Starting with a mangOH Green board&#8221;<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":426,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[2],"tags":[],"_links":{"self":[{"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/posts\/469"}],"collection":[{"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/comments?post=469"}],"version-history":[{"count":27,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/posts\/469\/revisions"}],"predecessor-version":[{"id":945,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/posts\/469\/revisions\/945"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/media\/426"}],"wp:attachment":[{"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/media?parent=469"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/categories?post=469"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/tags?post=469"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}