Skip to contentSkip to navigationSkip to topbar

Microvisor Nucleo Development Board Connectivity Guide


(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.

The Nucleo Development Board (NDB) incorporates a Quectel EG-21G cellular modem, and ESP32 WiFi/BLE module, and an Ethernet jack. WiFi and Ethernet can be used by the NDB to connect to the Internet in place of the cellular modem. This takes place automatically at power on:

  • For Ethernet, connect an RJ-45 cable between your NDB and your router, then connect the NDB to power.
  • For WiFi, add your wireless network's credentials to the board (see below) and then power-cycle the NDB.

When it is re-booted, Microvisor will attempt to connect to the Internet in this order:

  1. With Ethernet if it is wired up to an active network.
  2. With WiFi if it is configured with credentials and the specified network can be found.
  3. Cellular via Super SIM.
(warning)

Warning

Microvisor currently supports only Super SIM for cellular connectivity. We expect to enable support for other SIMs in a future release.

As soon as a connection is made, no other devices are used. For example, if Ethernet is not connected, Microvisor will attempt to connect by WiFi. If it succeeds, it will not attempt to connect by cellular.

To configure your NDB's WiFi credentials, follow these steps. They assume you have the Twilio CLI and its Microvisor plugin installed. This can be done on Ubuntu Linux, Windows 10/11, and macOS natively. If you are running Windows Subsystem for Linux (WSL), you will not be able to connect to Linux serial ports, so we recommend following these instructions under your native OS.

(warning)

Warning

On Linux, you will need to perform these commands as root or as a member of the group dialout. To add a user to that group, open a terminal and run:

sudo usermod -a -G dialout <username>
  1. Connect the supplied Micro USB cable to your computer and to the NDB's CONTROL port. If you use your own Micro USB cable, make sure it is data-capable, not power only.
  2. Press RESET on the NDB.
  3. The NDB's SYSTEM LED will turn solid blue, and no application code will be run:

    Microvisor Nucleo Development Board WiFi setting via UART.
  4. Open a terminal or shell and run:

    twilio microvisor:wificonfig:ports

    This will give you a list of serial ports. You will likely see /dev/ttyUSB0 or /dev/ttyACM0 on Linux, /dev/cu.usbmodem on macOS, or COMx on Windows, depending on your hardware. Make a note of this.

  5. To set your WiFi credentials run the following command, substituting your own values for the placeholders:

    twilio microvisor:wificonfig:set '<YOUR_SSID>' '<YOUR_PASSPHRASE>' <YOUR_PORT>
  6. You can check the saved credentials with:

    twilio microvisor:wificonfig:get <YOUR_PORT>

    Note that this will display your SSID in the terminal.

  7. Remove the Micro USB cable from the NDB and power-cycle the board. A full power-cycle is required: pressing RESET will not move the board out of provisioning mode.
(information)

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.

Need some help?

Terms of service

Copyright © 2024 Twilio Inc.