Microvisor Nucleo Development Board Connectivity Guide

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

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 Microvisor CLI 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

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:

    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:

    microvisor wificonfig set <YOUR_SSID> <YOUR_PASSPHRASE> <YOUR_PORT>

  6. You can check the saved credentials with:

    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.