joysaaaa / generic-onvif-server

ONVIF, WS-Discovery, RTSP servers loading camera from generic library.

Generic ONVIF Server

Reimplementation of this great ONVIF server template including RTSP video and WS-Discovery servers into a single program. Camera is loaded using a dynamic library implementing the generic camera interface.

Warning

• Work in progress !.
• Many ONVIF features not implemented.
• Has only been tested with ONVIF Device Manager.
• Pretty big binary, might not be suited for embedded.

Dependencies

gSOAP

soapcpp2 and wsdl2h binaries from gSOAP are required.
Follow the installation guide : here

GStreamer RTSP server

Easiest way to get the packages is from distribution repositories (apt-get, pacman, ...).
Names can vary depending of the distribution :

• gstreamer
• gst-rtsp-server
• gst-plugins-base
• gst-plugins-good
• gst-vaapi

Depending on the encoder you want to use, you might need to add other gst packages.
You can activate GStreamer debug output setting GST_DEBUG variable to wanted log level.

Usage

$ make             # release
$ make debug       # debug symbols and asan
$ make clean       # clean target and objects
$ make deep-clean  # also clean gSOAP generated files

Usage: onvif-server [options]
Options:
  -h | --help                  Print this help.
  -d | --debug                 Activate debug output.
  --xaddr           <addr>     Address used by client to reach ONVIF server.
  --configs         <path>     Configurations file path.

Configurations

• Configurations can be loaded with the parameter --configs, use it multiple time to load multiple files.
• You can put all configurations in a single file but be sure to load PROFILE category last.
• Example configurations can be found inside configs folder.
• Default configurations search paths are ./onvif.configand /etc/generic-onvif-server/configs/onvif.config if no configuration path is provided.
• More details here

Camera

Camera are loaded giving the path of a dynamic library implementing the CameraGeneric class interface.
Add the path of the lib in the configuration category STREAM under the variable camera_lib.
In the camera directory you can find camera_generic.h and camera_generic_structs.h specifiying CameraGeneric class interface.

An example Makefile and two example camera libraries are within the directory :

• camera_dummy is a mocked camera wich simulates a camera.
• camera_v4l2 is a (really bad written) library to use v4l2 cameras.

Just run make inside camera directory to generate libdummycam.so and libv4l2cam.so

TODO

• Load configurations from files.
• Get rid of xaddr parameter.
• Save configurations into files before exiting.
• Simplify configurations (Camera capabilities might be sufficient for PTZ range for example).
• Implement ONVIF System features.
• Add HTTPS.
• Make RTSP server more generic (only take JPEG frame currently).
• Add dynamic runtime modification on GStreamer pipeline. (adding OSD for example).
• Add capabilities request for generic camera headers.
• Add Doxygen-like comments on important functions (mostly camera folder).
• Hard refactoring on CameraV4L2.
• Add usage function in camera generic.
• Handle GStreamer behavior when it failed to create pipeline (either log it or exit).