PHP Doku:: Sets terminal attributes and baud rate for a serial port - function.dio-tcsetattr.html

Verlauf / Chronik / History: (1) anzeigen

Sie sind hier:
Doku-StartseitePHP-HandbuchFunktionsreferenzDateisystemrelevante ErweiterungenDirect-IODirect-IO-Funktionendio_tcsetattr

Ein Service von Reinhard Neidl - Webprogrammierung.





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

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.


Es wird kein Wert zurückgegeben.


Beispiel #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) {



Hinweis: Diese Funktion ist auf Windows-Plattformen nicht implementiert.

3 BenutzerBeiträge:
- Beiträge aktualisieren...
daniel widyanto (kunilkuda at gmail dot com)
1.07.2005 3:34
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
fherrero at noticiasdenavarra dot com
2.04.2005 2:30
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) {

healer at colorado dot edu
20.07.2003 0:37
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...

PHP Powered Diese Seite bei
The PHP manual text and comments are covered by the Creative Commons Attribution 3.0 License © the PHP Documentation Group - Impressum - mail("TO:Reinhard Neidl",...)