Xvisio Device Firmware Upgrade Guide
Xvisio SDK Documentation Home Page

Linux/Ubuntu - Xvisio Device Firmware Upgrade Guide


Prerequisites

Make Ubuntu Up-to-date

Update Ubuntu distribution, including getting the latest stable kernel:

  • sudo apt-get update && sudo apt-get upgrade && sudo apt-get dist-upgrade

Ubuntu Dependency Library Installation

Install dependent library:

  • sudo apt-get update
  • sudo apt-get install dfu-util

Install usb permissions:
Download permissions file 99-xvisio.rules.
Open a terminal in the directory that you download the file and input the command:

  • sudo cp 99-xvisio.rules /etc/udev/rules.d/
  • sudo udevadm control --reload-rules && udevadm trigger

Upgrade

  1. Connect the xvisio device with PC via USB cable.
  2. Check the USB device status. Open a terminal and input:
    lsusb
    Observe the terminal output usb status information where VID:PID is "040e:f408", and "MCCI XVisio vSLAM" indicates Xvisio device.
    Confirm that the current device enumeration is USB3.0 or USB2.0 by the USB Bus number of the Xvisio device and the corresponding BUS HUB type.
    Please ensure proper enumeration of Xvisio device.
    The above description is shown in the following figure:
    image
  3. Click to download the upgrade tool.
  4. Unzip the upgrade tool. Open the terminal in the directory, input the commands and press "Enter":
    sudo chmod +x xvisioUpdateImg
    sudo ./xvisioUpdateImg <path>/xxxx.img
    Where "<path>/xxxx.img" is the path of the firmware that needs to be upgraded.
  5. During the upgrade process:
    image
  6. Update completed:
    image
    If no error is reported in the log which indicates that the upgrade is successfully completed.
  7. Check USB status to confirm device re-enumeration after upgrade.
    lsusb
    Observe the terminal output usb status information where VID:PID is "040e:f408", and "MCCI XVisio vSLAM" indicates Xvisio device.
    Confirm that the current device enumeration is USB3.0 or USB2.0 by the USB Bus number of the Xvisio device and the corresponding BUS HUB type.
    Please ensure proper enumeration of Xvisio device.
    The above description is shown in the following figure:
    image

Check for Upgrades

  • Please confirm that the current Ubuntu/Linux host has installed xvisio SDK. If not, please refer to Linux/Ubuntu sdk installation guide to install.
  • Run the demo-api program to check the SDK version:
    1. Open a terminal, input the demo application name and press "Enter":
      demo-api
      image
    2. Open another terminal at the same location, input the “pipe_srv” and press "Enter":
      pipe_srv
      image
      pipe_srv and demo-api must be opened in the same directory.
    3. Type character "1" in the terminal of "pipe_srv" and press "Enter" to observe the output of the demo-api terminal:
      image
      If the device works as below, it will output:
      Device version: V1.XX....
      Please check whether the version read is the same as the firmware version installed this time.

Xvisio Device Firmware Upgrade Guide
Xvisio SDK Documentation Home Page