Stream RTSP video using MIPI cameras from VOXL (VOXL-RTSP)
Table of contents
- Running VOXL-RTSP
- Viewing Video Stream
- Accessing Raw Frames
voxl-streamer is replacing voxl-rtsp as the framework to access MIPI cameras. voxl-rtsp will be deprecated in the future.
VOXL-RTSP is a simple application to stream video from a VOXL image sensor using RTSP and, optionally, store video locally to a MP4 file. Run the video streaming application from the VOXL and view using a RTSP viewer such as VLC or Quicktime player.
The VOXL’s connectors are attached to the following Image Sensor Subsystem ports and have the following colloquial names.
|Port||Image Sensor ID||Colloquial Name|
|J2||0||Hi-res Image Sensor Port|
|J3||1||Stereo Image Sensor Port|
|J4||2||Tracking Image Sensor Port|
Run the streaming server on target, using the
-c option with the specified Image Sensor ID to choose which image sensor to stream video from.
$ voxl-rtsp -c 0 # Stream video from Hi-res Image Sensor Simple RTSP starting Camera number: 0 Connected Started camera 0 Created session Video track created Updated camera parameters AE Mode: 1, Exposure: 15814, Gain: 100, AWB Mode: 1 rtsp://DEVICE_IP:PORT/live Started session Ctrl-c or 'kill 3038' to end
Some parameters to try:
Viewing Video Stream
RTSP Streaming to VLC or Quicktime
Open streaming server’s RTSP URL in VLC or QuickTime player:
Connect host system to VOXL’s WiFi
On the host system, run the VLC software
Open Network Stream
Enter RTSP URL, default:
Click Play to view the video stream
RTSP Streaming to QGroundControl
The first step to streaming video to QGroundControl is connecting the VOXL system to QGroundControl through an IP connection. Instructions on establishing a connection to QGroundControl can be found here.
Next, in QGroundControl, press the purple QGC logo in the top left corner in order to Access the
Generaltab, scroll down until you find the
Video Sourcedropdown, choose
RTSP Video Stream
RTSP URLfield. enter the RTSP URL, default:
You will now be able to view the video stream under QGroundControl’s
Accessing Raw Frames
-m option allows access to the raw frames from the MIPI cameras. This option creates a FIFO special file, a named pipe, that can be opened by many different types of processses for reading or writing.