pjlink.class.php

<?php
/**
 * @file  pjlink.class.php
 * @brief Pure PHP PJLink library for operating and controlling data projectors
 *
 * @mainpage
 *
 * PJLink PHP class - PJLINK Class1 and Class2 library
 *
 * http://developer.sysco.ch/
 *
 * The PJLink PHP class is the lightest pure PHP package available for operating
 * and controlling data projectors using the PJLink Class1 and Class2 standard.
 *
 * PJLink Class1 specifications are available here:
 *   http://pjlink.jbmia.or.jp/english/data/5-1_PJLink_eng_20131210.pdf
 *
 * PJLink Class2 specifications are available here:
 *   http://pjlink.jbmia.or.jp/english/data_cl2/PJLink_5-1.pdf
 *
 * PJLink test software is available gere:
 *   http://pjlink.jbmia.or.jp/english/data_cl2/PJLink_5-2.zip
 *
 * The Readme file contains additional information.
 *
 * PHP 5.3.0 or higher is supported.
 *
 * @author    Andre Liechti, SysCo systemes de communication sa, <developer@sysco.ch>
 * @version   2.0.1.0
 * @date      2022-10-21
 * @since     2017-04-23
 * @copyright (c) 2017-2019 SysCo systemes de communication sa
 * @copyright GNU Lesser General Public License
 *
 *//*
 *
 * LICENCE
 *
 *   Copyright (c) 2017-2022 SysCo systemes de communication sa
 *   SysCo (tm) is a trademark of SysCo systemes de communication sa
 *   (http://www.sysco.ch/)
 *   All rights reserved.
 * 
 *   PJLink PHP class is free software; you can redistribute it and/or
 *   modify it under the terms of the GNU Lesser General Public License as
 *   published by the Free Software Foundation, either version 3 of the License,
 *   or (at your option) any later version.
 * 
 *   PJLink PHP class is distributed in the hope that it will be useful,
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *   GNU Lesser General Public License for more details.
 * 
 *   You should have received a copy of the GNU Lesser General Public
 *   License along with PJLink PHP class.
 *   If not, see <http://www.gnu.org/licenses/>.
 *
 *
 * Usage
 *
 *   Every command send to the projector return false is something is wrong.
 *     The error message can be detailed by calling the getError() method.
 *
 *
 *   Public methods available:
 *
 *   Class1/2 functions
 *    setClassLevel([$class_level])
 *    getClassLevel()
 *    getError()
 *    getErrorNumber()
 *    getResponseRaw()
 *    getResponseText()
 *    setDevice($host, [[[$password], $timeout], $port])
 *    powerOn([[[[$host], $password], $timeout], $port])
 *    powerOff([[[[$host], $password], $timeout], $port])
 *    getPowerState([[[[$host], $password], $timeout], $port])
 *    setInput($input, [[[[$host], $password], $timeout], $port])
 *    getInput([[[[$host], $password], $timeout], $port])
 *    muteVideoOn([[[[$host], $password], $timeout], $port])
 *    muteVideoOff([[[[$host], $password], $timeout], $port])
 *    muteAudioOn([[[[$host], $password], $timeout], $port])
 *    muteAudioOff([[[[$host], $password], $timeout], $port])
 *    muteVideoAudioOn([[[[$host], $password], $timeout], $port])
 *    muteVideoAudioOff([[[[$host], $password], $timeout], $port])
 *    getMuteState([[[[$host], $password], $timeout], $port])
 *    getErrorState([[[[$host], $password], $timeout], $port])
 *    getLampState([[[[$host], $password], $timeout], $port])
 *    getInputList([[[[$host], $password], $timeout], $port])
 *    getName([[[[$host], $password], $timeout], $port])
 *    getManufactureName([[[[$host], $password], $timeout], $port])
 *    getProductName([[[[$host], $password], $timeout], $port])
 *    getOtherInfo([[[[$host], $password], $timeout], $port])
 *    getClass([[[[$host], $password], $timeout], $port])
 *
 *   Class2 only functions
 *    getSerialNumber([[[[$host], $password], $timeout], $port])
 *    getSoftwareVersion([[[[$host], $password], $timeout], $port])
 *    getInputTerminalName($input, [[[[$host], $password], $timeout], $port])
 *    getInputResolution([[[[$host], $password], $timeout], $port])
 *    getRecommendedResolution([[[[$host], $password], $timeout], $port])
 *    getFilterUsage([[[[$host], $password], $timeout], $port])
 *    getLampReplacementModel([[[[$host], $password], $timeout], $port])
 *    getFilterReplacementModel([[[[$host], $password], $timeout], $port])
 *    setSpeakerVolume($volume, [[[[$host], $password], $timeout], $port])
 *    setMicrophoneVolume($volume, [[[[$host], $password], $timeout], $port])
 *    freezeOn([[[[$host], $password], $timeout], $port])
 *    freezeOff([[[[$host], $password], $timeout], $port])
 *    getFreezeState([[[[$host], $password], $timeout], $port])
 *
 *
 * Examples
 *
 *   // Example 1
 *   require_once('pjlink.class.php');
 *   $pjlink = new PJLink();
 *   if (false === $pjlink->powerOn("192.168.0.1")) {
 *     echo $pjlink->getError();
 *	 } elseif (false === $pjlink->setInput(11, "192.168.0.1")) {
 *     echo $pjlink->getError();
 *	 }
 *
 *
 *   // Example 2
 *   require_once('pjlink.class.php');
 *   $pjlink = new PJLink(1);
 *   $pjlink->setDevice("192.168.0.1", "my_pjlink_pass", 10, 4352);
 *   if (false === $pjlink->powerOn()) {
 *     echo $pjlink->getError();
 *	 } elseif (false === $pjlink->setInput(11)) {
 *     echo $pjlink->getError();
 *	 }
 *   echo "Device: ".$pjlink->getManufactureName().", ".$pjlink->getProductName()."<br />\n";
 *
 *
 *   // Example 3
 *   require_once('pjlink.class.php');
 *   $pjlink = new PJLink(2);
 *   $pjlink->setDevice("192.168.0.1", "my_pjlink_pass", 10, 4352);
 *   if (false === $pjlink->powerOn()) {
 *     echo $pjlink->getError();
 *	 } elseif (false === $pjlink->setInput(11)) {
 *     echo $pjlink->getError();
 *	 }
 *   echo "Device: ".$pjlink->getManufactureName().", ".$pjlink->getProductName()."<br />\n";
 *   $pjlink->setClassLevel(1);
 *   $pjlink->powerOn("192.168.0.2");
 *
 *
 * No external file is needed (no PEAR, no PECL, no cURL).
 *
 *
 * Special issues
 *
 *   If you need specific developements concerning strong authentication,
 *   do not hesistate to contact us per email at developer@sysco.ch.
 *
 *
 * Users feedbacks and comments
 *
 * 2019-03-10 tomatow
 *   Patch bad specifications implementation, accept lower case response
 *
 * 2017-08-07 Benjamin (DE)
 *   Question about Class 2 support availability
 *
 * 2017-04-24 SysCo/al (CH)
 *   First public version
 *
 *
 * Change Log
 *
 *   2022-10-21 2.0.1.0 SysCo/al Full support of upper and lower case response, also for handling authentication
 *   2019-03-13 2.0.0.2 tomatow  Lower case response are now accepted
 *   2017-09-05 2.0.0.0 SysCo/al First public Class2 support
 *   2017-04-24 1.0.0.1 SysCo/al First public version
 *   2017-04-23 1.0.0.0 SysCo/al Initial implementation
 *********************************************************************/

// PJLINK constants
define ("PJLINK_OK",              0);
define ("PJLINK_BAD_DEVICE",      20);
define ("PJLINK_NO_CONNECTION",   21);
define ("PJLINK_AUTH_ERROR",      22);
define ("PJLINK_SEND_ERROR",      23);

define ("PJLINK_DEFAULT_PORT",    4352);
define ("PJLINK_DEFAULT_TIMEOUT", 5);
define ("PJLINK_PREFIX",          "%");

class PJLink
{
	var $class_level   = "1";
	var $host          = "";
	var $password      = "";
	var $timeout       = PJLINK_DEFAULT_TIMEOUT;
	var $port          = PJLINK_DEFAULT_PORT;
	var $socket        = NULL;
	var $error         = "";
	var $error_number  = "";
	var $prefix_hash   = "";
	var $response_raw  = "";
	var $response_text = "";

  function __construct(
    $class_level = '1'
  ) {
  	$this->class_level = $class_level;
  }

	public function getClassLevel()
	{
		return $this->class_level;
	}

	public function setClassLevel(
		$class_level = "1"
	) {
		$this->class_level = $class_level;
	}

	public function getError()
	{
		return $this->error;
	}

	public function getErrorNumber()
	{
		return $this->error_number;
	}

	public function getResponseRaw()
	{
		return $this->response_raw;
	}

	public function getResponseText()
	{
		return $this->response_text;
	}

	public function setDevice(
		$host,
		$password = "",
		$timeout  = PJLINK_DEFAULT_TIMEOUT, 
		$port     = PJLINK_DEFAULT_PORT
	) {

		$this->error = "";
		$this->error_number = PJLINK_OK;

		$this->host     = $host;
		$this->password = $password;
		$this->timeout  = $timeout;
		$this->port     = $port;

		if ($host == '') {
			$this->error = "Host not defined";
			$this->error_number = PJLINK_BAD_DEVICE;
			return false;
		}

		return true;
	}


	private function open(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {

		$this->error = "";
		$this->error_number = PJLINK_OK;

		if ($host !== "") {
			$this->host = $host;
		}

		if ($password !== "") {
			$this->password = $password;
		}

		if ($timeout !== 0) {
			$this->timeout = intval($timeout);
		}

		if (intval($port) > 0) {
			$this->port = intval($port);
		}
	
		if ($this->host == '') {
			$this->error = "Host not defined";
			$this->error_number = PJLINK_BAD_DEVICE;
			return false;
		}

		$errno = 0;
		$errstr = "";

		$this->socket = @fsockopen($this->host, $this->port, $errno, $errstr, $this->timeout);

		if (!$this->socket) {
			$this->error = "Connection failed: " . socket_strerror($errno);
			$this->error_number = PJLINK_NO_CONNECTION;
			return false;
		}

		stream_set_timeout($this->socket, $this->timeout, 0);

		$response = $this->getResponse();

		if (FALSE !== stripos($response, "PJLINK 0")) {
			$this->prefix_hash = "";
			return true;
		} elseif (FALSE !== stripos($response, "PJLINK 1")) {
			$auth_random = trim(substr($response, stripos($response, "PJLINK 1") + 9));
			$this->prefix_hash = md5($auth_random . $this->password);
			return true;
		} else {
			$this->error = "Bad answer, connection failed";
			$this->error_number = PJLINK_NO_CONNECTION;
			return false;
		}
	}


	private function sendCommand(
		$command
	) {

		$this->error = "";
		$this->error_number = PJLINK_OK;
		$this->response_raw = "";
		$this->response_text = "";

		if (!$this->socket) {
			$this->error = "Device not connected";
			$this->error_number = PJLINK_NO_CONNECTION;
			return false;
		}

		if (FALSE === fwrite($this->socket, $this->prefix_hash . $command . chr(13))) {
			$this->error = "Error sending command ".$command;
			$this->error_number = PJLINK_SEND_ERROR;
			return false;
		}

		$response = $this->getResponse();

		if (FALSE !== stripos($response, "PJLINK ERRA")) {
			$this->error = "Authentication failed";
			$this->error_number = PJLINK_AUTH_ERROR;
			return false;
		} elseif (FALSE !== stripos($response, PJLINK_PREFIX)) {
			$result = trim(substr($response, stripos($response, "=") + 1));
			if (0 === stripos($result, "ERR")) {
				$this->response_text = $result;
				return false;
			} else {
				return $result;
			}
		} else {
			$this->error = "Error sending command ".$command;
			$this->error_number = PJLINK_SEND_ERROR;
			return false;
		}
	}


	private function getResponse()
	{

		$this->error = "";
		$this->error_number = PJLINK_OK;
		$this->response_raw = "";
		$this->response_text = "";

		$response = '';
		if (!$this->socket) {
			$this->error = "Device not connected";
			$this->error_number = PJLINK_NO_CONNECTION;
			return false;
		}

		while (true) {
			$char = fgetc($this->socket);
			if (($char !== false) && ($char !== chr(13))) {
				$response.= $char;
			} else {
				$this->response_raw = $response;
				$this->response_text = $response;
				return $response;
			}
		}
	}


	private function close()
	{

		$this->error = "";
		$this->error_number = PJLINK_OK;

		if (!$this->socket) {
			$this->error = "Device not connected";
			$this->error_number = PJLINK_NO_CONNECTION;
			return false;
		} else {
			fclose($this->socket);
			return true;
		}
	}


	// Power control instruction POWR (ON)
	public function powerOn(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "POWR 1";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR2':
						$this->response_text = "out-of-parameter";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


    // Power control instruction POWR (OFF)
	public function powerOff(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "POWR 0";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR2':
						$this->response_text = "out-of-parameter";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


    // Power status query POWR ?
	public function getPowerState(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "POWR ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
					case '0':
						$this->response_text = "off";
					  break;
					case '1':
						$this->response_text = "on";
					  break;
					case '2':
						$this->response_text = "cooling";
					  break;
					case '3':
						$this->response_text = "warm-up";
					  break;
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


    // Input switch instruction INPT
	public function setInput(
		$input,
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . $this->getClassLevel() . "INPT " . $input;
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR2':
						$this->response_text = "nonexistent";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


    // Input switch query INPT ?
	public function getInput(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . $this->getClassLevel() . "INPT ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


    // Mute instruction AVMT
	private function muteVideoAudio(
		$input    = "",
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "AVMT " . $input;
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR2':
						$this->response_text = "out-of-parameter";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}

	
	public function muteVideoOn(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
    ) {
        return $this->muteVideoAudio("11", $host, $password, $timeout, $port);
	}


	public function muteVideoOff(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
    ) {
        return $this->muteVideoAudio("10", $host, $password, $timeout, $port);
	}


	public function muteAudioOn(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
    ) {
        return $this->muteVideoAudio("21", $host, $password, $timeout, $port);
	}


	public function muteAudioOff(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
    ) {
        return $this->muteVideoAudio("20", $host, $password, $timeout, $port);
	}


	public function muteVideoAudioOn(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
    ) {
        return $this->muteVideoAudio("31", $host, $password, $timeout, $port);
	}


	public function muteVideoAudioOff(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
    ) {
        return $this->muteVideoAudio("30", $host, $password, $timeout, $port);
	}


    // Mute status query AVMT ?
	public function getMuteState(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "AVMT ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
					case '11':
						$this->response_text = "video-mute-on";
					  break;
					case '21':
						$this->response_text = "audio-mute-on";
					  break;
					case '31':
						$this->response_text = "video-audio-mute-on";
					  break;
					case '30':
						$this->response_text = "video-audio-mute-off";
					  break;
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Error status query ERST ?
	public function getErrorState(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "ERST ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = "";
				if (substr($result, 0, 1) != "0") {
					$this->response_text.= ($this->response_text != "" ? ", " : "") . "FAN: " . ((substr($result, 0, 1) == "1") ? "WARNING" : "ERROR");
				}
				if (substr($result, 1, 1) != "0") {
					$this->response_text.= ($this->response_text != "" ? ", " : "") . "LAMP: " . ((substr($result, 1, 1) == "1") ? "WARNING" : "ERROR");
				}
				if (substr($result, 2, 1) != "0") {
					$this->response_text.= ($this->response_text != "" ? ", " : "") . "TEMPERATURE: " . ((substr($result, 2, 1) == "1") ? "WARNING" : "ERROR");
				}
				if (substr($result, 3, 1) != "0") {
					$this->response_text.= ($this->response_text != "" ? ", " : "") . "COVER OPEN: " . ((substr($result, 3, 1) == "1") ? "WARNING" : "ERROR");
				}
				if (substr($result, 4, 1) != "0") {
					$this->response_text.= ($this->response_text != "" ? ", " : "") . "FILTER: " . ((substr($result, 4, 1) == "1") ? "WARNING" : "ERROR");
				}
				if (substr($result, 5, 1) != "0") {
					$this->response_text.= ($this->response_text != "" ? ", " : "") . "OTHER: " . ((substr($result, 5, 1) == "1") ? "WARNING" : "ERROR");
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Lamp number/lighting hour query LAMP ?
	public function getLampState(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "LAMP ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$lamps_result = explode(" ", $result);
				$result_position = 0;
				$result_text = "";
				foreach($lamps_result as $one_result) {
					if (($result_position % 2) == 0)
					{
						if ($result_position > 0) {
							$result_text.= " - ";
						}
						$result_text.= "Lamp " . (1 + ($result_position / 2)) . ": usage time " . $one_result;
					} else {
						$result_text.= ", lamp is " . (("1" == $one_result) ? "ON" : "OFF");
					}
					$result_position++;
				}
				$this->response_text = $result_text;
			} else {
				switch (strtoupper($result)) {
					case 'ERR1':
						$this->response_text = "no-lamp";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


    // Input toggling list query INST ?
	public function getInputList(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . $this->getClassLevel() . "INST ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR2':
						$this->response_text = "out-of-parameter";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Projector/Display name query NAME ?
	public function getName(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "NAME ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}

	// . Manufacture name information query INF1 ?
	public function getManufactureName(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "INF1 ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Product name information query INF2 ?
	public function getProductName(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "INF2 ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Other information query INFO ?
	public function getOtherInfo(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "INFO ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Class information query CLSS ?
	public function getClass(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "1" . "CLSS ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
        if ((intval($result) > 0) && (intval($result) < 3)) {
        	$this->setClassLevel(intval($result));
        }
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Serial number query SNUM ?
	public function getSerialNumber(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "SNUM ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Software version query SVER ?
	public function getSoftwareVersion(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "SVER ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Input terminal name query INNM ?
	public function getInputTerminalName(
		$input    = "",
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "INNM ?" . $input;
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case 'ERR2':
						$this->response_text = "out-of-parameter";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Input resolution query IRES ?
	public function getInputResolution(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "IRES ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case '-':
						$this->response_text = "no-signal";
					  break;
					case '*':
						$this->response_text = "unknown-signal";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Recommended resolution query RRES ?
	public function getRecommendedResolution(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "IRES ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Filter usage time query FILT ?
	public function getFilterUsage(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "FILT ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case 'ERR1':
						$this->response_text = "no-filter";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Lamp replacement model number query RLMP ?
	public function getLampReplacementModel(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "RLMP ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case '':
						$this->response_text = "no-replacement-model-number";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Filter replacement model number query RFIL ?
	public function getFilterReplacementModel(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "RFIL ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				$this->response_text = $result;
			} else {
				switch (strtoupper($result)) {
					case '':
						$this->response_text = "no-replacement-model-number";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


    // Speaker volume adjustment instruction SVOL
	public function setSpeakerVolume(
		$volume   = "",
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "SVOL " . $volume;
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR1':
						$this->response_text = "no-speaker";
					  break;
					case 'ERR2':
						$this->response_text = "out-of-parameter";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


    // Microphone volume adjustment command MVOL
	public function setMicrophoneVolume(
		$volume   = "",
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "MVOL " . $volume;
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR1':
						$this->response_text = "no-microphone";
					  break;
					case 'ERR2':
						$this->response_text = "out-of-parameter";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Freeze instruction FREZ (freeze)
	public function freezeOn(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "FREZ 1";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR1':
						$this->response_text = "not-supported";
					  break;
					case 'ERR2':
						$this->response_text = "out-of-parameter";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Freeze instruction FREZ (cancel freeze)
	public function freezeOff(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "FREZ 0";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR1':
						$this->response_text = "not-supported";
					  break;
					case 'ERR2':
						$this->response_text = "out-of-parameter";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}


	// Freeze status query FREZ ?
	public function getFreezeState(
		$host     = "",
		$password = "",
		$timeout  = 0,
		$port     = 0
	) {
		$command = PJLINK_PREFIX . "2" . "FREZ ?";
		if ($this->open($host, $password, $timeout, $port)) {
			$result = $this->sendCommand($command);
			if (false !== $result) {
				switch (strtoupper($result)) {
					case '0':
						$this->response_text = "unfreezed";
					  break;
					case '1':
						$this->response_text = "freezed";
					  break;
				  default:
						$this->response_text = $result;
				}
			} else {
				switch (strtoupper($result)) {
					case 'ERR1':
						$this->response_text = "not-supported";
					  break;
					case 'ERR3':
						$this->response_text = "unavailable";
					  break;
					case 'ERR4':
						$this->response_text = "failure";
					  break;
				}
				$this->error = $this->response_text;
			}
			return $result;
		} else {
			return false;
		}
	}
}