{"id":701,"date":"2018-05-12T11:35:14","date_gmt":"2018-05-12T09:35:14","guid":{"rendered":"http:\/\/systev.com\/?p=701"},"modified":"2019-06-09T20:04:17","modified_gmt":"2019-06-09T18:04:17","slug":"mangoh-red-using-a-linux-mint-vm-for-development","status":"publish","type":"post","link":"https:\/\/systev.com\/mangoh-red-using-a-linux-mint-vm-for-development\/","title":{"rendered":"mangOH Red: using a Linux Mint VM for development"},"content":{"rendered":"<p><strong>Updated: 13-May-2018<\/strong><\/p>\n<h1>Introduction<\/h1>\n<p>To develop for the <a href=\"https:\/\/mangoh.io\/mangoh-red\" target=\"_blank\" rel=\"noopener noreferrer\">mangOH Red board<\/a>, you can use an Ubuntu-based virtual machine, <a href=\"https:\/\/mangoh.io\/mangoh-red-resources-getting-started\" target=\"_blank\" rel=\"noopener noreferrer\">provided by the mangOH team<\/a>. It turns out that I prefer <a href=\"https:\/\/linuxmint.com\/\" target=\"_blank\" rel=\"noopener noreferrer\">Linux Mint<\/a> to Ubuntu, mainly because of the window manager, and I wanted to start trying to understand how the mangOH development environment is structured and works. So I decided to set up my own development VM, based on Linux Mint.<\/p>\n<p>In this article, I describe the various steps I followed to create this VM.<!--more--><\/p>\n<p>The host machine I use is a MacBook running macOS High Sierra, but provided explanations can be easily adapted to a Linux host, or to a Windows host.<\/p>\n<p>You don&#8217;t need to be an expert in Linux nor in virtual machines to perform operations described below, as I tried to provide detailed information. Nevertheless, having a first experience is a good thing. And anyway, if you plan to develop for a mangOH board, you&#8217;ll need this experience \ud83d\ude42<\/p>\n<h1>Creation of the VM<\/h1>\n<ul>\n<li>install <a href=\"https:\/\/www.virtualbox.org\/wiki\/Downloads\" target=\"_blank\" rel=\"noopener noreferrer\">VirtualBox<\/a> and VirtualBox Extension Pack<\/li>\n<li><a href=\"https:\/\/linuxmint.com\/download.php\" target=\"_blank\" rel=\"noopener noreferrer\">download Linux Mint<\/a>. I&#8217;ll use the 18.3 MATE 64-bit version<\/li>\n<li><a href=\"https:\/\/linuxmint.com\/verify.php\" target=\"_blank\" rel=\"noopener noreferrer\">verify downloaded ISO image<\/a>:<\/li>\n<\/ul>\n<pre>shasum -a 256 linuxmint-18.3-mate-64bit.iso\n<\/pre>\n<ul>\n<li>from VirtualBox, create a new VM: click on <strong>New<\/strong>, and specify following characteristics:\n<ul>\n<li><strong>Name<\/strong>: <code>mangoh<\/code> (for instance)<\/li>\n<li><strong>Type<\/strong>: <code>Linux<\/code><\/li>\n<li><strong>Version<\/strong>: <code>Linux 2.6 \/ 3.x \/ 4.x (64-bit)<\/code><\/li>\n<li><strong>Memory size<\/strong>: <code>4096 MB<\/code> (adapt to your host memory)<\/li>\n<li><strong>Hard disk<\/strong>: <code>Create a virtual hard disk now<\/code><\/li>\n<li><strong>Hard disk file type<\/strong>: <code>VDI<\/code><\/li>\n<li><strong>Storage on physical hard disk<\/strong>: <code>Dynamically allocated<\/code><\/li>\n<li><strong>File location and size<\/strong>: keep default value for location or adapt it, use 30 GB for size, or adapt<\/li>\n<\/ul>\n<\/li>\n<li>once the new VM slot is displayed in the list of VMs, select it and click on <strong>Settings<\/strong> then:\n<ul>\n<li>click on <strong>Ports<\/strong> then <strong>USB<\/strong> and select <strong>USB 3.0<\/strong><\/li>\n<li>click on <strong>OK<\/strong> button<\/li>\n<\/ul>\n<\/li>\n<li>now click on <strong>Start<\/strong> then:\n<ul>\n<li>select the Linux Mint ISO file and click on <strong>Start<\/strong> button<\/li>\n<li>close the message windows about keyboard and mouse integration<\/li>\n<li>wait for Linux Mint to boot<\/li>\n<\/ul>\n<\/li>\n<li>in VirtualBox VM menu bar, click on <strong>View<\/strong> and then on <strong>Full-screen Mode<\/strong><\/li>\n<li>in the dialog box that appears, check which key is the <em>host<\/em> key on your host system (on the MacBook, that&#8217;s <code>Left-cmd<\/code>). You can use the <code>host+F<\/code> key combination to switch to\/from full-screen mode. Click on the <strong>Switch<\/strong> button<\/li>\n<li>increase Linux Mint display definition, thanks to <strong>Menu \/ Control Center \/ Displays<\/strong>, selecting <code>1024 x 768<\/code> for instance. This will make the installation process easier<\/li>\n<li>double click on <strong>Linux Mint Install<\/strong> icon and then:\n<ul>\n<li>select language<\/li>\n<li>check <strong>Install third-party software&#8230;<\/strong><\/li>\n<li>keep selected <strong>Erase disk and install Linux Mint<\/strong><\/li>\n<li>accept disk partitioning<\/li>\n<li>select your time zone<\/li>\n<li>select keyboard layout. For my MacBook, that&#8217;s <strong>French \/ French &#8211; French (Macintosh)<\/strong><\/li>\n<li>set <strong>Your name<\/strong> to <code>mangoh<\/code>, keep proposed computer&#8217;s name and username, use <code>mangoh<\/code> for password<\/li>\n<li>accept the restart, at the end of the installation, and press the <code>Enter<\/code> key when requested<\/li>\n<\/ul>\n<\/li>\n<\/ul>\n<h1>Configuration of the VM<\/h1>\n<ul>\n<li>after the reboot, perform a Linux update, by clicking on the Update Manager icon, on the right-hand side of the bottom panel (a white <em>i<\/em> letter on a blue circle in a kind of shield). Select <strong>Let me review sensitive updates<\/strong>. Requested password is the one defined previously (<code>mangoh<\/code>)<\/li>\n<li>from the VirtualBox VM menu, click on <strong>Devices \/ Insert Guest Additions CD image&#8230;<\/strong> and accept to run the application. Password is still the same one<\/li>\n<li>from the VirtualBox VM menu, click on <strong>Devices \/ Shared Clipboard<\/strong> and select <strong>Bidirectional<\/strong><\/li>\n<li>from the VirtualBox VM menu, click on <strong>Devices \/ Shared Folders \/ Shared Folders Settings&#8230;<\/strong> Select a host machine folder (it will be shared with the VM) and provide a name for the associated guest device (<strong>Folder Name<\/strong>), <code>sharedFolder<\/code> for instance. Check <strong>Auto-mount<\/strong> and <strong>Make Permanent<\/strong><\/li>\n<li>start a terminal (<strong>Menu \/ Terminal<\/strong>) and run following command:<\/li>\n<\/ul>\n<pre>sudo adduser mangoh vboxsf\n# This grants you read\/write access to the shared folder\n<\/pre>\n<ul>\n<li>eject the virtual CDROM that have been added to the desktop by the guest additions: right-click on it and select <strong>Eject<\/strong><\/li>\n<li>reboot (<strong>Menu \/ Quit \/ Restart<\/strong>)<\/li>\n<li>start the Package Manager via <strong>Menu \/ Package Manager<\/strong>, and type <code>modemmanager<\/code> in the <strong>Quick filter<\/strong> input field. In the list of packages that is displayed as a result, right-click on <code>modemmanager<\/code> and select <strong>Mark for Complete Removal<\/strong>. Then click on <strong>Apply<\/strong> tool (if modemmanager is not removed, Linux Mint will try to use the mangOH board as a 3G modem)<\/li>\n<li>still from the Package Manager, install emacs (or your preferred text editor) (select for installation and apply)<\/li>\n<li>exit from the Package Manager<\/li>\n<li>right-click on the bottom panel and select <strong>Add to panel&#8230;<\/strong> Click on System Monitor and then on <strong>Add<\/strong> button. Close the Add to Panel window<\/li>\n<li>right-click on the icon that was just added to the panel and select <strong>Preferences<\/strong>. Check <strong>Memory<\/strong> and <strong>Network<\/strong>, and close the window. This applet will provide you with information about processor and memory use, and network traffic, in real-time<\/li>\n<li>in <strong>Menu \/ Control Center \/ Screensaver<\/strong>, uncheck <strong>Lock screen when screensaver is active<\/strong><\/li>\n<\/ul>\n<h1>Installation of the development environment<\/h1>\n<p>The <em><a href=\"http:\/\/mangoh.io\/uploaded-documents\/Reference\/mangOH%20Red\/Discover\/Getting%20Started\/mangOH%20Red%20GSG%20-%20Linux%20R2\/#t=41112261_mangOH_Red_GSG_-_HTML5%2F41112261_Tut_Quick_Start%2F41112261_Tut_Quick_Start.htm\" target=\"_blank\" rel=\"noopener noreferrer\">mangOH Red Getting Started Guide<\/a><\/em> is used as reference. All steps below are to be performed in the VM.<\/p>\n<h2>Dependencies<\/h2>\n<ul>\n<li>install dependencies:<\/li>\n<\/ul>\n<pre>sudo apt-get install -y \\\n    build-essential \\\n    lib32z1 \\\n    lib32ncurses5 \\\n    cmake \\\n    git \\\n    ninja-build \\\n    repo \\\n    python-jinja2 \\\n    python-git \\\n    texinfo \\\n    chrpath \\\n    libxml2-utils \\\n    gcovr \\\n    libcurl4-gnutls-dev \\\n    zlib1g-dev \\\n    libbz2-dev \\\n    bsdiff \\\n    libssl-dev \\\n    dh-autoreconf\n<\/pre>\n<h2>Module firmware and toolchain<\/h2>\n<ul>\n<li>on <a href=\"https:\/\/source.sierrawireless.com\/\" target=\"_blank\" rel=\"noopener noreferrer\">Sierra Wireless Source page<\/a>, in <em>Devices \/ Airprime<\/em> section, select the module inserted in the mangOH Red socket. Mine is a WP8548, and following instructions will refer to it<\/li>\n<li>login (create a Source account, if you don&#8217;t already have one)<\/li>\n<li>in the <em>Software download<\/em> section, click on <em>Firmware<\/em><\/li>\n<li>in the <em>Firmware Update Instructions for Legato CLI users (Linux),<\/em> click on <em>R15 (Generic \u2014 GCF)<\/em>. Download of <code>WPx5xx_Release15_GENERIC_SPK.spk<\/code> file starts<\/li>\n<li>create a folder named <code>WP_Module_Firmware<\/code>, and move the above file to it:<\/li>\n<\/ul>\n<pre>mkdir ~\/WP_Module_Firmware\nmv ~\/Downloads\/WPx5xx_Release15_GENERIC_SPK.spk ~\/WP_Module_Firmware\/\n<\/pre>\n<ul>\n<li>in the <em>Release Content<\/em> section, click on <em>WP8548 &amp; WP75xx Firmware Release 15 Components<\/em><\/li>\n<li>in the <em>Rebuild Linux Distribution<\/em> section, click on <em>64-bit ToolChain<\/em>. Download of toolchain starts. File name is\u00a0<code>poky-swi-ext-glibc-x86_64-meta-toolchain-swi-ext-armv7a-vfp-neon-toolchain-swi-ext-1.7.3.sh<\/code>. Associated Legato Distro Source version, displayed in the section, is <code>SWI9X15Y_07.12.14.00<\/code><\/li>\n<li>install the toolchain, from within the folder where the file has been downloaded:<\/li>\n<\/ul>\n<pre>sudo .\/poky-swi-ext-glibc-x86_64-meta-toolchain-swi-ext-armv7a-vfp-neon-toolchain-swi-ext-1.7.3.sh\n<\/pre>\n<ul>\n<li>when asked for target directory, add the Legato Distro Source version to the name of the default directory. For me, this gives: <code>\/opt\/swi\/y17-ext-SWI9X15Y_07.12.14.00<\/code><\/li>\n<li>create a symbolic link to the above folder for your module. For me:<\/li>\n<\/ul>\n<pre>cd \/opt\/swi\nsudo ln -f -s y17-ext-SWI9X15Y_07.12.14.00 y17-ext-wp85\n<\/pre>\n<ul>\n<li>run kernel build scripts:<\/li>\n<\/ul>\n<pre>export PATH=\/opt\/swi\/y17-ext-wp85\/sysroots\/x86_64-pokysdk-linux\/usr\/bin\/arm-poky-linux-gnueabi:$PATH\ncd \/opt\/swi\/y17-ext-wp85\/sysroots\/armv7a-vfp-neon-poky-linux-gnueabi\/usr\/src\/kernel\/\nsudo chown -R $USER .\nARCH=arm CROSS_COMPILE=arm-poky-linux-gnueabi- make scripts\nsudo chown -R root .\n<\/pre>\n<ul>\n<li>download and install swiflash, the tool that allows to flash images into the WP8548 module:<\/li>\n<\/ul>\n<pre>wget http:\/\/updatesite.sierrawireless.com\/swiflash\/swiflash_latest.deb -O ~\/Downloads\/swiflash_latest.deb\nsudo apt-get install ~\/Downloads\/swiflash_latest.deb\n<\/pre>\n<h2>MangOH development environment<\/h2>\n<p>Proceed as explained <a href=\"http:\/\/mangoh.io\/uploaded-documents\/Reference\/mangOH%20Red\/Discover\/Getting%20Started\/mangOH%20Red%20GSG%20-%20Linux%20R2\/41112261_mangOH_Red_GSG_-_HTML5\/41112261_PrepMangoh\/41112261_PrepMangoh.htm#XREF_22697_Prepare_your\" target=\"_blank\" rel=\"noopener noreferrer\">here<\/a>. For me:<\/p>\n<ul>\n<li>get Legato Application Framework source code:<\/li>\n<\/ul>\n<pre># Set git identity\ngit config --global user.email \"\"\ngit config --global user.name \"\"\n# Install Legato framework\ncd ~\nmkdir legato_framework\ncd legato_framework\nrepo init -u git:\/\/github.com\/legatoproject\/manifest -m \\\n    legato\/releases\/18.04.0\/legato.xml\nrepo sync\n<\/pre>\n<ul>\n<li>get mangOH platform source code:<\/li>\n<\/ul>\n<pre>cd ~\ngit clone --recursive git:\/\/github.com\/mangOH\/mangOH\n<\/pre>\n<ul>\n<li>add following lines to <code>.bashrc<\/code> file:<\/li>\n<\/ul>\n<pre>export LEGATO_ROOT=~\/legato_framework\/legato\nexport WP85_SYSROOT=\/opt\/swi\/y17-ext-wp85\/sysroots\/armv7a-vfp-neon-poky-linux-gnueabi\nalias cfglegato=\"pushd . &amp;&amp; cd ~\/legato_framework\/legato &amp;&amp; source .\/bin\/configlegatoenv ; popd\"\n<\/pre>\n<ul>\n<li>close the terminal, open a new one. Above environment variables are now defined<\/li>\n<li>build Legato Application Framework and mangOH platform for the mangOH Red and WP8548 target:<\/li>\n<\/ul>\n<pre>cd ~\/mangOH\nmake red_wp85\n<\/pre>\n<h1>MangOH board setup<\/h1>\n<p>Proceed as explained <a href=\"http:\/\/mangoh.io\/uploaded-documents\/Reference\/mangOH%20Red\/Discover\/Getting%20Started\/mangOH%20Red%20GSG%20-%20Linux%20R2\/41112261_mangOH_Red_GSG_-_HTML5\/41112261_Tut_SetUp\/41112261_Tut_SetUp.htm#XREF_43758_Set_Up_Your\" target=\"_blank\" rel=\"noopener noreferrer\">here.<\/a> For me:<\/p>\n<ul>\n<li>set following DIP switches to ON: 1, 3, 8. Documentation says that 5 should be set to ON as well, but as it relates to the backup battery and I don&#8217;t have one<\/li>\n<li>ensure the SIM card is inserted in its slot<\/li>\n<li>connect the main antenna and the GNSS antenna<\/li>\n<li>set the Power Header jumper on the pair of pins that are close to the CF3 USB port<\/li>\n<li>connect the CF3 USB port to the development computer, with provided cable<\/li>\n<\/ul>\n<h1>VM configuration for the board<\/h1>\n<ul>\n<li>ensure that the mangOH board is on: the green power LED must be on<\/li>\n<li>ensure that the board is seen by the host OS. On the MacBook, I check that a ping to 192.168.2.2 returns an answer. On Linux, you can also use the lsusb command<\/li>\n<li>on VirtualBox VM menu, click on <strong>Devices \/ USB<\/strong>. The board should be listed as <code>Sierra Wireless, Incorporated WP8548 [0006]<\/code><\/li>\n<li>click on it. This transfers the USB connection management from the host computer to the virtual machine. Make the transfer permanent with <strong>Devices \/ USB \/ USB Settings&#8230;<\/strong>: add an USB device filter for the board &#8211; <em>Note:<\/em> further testing shows that on my MacBook the transfer is not permanent \ud83d\ude41 Consequently, every time the USB connection is reinitialized (typically, when the board reboots), I have to manually reattach the USB device to the VM<\/li>\n<li>ensure that the board is now seen by the VM:<\/li>\n<\/ul>\n<pre>ping 192.168.2.2\n#\n# Reply should be: \n#\n# PING 192.168.2.2 (192.168.2.2) 56(84) bytes of data.\n# 64 bytes from 192.168.2.2: icmp_seq=1 ttl=64 time=1.20 ms\n# ...\n# use CTRL+C to exit from the command\n#\n<\/pre>\n<h1>Board firmware update<\/h1>\n<ul>\n<li>update the board module with the firmware previously downloaded:<\/li>\n<\/ul>\n<pre>cd ~\/WP_Module_Firmware\nswiflash -m WP85XX -i WPx5xx_Release15_GENERIC_SPK.spk\n#\n# Reply should be:\n#\n# Detecting USB of the target\n# DONE\n# Communicating with the target\n# DONE\n# Switching to firmware download mode\n# .......................................DONE\n# Downloading the firmware\n# ....................DONE\n# Rebooting the module\n# ...........DONE\n# Firmware Download SUCCESS\n#\n<\/pre>\n<p>Given the fact that the USB attach is not automatic (see above), I had to manually reattach the board to the VM twice during firmware update: during the switch to firmware download mode, and after module reboot.<\/p>\n<ul>\n<li>connect to the board, and display firmware information:<\/li>\n<\/ul>\n<pre>ssh root@192.168.2.2\n#\n# Replay \"yes\" to the displayed message:\n#\n# The authenticity of host '192.168.2.2 (192.168.2.2)' can't be established.\n# RSA key fingerprint is SHA256:&lt;aString&gt;.\n# Are you sure you want to continue connecting (yes\/no)? yes\n#\n# The above message is displayed at the first connection only.\n#\n# Keep the \"no password\" configuration:\n#\n# Linux swi-mdm9x15 3.14.29ltsi-13c67b16ff_922830eb31 #2 PREEMPT Fri Apr 15 02:38:16 PDT 2016 # armv7l GNU\/Linux\n#\n# It is strongly recommended to setup credentials for remote login.\n# Please select one of the following options:\n#  1) Setup ssh keys and disable passwords-based authentication via ssh\n#     (the most secure)\n#  2) Setup password (better than nothing)\n#  3) Do nothing\n3\n#\n# Would you like a reminder next time you log in [Y\/n]?\n#\n# OK, I will remind you next time.\n#\n# Request firmware information:\n#\ncm info\n#\n# Answer for firmware is:\n# Firmware:   SWI9X15Y_07.12.14.00 r34472 CARMD-EV-FRMWR1 2017\/11\/29 18:24:42\n# Bootloader: SWI9X15Y_07.12.14.00 r34472 CARMD-EV-FRMWR1 2017\/11\/29 18:24:42\n#\n<\/pre>\n<ul>\n<li>install embedded part of mangOH Red platform:<\/li>\n<\/ul>\n<pre>#\n# Define required environment variables and commands:\n#\ncfglegato\n# \n# Install platform:\n#\nupdate ~\/mangOH\/build\/update_files\/red\/mangOH.wp85.update 192.168.2.2\n#\n<\/pre>\n<ul>\n<li>reconnect to the board (<code>ssh...<\/code>), and execute the <code>app status <\/code>command. You should find the <code>redSensorToCloud<\/code> application in the returned list.<\/li>\n<\/ul>\n<p>That&#8217;s it: the development environment is ready.<\/p>\n<p>For more information, you can refer to following documents:<\/p>\n<ul>\n<li><a href=\"https:\/\/mangoh.io\/mangoh-red-resources-getting-started\" target=\"_blank\" rel=\"noopener noreferrer\">mangOH Red Ressources &#8211; Getting Started<\/a><\/li>\n<li><a href=\"https:\/\/legato.io\/legato-docs\/latest\/basicBuild.html\" target=\"_blank\" rel=\"noopener noreferrer\">Install\/Build Legato<\/a><\/li>\n<li><a href=\"https:\/\/source.sierrawireless.com\/\" target=\"_blank\" rel=\"noopener noreferrer\">The Source &#8211; Sierra Wireless<\/a><\/li>\n<\/ul>\n<h1>Limitations<\/h1>\n<ul>\n<li>the MediaTek mt7697 SDK is not installed.<\/li>\n<li><del>Developer Studio is not installed.<\/del> Check <a href=\"http:\/\/systev.com\/mangoh-red-configuring-developer-studio\/\" target=\"_blank\" rel=\"noopener noreferrer\">this article<\/a> to install and configure Developer Studio.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Updated: 13-May-2018 Introduction To develop for the mangOH Red board, you can use an Ubuntu-based virtual machine, provided by the mangOH team. It turns out that I prefer Linux Mint to Ubuntu, mainly because of the window manager, and I wanted to start trying to understand how the mangOH development environment is structured and works. &hellip; <\/p>\n<p class=\"link-more\"><a href=\"https:\/\/systev.com\/mangoh-red-using-a-linux-mint-vm-for-development\/\" class=\"more-link\">Continue reading<span class=\"screen-reader-text\"> &#8220;mangOH Red: using a Linux Mint VM for development&#8221;<\/span><\/a><\/p>\n","protected":false},"author":2,"featured_media":702,"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\/701"}],"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=701"}],"version-history":[{"count":13,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/posts\/701\/revisions"}],"predecessor-version":[{"id":940,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/posts\/701\/revisions\/940"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/media\/702"}],"wp:attachment":[{"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/media?parent=701"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/categories?post=701"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/systev.com\/wp-json\/wp\/v2\/tags?post=701"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}