UVC Video Streaming (RTSP)

Table of contents

  1. Overview
  2. Requirements
    1. Hardware
    2. Target Software
    3. Host Software
  3. Setup Hardware
  4. Network Configuration
  5. Run Software on Target
    1. Terminal Session 1 - ffserver
    2. Terminal Session 2 - ffmpeg
  6. Run VLC Software on Host

Overview

This user guide provides the necessary steps to get video streaming over RTSP network using a UVC (e.g. USB webcame like a Logitech C270) and the VOXL system.

In short, we’ll be doing the following:

  • Connect an HD USB webcam to the VOXL’s USB Hub
  • Install VLC on a host computer to view the video stream
  • Use ffmpeg on the VOXL to stream the video to the host computer

Requirements

Hardware

  • Host computer (Ubuntu 18.04 used in this guide)
  • VOXL-DK
    • VOXL Core Board (MCCA-M0006)
    • Wi-Fi antennas (MANT-00001)
    • APM Regulator Board and cable (MCCA-M0009 and MCBL-00001 cable)
  • 5V/6A Power Supply (MPS-00001-1, MPN: WR9QA6000LCP-N(R6B) with Q-NA(R))
  • Micro USB cable (to load software on target)
  • One of the following VOXL accessies with USB Hub:
    • VOXL-ACC-HUB
    • VOXL-ACC-LTEH-US
    • VOXL-ACC-LTEH-W
  • A UVC device like the Logitech C270
  • USB A Female to JST male 4-pin cable

Target Software

From the host computer:

  • Download the ffmpeg package from here
  • Install the package to the target:
adb push ffmpeg_3.4.5_8x96.ipk /home/root/ipk
adb shell "opkg install /home/root/ipk/ffmpeg_3.4.5_8x96.ipk"

Host Software

  • On the host computer, install VLC media player, which we’ll used to display the RTSP video:
sudo apt-get install vlc

Setup Hardware

  • Disconnect power from the VOXL
  • Attach the USB Hub accessory to VOXL J13
  • Attach the JST cable to the JST USB connector (J16 or J17)
  • Attach the Logitech C270 (or equivalent) UVC camera to the USB connector on the JST to USB Female A cable
  • Connect power to the VOXL

jst-connection

Network Configuration

  • Configure the VOXL as an Access Point (or connect it to a network)
    • instructions on how to do this are here
    • the default IP address of the device will be 192.168.8.1
  • Connect the host computer to the VOXL’s Access Point (default password is 1234567890) or to the same network you connected the VOXL to

Run Software on Target

Terminal Session 1 - ffserver

  • SSH onto the target (see here for details)
  • First, validate the the USB device is found using the lsusb command:
root@apq8096:~# lsusb
Bus 001 Device 003: ID 046d:0825 Logitech, Inc. Webcam C270
Bus 002 Device 001: ID 1d6b:0003 Linux Foundation 3.0 root hub
Bus 001 Device 002: ID 0424:2514 Standard Microsystems Corp. USB 2.0 Hub
Bus 001 Device 001: ID 1d6b:0002 Linux Foundation 2.0 root hub
  • Start ffserver with the following command (which is using a default configuration file that was installed by the package)
ffserver -d -f /etc/ffserver.conf

Terminal Session 2 - ffmpeg

  • Open another terminal session and again SHH onto the target
  • Start the video stream using the following coammand:
ffmpeg -i /dev/video2 http://localhost:8090/feed1.ffm

Run VLC Software on Host

  • On the host system, run the VLC software
  • Go to Media > Open Network Stream
  • Enter the following URL:
rtsp://192.168.8.1:8008/live
  • Click Play to view the video stream

Copyright (c) 2019 ModalAI Inc.