PHP Classes

Arduino PHP Serial Linux: Communicate with a Arduino board via serial port

Recommend this page to a friend!
  Info   View files Example   View files View files (5)   DownloadInstall with Composer Download .zip   Reputation   Support forum   Blog    
Last Updated Ratings Unique User Downloads Download Rankings
2017-12-19 (1 month ago) RSS 2.0 feedNot enough user ratingsTotal: 103 This week: 24All time: 8,818 This week: 17Up
Version License PHP version Categories
arduinolinuxserial 1.0GNU Lesser Genera...5PHP 5, Unix, Hardware
Description Author

This class can communicate with a Arduino board via serial port.

It can open a connection with a USB serial port of a given name on Linux.

The class can send and receive messages from the board.

  Performance   Level  
Name: Marco Sillano <contact>
Classes: 3 packages by
Country: Italy Italy
Age: ???
All time rank: 3370138 in Italy Italy
Week rank: 19 Up1 in Italy Italy Up
Innovation award
Innovation award
Nominee: 2x



This is an helper class for php-Arduino communications on Linux

After a week of googling and tests, i build this Class to communicate from php running on Linux (master) to an Arduino board via serial USB.

The master message max length is 60 char (serial Arduino rx buffer limit), the response (from Arduino) as no limits. The '\n' char is used internally as terminator. The protocol uses CRC8 to insure correctness. In case of error the message is resended 3 times before exit in error state.

A Bash script ( is used to setup the USB device on Linux, after startup or USB connection. The serial communication is open for every message: in the Bash script the DTR pin is disabled to avoid the Arduino auto reset. (see:


- ERROR LCRC: bad CRC Linux -> Arduino - ERROR ACRC: bad CRC Arduino -> Linux - ERROR CODE: sended a command code not implemented in Arduino - ERROR SERIAL: USB not plugged, Arduino not running or php fail in open the serial device.

   In this case the file 'status.txt' contains: 'stty: /dev/ttyACM0: Inappropriate ioctl for device' ?? 
   Solution: disconect and reconnect Arduino USB


see ArduinoLinuxSerial.php file.


Now you can develop MySQL and web enabled Arduino applications only working on Arduino and PHP. 
To keep ligth the Arduino Sketch, you can port all not realtime logic to PHP side.
At the end your application will works on MXQ+Arduino UNO even 24/7 with only 20 Watt AC power, and can
be controlled by smartphone via WiFi.
What more?

## see also

I am very interested in using TVboxes (like MXQ) as dedicated WEB servers with Arduino extensions: so about (Linux + Android)-Arduino USB serial communication I tested many solutions:

 Using ArduinoLinuxSerial ( the Master is php, and you need the 
 serial driver (uses devices like /dev/ACMx or /dev/USBx). It is blocking the master and the php->Arduino message
 is limited to 60 char. Fastest.

 Using USBphpTunnel ( the master is Arduino, and the Android app uses 
 ports like /dev/bus/dev/00X/00Y, so you don't need the serial driver. It is blocking the master (arduino) and 
 it allows big messages. It works in background of the main php program. Useful for data logging.
 Using USBphpTunnel_Fifo ( the master is php. It is NOT blocking the 
 master, allows payload of 4k, allows concurrence. Works in background, and it is no fast (depending from polling 
 Arduno frequence, 5-15 sec. plus processing time). Well placed for long Arduino processes (like waiting user 
  Files folder image Files  
File Role Description
Files folder imagearduino (1 file)
Files folder imagetest (1 file)
Plain text file ArduinoLinuxSerial.php Class Class source
Accessible without login Plain text file Doc. Documentation
Accessible without login Plain text file Data Auxiliary data

  Files folder image Files  /  arduino  
File Role Description
  Accessible without login Plain text file testSerial.ino Data Auxiliary data

  Files folder image Files  /  test  
File Role Description
  Accessible without login Plain text file testSerial.php Example Example script

 Version Control Unique User Downloads Download Rankings  
This week:24
All time:8,818
This week:17Up