Maxis NB-IoT Challenge Workshop - GitHub Pages

Install Azure CLI with aptIf you are running a distribution that comes with apt , such as Ubuntu or Debian,there's an x86 64 package available for the Azure CLI. This package has beentested with and is supported for: Ubuntu trusty, xenial, artful, bionic, and disco Debian wheezy, jessie, and stretch NoteThe package for Azure CLI installs its own Python interpreter, and does not use the systemPython.InstallWe offer two ways to install the Azure CLI with distributions that support apt :As an all-in-one script that runs the install commands for you, and instructionsthat you can run as a step-by-step process on your own.Install with one commandWe offer and maintain a script which runs all of the installation commands inone step. Run it by using curl and pipe directly to bash , or download the scriptto a file and inspect it before running.curl -sL https://aka.ms/InstallAzureCLIDeb sudo bash NoteThis script is only verified for Ubuntu 16.04 and Debian 8 . It may not work on otherdistributions. If you're using a derived distribution such as Linux Mint, follow the manual installinstructions and perform any necessary troubleshooting.

Manual install instructionsIf you don't want to run a script as superuser, follow these manual steps to installthe Azure CLI.1. Get packages needed for the install process:sudo apt-get updatesudo apt-get install curl apt-transport-https lsb-release gnupg2. Download and install the Microsoft signing key:curl -sL https://packages.microsoft.com/keys/microsoft.asc \gpg --dearmor \sudo tee /etc/apt/trusted.gpg.d/microsoft.asc.gpg /dev/null3. Add the Azure CLI software repository:AZ REPO (lsb release -cs)echo "deb [arch amd64] https://packages.microsoft.com/repos/azure-cli/ AZ REPO main" \sudo tee /etc/apt/sources.list.d/azure-cli.list4. Update repository information and install the azure-cli package:sudo apt-get updatesudo apt-get install azure-cliRun the Azure CLI with the az command. To sign in, use the az logincommand.To learn more about different authentication methods, see Sign in with AzureCLI.TroubleshootingHere are some common problems seen when installing with apt . If youexperience a problem not covered here, file an issue on github.

lsb release does not return the correct base distribution versionSome Ubuntu- or Debian-derived distributions such as Linux Mint may not returnthe correct version name from lsb release . This value is used in the installprocess to determine the package to install. If you know the code name of theUbuntu or Debian version your distribution is derived from, you can set theAZ REPO value manually when adding the repository. Otherwise, look upinformation for your distribution on how to determine the base distribution codename and set AZ REPO to the correct value.No package for your distributionSometimes it may be a while after a distribution is released before there's anAzure CLI package available for it. The Azure CLI designed to be resilient withregards to future versions of dependencies and rely on as few of them aspossible. If there's no package available for your base distribution, try a packagefor an earlier distribution.To do this, set the value of AZ REPO manually when adding the repository. ForUbuntu distributions use the bionic repository, and for Debian distributions usestretch . Distributions released before Ubuntu Trusty and Debian Wheezy arenot supported.Proxy blocks connectionIf you're unable to connect to an external resource due to a proxy, make sure thatyou've correctly set the HTTP PROXY and HTTPS PROXY variables in your shell.You will need to contact your system administrator to know what host(s) andport(s) to use for these proxies.These values are respected by many Linux programs, including those which areused in the install process. To set these values:No authexport HTTP PROXY http://[proxy]:[port]export HTTPS PROXY https://[proxy]:[port]

Basic authexport HTTP PROXY http://[username]:[password]@[proxy]:[port]export HTTPS PROXY https://[username]:[password]@[proxy]:[port] NoteIf you are behind a proxy, these shell variables must be set to connect to Azure services with theCLI. If you are not using basic auth, it's recommended to export these variables in your .bashrcfile. Always follow your business' security policies and the requirements of your systemadministrator.You may also want to explicitly configure apt to use this proxy at all times.Make sure that the following lines appear in an apt configuration file in /etc/apt/apt.conf.d/ . We recommend using either your existing globalconfiguration file, an existing proxy configuration file, 40proxies , or 99local ,but follow your system administration requirements.Acquire {http::proxy s::proxy "https://[username]:[password]@[proxy]:[port]";}If your proxy does not use basic auth, remove the [username]:[password]@portion of the proxy URI. If you require more information for proxy configuration,see the official Ubuntu documentation: apt.conf manpage Ubuntu wiki - apt-get howtoIn order to get the Microsoft signing key and get the package from our repository,your proxy needs to allow HTTPS connections to the following address:https://packages.microsoft.com

CLI fails to install or run on Windows Subsystem for LinuxSince Windows Subsystem for Linux (WSL) is a system call translation layer ontop of the Windows platform, you might experience an error when trying to installor run the Azure CLI. The CLI relies on some features that may have a bug inWSL. If you experience an error no matter how you install the CLI, there's a goodchance it's an issue with WSL and not with the CLI install process.To troubleshoot your WSL installation and possibly resolve issues: If you can, run an identical install process on a Linux machine or VM to see ifit succeeds. If it does, your issue is almost certainly related to WSL. To starta Linux VM in Azure, see the create a Linux VM in the Azure Portaldocumentation. Make sure that you're running the latest version of WSL. To get the latestversion, update your Windows 10 installation. Check for any open issues with WSL which might address your problem.Often there will be suggestions on how to work around the problem, orinformation about a release where the issue will be fixed. If there are no existing issues for your problem, file a new issue with WSLand make sure that you include as much information as possible.If you continue to have issues installing or running on WSL, consider installingthe CLI for Windows.UpdateUse apt-get upgrade to update the CLI package.sudo apt-get update && sudo apt-get upgrade

NoteThis command upgrades all of the installed packages on your system that have not had adependency change. To upgrade the CLI only, use apt-get install .sudo apt-get update && sudo apt-get install --only-upgrade -y azure-cliUninstall1. Uninstall with apt-get remove :sudo apt-get remove -y azure-cli2. If you don't plan to reinstall the CLI, remove the Azure CLI repositoryinformation:sudo rm /etc/apt/sources.list.d/azure-cli.list3. Remove the signing key:sudo rm /etc/apt/trusted.gpg.d/microsoft.asc.gpg4. Remove any unneeded packages:sudo apt autoremove ReferencesFor more references, please refer to Microsoft Documentation - Install Azure CLI with aptComments

Install Azure CLI on macOSFor the macOS platform, you can install the Azure CLI with homebrew packagemanager. Homebrew makes it easy to keep your installation of the CLI update todate. The CLI package has been tested on macOS versions 10.9 and later.InstallHomebrew is the easiest way to manage your CLI install. It provides convenientways to install, update, and uninstall. If you don't have homebrew available onyour system, install homebrew before continuing.You can install the CLI by updating your brew repository information, and thenrunning the install command:brew update && brew install azure-cliThe Azure CLI has a dependency on the python3 package in Homebrew, andwill install it on your system, even if Python 2 is available. The Azure CLI isguaranteed to be compatible with the latest version of python3 published onHomebrew.You can then run the Azure CLI with the az command. To sign in, use az logincommand.To learn more about different authentication methods, see Sign in with AzureCLI.TroubleshootingIf you encounter a problem when installing the CLI through Homebrew, here aresome common errors. If you experience a problem not covered here, file an issueon github.

Unable to find Python or installed packagesThere may be a minor version mismatch or other issue during homebrewinstallation. The CLI doesn't use a Python virtual environment, so it relies onfinding the installed Python version. A possible fix is to install and relink thepython3 dependency from Homebrew.brew update && brew install python3 && brew upgrade python3brew link --overwrite python3CLI version 1.x is installedIf an out-of-date version was installed, it could be because of a stale homebrewcache. Follow the update instructions.Proxy blocks connectionYou may be unable to get resources from Homebrew unless you have correctlyconfigured it to use your proxy. Follow the Homebrew proxy configurationinstructions.If you are behind a proxy, HTTP PROXY and HTTPS PROXY must be set toconnect to Azure services with the CLI. If you are not using basic auth, it'srecommended to export these variables in your .bashrc file. Always followyour business' security policies and the requirements of your systemadministrator.In order to get the bottle resources from Homebrew, your proxy needs to allowHTTPS connections to the following addresses: https://formulae.brew.sh https://homebrew.bintray.com

UpdateThe CLI is regularly updated with bug fixes, improvements, new features, andpreview functionality. A new release is available roughly every two weeks. Updateyour local repository information and then upgrade the azure-cli package.brew update && brew upgrade azure-cliUninstallUse homebrew to uninstall the azure-cli package.brew uninstall azure-cliOther installation methodsIf you can't use homebrew to install the Azure CLI in your environment, it'spossible to use the manual instructions for Linux. Note that this process is notofficially maintained to be compatible with macOS. Using a package managersuch as Homebrew is always recommended. Only use the manual installationmethod if you have no other option available.For the manual installation instructions, see Install Azure CLI on Linux manually.Comments

Getting Started with Raspberry PiIn this course, we will be using Raspberry Pi in headless mode (a.k.a nokeyboard, mouse or monitor attached to Raspberry Pi). We will use our personalcomputer to remote access to Raspberry Pi instead. The Raspberry Pi in thisworkshop has prebuild image which has VNC and SSH capability.Getting IP addressFirst of all, we will need IP address of Raspberry Pi. Power up your Raspberry Piwith NB-IoT Hat attached. Then access to website https://maxischallenge.firebaseapp.com/ to obtain your Raspberry Pi Information by referringIMEI from NB-IoT HAT.VNC1. Download VNC Viewer from here. Choose appropriate installer for your PCwhich will remote access to Raspberry Pi.

2. Open VNC Viewer.3. Enter Raspberry Pi IP Address and Press Enter Button.

4. Enter username and password for Raspberry Pi. By default, username is piand password is raspberry .5. Viola! Now you can access to Rasberry Pi remotely.SSH Windowsa. Download Putty software from here.b. Open downloaded Putty.exe.

c. Select SSH and enter your Raspberry Pi IP Address.d. Press Open button to open SSH Terminal.e. When login as appears, enter pi , we are going to login as pi.f. By default the password is raspberry . Mac OS, Linux Run command ssh pi@ youripaddress in local terminal. Enter password raspberry .Comments

Grove Pi with Raspberry PiThis course explains how to use Grove Pi HAT with Rasbperry Pi to interface,control and get data from sensors.The GrovePi can be programmed in Python, C, C#, Go, and NodeJS on theRaspberry Pi. We will be using Python as main language for the course.Install Grove Pi Python (Important) sudo curl -kL dexterindustries.com/update grovepi bash sudo rebootFirmware Update (Important) cd Dexter/GrovePi/Firmware sudo chmod x firmware update.sh sudo bash firmware update.shGetting started with Example DHT Temperature &Humidity SensorSounds familiar? Temperature and humidity are the values that are being sent toAzure Cloud if you are following previous course. Right now we can send thosevalues from actual hardware DHT11 Temperature & Humidity Sensor.

Steps1. Plug the Grove Pi HAT onto Raspberry Pi.2. Plug the DHT11 Sensor (Blue color) to port D4 on GrovePi.3. Create a python script called dht.py.4. Copy the following content into dht.py.#!/usr/bin/env pythonimport grovepi

import mathfrom time import sleep# Connect the Grove Temperature & Humidity Sensor Pro todigital port D4# This example uses the blue colored sensor.# SIG,NC,VCC,GNDsensor 4 # The Sensor goes on digital port 4.# temp humidity sensor type# Grove Base Kit comes with the blue sensor.blue 0# The Blue colored sensor.white 1# The White colored sensor.try:while True:try:# This example uses the blue colored sensor.# The first parameter is the port, the secondparameter is the type of sensor.[temp,humidity] grovepi.dht(sensor,blue)if math.isnan(temp) False andmath.isnan(humidity) False:print("temp %.02f C humidity %.02f%%"%(temp,humidity))sleep(1)except IOError:print ("Error")except KeyboardInterrupt:print ("Pressed Ctrl C. Exiting now.")5. Run command sudo python dht.py to run the program.6. If the setup is correct, we will see temperature and humidity values areshowing up. ImportantWe have discovered that to make the script to run properly, step Install Grove Pi Pythonand Firmware Update must be completed at least once to install proper GrovePi Library.Install GrovePi Library using pip install or pip3 install will cause the script not torun properly.

AlternativeIf the script above does not run nicely as expected, you can consider followingsteps.1. Plug the Grove Pi HAT onto Raspberry Pi.2. Plug the DHT11 Sensor (Blue color) to port D4 on GrovePi.3. Run the command below to run example DHT11 sensor script. cd /home/pi/Dexter/GrovePi/Software/Python sudo python grove dht pro.py ImportantFor this alternative, every time you created a new script, the file grovepi.py must be alongsidewith your created script. The file can be found at the same folder as the file grove dht pro.py .References1. For more examples, you can visit oftware/Python2. For other programming language, you can refer to here oftwareComments

Testing Raspberry Pi SIM7000E NB-IoTHat Maxis NB-IoTNB-IoT AT command testingAT command test is basic step to check if NB-IoT is working in good condition.Prerequisite Raspberry Pi SIM7000E NB-IoT HAT MicroUSB Type B CableSteps1. Insert and lock the NB-IoT SIM card onto NB-IoT HAT (Back). Connect theNB-IoT HAT to Raspberry Pi Board via USB cable.2. Run the command below on Raspberry Pi to check availability of HAT. It willshow /dev/ttyUSB2 if it exists.ls /dev/ttyUSB2

3. Run the command below to install screen utility on Raspberry Pi, whichallows us to communicate to HAT via UART.sudo apt-get install screen4. Run below command to start.screen /dev/ttyUSB2 1152005. Type and enter AT command repeatedly until you see OK in return.6. Run AT commands below to test connection with Internet.- : User input# test using AT- ATOK# check firmware version, make sure it contains SIM7000E- AT GSVSIMCOM LtdSIMCOM SIM7000ERevision:1351B06SIM7000E# check service, result might be different- AT CPSI? CPSI: GSM,Online,502-12,0x1054,62168,512 DCS 1800,-71,0,32-32- AT CPSI? CPSI: NO SERVICE,Online# check signal quality- AT CSQ CSQ: 23,99# configure to use NB-IoT- AT CMNB 2OK- AT CNMP 38OK- AT CBANDCFG "NB-IOT",8OK

- AT CSTT "M2MXNBIOT"OK- AT CPSI? CPSI: LTE 8,3702,0,0,-10,-82,-72,15# check establish connection- AT CIPSTATUSOKSTATE: IP START# start establish connection- AT CIICROK- AT CIPSTATUSOKSTATE: IP GPRSACT# get IP address- AT CIFSR10.247.96.227# ping www.google.com- AT CIPPING "www.google.com" CIPPING: 1,"172.217.166.132",111,52 CIPPING: 2,"172.217.166.132",170,52 CIPPING: 3,"172.217.166.132",110,52 CIPPING: 4,"172.217.166.132",128,527. Run Ctrl-a then Ctrl-d to minimise the screen. To Resume the screenrun screen -r .8. Run Ctrl-a then type :quit to quit the screen.PPP Installation on Raspberry PiNB-IoT HAT offers PPP (Point-to-Point Protocol) for us to connect Raspberry Pito Internet easily. The following steps show how to establish Internet connectionwith Raspberry Pi.

Prerequisite Raspberry Pi SIM7000E NB-IoT HAT MicroUSB Type B CableSteps1. Plug the NB-IoT HAT into Raspberry Pi Board using USB. Ensure the MaxisSIM card is inserted and secured on the HAT.2. Run the command below on Raspberry Pi to check availability of HAT. It willshow /dev/ttyUSB2 if it exists.ls /dev/ttyUSB23. Go to directory where you have downloaded the GIT respository. E.g. /home/pi/maxis-nbiot-hackathoncd /home/pi/maxis-nbiot-hackathon4. Run the commands below to install PPP on Raspberry Pi.

cd "Raspberry Pi/PPP Installer" sudo chmod x install.sh sudo ./install.sh5. Run command below to start the connection.sudo systemctl start nbiot.service6. Run command below to check if interface ppp0 exists.ifconfig7. If it is successful, you should see IP exists in interface ppp0 from ifconfigcommand.8. Run command below to stop the connection.sudo systemctl stop nbiot.service9. To automate the connection during Raspberry Pi boot-up, run commandsudo systemctl enable nbiot.service . To see the effect, run sudoreboot to restart Raspberry Pi.ReferencesFor more references, please visit https://www.rhydolabz.com/wiki/?p 16325Comments

Send simulated telemetry using RaspberryPiWe will be using Raspberry Pi to send simulated temperature and humiditytelemetry for testing purpose. In this workshop, we will be using Python as mainlanguage.Steps1. Check if Python is installed. You can verify the current version of Python onyour development machine using one of the following commands:Python2:python --versionPython3:python3 --version2. You can download Python by running below commands.Python2:sudo apt-get install pythonsudo apt-get install python-devPython3:sudo apt-get install python3sudo apt-get install pyt

Create simple server and web application to view and monitor the activity of the sensors connected to Raspberry Pi. . Ubuntu 16.04 macOS Azure Cloud Shell Download the MSI installer Ubuntu install instructions macOS install . Ubuntu trusty, xenial, artfu