Difference between revisions of "Elphel 353 series quick start guide"

From ElphelWiki
Jump to: navigation, search
(Command line access)
 
(40 intermediate revisions by 4 users not shown)
Line 1: Line 1:
 +
<font size='2'>
 
==Notes==
 
==Notes==
 
* The following guide was written for (K)Ubuntu OS
 
* The following guide was written for (K)Ubuntu OS
 
* The camera has a web-based interface and it should work in any OS ([http://www.mozilla.com/en-US/firefox/firefox.html Firefox] browser is recommended)
 
* The camera has a web-based interface and it should work in any OS ([http://www.mozilla.com/en-US/firefox/firefox.html Firefox] browser is recommended)
* Download [[Media:Elphel353QuickGuide v1.pdf | (pdf)]]  
+
 
 +
==Lens Mount==
 +
[[Adapter_ring | Lens Adapter Ring]]<br>
 +
Check if you need the C/CS adapter ring to connect your own lenses.
  
 
==Connection==
 
==Connection==
Line 13: Line 17:
 
|}
 
|}
  
====2 .Router/switch with PoE ports====
+
====2. 12V Power Module <font color=red>(ONLY FOR 12V CAMERAS)</font>====
 
{|
 
{|
|[[image:poe_switch.jpg|thumb|Fig.2 Camera connection using a PoE Switch (just plug the camera directly to the switch)]]
+
|[[image:Connect 12v power module.jpeg|500px|thumb|Fig.3 12V camera connection]]
 +
|[[image:Power-injector-illustration.jpg|500px|thumb|power injector adapter]]
 
|}
 
|}
  
====3. 12V Power Module <font color=red>(ONLY FOR 12V CAMERAS)</font>====
+
==Network==
{|
+
The default camera IP address  is '''192.168.0.9'''* ("ping -b 192.168.0.255" if it accidentally has some other address)
|[[image:Connect 12v power module.jpeg|500px|thumb|Fig.3 Camera connection using a PoE Switch]]
 
|}
 
  
==Network==
+
* Ensure that your PC or router/switch, the camera is connected to, has an IP address from the same subnetwork – that is '''192.168.0.xxx'''.
The default camera IP address is '''192.168.0.9'''*
+
* When you get to the camera's home page - the IP address can be changed from the Preferences page.
  
Login:     root
+
Now, in case you IP belongs to another subnetwork (for example, your IP is 192.168.1.xxx), you may not be able to access the camera - therefore, you won't be able to change its preferences. What you have to do is use [http://www3.elphel.com/liveusb Elphel's Live USB]. Change your BIOS settings to be able to boot from a USB device that has Elphel's ditro installed. Once the system from the USB is running, let its program map the connected cameras and connect to them. Mind you, with the live distro the default IP address (192.168.0.9) should work. From the camera's homepage, go to System Preferences -> Network and change the IP address to 192.168.1.9 (in the example we are using). You can now reboot. Everything now will be working as expected.
  
Password:  pass
+
===SSH/FTP connection===
  
* Ensure that your PC or router/switch, the camera is connected to, has an IP address from the same subnetwork – that is 192.168.0.xxx.
+
Default user is:
 +
Login:    root
 +
Password:  pass
  
 
==Camera Index Page Menu==
 
==Camera Index Page Menu==
Line 40: Line 45:
 
* Main Applications menu items:
 
* Main Applications menu items:
 
* Camera Control Interface
 
* Camera Control Interface
* Disk Recorder
+
* Disk Recorder (only use this if you have an actual disk: HDD, SSD, compactflash card connected to your camera)
 
* Parameter Editor
 
* Parameter Editor
 
* Terminal
 
* Terminal
 
* System Preferences
 
* System Preferences
 
* File Browser / Text Editor
 
* File Browser / Text Editor
 
  
 
==Help Tips==
 
==Help Tips==
Line 60: Line 64:
 
|}
 
|}
 
====browser====
 
====browser====
http://192.168.0.9:8081/bimg
+
http://192.168.0.9:8081/bimg
 +
 
 +
====shell script====
 +
wget http://192.168.0.9:8081/bimg -O filename.jpeg
 +
 
 +
====PHP====
 +
In PHP it will be just a system() or exec() call:
 +
system("wget http://192.168.0.9:8081/bimg -O filename.jpeg");
 +
 
 +
==Camera GUI(camvc) Controls==
 +
{|
 +
|[[File:Controls with blank.jpeg|400px|thumb|Fig.6 camvc controls]]
 +
|}
  
 
==Watch/record video stream over the network==
 
==Watch/record video stream over the network==
 
There are several ways to watch/record video streams from the camera:
 
There are several ways to watch/record video streams from the camera:
 +
 
====1. watch: camvc====
 
====1. watch: camvc====
 
First click on an icon with a "screen" (the 3rd one from the left) and then change the display mode to "a guy on a bicycle".
 
First click on an icon with a "screen" (the 3rd one from the left) and then change the display mode to "a guy on a bicycle".
 +
 +
This icon is only active if you have a media plugin installed in your web browser. Elphel's live USB uses "gecko-mediaplayer" together with "gnome-mplayer". Other media plugins (such as the VLC plugin) also may work. In case the "guy on a bicycle" icon is inactive, check if you have one of them installed - in case it's still not working you may have to uninstall "totem-mozilla" (this is the case for Debian Squeeze and Iceweasel).
 
{|
 
{|
|[[image:Display live video.jpeg|250px|thumb|Fig. 6 Turn on Live Video Stream]]
+
|[[image:Display live video.jpeg|250px|thumb|Fig. 7 Turn on Live Video Stream]]
 
|}
 
|}
====2. watch: player GUI / command line====
+
 
To watch the video stream with MPlayer or VLC open the '''rtsp://192.168.0.9:554'''. You can use either a player GUI or a command line. Here is an example command from Linux terminal window:  
+
====2. watch: multipart jpeg (low latency)====
 +
* Works in Firefox, '''low latency stream'''
 +
'''http://192.168.0.9:8081/mimg'''
 +
 
 +
====3. watch: player GUI / command line====
 +
To watch the video stream with VLC or something else (ffplay, Mplayer) open the '''rtsp://192.168.0.9:554'''. You can use either a player GUI or a command line. Here is an example command from Linux terminal window:  
 +
<!--
 +
Doesn't work anymore?!
 +
=====Mplayer=====
 
  '''mplayer  rtsp://192.168.0.9:554 -vo x11 -zoom'''
 
  '''mplayer  rtsp://192.168.0.9:554 -vo x11 -zoom'''
 +
-->
 +
=====VLC (high latency, ffplay might be better)=====
 +
'''vlc rtsp://192.168.0.9:554'''
  
====3. record: command line====
+
====4. record: command line====
  '''mencoder rtsp://192.168.0.9:554 -ovc copy -fps <fps> -o filename.avi'''
+
  '''mencoder rtsp://192.168.0.9:554 -ovc copy -fps <fps> -o <file_name>.mov'''
 
   
 
   
 
  where  
 
  where  
 
  '''<fps>'''        - approximate value of the frame frequency (this parameter is mandatory);  
 
  '''<fps>'''        - approximate value of the frame frequency (this parameter is mandatory);  
  '''filename.avi''' - the name of an output file
+
  '''<file_name>.mov''' - the name of an output file
 +
 
 +
or
 +
'''vlc rtsp://192.168.0.9:554 -V x11 --sout file/ogg:<file_name>.mov'''
  
 
==FTP access==
 
==FTP access==
Line 84: Line 117:
  
 
==Command line access==
 
==Command line access==
a) '''SSH'''
+
a) '''SSH''' (outdated, drops connections, please, use Telnet)
  
 
In the terminal window: ssh root@192.168.0.9
 
In the terminal window: ssh root@192.168.0.9
Line 95: Line 128:
  
 
Firefox address line: http://192.168.0.9/phpshell.php
 
Firefox address line: http://192.168.0.9/phpshell.php
 +
 +
===Reboot===
 +
In a terminal/phpshell type '''reboot -f'''.
  
 
==Serial port (10369 board required)==
 
==Serial port (10369 board required)==
Line 102: Line 138:
  
 
XON/XOFF : None
 
XON/XOFF : None
 +
 +
==PHP samples==
 +
====On the camera====
 +
[[PHP in Elphel cameras|PHP API Reference Documentation]]
 +
 +
[[Elphel PHP constants|List of PHP Constants]]
 +
 +
[[PHP_Examples|PHP Examples]]
 +
====On the PC====
 +
<br/>
 +
==Accessing camera parameters==
 +
 +
===Camera GUI===
 +
http://192.168.0.9 -> "Parameter Editor"
 +
 +
Navigate through the 1st table links. They cover most if not all of the camera parameters.
 +
 +
===On-camera script "parsedit.php" - through a browser or AJAX GET call===
 +
The response is in XML form:
 +
 +
Read:
 +
http://192.168.0.9/parsedit.php?immediate&PAR1&PAR2
 +
Change:
 +
http://192.168.0.9/parsedit.php?immediate&PAR1=VAL1&PAR2=VAL2
 +
 +
Note 1: It's just if the parameter value is specified it will be applied. The call can have mixed specified and unspecified parameters.
 +
 +
Note 2: The new value is read on the next call.
 +
 +
==Keeping settings after power off==
 +
http://192.168.0.9 -> "Parameter Editor"
 +
 +
Scroll to the 2nd table.
 +
* "Save" button
 +
* Optionally write some comment and press "Update" to the right of it. Next time the camera will boot with these settings.
 +
* To set the parameter group used at boot time, select it and press "Update Default" button.
 +
 +
==More Tutorials==
 +
See [[Tutorials]]
 +
</font>
 +
[[Category:User Guide]]

Latest revision as of 12:13, 11 February 2016

Notes

  • The following guide was written for (K)Ubuntu OS
  • The camera has a web-based interface and it should work in any OS (Firefox browser is recommended)

Lens Mount

Lens Adapter Ring
Check if you need the C/CS adapter ring to connect your own lenses.

Connection

When the camera is properly connected to a PC the leds on the back will go solid yellow and blinking green.

1. Standard PoE Injector

Fig.1 Camera connection using a standard PoE Injector

2. 12V Power Module (ONLY FOR 12V CAMERAS)

Fig.3 12V camera connection
power injector adapter

Network

The default camera IP address is 192.168.0.9* ("ping -b 192.168.0.255" if it accidentally has some other address)

  • Ensure that your PC or router/switch, the camera is connected to, has an IP address from the same subnetwork – that is 192.168.0.xxx.
  • When you get to the camera's home page - the IP address can be changed from the Preferences page.

Now, in case you IP belongs to another subnetwork (for example, your IP is 192.168.1.xxx), you may not be able to access the camera - therefore, you won't be able to change its preferences. What you have to do is use Elphel's Live USB. Change your BIOS settings to be able to boot from a USB device that has Elphel's ditro installed. Once the system from the USB is running, let its program map the connected cameras and connect to them. Mind you, with the live distro the default IP address (192.168.0.9) should work. From the camera's homepage, go to System Preferences -> Network and change the IP address to 192.168.1.9 (in the example we are using). You can now reboot. Everything now will be working as expected.

SSH/FTP connection

Default user is:

Login:     root
Password:  pass

Camera Index Page Menu

http://192.168.0.9 *

* It is recommended to use the Firefox browser.


  • Main Applications menu items:
  • Camera Control Interface
  • Disk Recorder (only use this if you have an actual disk: HDD, SSD, compactflash card connected to your camera)
  • Parameter Editor
  • Terminal
  • System Preferences
  • File Browser / Text Editor

Help Tips

Open the Camera Control Interface (camvc).

Fig.4 Help

Getting the first images

camvc

In the Camera Control Interface (camvc): "Shift+Click" on the button to save.

Fig.5 Acquire an image from the Camera Control Interface

browser

http://192.168.0.9:8081/bimg

shell script

wget http://192.168.0.9:8081/bimg -O filename.jpeg

PHP

In PHP it will be just a system() or exec() call:

system("wget http://192.168.0.9:8081/bimg -O filename.jpeg");

Camera GUI(camvc) Controls

Fig.6 camvc controls

Watch/record video stream over the network

There are several ways to watch/record video streams from the camera:

1. watch: camvc

First click on an icon with a "screen" (the 3rd one from the left) and then change the display mode to "a guy on a bicycle".

This icon is only active if you have a media plugin installed in your web browser. Elphel's live USB uses "gecko-mediaplayer" together with "gnome-mplayer". Other media plugins (such as the VLC plugin) also may work. In case the "guy on a bicycle" icon is inactive, check if you have one of them installed - in case it's still not working you may have to uninstall "totem-mozilla" (this is the case for Debian Squeeze and Iceweasel).

Fig. 7 Turn on Live Video Stream

2. watch: multipart jpeg (low latency)

  • Works in Firefox, low latency stream
http://192.168.0.9:8081/mimg

3. watch: player GUI / command line

To watch the video stream with VLC or something else (ffplay, Mplayer) open the rtsp://192.168.0.9:554. You can use either a player GUI or a command line. Here is an example command from Linux terminal window:

VLC (high latency, ffplay might be better)
vlc rtsp://192.168.0.9:554

4. record: command line

mencoder rtsp://192.168.0.9:554 -ovc copy -fps <fps> -o <file_name>.mov

where 
<fps>        - approximate value of the frame frequency (this parameter is mandatory); 
<file_name>.mov - the name of an output file

or

vlc rtsp://192.168.0.9:554 -V x11 --sout file/ogg:<file_name>.mov

FTP access

ftp://192.168.0.9

Command line access

a) SSH (outdated, drops connections, please, use Telnet)

In the terminal window: ssh root@192.168.0.9

b) Telnet

In the terminal window: telnet 192.168.0.9

c) Phpshell

Firefox address line: http://192.168.0.9/phpshell.php

Reboot

In a terminal/phpshell type reboot -f.

Serial port (10369 board required)

Speed: 115200 8N1

RTS/CTS: None

XON/XOFF : None

PHP samples

On the camera

PHP API Reference Documentation

List of PHP Constants

PHP Examples

On the PC


Accessing camera parameters

Camera GUI

http://192.168.0.9 -> "Parameter Editor"

Navigate through the 1st table links. They cover most if not all of the camera parameters.

On-camera script "parsedit.php" - through a browser or AJAX GET call

The response is in XML form:

Read:

http://192.168.0.9/parsedit.php?immediate&PAR1&PAR2

Change:

http://192.168.0.9/parsedit.php?immediate&PAR1=VAL1&PAR2=VAL2

Note 1: It's just if the parameter value is specified it will be applied. The call can have mixed specified and unspecified parameters.

Note 2: The new value is read on the next call.

Keeping settings after power off

http://192.168.0.9 -> "Parameter Editor"

Scroll to the 2nd table.

  • "Save" button
  • Optionally write some comment and press "Update" to the right of it. Next time the camera will boot with these settings.
  • To set the parameter group used at boot time, select it and press "Update Default" button.

More Tutorials

See Tutorials