Skip to contentSkip to navigationSkip to topbar
Rate this Page:

Microvisor Quick Start


(warning)

Warning

Microvisor Public Beta

Microvisor is in a pre-release phase and the information contained in this document is subject to change. Some features referenced below may not be fully available until Microvisor's General Availability (GA) release.

This Quick Start is intended to help experienced embedded developers get up and running as fast as possible. If you are new to embedded development, we strongly recommend you start with Get Started with the Microvisor Nucleo Development Board rather than this guide.

The following instructions assume you have a Twilio account and a Microvisor Nucleo Development board that is powered up and connected to the Internet using the supplied Super SIM, WiFi or Ethernet. It also assumes familiarity with Ubuntu and/or Docker on Widows and macOS. You must be familiar with Git on your preferred platform and have it installed.

The Microvisor Nucleo Development Board.

The primary Microvisor development platform is Ubuntu 20.0.4.


Windows

windows page anchor

The recommended solution for working with Microvisor on Windows 10 and 11 is via Windows Subsystem for Linux 2 (WSL). You will need Administrator privileges to install WSL.

  1. Open an Administrator-level Powershell or Command Prompt instance.
  2. Run wsl --install -d Ubuntu-20.04 .
  3. Exit from Ubuntu and quit Powershell.
  4. Open the Ubuntu 20.04 LTS shell from your Start menu.
  5. Follow the command line instructions.

Alternatively, you can use Docker. You can also try native tools, but this is unsupported at this time.


The recommended solution for working with Microvisor on Mac is Docker, as outlined below. However, if you're happy not to be supported, you can use native tools on macOS.


Command line (Ubuntu/WSL)

command-line-ubuntuwsl page anchor

1. Install the prerequisites

1-install-the-prerequisites page anchor

_10
sudo bash -c 'apt update && apt install -y gcc-arm-none-eabi binutils-arm-none-eabi \
_10
build-essential libsecret-1-dev cmake curl git jq wget gdb-multiarch'

2. Install the Twilio CLI

2-install-the-twilio-cli page anchor

_10
curl -sL https://twilio-cli-prod.s3.amazonaws.com/twilio_pub.asc | sudo apt-key add -
_10
sudo touch /etc/apt/sources.list.d/twilio.list
_10
echo 'deb https://twilio-cli-prod.s3.amazonaws.com/apt/ /' | sudo tee /etc/apt/sources.list.d/twilio.list
_10
sudo apt update
_10
sudo apt install -y twilio

3. Install the Twilio CLI Microvisor Plugin

3-install-the-twilio-cli-microvisor-plugin page anchor

Close your terminal window or tab, and open a new one. Now run:


_10
twilio plugins:install @twilio/plugin-microvisor

4. Set up the Twilio CLI

4-set-up-the-twilio-cli page anchor

_10
twilio login

Enter your account SID and your account Auth Token, and provide a name ("shorthand identifier") for your profile when asked to do so.


_10
twilio profiles:use <YOUR_SHORTHAND_IDENTIFIER>

5. Set environment variables

5-set-environment-variables page anchor

Enter the following command to get your target device's SID:


_10
twilio api:microvisor:v1\:devices:list

Set your device's SID as an environment variable. It should be added to your shell profile:


_10
export MV_DEVICE_SID=UVxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

(information)

Info

The QR code on the back of your board and on the anti-static bag in which it shipped also contains your NDB's SID. Scan the code with your mobile phone and a suitable app, and the board's SID is the third /-separated field.

6. Clone the Microvisor FreeRTOS demo

6-clone-the-microvisor-freertos-demo page anchor

_10
git clone --recurse-submodules https://github.com/korewireless/Microvisor-Demo-CMSIS-Freertos.git && cd Microvisor-Demo-CMSIS-Freertos

7. Build and deploy the demo

7-build-and-deploy-the-demo page anchor

_10
twilio microvisor:deploy . --devicesid ${MV_DEVICE_SID} --genkeys --log

You have now completed the set-up and build process using the Linux command line.


This flow assumes you have Docker(link takes you to an external page) installed on your system and that you have started its daemon. It also assumes you have Git installed on your system(link takes you to an external page).

1. Set environment variables

1-set-environment-variables page anchor

Set your Twilio credentials as environment variables. You can get the first two from your Twilio Console account dashboard(link takes you to an external page). The QR code on the back of your board and on the anti-static bag in which it shipped also contains your NDB's SID. Scan the code with your mobile phone and a suitable app, and the board's SID is the third /-separated field.

They should be added to your shell profile.

macOS

macos-2 page anchor

_10
export TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
_10
export TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
_10
export MV_DEVICE_SID=UVxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx


_10
$env:TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
_10
$env:TWILIO_AUTH_TOKEN="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
_10
$env:MV_DEVICE_SID="UVxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"


_10
set TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
_10
set TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
_10
set MV_DEVICE_SID=UVxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

macOS/Windows
macoswindows page anchor

_10
git clone --recurse-submodules https://github.com/korewireless/Microvisor-Demo-CMSIS-Freertos.git && cd Microvisor-Demo-CMSIS-Freertos


_10
docker build --build-arg UID=$(id -u) --build-arg GID=$(id -g) -t microvisor-freertos-image .


_10
docker build -t microvisor-freertos-image .


_10
docker run -it --rm -v .:/home/mvisor/project/ --env-file env.list --name microvisor-freertos microvisor-freertos-image

Under Docker, the demo is compiled, uploaded and deployed to your development board. It also initiates logging — hit ctrl-c to break out to the command prompt.

You have now completed the set-up and build process using Docker.

(information)

Info

Microvisor Help and Support

We welcome all inquiries you may have about Microvisor and its implementation, and any support questions that arise once you've begun developing with Microvisor. Please submit your queries via a KORE Wireless ticket: log in to the Kore console(link takes you to an external page) and click the Contact Support button in the left-hand navbar.


Rate this Page: