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 assumes 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.
The primary Microvisor development platform is Ubuntu 20.0.4.
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.
- Open an Administrator-level Powershell or Command Prompt instance.
wsl --install -d Ubuntu-20.04.
- Open the Ubuntu 20.04 LTS shell from your Start menu.
- Follow the command line instructions.
This Quick Start assumes you have version 0.5.1 of Microvisor installed on your board, and the Twilio CLI Microvisor Plugin 0.3.10 or above installed on your computer. Please see the Plugin page for installation details and to learn how to check which Microvisor version you are running.
sudo bash -c 'apt update && apt install -y gcc-arm-none-eabi binutils-arm-none-eabi \ build-essential libsecret-1-dev cmake curl git jq wget'
curl -sL https://twilio-cli-prod.s3.amazonaws.com/twilio_pub.asc | sudo apt-key add - sudo touch /etc/apt/sources.list.d/twilio.list echo 'deb https://twilio-cli-prod.s3.amazonaws.com/apt/ /' | sudo tee /etc/apt/sources.list.d/twilio.list sudo apt update sudo apt install -y twilio
Close your terminal window or tab, and open a new one. Now run:
twilio plugins:install @twilio/plugin-microvisor
Enter your account SID and your account Auth Token, and provide an name for your profile when asked to do so.
twilio profiles:use <YOUR_PROFILE_NAME>
Enter the following command to get your target device’s SID:
Set your device’s SID as an environment variable. It should be added to your shell profile:
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
This assumes you have Docker Desktop installed on your system and that you have started its daemon.
Set your Twilio credentials as environment variables. You can get the first two from your Twilio Console account dashboard. 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
export TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx export TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx export MV_DEVICE_SID=UVxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
They should be added to your shell profile.
$env:TWILIO_ACCOUNT_SID="ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" $env:TWILIO_AUTH_TOKEN="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" $env:MV_DEVICE_SID="UVxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
Windows Command Prompt
set TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx set TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx set MV_DEVICE_SID=UVxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
docker build --build-arg UID=$(id -u) --build-arg GID=$(id -g) \ -t microvisor-freertos-image .
docker run -it --rm -v $(pwd)/:/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.