PHP EPICS Module

1. Introduction

The examles in section 3. explain how to use the module in a php page.

2. Supported Versions / Platforms

• linux-x86 (2.4)
• red-hat 9

• 3.14
• 3.13

• 4.3.x

3. Functions implemented

4. How to use ca_get, ca_put, ca_monitor in a PHP script?

Example 1: test_ca_get_put.php

	<?php
	#load external module
	dl("php_epics.so");

	#call function ca_get implemented in the php_epics.so module and display
	#the result

	$rt = ca_get("TEST:ai1");
	echo "Channel TEST:ai1 ".$rt;

	#in order to call ca_put function we want to pass a value as a parameter from
	#a text field
	echo "<FORM METHOD=GET ACTION=test_ca_get_put.php>\n";
	echo "Channel TEST:ai2 <INPUT TYPE=TEXT NAME=CHANNEL VALUE=".$_GET["CHANNEL"].">";
	echo "<INPUT TYPE=SUBMIT VALUE=Go>\n";
	echo "</FORM>";

	#call the function
	ca_put("TEST:ai2",$_GET["CHANNEL"]);

	#read and display the value
	echo "Channel TEST:ai2 ".ca_get("TEST:ai2");

	#Note: Channels "TEST:ai1","TEST:ai2" are running as soft channels on a PC
	#      on PSI network.
	?>

Example 2: test_ca_monitor.php

<?php
	//load external module
	dl("php_epics.so");

	/* The function is called by ca_monitor imlemented in php_epics.so
	 * module any time when a value of one of EPICS channels changes
	 *Parameters:
	 *      channel name
	 *      value
	*/
	function test_monitor($a,$b) {
	    echo "test_monitor called: new value of $a is $b $<BR>\n";
	    //flush the output buffer to the browser
	    flush();
	}

	//flush the output buffer and turn off the output buffering
	ob_end_flush() ;

	//ca_monitor is implemented in php_epics.so module
	$res=ca_monitor("TEST:ai1,TEST:ai2",40,"test_monitor");

	echo "$res... Done.";

	//Note: Channels "TEST:ai1","TEST:ai2" are running as soft channels on a PC
	//      on PSI network.
	?>

You don't know and don't want to learn the php scripting language? Try to follow the next section.

5. Things in progress