Camera

A Camera is an IP (Security) Camera, or a USB / CSI Camera attached to Gateway.

Overview

Lumeo enables provisioning, configuration and management of IP and USB cameras easily from a central location and process video from them.

TLDR:

  • In order to use a camera as a source, you start by linking it to a Gateway in your Application.
  • Gateways let you discover Cameras attached to them or on the same network as the Gateway
  • Once a Camera is Linked to an Application, it can be used in the Video Source node in a Pipeline

📘

Quickstart

See Camera Setup Guide for a step by step guide to add Cameras and Streams.

USB Cameras

Lumeo supports USB and Raspberry Pi-like cameras connected to a Gateway via USB interface. Most v4l2 enabled USB cameras should work out of the box with Lumeo.

🚧

Connect USB Cameras when installing

In order for USB Cameras to be discoverable within Lumeo Gateway containers, ensure that they are plugged in when running the installer.

If the USB cameras were plugged in after the setup was completed, you can "restart" the Gateway by re-running the Gateway installer and selecting "restart" as the option in the Container manager.

Link a New USB Camera

To Link a new USB/CSI Camera with your Application, start by discovering it on the Gateway detail page. Click Link next to the discovered camera to add it to your application.

If the Camera doesn't show up in Discovery, you can also try to add it manually by specifying it's file URI (file:///dev/video0) when adding a new Camera.

Configure USB Camera

Once linked to an Application, you can set a video format, resolution and frame rate for the camera in the Video Source node.

Process Video from a USB Camera

USB Cameras can be selected in the Video Source node when you deploy a Pipeline that contains that node.

IP Cameras

Lumeo supports IP Cameras that support ONVIF.

Link a New IP Camera

To Link a new IP Camera with your Application, start by discovering it on the Gateway detail page. Lumeo will automatically discover IP cameras on the same subnet as your Gateway. Once discovered, you can link the camera by providing camera credentials.

If the Camera doesn't show up in Discovery, you can also try to add it manually by specifying it's IP address as long as it is reachable via the chosen Gateway.

As a part of the linking process, Lumeo automatically creates a Stream for each video stream that the IP Camera provides. Camera details page has details of that camera's Streams. See Stream for more information.

🚧

Manually configured IP Cameras must be accessible from the Gateway

It's important to ensure that IP cameras, when configured manually, are accessible from the Gateway. This is one of the most common reasons why a manually configured camera may not work.

For instance, when used with Lumeo Cloud Gateways, an IP camera on your local network must be port-forwarded via a Router. This port forwarding should include the ONVIF port (580) and RTSP port (554), and you must specify the forwarded ONVIF port in the camera IP address in Lumeo.

If your IP Camera doesn't show up in Discovery (because it doesn't support ONVIF, or doesn't conform to the standard correctly), and cannot be added manually, we recommend that you create a RTSP stream instead using the Stream section.

Configure IP Camera

Currently, IP Camera settings & Stream settings must be configured using the Camera's native web interface or manufacturer's tools.

Process Video from an IP Camera

IP Camera Streams can be selected in the Video Source node when you deploy a Pipeline that contains that node.

API Reference

See cameras