Difference between revisions of "Elphel 353 series quick start guide"
(→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) | ||
− | + | ||
+ | ==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 . | + | ====2. 12V Power Module <font color=red>(ONLY FOR 12V CAMERAS)</font>==== |
{| | {| | ||
− | |[[image: | + | |[[image:Connect 12v power module.jpeg|500px|thumb|Fig.3 12V camera connection]] |
+ | |[[image:Power-injector-illustration.jpg|500px|thumb|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 [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. | |
− | + | ===SSH/FTP connection=== | |
− | + | 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. | + | |[[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 | + | ====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''' | ||
− | ==== | + | ====4. record: command line==== |
− | '''mencoder rtsp://192.168.0.9:554 -ovc copy -fps <fps> -o | + | '''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); | ||
− | ''' | + | '''<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
Contents
- 1 Notes
- 2 Lens Mount
- 3 Connection
- 4 Network
- 5 Camera Index Page Menu
- 6 Help Tips
- 7 Getting the first images
- 8 Camera GUI(camvc) Controls
- 9 Watch/record video stream over the network
- 10 FTP access
- 11 Command line access
- 12 Serial port (10369 board required)
- 13 PHP samples
- 14 Accessing camera parameters
- 15 Keeping settings after power off
- 16 More Tutorials
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
2. 12V Power Module (ONLY FOR 12V CAMERAS)
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
* 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).
Getting the first images
camvc
In the Camera Control Interface (camvc): "Shift+Click" on the button to save.
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
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).
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
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
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