Camera Setup Guide
Overview
This Guide explains the various ways you can connect your camera to Lumeo.
Gateway Type | Supported Cameras | Configuration |
---|---|---|
Lumeo Cloud Gateway | Any IP Camera with provides a RTSP or HTTP stream, and is accessible via the public internet. You may need to use port forwarding if your cameras are behind a router or firewall. | See Stream Setup section below. |
Local Gateway | ONVIF-enabled IP Camera Any IP Camera that provides a RTSP or HTTP stream. | See ONVIF Setup section if your camera supports ONVIF. Alternatively, use Stream Setup section if your Camera does not have ONVIF enabled. |
Local Gateway | USB Camera | See Camera page. |
ONVIF Setup
Discover Cameras
To Link a new IP Camera with your Application, start by discovering it on the Gateway detail page. Lumeo will automatically discover Onvif IP cameras on the same subnet as your Gateway. Click the Add Camera button to start and Onvif discovery.
This will start an Onvif discovery for cameras. Once discovered, you can link the camera by providing camera credentials. Click the link button.
This will open an additional window to complete the connection with the camera. Here you will need to put in the Onvif user and password.
Manually Add Cameras
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.
Click on Add Camera and then Manually add cameras
From this window you can select the gateway and then input the ip address, Camera name and Onvif user credentials for the camera.
If this does not work you might not have Onvif setup on your camera. There are some instructions below to setup Onvif on a couple of popular camera models.
Enable ONVIF on camera
Refer to your Camera's instructions on how to enable ONVIF. Here are some steps for popular camera brands:
Axis
Step 1: Log into the web interface of the camera
- Type in the IP address of the camera into a web browser (like Chrome or Internet Explorer)
Step 2: Go to System Options > Security > ONVIF
Step 3: Click the "Add..." button
Step 4: Create a user with administrator privileges
Step 5: Save the configuration
HIKVision
Step 1: Log into the web interface of the camera
- Type in the IP address of the camera into a web browser (like Chrome or Internet Explorer)
Step 2: Go to Configuration > Network > Advanced Settings > Integration Protocol
Step 3: Check on the 'Enable ONVIF' or 'Enable Open Network Video Interface' box
Step 4: Check on the 'Enable Hikvision CGI' box
Step 5: Set 'Hikvision CGI Authentication' to 'digest/basic'
Step 6: Click on the 'add' button and create a ONVIF profile
- You can use whatever user name and password you want
- For the level:
- Media Users: have access to get the real-time streaming, get a list of device supported functions, and read configurations of device.
- Operators: have access to all settings except:
- Causing changes to the system configuration, such as setting network default gateway
- Causing unrecoverable changes to the system, such as setting system factory default and upgrading system
- Reading confidential system configuration information, such as getting system log
- Administrators: have unrestricted access to all settings.
Step 7: Click on the 'Apply' button on the bottom of the screen once you are done.
Stream Setup
If your camera is not ONVIF enabled, or you are trying to access the Camera from a Gateway outside the firewall (such as from a Lumeo Cloud Gateway), you can add it as a Stream. To do this you will need to find the rtsp url for your particular camera model. Look for it in the camera manual or find your camera model below:
Once you find a URL for your camera go to Streams.
Then Click the Add Input stream button in the top right.
Use a public IP Address in the Stream URI when using Lumeo Cloud Gateways
If using the Lumeo Cloud gateway, you will need to ensure that the Stream URL you configure in Lumeo uses the public IP address with port forwarding. See next section for how to set it up.
Here you will put in the URL for your camera an optional name and then save streams.
Forward RTSP through firewall
This is something that is help when trying to connect a camera at your site to a cloud gateway. To do this you are going to need to setup port forwarding on your router. Here are some basic instructions to complete this. Please check with the manual for your specific router. After you have completed the steps below you can go to https://www.whatismyip.com/ to find your public ip for your router to use in the RTSP stream section above.
- On your web browser address bar, type your router's IP Address/Default Gateway or use your router's Mobile app.
- Log in with your router's credentials (username and password) to view your router's firmware settings.
- Navigate to the port forwarding section of your router.
- Click on Port Forwarding.
- Enter the IP address of your camera in your router in the correct box.
- Put the destination RTSP TCP and UDP ports of the Camera in the boxes in your router. The default RTSP port number is 554.
- Pick a unused public port as the source port (the first one can be 554, but if you are mapping multiple cameras, each will need a different public port). And then click the apply button.
- And you're done. Restart your router to let the changes take effect.
- Once your changes take effect, now you can use your public IP address and public port to setup a Stream. The final RTSP URL that you configure in Lumeo Console will look like following:
rtsp://username:password@public-ip-address:forwarded-port/....
ex.
rtsp://admin:[email protected]:8554/onvif1
Common Misconfigurations
- Configuring your internal network IP in Lumeo Console when you are using Lumeo Cloud Gateways
- IP Addresses that start with
192.168.x.y
or10.0.x.y
or172.16.x.y
are internal IP addresses, not your public IP address. They can only be used when the Lumeo Gateway is deployed within your network.
- IP Addresses that start with
- Missing credentials
- If your camera is using RTSP credentials (which may be different from an email address used to setup web access for the camera), you will need to ensure they are present in the RTSP URL as
rtsp://username:password@....
- If your camera is using RTSP credentials (which may be different from an email address used to setup web access for the camera), you will need to ensure they are present in the RTSP URL as
- Port Forwarding is not setup or not working correctly
- Often times, using your internal IP address and playing the RTSP stream with VLC from within your network will work just fine. However, if the port forwarding is not setup correctly, Lumeo Cloud gateways cannot access the stream from outside your network.
- To verify, create your RTSP URL with the public IP address and forwarded port, and play that using VLC.
Updated 10 months ago