CakeFest 2017 NYC, the Official CakePHP Conference


(PHP 4 >= 4.3.0, PHP 5 <= 5.0.5, PHP 7)

dio_tcsetattr Sets terminal attributes and baud rate for a serial port


bool dio_tcsetattr ( resource $fd , array $options )

dio_tcsetattr() sets the terminal attributes and baud rate of the open fd.



The file descriptor returned by dio_open().


The currently available options are:

  • 'baud' - baud rate of the port - can be 38400,19200,9600,4800,2400,1800, 1200,600,300,200,150,134,110,75 or 50, default value is 9600.

  • 'bits' - data bits - can be 8,7,6 or 5. Default value is 8.

  • 'stop' - stop bits - can be 1 or 2. Default value is 1.

  • 'parity' - can be 0,1 or 2. Default value is 0.

Return Values

No value is returned.


Example #1 Setting the baud rate on a serial port


dio_open('/dev/ttyS0'O_RDWR O_NOCTTY O_NONBLOCK);


dio_tcsetattr($fd, array(
'baud' => 9600,
'bits' => 8,
'stop'  => 1,
'parity' => 0

while (
1) {

$data dio_read($fd256);

  if (
$data) {



Note: This function is not implemented on Windows platforms.

add a note add a note

User Contributed Notes 3 notes

fherrero at noticiasdenavarra dot com
11 years ago
For Windows the Example 1 looks same this one:


('mode com1: baud=9600 data=8 stop=1 parity=n xon=on');
// execute 'help mode' in command line of Windows for help

$fd = dio_open('com1:', O_RDWR);

while (
1) {

$data = dio_read($fd, 256);

  if (
$data) {

daniel widyanto (kunilkuda at gmail dot com)
11 years ago
I'm using PHP to interface my AVR microcontroller in /dev/ttyS0. I bet someone else does the same.

Here's some hint :
- dio_tcsetattr -> is set to enable :
            - RTS / CTS hardware control
            - ICANON mode
              (means that dio_read will wait until 0x0A/LF or other control character is entered in /dev/ttyS0 before it returns reading result, when you use dio_write it will also send 0x0A/LF automatically in the end of the message to your device).

For those who dont need RTS/CTS and/or ICANON, you can use linux command : stty.

Here's mine :

('stty -F /dev/ttyS0 4800 raw');

$fd=dio_open('/dev/ttyS0',O_RDWR | O_NOCTTY | O_NDELAY);

dio_write($fd,"\x41",1);  // write 0x41 or 'A' to /dev/ttyS0
        // Replace result_length with your expected command result length
for ($i=0;$i < result_length;$i++) {
$result .=dio_read($fd, 1);

Refer to :
- Serial Programming Guide for POSIX Operating Systems,
- stty man pages
healer at colorado dot edu
13 years ago
It was frustrating at first because I was trying to get my Linux box to talk to an external serial device (a PIC18F452 programmable chip) and the example provided here refers to fcntl() and open() parameters that aren't in the PHP documentation.

I finally found out what does what through the man pages:

man open
man fcntl

still haven't gotten it to work, or how to reset the ttySx, but thought it may help someone...
To Top