PHP in Elphel cameras - Revision history

Dimitrios: Corrected parameter ELPHEL_FP100S in example

2012-02-08T13:00:36Z

Corrected parameter ELPHEL_FP100S in example

← Older revision		Revision as of 13:00, 8 February 2012
Line 36:		Line 36:

	Example:		Example:
	echo elphel_get_P_value(~~ELPHEL_FP100S~~)/~~100~~; // will return current camera sensor frame rate in (frames per second);		echo elphel_get_P_value(ELPHEL_FP1000S)/1000; // will return current camera sensor frame rate in (frames per second);

Dimitrios at 14:52, 5 January 2012

2012-01-05T14:52:17Z

← Older revision		Revision as of 14:52, 5 January 2012
Line 13:		Line 13:

	You may also edit small text files with web-based editor. It does not allow to open non-existent file, but has an option to "Save As" - http://192.168.0.9/admin-bin/editcgi.cgi		You may also edit small text files with web-based editor. It does not allow to open non-existent file, but has an option to "Save As" - http://192.168.0.9/admin-bin/editcgi.cgi
	So you can try opening http://192.168.0.09/admin-bin/editcgi.cgi?file=/usr/html/phpinfo.php and then (modify and) save it to /var/html/test.php . When done - just open the following URL and watch the results of the script processing by in-camera PHP:		So you can try opening http://192.168.0.9/admin-bin/editcgi.cgi?file=/usr/html/phpinfo.php and then (modify and) save it to /var/html/test.php . When done - just open the following URL and watch the results of the script processing by in-camera PHP:

	'''http://192.168.0.9/var/test.php''' - run		'''http://192.168.0.9/var/test.php''' - run

Mash at 16:13, 3 November 2010

2010-11-03T16:13:35Z

← Older revision		Revision as of 16:13, 3 November 2010
Line 236:		Line 236:
	Example:		Example:
	elphel_wait_frame();		elphel_wait_frame();


			----

			==== elphel_wait_frame_abs ====
			''long'' '''elphel_wait_frame''' (''long'' frame)

			wait for absolute frame number (includes those that are not compressed)

			returns: frame number

			Example:
			elphel_wait_frame_abs(200);


			----

			==== elphel_skip_frames ====
			''long'' '''elphel_skip_frames''' (''long'' frames)

			skip some frames (includes those that are not compressed) - will work even if no frames are compressed

			returns: frame number

			Example:
			elphel_skip_frames(1);

Mash: /* elphel_set_P_arr */

2010-11-03T16:05:12Z

elphel_set_P_arr

← Older revision		Revision as of 16:05, 3 November 2010
Line 74:		Line 74:

	==== elphel_set_P_arr ====		==== elphel_set_P_arr ====
	''long'' '''elphel_set_P_arr''' (''array'' $input)		''long'' '''elphel_set_P_arr''' (''array'' $input, ''long'' $frame, ''long'' $flag) )

	Write multiple camera parameters, provided as an associative array, where keys are parameter names same as defined [[Elphel_PHP_constants]], but without "ELPHEL_" prefix. Values should be numeric and integer, all other types are ignored.		Write multiple camera parameters, provided as an associative array, where keys are parameter names same as defined [[Elphel_PHP_constants]], but without "ELPHEL_" prefix. Values should be numeric and integer, all other types are ignored.

	Return value - number ~~of successfully processed elements.~~		optional arguments:
			frame - frame number to write these parameters to - if not specified default framedelay (current frame + 3) is applied)
			flag - possible flags?

			Return value - frame number to which parameters were written

	Example:		Example:
	echo elphel_set_P_arr(array("WOI_LEFT" => 896, "WOI_TOP" => 672, "WOI_WIDTH" => 800, "WOI_HEIGHT" => 600));		echo elphel_set_P_arr(array("WOI_LEFT" => 896, "WOI_TOP" => 672, "WOI_WIDTH" => 800, "WOI_HEIGHT" => 600));
	Will ~~print 4 and~~ set 800x600 window in the center of the 5Mpix sensor.		Will set 800x600 window in the center of the 5Mpix sensor and print frame number these changes where applied to


	----		----

	==== elphel_get_state ====		==== elphel_get_state ====
	''long'' '''elphel_get_state''' (''void'')		''long'' '''elphel_get_state''' (''void'')

Bburke: /* elphel_get_P_arr */

2010-07-23T18:04:12Z

elphel_get_P_arr

← Older revision		Revision as of 18:04, 23 July 2010
Line 55:		Line 55:
	==== elphel_get_P_arr ====		==== elphel_get_P_arr ====
	''array'' '''elphel_get_P_arr''' (''array'' $template)		''array'' '''elphel_get_P_arr''' (''array'' $template)

	Read multiple camera parameters as an associative array, according to $template. $template should have elements with the key names matching the camera parameters names, same as defined [[Elphel_PHP_constants]], but without "ELPHEL_" prefix (all the elements with the other keys will be ignored). '''elphel_get_P_arr''' returns array, where element keys are the same as in $template (after removing of any unknown ones), and values are ''long'' values read from the camera.		Read multiple camera parameters as an associative array, according to $template. $template should have elements with the key names matching the camera parameters names, same as defined [[Elphel_PHP_constants]], but without "ELPHEL_" prefix (all the elements with the other keys will be ignored). '''elphel_get_P_arr''' returns array, where element keys are the same as in $template (after removing of any unknown ones), and values are ''long'' values read from the camera.

Line 71:		Line 72:

	----		----

	==== elphel_set_P_arr ====		==== elphel_set_P_arr ====
	''long'' '''elphel_set_P_arr''' (''array'' $input)		''long'' '''elphel_set_P_arr''' (''array'' $input)

Bburke: /* elphel_set_P_value */

2010-07-23T18:03:24Z

elphel_set_P_value

← Older revision		Revision as of 18:03, 23 July 2010
Line 42:		Line 42:
	==== elphel_set_P_value ====		==== elphel_set_P_value ====
	''void'' '''elphel_set_P_value''' (''long'' $address, ''long'' $data)		''void'' '''elphel_set_P_value''' (''long'' $address, ''long'' $data)
	Set camera ~~parameters to be used when the camera will be "programmed" (see below)~~.
			Set a single camera parameter.

	Example:		Example:
	elphel_set_P_value(ELPHEL_QUALITY,100); // set JPEG compression quality to 100% - virtually lossless		elphel_set_P_value(ELPHEL_QUALITY,100); // set JPEG compression quality to 100% - virtually lossless
Line 50:		Line 52:

	----		----

	==== elphel_get_P_arr ====		==== elphel_get_P_arr ====
	''array'' '''elphel_get_P_arr''' (''array'' $template)		''array'' '''elphel_get_P_arr''' (''array'' $template)

Bburke: /* elphel_program_sensor */

2010-07-23T17:58:42Z

elphel_program_sensor

← Older revision		Revision as of 17:58, 23 July 2010
Line 210:		Line 210:

	Applies written earlier (see [[PHP_in_Elphel_cameras#elphel_set_P_value\|elphel_set_P_value]], [[PHP_in_Elphel_cameras#elphel_set_P_arr\|elphel_set_P_arr]], [[PHP_in_Elphel_cameras#elphel_white_balance\|elphel_white_balance]]) parameters to the cameras sensor and FPGA compressor. $nonstop determines if the acquisition should be restarted ($nonstop==0) or updated without stopping ($nonstop==1).		Applies written earlier (see [[PHP_in_Elphel_cameras#elphel_set_P_value\|elphel_set_P_value]], [[PHP_in_Elphel_cameras#elphel_set_P_arr\|elphel_set_P_arr]], [[PHP_in_Elphel_cameras#elphel_white_balance\|elphel_white_balance]]) parameters to the cameras sensor and FPGA compressor. $nonstop determines if the acquisition should be restarted ($nonstop==0) or updated without stopping ($nonstop==1).

			'''Note:''' As of version 8.x, parameters are applied as they are set. Therefore, this function is no longer necessary.

	Example:		Example:
	elphel_program_sensor(0);		elphel_program_sensor(0);


	----		----

Polto: /* PHP in Elphel cameras (models 353/363) */

2009-05-26T19:06:39Z

PHP in Elphel cameras (models 353/363)

← Older revision		Revision as of 19:06, 26 May 2009
Line 5:		Line 5:

	== PHP in Elphel cameras (models 353/363) ==		== PHP in Elphel cameras (models 353/363) ==
	Current version of PHP in Elphel cameras is 5.2.1, we will try to keep it (almost) current. ~~As of now ( [[Release_notes\|Elphel software version 7.1.6]]) there are two copies of~~ PHP in the camera ~~- one~~ is working ~~through [http://www.boa.org/ Boa web server] (traditional for Axis ETRAX based products) in CGI mode (port 80) and the other one~~ in [http://en.wikipedia.org/wiki/FastCGI Fast CGI] mode through [http://www.lighttpd.net/ Lighttpd] ~~on port 81~~. Fast CGI mode does not restart applications (like traditional CGI does) for each HTTP request but rather keeps them alive to serve multiple requests. In the case of large application like PHP itself it makes a big performance difference and allows usage of the PHP scripts in the camera without the penalty of slow responses - something really undesirable for [http://www.linuxdevices.com/articles/AT5951285077.html AJAX applications].		Current version of PHP in Elphel cameras is 5.2.1, we will try to keep it (almost) current. PHP in the camera is working in [http://en.wikipedia.org/wiki/FastCGI Fast CGI] mode through [http://www.lighttpd.net/ Lighttpd]. Fast CGI mode does not restart applications (like traditional CGI does) for each HTTP request but rather keeps them alive to serve multiple requests. In the case of large application like PHP itself it makes a big performance difference and allows usage of the PHP scripts in the camera without the penalty of slow responses - something really undesirable for [http://www.linuxdevices.com/articles/AT5951285077.html AJAX applications].


	== How to use PHP in the camera ==		== How to use PHP in the camera ==

Polto at 19:03, 26 May 2009

2009-05-26T19:03:24Z

← Older revision		Revision as of 19:03, 26 May 2009
Line 10:		Line 10:
	== How to use PHP in the camera ==		== How to use PHP in the camera ==
	It is very simple. It is the same as to try your HTML/JavaScript pages. You just need to ftp you script to one of the two locations (or their subdirectories) in the camera. Examples below assume you have the default camera IP='''192.168.0.9''':		It is very simple. It is the same as to try your HTML/JavaScript pages. You just need to ftp you script to one of the two locations (or their subdirectories) in the camera. Examples below assume you have the default camera IP='''192.168.0.9''':
	* '''/var/html''' (visible as '''http://192.168.0.9~~:81~~/var/''' in the web browser) - recommended for experiments, if something goes wrong you can just power-cycle the camera and all your changes will be gone		* '''/var/html''' (visible as '''http://192.168.0.9/var/''' in the web browser) - recommended for experiments, if something goes wrong you can just power-cycle the camera and all your changes will be gone
	* '''/usr/html''' (visible as ''http://192.168.0.9~~:81~~/''' in the web browser) - permanent (until next full firmware upgrade ) storage in the camera flash memory. This second location is more dangerous as you can change the installed files and rebooting will not restore the default behaviour. Flash memory has limited number of write cycles and can develop additional bad blocks during usage, so this location is recommended for "final" files, already tested in /var/html.		* '''/usr/html''' (visible as ''http://192.168.0.9/''' in the web browser) - permanent (until next full firmware upgrade ) storage in the camera flash memory. This second location is more dangerous as you can change the installed files and rebooting will not restore the default behaviour. Flash memory has limited number of write cycles and can develop additional bad blocks during usage, so this location is recommended for "final" files, already tested in /var/html.

	You may also edit small text files with web-based editor. It does not allow to open non-existent file, but has an option to "Save As" - http://192.168.0.9~~:81~~/admin-bin/editcgi.cgi		You may also edit small text files with web-based editor. It does not allow to open non-existent file, but has an option to "Save As" - http://192.168.0.9/admin-bin/editcgi.cgi
	So you can try opening http://192.168.0.09~~:81~~/admin-bin/editcgi.cgi?file=/usr/html/phpinfo.php and then (modify and) save it to /var/html/test.php . When done - just open the following URL and watch the results of the script processing by in-camera PHP:		So you can try opening http://192.168.0.09/admin-bin/editcgi.cgi?file=/usr/html/phpinfo.php and then (modify and) save it to /var/html/test.php . When done - just open the following URL and watch the results of the script processing by in-camera PHP:

	'''http://192.168.0.9~~:81~~/var/test.php''' - run		'''http://192.168.0.9/var/test.php''' - run
	'''http://192.168.0.9~~:81~~/admin-bin/editcgi.cgi?file=/var/html/test.php''' - edit		'''http://192.168.0.9/admin-bin/editcgi.cgi?file=/var/html/test.php''' - edit

	It is also possible to execute PHP scripts without the browser - camera startup scripts already use it for various initialization of the hardware. You can (silently) execute the same program in telnet session:		It is also possible to execute PHP scripts without the browser - camera startup scripts already use it for various initialization of the hardware. You can (silently) execute the same program in telnet session:

Andrey.filippov: /* Creating custom PHP extensions for Elphel cameras */

2009-01-09T21:24:35Z

Creating custom PHP extensions for Elphel cameras

← Older revision		Revision as of 21:24, 9 January 2009
Line 415:		Line 415:
	** <yourname>.c		** <yourname>.c

	You may use ext_skel script to automate this process or follow a nice a tutorial by Sara Goleman '''[http://devzone.zend.com/node/view/id/1021 Extension Writing Part I: Introduction to PHP and Zend]''' . You may also like to read her book, "Extending and Embedding PHP".		You may use ext_skel script to automate this process or follow a nice tutorial by Sara Goleman '''[http://devzone.zend.com/node/view/id/1021 Extension Writing Part I: Introduction to PHP and Zend]''' . You may also like to read her book, "Extending and Embedding PHP".
	=== config.m4 ===		=== config.m4 ===