PHP (PHP HyperText Preprocessor) is a server side scripting language popular with website developers. Typically PHP is used to generate web pages by interrogating a database and files. However PHP can also be used to control and communicate with other devices. This article explains how to configure PHP in order to send and receive data over a serial port on a unix system or a windows system. Prerequisites.
PHP installed on your computer. An installed Brainboxes Serial port product Steps In Brief. Install PHP Direct IO extension.
Configure PHP to use the extension. Use PHP file provided in the downloads.
Open terminal program at other end of serial connection. Configure PHP file with correct local serial port settings. Go! In-depth Install PHP Direct IO PHP by default does not offer good COM port support however a PHP extension called Direct IO does offers low level access to IO. We will use this extension for serial port communication.
On unix system install the extension using PECL, open a terminal and type: sudo pecl install dio-0.0.7 On windows download the latest php direct io extension dll from:. The dll file should be copied into your phpextension folder (often located in ext or lib phpext ) Configure PHP to use the extension Next the php.ini file needs to be updated to tell it to use the extension. To the bottom of the php.ini file add the following. Unix: extension=dio.so Windows: extension=phpdio.dll Restart PHP Unix: commands vary, on mac for example: sudo apachectl restart Windows: restart IIS webserver, or WAMP server Use PHP file provided in the downloads Download the file about and place it in your web-servers root directory. Navigate to the file the a web browser to confirm that an error is not produced which tells you to install PHP Direct IO. Open terminal program at other end of serial connection In order to test sending and receiving serial data in PHP, the other end of the serial port should be open. On a windows system we recommend using Putty and on Mac OSX CoolTerm (see for more details) to configure a serial for for transmitting and recieving data.
We also recommend opening the other side of the serial connection in the terminal initially to confirm that data is definitely able to be sent and received across the connection. Configure PHP file with correct local serial port settings The sample script has some settings to be configured at the top, most importantly the port name. Windows the port name should be 'comX:' (X being the port number assigned name must be lower case and a colon at the end) this can be found by opening Device Manager.
Unix systems the port name is '/dev/cu.usbserial-XXXXXXXXX' where 'X' is a randomly assigned id. To find all the names of Brainboxes serial ports installed on UNIX type ls /dev/cu.usbserial.
into the terminal. In a Web Browser open the file, the other end of the serial port should show 'HELLO WORLD!' Then type into the terminal on the other end of the connection, this will be echoed back onto the web browser window. Important note: PHP Direct IO does not currently implement a timeout on reads and is blocking. What this means is that if there is no data present when the read method is called then PHP will block (halt) until data is received or the PHP execution time is reached. Links PHP Direct IO manual.
Failed to load latest commit information. Apr 24, 2015 Jul 19, 2015 Jul 19, 2015 Sep 26, 2015 Apr 22, 2015 Mar 23, 2014 Jun 15, 2015 Apr 15, 2015 Feb 16, 2016 Mar 17, 2015 Jan 11, 2016 Sep 23, 2015 Sep 23, 2015 Sep 23, 2015 Sep 23, 2015 Jan 11, 2016 Jan 11, 2016 Sep 23, 2015 Sep 28, 2015 Sep 23, 2015 Sep 28, 2015 Sep 28, 2015 Jan 15, 2016 Aug 27, 2015 Apr 24, 2015 Jan 3, 2016 Apr 27, 2015 Jul 28, 2014 Jan 9, 2016 Jan 11, 2016 Jan 2, 2016 Jan 2, 2016 Mar 23, 2014 Jan 9, 2016 Jan 2, 2016 Jul 19, 2015 Sep 27, 2015 Sep 23, 2015 Jan 15, 2016 Sep 23, 2015 Jun 19, 2015 Jun 5, 2015 Jun 17, 2015 Jan 11, 2016 Jan 11, 2016.