Focusing a camera and the first tests: Difference between revisions

From Global Meteor Network
Jump to navigation Jump to search
No edit summary
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
'''WARNING: THIS IS A PAGE IN PROGRESS! DO NOT FOLLOW IT IF YOU ARE LOOKING FOR THE BUILDING OF A CAMERA FROM SCRATCH'''
  Ahoj! In this section, cable the camera for the first time, do the preliminary focusing, configure your camera and optionally test the whole system.  
  Ahoj! In this section, you will cable the camera for the first time, do the preliminary focusing and test the whole system.  


Before we come to focusing camera, we need to setup and configure it. By this is mean the IP configuration of camera and setting up the parameters of camera needed for its night operation. Instead of text, you will now watch a video with detailed hands on instructions:
= Testing and Focusing =
At this point, your camera must be tested and focused. There's no point sealing up the housing and screwing it to the wall if its not working or isn't focused !


== Testing the Camera ==
* If your camera came with a single PoE cable, connect this to a netork cable and plug the other end of the network cable into your PoE injector.
* if your camera came with a cable with separate network and power sockets, plug the "output" PoE adapter into the camera cable and plug a network cable into the PoE adapter, then connect the other end of the network cable into the other PoE adapter.
*. Connect the PoE adapter or injector into a spare socket on your home router and connect the camera power supply to it.
The Camera PoE cable lights should come on, indicating traffic is flowing. After a few seconds, it should steady down to irregular flashing. If you don't see flashing lights then check the cable connections to make sure everything is plugged in properly.
<table><tr><td>
=== Find its IP Address ===
[[File:ip-scan.jpg|thumb|right|Finding the Camera Address]]
The camera should now appear as a device on your network and to test it properly you will need to find its IP Address. The easiest way to do this is using a free piece of software called [[https://www.advanced-ip-scanner.com/|Advanced IP Scanner]]. Download and run it (no need to install). Click "Scan" and wait till it finishes. The camera can usually be identified by Manufacturer 'ICP Internet Communications' or 'Motion Control Systems', though other vendor names are possible such as 'Koenig & Bauer AG' and 'Metrohm AG'. If none of the names look right you may need to experiment by trying to connect to each candidate in turn.
=== Checking the Connection ===
[[File:vlcconfig.jpg|thumb|right|VLC Network Stream]]
* Once you have the IP Address, open VLC on your Pi, Mac or Windows machine, and from the "Media" menu, select "Open Network Stream".
* Enter the following into the address box, replacing '''1.2.3.4''' with the address you got in the previous step
<blockquote>rtsp://'''1.2.3.4''':554/user=admin&password=&channel=1&stream=0.sdp</blockquote>
* After a second or two, you should get a view through the camera. If nothing comes up, check you have got the right IP address, and that the cables are secure.
* You can now double-check that you installed the camera the right way up.
If the image is upside down in VLC, turn it through 180 degrees in the housing. do '''not''' be tempted to use firmware settings to flip or mirror the image. These cameras have a 'rolling' shutter and to work out precise timings of meteors, the RMS software compensates for the shutter movement. If the camera is upside down and the image then flipped, the shutter is working in the opposite direction to that expected by RMS and timings will be wrong. You '''must''' physically rotate the camera.
* Note that its entirely normal for the image to be very red and overexposed in daylight. We've removed the IR Block filter so the camera picks up a lot of red light. This is exactly what we want.
</td></tr></table>
<table><tr><td>
== Checking for Obstructions of camera housing ==
[[File:vlcview.jpg|thumb|right|Obstructions]]
This is to make sure that the camera housing is not too visible in the camera's FoV.
* Temporarily close the housing case up and check if it can be seen obstructing the view anywhere.
* Check the live stream from the camera and if necessary bend or tilt the bracket to angle the camera down a bit (inside the camera housing).
* However, don't worry if you can't eliminate all obstructions. Later on you will create a software mask to prevent these areas causing false detections.
</td></tr></table>
<table><tr><td>
== Focusing the Camera ==
There's a whole separate section of the Wiki on [[Focusing_your_camera|focusing]], but here's the short version !!
* connect the camera to your network as above.
* Open VLC.
* Aim the camera at something at around 30-50 metres away.
* Screw the lens in and out slowly to get best focus.
You can usually do an initial focus with the camera assembled on a desk. Point it out a window during the hours of darkness and focus on a building at least 50m away.
You can do this using the RMS utility ShowLivestream instead of VLC, if you have already fully configured the camera and Pi as explained in the next step.
Note that there's a short lag due to the network, so you should wait a second or two after each adjustment to allow the change to be reflected in VLC.
Important note: if your camera came with an electronic filter, and you have left the 'daytime' filter in place you MUST finalise focus at night. The filters slightly alter focus.
</td></tr></table>
= [Optional] All system test =
* Hook RPi up to a monitor with an HDMI cable
* Plug a keyboard and mouse into USB ports on the RPi
* Connect one end of an ethernet cable into the ethernet port on the RPi and the other end into the ‘LAN’ port on the POE injector (See image below).
* Connect another ethernet cable into the ‘POE’ port on the injector and run to the camera cable connector (See image below). Before plugging into the camera, run the cable end through the ethernet connector cover.
* Plug the POE injector into a wall outlet.
* Plug the RPi power supply into the RPi and then into a wall outlet.
* The first thing you would need to do is to connect it to WiFi. In the upper right corner, click on the two arrows pointing up and down, choose your WiFi network and enter the password. You should now be connected to the Internet.
* Ignore (for now) the steps in the terminal window shown on the screen which will help you set everything up.
* The video stream can be checked by double-clicking on the RMS.ShowLiveStream icon on the desktop. When asked, click ‘Execute in terminal’. You should then see a live stream from the camera. To stop the live stream hold down the ‘Ctrl’ key and press ‘c’ while the mouse is in the terminal window that popped up. Note that the stream will lag behind the real-view for a few seconds.
If the video stream opens and looks good, then you have successfully tested your system!
[[File:All_system_test.png]]
= Camera setup & configuration =
To operate at night, the camera must be reset to the correct gain, colour mode and video mode. There are two ways you can do this - doing it via the CMS software (works on Windows only) or via RMS scripts (can be done directly from your Raspberry Pi). In any case it is recommended to watch the below video.
== Camera setup & configuration - Youtube video method ==
<table><tr><td>
* CMS is a security camera software package you can download [https://www.dropbox.com/s/3r4fiqec6jpzwz3/CMS%20and%20Manual.rar?dl=0 as a rar archive here] or [https://archive.ukmeteors.co.uk/RMS_images/CMS.zip as a zip archive here]. You can use the software as explained in the video by Denis Vida below.
* Note however that you should reset the network as the LAST thing you do. The video does it a bit soon.
</td></tr>
<tr><td>
{{#evt:
{{#evt:
service=youtube
service=youtube
Line 10: Line 108:
}}
}}


= header1 =
</td></tr></table>
== Header2 ==
 
<table><tr><td>
 
== Camera setup & configuration - RMS Script method ==
[[File:Ping-camera.JPG|thumb|right|Making sure the Pi can see the Camera]]
 
'''Note that all RMS scripts MUST be run from the source/RMS folder as the Pi user. Don't be tempted to cd into a different folder! It won't work.'''
 
* If you have a Pi4, you can use a utility that's part of RMS, as follows:
 
* If you're not using the pre-built image, first install RMS on the Pi as explained [https://globalmeteornetwork.org/wiki/index.php?title=Main_Page#RMS_Software_Installation here].
* Now plug the camera into your router, open a Terminal window on the Pi and, using the address of your camera, make sure the Pi can ping the camera:
<pre>ping a.b.c.d</pre>
If you get any errors or timeouts, check the camera IP address, and check that the Pi is connected to your home network.


* Next open a terminal window and run this script to reset the camera IP address. 
<pre> python -m Utils.SetCameraAddress a.b.c.d 192.168.42.10</pre>
* You will lose connection to the camera and see a bunch of error messages. Thats normal. Once you see a timeout message, unplug the power and network from the camera.
* Now plug the camera directly into the Pi's ethernet port, open a Terminal window and run the following script to update the camera gain, video mode, and other settings.
[[File:Setting-camer-params.JPG|thumb|right|Setting Camera Params]]
<pre>Scripts/RMS_SetCameraParams.sh</pre>


* Note: If you have RMS installed on your PC then you can change the camera address from your PC instead, then connect it to the Pi and run the 2nd script.
</td></tr></table>


  You are now done with this section and now you are going to focus your camera and put all bits and pieces together for the first test. Exciting, isn't it? [https://globalmeteornetwork.org/wiki/index.php?title=Build_%26_Install_%26_Setup_your_camera_-_The_complete_how-to Back to the signpost page.]
  You are now done with this section and now you are going to install your camera into the position. Drilling holes into the wall is fun, right? [https://globalmeteornetwork.org/wiki/index.php?title=Build_%26_Install_%26_Setup_your_camera_-_The_complete_how-to Back to the signpost page.]

Latest revision as of 07:38, 28 February 2024

Ahoj! In this section, cable the camera for the first time, do the preliminary focusing, configure your camera and optionally test the whole system. 

Testing and Focusing

At this point, your camera must be tested and focused. There's no point sealing up the housing and screwing it to the wall if its not working or isn't focused !

Testing the Camera

  • If your camera came with a single PoE cable, connect this to a netork cable and plug the other end of the network cable into your PoE injector.
  • if your camera came with a cable with separate network and power sockets, plug the "output" PoE adapter into the camera cable and plug a network cable into the PoE adapter, then connect the other end of the network cable into the other PoE adapter.
  • . Connect the PoE adapter or injector into a spare socket on your home router and connect the camera power supply to it.

The Camera PoE cable lights should come on, indicating traffic is flowing. After a few seconds, it should steady down to irregular flashing. If you don't see flashing lights then check the cable connections to make sure everything is plugged in properly.

Find its IP Address

Finding the Camera Address

The camera should now appear as a device on your network and to test it properly you will need to find its IP Address. The easiest way to do this is using a free piece of software called [IP Scanner]. Download and run it (no need to install). Click "Scan" and wait till it finishes. The camera can usually be identified by Manufacturer 'ICP Internet Communications' or 'Motion Control Systems', though other vendor names are possible such as 'Koenig & Bauer AG' and 'Metrohm AG'. If none of the names look right you may need to experiment by trying to connect to each candidate in turn.

Checking the Connection

VLC Network Stream
  • Once you have the IP Address, open VLC on your Pi, Mac or Windows machine, and from the "Media" menu, select "Open Network Stream".
  • Enter the following into the address box, replacing 1.2.3.4 with the address you got in the previous step

rtsp://1.2.3.4:554/user=admin&password=&channel=1&stream=0.sdp

  • After a second or two, you should get a view through the camera. If nothing comes up, check you have got the right IP address, and that the cables are secure.
  • You can now double-check that you installed the camera the right way up.

If the image is upside down in VLC, turn it through 180 degrees in the housing. do not be tempted to use firmware settings to flip or mirror the image. These cameras have a 'rolling' shutter and to work out precise timings of meteors, the RMS software compensates for the shutter movement. If the camera is upside down and the image then flipped, the shutter is working in the opposite direction to that expected by RMS and timings will be wrong. You must physically rotate the camera.

  • Note that its entirely normal for the image to be very red and overexposed in daylight. We've removed the IR Block filter so the camera picks up a lot of red light. This is exactly what we want.

Checking for Obstructions of camera housing

Obstructions

This is to make sure that the camera housing is not too visible in the camera's FoV.

  • Temporarily close the housing case up and check if it can be seen obstructing the view anywhere.
  • Check the live stream from the camera and if necessary bend or tilt the bracket to angle the camera down a bit (inside the camera housing).
  • However, don't worry if you can't eliminate all obstructions. Later on you will create a software mask to prevent these areas causing false detections.

Focusing the Camera

There's a whole separate section of the Wiki on focusing, but here's the short version !!

  • connect the camera to your network as above.
  • Open VLC.
  • Aim the camera at something at around 30-50 metres away.
  • Screw the lens in and out slowly to get best focus.

You can usually do an initial focus with the camera assembled on a desk. Point it out a window during the hours of darkness and focus on a building at least 50m away.

You can do this using the RMS utility ShowLivestream instead of VLC, if you have already fully configured the camera and Pi as explained in the next step.

Note that there's a short lag due to the network, so you should wait a second or two after each adjustment to allow the change to be reflected in VLC.

Important note: if your camera came with an electronic filter, and you have left the 'daytime' filter in place you MUST finalise focus at night. The filters slightly alter focus.

[Optional] All system test

  • Hook RPi up to a monitor with an HDMI cable
  • Plug a keyboard and mouse into USB ports on the RPi
  • Connect one end of an ethernet cable into the ethernet port on the RPi and the other end into the ‘LAN’ port on the POE injector (See image below).
  • Connect another ethernet cable into the ‘POE’ port on the injector and run to the camera cable connector (See image below). Before plugging into the camera, run the cable end through the ethernet connector cover.
  • Plug the POE injector into a wall outlet.
  • Plug the RPi power supply into the RPi and then into a wall outlet.
  • The first thing you would need to do is to connect it to WiFi. In the upper right corner, click on the two arrows pointing up and down, choose your WiFi network and enter the password. You should now be connected to the Internet.
  • Ignore (for now) the steps in the terminal window shown on the screen which will help you set everything up.
  • The video stream can be checked by double-clicking on the RMS.ShowLiveStream icon on the desktop. When asked, click ‘Execute in terminal’. You should then see a live stream from the camera. To stop the live stream hold down the ‘Ctrl’ key and press ‘c’ while the mouse is in the terminal window that popped up. Note that the stream will lag behind the real-view for a few seconds.

If the video stream opens and looks good, then you have successfully tested your system!

All system test.png

Camera setup & configuration

To operate at night, the camera must be reset to the correct gain, colour mode and video mode. There are two ways you can do this - doing it via the CMS software (works on Windows only) or via RMS scripts (can be done directly from your Raspberry Pi). In any case it is recommended to watch the below video.

Camera setup & configuration - Youtube video method

  • CMS is a security camera software package you can download as a rar archive here or as a zip archive here. You can use the software as explained in the video by Denis Vida below.
  • Note however that you should reset the network as the LAST thing you do. The video does it a bit soon.

Camera setup & configuration - RMS Script method

Making sure the Pi can see the Camera

Note that all RMS scripts MUST be run from the source/RMS folder as the Pi user. Don't be tempted to cd into a different folder! It won't work.

  • If you have a Pi4, you can use a utility that's part of RMS, as follows:
  • If you're not using the pre-built image, first install RMS on the Pi as explained here.
  • Now plug the camera into your router, open a Terminal window on the Pi and, using the address of your camera, make sure the Pi can ping the camera:
ping a.b.c.d

If you get any errors or timeouts, check the camera IP address, and check that the Pi is connected to your home network.

  • Next open a terminal window and run this script to reset the camera IP address.
 python -m Utils.SetCameraAddress a.b.c.d 192.168.42.10
  • You will lose connection to the camera and see a bunch of error messages. Thats normal. Once you see a timeout message, unplug the power and network from the camera.
  • Now plug the camera directly into the Pi's ethernet port, open a Terminal window and run the following script to update the camera gain, video mode, and other settings.
Setting Camera Params
Scripts/RMS_SetCameraParams.sh
  • Note: If you have RMS installed on your PC then you can change the camera address from your PC instead, then connect it to the Pi and run the 2nd script.
You are now done with this section and now you are going to install your camera into the position. Drilling holes into the wall is fun, right? Back to the signpost page.