Работа с СОМ-портом на Си в linux

Каждый, кто постоянно занимается электроникой и программирует встраиваемые устройства, неизбежно сталкивается с необходимостью работы с СОМ-портом под линуксом. Чаще всего появляется задача сопрячь какой-то датчик, либо удалённое устройство с одноплатником. Да, что греха таить, сейчас в 2020 году UART, наверное, самый распространённый интерфейс для обмена данными, несмотря на всю его архаичность.
Поэтому умение работать с СОМ-портами в linux особенно важно. И вот, казалось бы, UART, древнейший интерфейс, всё должно быть известно и понятно, и даже опытные программисты ломают зубы, работая с ним в линуксе. Особенный цирк с конями начинается при работе с передачей сырых данных по RS-485. Не знаю ни одного программиста, который бы не хватил горя при разработке ПО для таких решений. Самое забавное, что с более новомодным i2c работать в линуксе куда проще и понятнее, чем с ортодоксальным UART. Чтобы не было путаницы дальше, всё семейство UART (RS-232, RS-485, UART 5V, UART 3,3 и т.д.) по тексту я буду называть COM-порт или UART. Мы говорим в статье не о физическом интерфейсе, а о программной стороне вопроса.
В этой статье я хочу показать, как писать свои программы, работающие с UART в ОС Linux. И неважно на каком языке вы пишете программу для работы с UART (python, c, c++, bash, php, perl и т.д.), принцип работы и грабли будут одни и те же, так как всё равно всё упирается в системные вызовы к ядру. А не понимание того, что там происходит и приводит к различным трудноуловимым багам.


Телетайп, на который БЭВМ могли выводить и получать данные. Фото взято здесь

Исторически сложилось, что СОМ-порт в UNIX использовался как терминал. То есть, как устройство для отображения и получения информации работы с ЭВМ. Отсюда идёт всё базовое наследие работы UART.

Основы ввода-вывода в linux: всё есть файл

Принцип операционных систем типа Unix (и GNU Linux вместе с ними): всё есть файл. Файл может быть регулярным на диске, к которому мы все привыкли, файлом может быть именованный или не именованный, канал для передачи данных, передача данных по сети, тоже по сути, работа с файл-сокетом (только не именованным). Таким образом разобравшись с функциями работы с файлами мы частично разберёмся с работой СОМ-порта.
Файл можно: создать, открыть, закрыть, удалить, прочитать и записать в файл. Всё это системные вызовы в ядро, для работы с данными, которые хранятся или передаются с помощью файла. Поскольку создание и удаление файла нас не интересует, далее их не рассматриваю. Этим системным вызовам соответствуют следующие имена функций. Привожу, в пример, вместе с заголовочными файлами, где они описаны:

#include <sys/types.h>
#include <sys/stat.h>
#include <fcntl.h>

int open(const char *pathname, int flags);
//Либо 
int open(const char *pathname, int flags, mode_t mode); //открыть файл

Принимает на вход имя файла, флаги опции открытия, и если расширенная функция, то и права доступа. Но нас это тоже пока не волнует. Возвращает дескриптор (описатель) открытого файла, число больше нуля. В любом другом случае – это ошибка открытия файла.
#include <unistd.h>
int close(int fd); //закрыть файл

Закрывает файл, на вход принимает дескриптор файла. Возвращает нуль в случае успеха.
Самые интересные системные вызовы для нас, это чтение и запись.
#include <unistd.h>
ssize_t read(int fd, void *buf, size_t count);

read() пытается записать count байтов файлового описателя fd в буфер, адрес которого начинается с buf.
Если количество count равно нулю, то read() возвращает это нулевое значение и завершает свою работу. Если count больше, чем SSIZE_MAX, то результат не может быть определён.
При успешном завершении вызова возвращается количество байтов, которые были считаны (нулевое значение означает конец файла), а позиция файла увеличивается на это значение. Если количество прочитанных байтов меньше, чем количество запрошенных, то это не считается ошибкой: например, данные могли быть почти в конце файла, в канале, на терминале, или read() был прерван сигналом. В случае ошибки возвращаемое значение равно -1, а переменной errno присваивается номер ошибки. В этом случае позиция файла не определена.

Обратите внимание! Что количество запрашиваемых байт на чтение, может не соответствовать реальному количеству считаных байт! Оно будет меньше, либо равно запрошенному.
#include <unistd.h>
ssize_t write(int fd, const void *buf, size_t count);

write записывает до count байтов из буфера buf в файл, на который ссылается файловый дескриптор fd.
В случае успешного завершения возвращается количество байтов, которые были записаны (ноль означает, что не было записано ни одного байта). В случае ошибки возвращается -1, а переменной errno присваивается соответствующее значение.

Обратите также внимание, что запись байт не гарантирует, что все байты будут записаны. Следует также контролировать количество байт, которое было записано, и в цикле дописывать их до окончания.

С точки зрения ядра, функции read и write осуществляют копирование данных из ядра в пространство пользователя (для чтения), и копирование из пространства пользователя в ядро (в случае записи). Таким образом, важно понимать, что функция записи не гарантирует реальную запись в устройство, а только копирование во внутренние буфера ядра. И в случае чтение из файл-устройства порта, вы читаете не физически из устройства, а просто копируете накопленные данные, которое драйвер ядра уже получил из порта ввода-вывода и сложил во внутренний буфер.

Файл-устройство COM-порта

Как уже было сказано, в ОС Linux всё есть файл. Файл-устройство COM-портов обычно располагается в каталоге с именем /dev/tty*, где вместо звёздочки может стоять любая последовательность символов или её не быть вовсе. Эти устройства обладают сходным интерфейсом, который был выведен десятилетия назад для последовательных терминалов TeleType (см. фотографию в начале поста) и получил название tty. Реализация конечного имени устройства зависит от текущей реализации операционной системы. Например, классический COM1 в Ubuntu выглядеть, как /dev/ttyS0. А если подключить USB-COM переходник, то файл-устройство будет иметь имя /dev/ttyUSB0, конечно если он единственный в системе, либо другой порядковый номер на конце, если воткнуто несколько шнурков. Часто, составные устройства (например, lte-модемы), определяются как /dev/ttyACM0.
Если вы откроете виртуальный терминал и просто введёте:
ls -la /dev/tty*

то увидите множество файл-устройств. К одному из них подключен ваш виртуальный терминал это файл-устройство “/dev/tty”. Проще говоря, стандартный поток ввода, вывода и стандартный поток ошибок идёт в это файл-устройство. В данном случае командная оболочка (в моём случае bash) использует его для ввода-вывода. Можем в этом убедиться введя:
~$ echo "Hello" > /dev/tty
Hello

Здесь мы командой echo вывели сообщение и перенаправили его в файл /dev/tty, в результате получили его на экране нашего терминала. Если вспомнить, как было всё организовано раньше, то терминал «подключен» к СОМ-порту и представляет собой пассивную железку, что к нему приходит, то он и выводит. Точно также отправляет сырые данные, введённые с клавиатуры. Таким образом, когда мы записали данные с помощью команды “echo” в файл-устройство (системный вызов write), то эти данные были отправлены на виртуальный порт и мы их увидели на экране нашего терминала.
Теперь важный момент, вы, наверняка знаете, что если работает некоторая программа и нажать ctrl-c, то программа получает SIGINT. Как же это работает? Если вы заметите, то набирая ctrl-c, вы посылаете символ «^c»: ETX (Конец текста, посылает сигнал уничтожения), ASCII 0x03. Драйвер СОМ-порта видя получение этого символа, посылает сигнал программе, которая сейчас владеет вводом-выводом. Таким образом, драйвер терминала может управляться специальными символами. Получение этих специальных символов, может очищать экран, менять цвет выводимых символов и т.д. Например, следующие символы могут выполнять следующие действия:

  • (ctrl-c) ^C → ETX (Конец текста, посылает сигнал уничтожения), ASCII 0x03
  • (ctrl-d) ^D → EOT (Конец передачи, завершает ввод), ASCII 0x04
  • ^H → BS (Backspace, \b ), ASCII 0x08
  • ^J → LF (подача линии, \n ), ASCII 0x0A
  • ^L → FF (канал формы, новая страница, очистка терминала), ASCII 0x0C
  • ^M → CR (возврат каретки, \r ), ASCII 0x0D

Как несложно догадаться, если в сыром режиме передачи данных эти символы будут переданы, то драйвер последовательного порта пошлёт нашей программе такие сигналы, и не известно, к чему это может привести.
Поэтому необходимо конфигурировать СОМ-порт для работы в сыром режиме, и не обрабатывать эти символы. Конфигурацию текущего терминала в консоли можно посмотреть командой:
stty -F /dev/tty -a

И на выходе мы получим следующий результат:
~$ stty -F /dev/tty -a
speed 38400 baud; rows 51; columns 238; line = 0;
intr = ^C; quit = ^\; erase = ^?; kill = ^U; eof = ^D; eol = <undef>; eol2 = <undef>; swtch = <undef>; start = ^Q; stop = ^S; susp = ^Z; rprnt = ^R; werase = ^W; lnext = ^V; discard = ^O; min = 1; time = 0;
-parenb -parodd -cmspar cs8 -hupcl -cstopb cread -clocal -crtscts
-ignbrk -brkint -ignpar -parmrk -inpck -istrip -inlcr -igncr icrnl ixon -ixoff -iuclc -ixany -imaxbel iutf8
opost -olcuc -ocrnl onlcr -onocr -onlret -ofill -ofdel nl0 cr0 tab0 bs0 vt0 ff0
isig icanon iexten echo echoe echok -echonl -noflsh -xcase -tostop -echoprt echoctl echoke -flusho -extproc

Обратите внимание, несмотря на то что данное файл-устройство виртуальное и не имеет реального воплощения в железе, у него всё равно есть скорость и управляющие флаги. Это флаги структуры termios. Как работать с этими флагами, что они значат и для чего нужны, мы разберёмся в следующей главе.
Рекомендую запомнить эту команду. Если какая-то программа меняет настройки порта, то они сохраняются и наследуются дальше. Например, если программа переводит терминал в «неканонический режим», то если она не вернёт настройки терминала, то он так и останется в этом режиме, и остальные программы будут уже работать с такими настройками.

Работа с файл-устройством терминала

Все манипуляции tty осуществляются с помощью одной структуры, struct termios, а также нескольких функций, определенных в заголовочном файле <termios.h>. Из этих функций широко применяются только шесть. Когда не нужно устанавливать скорость передачи данных по линии, используются только две наиболее важных функции — tcgetattr() и tcsetattr().
#include <termios.h>

struct termios {

 tcflag_t c_iflag; /* флаги режима ввода */

 tcflag_t c_oflag; /* флаги режима вывода */

 tcflag_t c_cflag; /* флаги управляющего режима */

 tcflag_t c_lflag; /* флаги локального режима */

 cc_t c_line;      /* дисциплина линии связи */

 cc_t c_cc[NCCS];  /* управляющие символы */

};

int tcgetattr(int fd, struct termios * tp);

int tcsetattr(int fd, int oact, struct termios * tp);

Почти в каждом случае программы должны использовать tcgetattr() для получения текущих установок устройства, модифицировать эти установки, а затем применять tcsetattr() для активизации модифицированных установок.

Для того, чтобы понять, как конфигурировать файл-устройства терминала (телетайпа, СОМ-порта, как будет угодно), разберём синтетический пример.
#include <stdio.h>
#include <stdlib.h>
#include <fcntl.h>
#include <unistd.h>
#include <termios.h>

int main (int argc, char ** argv)
{
  
  	struct termios oldsettings, newsettings;
	tcgetattr(fileno(stdin), &oldsettings);
	newsettings = oldsettings;
	newsettings.c_lflag &= ~(ECHO|ICANON|ISIG);
	newsettings.c_cc[VMIN] = 1;
	newsettings.c_cc[VTIME] = 1;
	tcsetattr(fileno(stdin), TCSANOW, &newsettings);
	printf("press [q] to quit\n");
	char rd_ch = '\0';
	int fd_in = open ("/dev/tty", O_RDONLY);
	while(rd_ch != 'q') {
		int read_count = read(fd_in, &rd_ch, 1);
	}
	tcsetattr(fileno(stdin), TCSANOW, &oldsettings);
	return EXIT_SUCCESS;
}

Пример обитает вот тут.

Давайте разберём, что же делает данная программа: она переводит терминал ввода-вывода в неканонический режим, отключая эхо показа клавиш на экране, блокируя все специальные символы, вызывающие сигнал, и ожидает в цикле ввода всего одного символа «q» для выхода.
Работа программы выглядит так:
./pressq 
press [q] to quit
$

Завершить работу программы комбинациями клавиш ctrl-c, ctrl-d и другими невозможно, так как драйвер терминала не обрабатывает соответствующие сигналы. На экране введённая информация не отображается. После завершения работы терминал восстанавливает своё первоначальное состояние.
Разберём код программы.
struct termios oldsettings, newsettings;

Здесь мы создаём два экземпляра структуры termios. Для того чтобы сохранить текущее состояние нашего терминала и потом иметь возможность его восстановить и новое.
tcgetattr(fileno(stdin), &oldsettings);

С помощью функции fileno(stdin) мы получаем дескриптор файла стандартного потока вывода, а функция tcgetattr получает текущие установки устройства в структуру oldsettings.
newsettings = oldsettings;

Копируем структуру.
newsettings.c_lflag &= ~(ECHO|ICANON|ISIG);

Здесь мы снимаем флаги локального эха, снимаем флаг канонического режима терминала и отключаем получение сигналов. Подробнее о флагах структуры termios можно посмотреть тут.
newsettings.c_cc[VMIN] = 1;
	newsettings.c_cc[VTIME] = 1;

Здесь указывается минимальное количество символов, которое будет передано за раз — для неканонического ввода (то количество символов, которое будет отдано функции read до истечения таймаута VTIME). А также таймаут, в децисекундах, после которого будет отдано накопившееся количество символов функции read. Если символов нет, то read вернёт нуль (см. главу «Основы ввода-вывода в linux: всё есть файл»).
Это место немного сложное, поясню. Если у нас не будет ввода, то функция read будет считывать нуль символов, каждые 0,1 с. Если символ приходит, то функция read будет срабатывать при каждом 1-м символе. Если функция read блокирующая!
tcsetattr(fileno(stdin), TCSANOW, &newsettings);

Записываем новые настройки в наш терминал.
char rd_ch = '\0';
		int fd_in = open ("/dev/tty", O_RDONLY);
		while(rd_ch != 'q') {
			int read_count = read(fd_in, &rd_ch, 1);
		}

Здесь идёт открытие файл-устройства "/dev/tty" c помощью функции open только для чтения. Можно было также разыменовать дескриптор стандартного ввода через fileno, но сделал так для наглядности. После этого, в цикле мы производим блокирующее чтение из этого файл-устройства по одному символу, пока не получим считанный символ, равный ‘q’.
tcsetattr(fileno(stdin), TCSANOW, &oldsettings);

Восстанавливаем настройки терминала.

Создадим настоящее устройство передачи данных

Предыдущий пример, хоть и был синтетическим, тем не менее часто используется, особенно при вводе паролей, либо при работе с псевдографикой в терминалах. Но наша задача, всё же, получить работу с живым реальным устройством. Для этого на Arduino сделаем такое вот синтетический пример.
void setup() {
    Serial.begin(9600);
}

void loop() {
     Serial.print("01234567890123456789\n\r");
     delay(2000);
}


Мы просто шлём строку «01234567890123456789\n\r» на скорости 9600 каждые две секунды. Умышленно сделал ASCII-символы, чтобы было проще отлаживать.
В терминале вводим
dmesg -w

Таким образом мы можем в реальном времени мониторить сообщения ядра. Подключаем Arduino-плату к нашему компьютеру и видим следующие сообщения:
[83343.555600] usb 2-2: new full-speed USB device number 3 using ohci-pci
[83344.099687] usb 2-2: New USB device found, idVendor=1a86, idProduct=7523, bcdDevice= 2.54
[83344.099694] usb 2-2: New USB device strings: Mfr=0, Product=2, SerialNumber=0
[83344.099698] usb 2-2: Product: USB2.0-Serial
[83344.199375] usbcore: registered new interface driver usbserial_generic
[83344.205220] usbserial: USB Serial support registered for generic
[83344.247903] usbcore: registered new interface driver ch341
[83344.248341] usbserial: USB Serial support registered for ch341-uart
[83344.248819] ch341 2-2:1.0: ch341-uart converter detected
[83344.311747] usb 2-2: ch341-uart converter now attached to ttyUSB0
Для нас самая главная информация, что нас СОМ-порт определился, как ttyUSB0 и обитает он соответственно в /dev/ttyUSB0.
$ ls -la /dev/ttyUSB0 
crw-rw---- 1 root dialout 188, 0 Oct 21 11:38 /dev/ttyUSB0

Для того чтобы с этим файл-устройством можно было работать не из-под root, надо добавить вашего пользователя в группу dialout. Для этого введём команду
sudo usermod -a -G dialout $USER

И перезагрузим систему.
sudo reboot

После успешной перезагрузки, можно проконтролировать корректность работы этого порта. Зададим скорость порта и попробуем прочитать из него содержимое.
$ stty -F /dev/ttyUSB0 9600
$ cat /dev/ttyUSB0 
0123456789

0123456789

0123456789

0123456789

Сообщения появляются раз в две секунды, значит всё корректно работает.
Небольшой полезный хак. Если требуется читать и анализировать сырые данные штатными средствами (без установки дополнительного ПО), то можно использовать программу hexdump:
hexdump -C /dev/ttyUSB0




Простейший пример блокирующего чтения из СОМ-порта

Разберём пример блокирующего чтения из COM-порта был взят отсюда и немного модифицирован. Все исходники будут доступны в отдельном репозитории к этой статье.

Блокирующее чтение, как следует из названия, блокирует программу в системном вызове read до тех пор, пока не появятся данные, которые может получить read. Если данных нет, то этот вызов будет ждать вечно и ничего работать не будет. Этот режим работы наиболее прост для понимания работы с СОМ-портом, и с него лучше всего начинать работать. Примеры работы с портом, разобранные выше, тот же cat и hexdump используют именно блокирующее чтение. Однако, на практике в реальных задачах, такое чтение применяется достаточно редко.

Разберём основные части кода SerialPort_read.c:

Открытие файл-устройства
fd = open("/dev/ttyUSB0",O_RDWR | O_NOCTTY);

Обратите внимание на флаги открытия: O_RDWR – открываем для чтения и записи, O_NOCTTY – терминал не может управлять данным процессом (тот терминал, с которого мы запускаем это приложение, может управлять процессом, например послать сигнал при комбинации ctrl-c).
struct termios SerialPortSettings;
tcgetattr(fd, &SerialPortSettings);

Инициализируем структуру termios и получаем текущие значения структуры.
cfsetispeed(&SerialPortSettings,B9600); 
cfsetospeed(&SerialPortSettings,B9600);

Задаём скорость на чтение и на запись. Обратите внимание, что скорости на чтение и на запись могут быть разными. Так же скорость задаётся макросами, начинающиеся с символа “B” (они описаны в termios.h). Могут принимать следующие значения:

        B0
        B50
        B75
        B110
        B134
        B150
        B200
        B300
        B600
        B1200
        B1800
        B2400
        B4800
        B9600
        B19200
        B38400
        B57600
        B115200
        B230400

Нулевая скорость, B0, используется для завершения связи.

Далее идут стандартные настройки порта:
SerialPortSettings.c_cflag &= ~PARENB;

Отключаем бит чётности (если флаг очищен).
SerialPortSettings.c_cflag &= ~CSTOPB;

Если флаг установлен, то стоп-бит равен двум, если очищен (в этом случае), то равен одному.
SerialPortSettings.c_cflag &= ~CSIZE;

Очищаем маску размера данных.
SerialPortSettings.c_cflag |=  CS8;

Устанавливаем размер передаваемых данных, равный восьми битам.
SerialPortSettings.c_cflag &= ~CRTSCTS;

Отключаем аппаратное управление потоком данных (RTS/CTS).
SerialPortSettings.c_cflag |= CREAD | CLOCAL;

Включаем приёмник, игнорируем контрольные линии модема.
SerialPortSettings.c_iflag &= ~(IXON | IXOFF | IXANY);

Отключаем управление потоком данных при вводе и выводе, отключаем возможность символов запускать ввод.
SerialPortSettings.c_iflag &= ~(ICANON | ECHO | ECHOE | ISIG);

Переводим терминал в неканонический режим (мы это уже разбирали).
SerialPortSettings.c_oflag &= ~OPOST;

Отключаем режим ввода, определяемый реализацией по умолчанию.

Теперь самое интересное (с этими параметрами мы ещё поиграемся). Хоть мы их разбирали уже, посмотрим какое будет поведение у них в нашем случае.
SerialPortSettings.c_cc[VMIN] = 40;

Считываем за раз только 40 символов.
SerialPortSettings.c_cc[VTIME] = 10;

Считываем каждую секунду. То есть, если значение отличное от нуля, функция read будет разблокирована по этому значению в децисекундах.
tcsetattr(fd,TCSANOW,&SerialPortSettings)

Записываем значение структуры termios.

Вы осознаёте теперь всю сложно работы с COM-портом? При этом мы не разобрали даже половины его возможностей, а уже это оказывается дико сложным. В любом случае придётся внимательно разобраться со всеми флагами структуры termios, чтобы понять, как корректно работать с портом.
Чтение у нас происходит в бесконечном цикле.
while (1) {
  tcflush(fd, TCIFLUSH);   //очищаем старые данные в буфере RX
  bytes_read = read(fd,&read_buffer,32); //запрос на чтение 32-х байт 
  printf("\n\n  Bytes Rxed -%d", bytes_read);
  for(i=0;i<bytes_read;i++)
    printf("%c",read_buffer[i]); //печать считанных символов
}

Скомпилируем и посмотрим, что же она будет у нас считывать.
$ gcc SerialPort_read.c -o SerialPort_read
$ ./SerialPort_read 

 +----------------------------------+
 |        Serial Port Read          |
 +----------------------------------+
  ttyUSB0 Opened Successfully 
  BaudRate = 9600 
  StopBits = 1 
  Parity   = none

  Bytes Rxed -11

  0123456789


  Bytes Rxed -11

  0123456789
….

Таким образом, при данных настройках корректно вычитывает наше сообщение.

Аналогично запись (системный вызов write) может быть блокирующей и не блокирующей, но в данном случае это не очень критично, так как после копирования данных в буфер ядра запись разблокируется.

Как сделать неблокирующее чтение?

Неблокирующее чтение отличается от блокирующего чтения тем, что если в буфере ядра linux нет данных, то функция read не будет ожидать их получения и сразу вернёт управление программе. С одной стороны это очень удобно, но с другой, если вы ожидаете посылку, то вам придётся в цикле читать, пока не получите данные. Для этих целей существует такие вещи как — select, poll и epoll. В рамках этой статьи нет возможности разобрать работу с ними, поэтому буду краток.
В своём вебинаре о работе с СОМ-портом (ссылки будут ниже), я разбирал пример чтения карт-ридера магнитных карт. Там у меня уже готовая библиотека работы с СОМ-портом. Её мы и разберём. Пример обитает тут.

Не буду разбирать подробно всю программу, пробегусь по основным моментам. Остальное в ней всё достаточно очевидно, и многое мы уже разобрали. Всё будет в файле uart.c.
Чтобы перевести СОМ-порт в неблокирующий режим, после открытия порта, нам необходимо файловый дескриптов перевести в режим неблокирующего чтения. Это делается с помощью функции.
fcntl(fd, F_SETFL, FNDELAY);

Таким образом, теперь, мы будем выходить сразу, после функции read, вне зависимости есть у нас данные или нет.
Сейчас стоит задача ожидать данные в буфере ядра, и если их нет выходить по какому-то таймауту, возвращая управления программе. Для этого напишем следующую функцию.
int read_com(int fd, int len , int timeout, uint8_t * buff){
	int ret = 0;
	
	struct pollfd fds;
	fds.fd=fd;
	fds.events = POLLIN;
	poll(&fds, 1, timeout);
	if(fds.revents & POLLIN) {
		ret = read(fd, buff, len);
	}
	if(ret<0){
		ret = 0;
	}
	return ret; 
}

На вход функция принимает файловый дескриптор открытого порта, длину запрашиваемых данных, таймаут в миллисекундах, после которого возвращается управление системе и указатель на буфер, куда будут считаны данные.
Управление осуществляется с помощью структуры:
struct pollfd fds;

В неё мы записываем файловый дескриптор, который хотим мониторить.
fds.fd=fd;

Указываем, то что мы хотим мониторить событие получение данных:
fds.events = POLLIN;

И соответственно взводим наш «сторожевой таймер».
poll(&fds, 1, timeout);

Из этой функции мы выйдем, либо по таймауту, либо по получению данных.

Дальше мы проверяем событие, которое произошло. И если событие соответствует POLLIN, то производим чтение данных.
И после чего возвращаем количество считанных данных или нуль в случае ошибки или нуля данных. Это не очень корректно, так как всё же лучше обработать все возникающие ошибки, а не отправлять нуль. Но это тестовый пример и можно так сделать.
Аналогичная функция есть и для записи. Для чего это нужно, ведь мы просто копируем данные в ядро? Да очень просто, если у вас режим передачи RS-485 управляется линией DTR/RTS, либо GPIO, то вы должны точно знать, когда данные были отправлены, чтобы правильно выставить эти пины, меняя режим передачи на приём. Выглядит это всё следующим образом.
int write_com(int fd, uint8_t * buf, size_t size, int timeout){
	int ret = 0;

	struct pollfd fds;
	fds.fd=fd;
	fds.events = POLLOUT;
	
	poll(&fds, 1, timeout);
	if(fds.revents & POLLOUT){
#ifdef USE_RTS
		set_rts(fd,RTS_SET);
#endif
		ret = write(fd, (uint8_t*)buf, size);

		tcdrain(fd); 
#ifdef USE_RTS
		set_rts(fd,RTS_CLR);
#endif
	}
	
	if(ret!=size) return 0;
	return 1; 
}

Здесь poll настроен на передачу. Единственное, на что стоит обратить внимание, это на вызов функции tcdrain(fd); Эта функция будет ожидать, пока все данные вывода, записанные на объект, на который ссылается fd, не будут переданы. Функцию int set_rts(int fd, int on) мы разберём в следующей главе.

Как подрыгать ножкой DTR и RTS, а также пара слов о RS-485

Кроме системных вызовов read и write, есть системный вызов ioctl, который позволяет осуществлять тонкую настройку. Будем честны, вот эта работа со структурой termios, внизу имеет системный вызов ioctl, который записывает все настройки в ядро. Но это от нас скрыто библиотечными функциями. Системный вызов ioctl не стандартизован и очень опасен, но позволяет производить тонкую настройку порта. Приведу пример функции установки или снятия сигнала rts.
int set_rts(int fd, int on){
	int flags;

	ioctl(fd, TIOCMGET, &flags);
	if (on) {
		flags |= TIOCM_RTS;
	} else {
		flags &= ~TIOCM_RTS;
	}
	ioctl(fd, TIOCMSET, &flags);
	return 1;
} 

Изначально мы получаем состояние флагов порта в переменную &flags.
ioctl(fd, TIOCMGET, &flags);

После чего, либо снимаем флаг состояния TIOCM_RTS, либо устанавливаем его.
И после этого записываем его
ioctl(fd, TIOCMSET, &flags);

Аналогично выглядит функция работы с сигналом DTR.
int set_dtr(int fd, int on){
	int flags;

	ioctl(fd, TIOCMGET, &flags);
	if (on) {
		flags |= TIOCM_DTR;
	} else {
		flags &= ~TIOCM_DTR;
	}
	ioctl(fd, TIOCMSET, &flags);
	return 1;
}

С RS-485 в линуксе всё обстоит не важно. Этот интерфейс совершенно не стандартизирован, и каждый производитель может делать всё что захочет. Где-то его нужно инициализировать в ядре, и драйвер ядра будет автоматически переключать приёмо-передатчик, где-то это всё реализовано аппаратно. Тут всё как бог на душу положит. Поэтому, с RS-485 приходится разбираться на месте. Но моя практика показывает, что всё что написано в документации – не актуально. Единственный эффективный путь – это лезть в код ядра и смотреть, что же там происходит на самом деле.

Выводы

Очень сложно в рамках маленькой статьи рассказать о таком сложном явлении в linux, как работа с терминалами. Получается так, что надо сначала понять почему COM-порт не порт, а на самом деле терминал, и как его превратить обратно в порт. Этот терминал имеет множество режимов работы и функционала. И, в силу исторических причин, несёт это огромное наследие дальше. Работа с другими интерфейсами в linux (тем же i2c сильно проще). Di_halt просил меня рассказать о примерах работы с прерываниями и прочим, но это всё лишняя информация. Реальная работа с железом, именно с портами идёт в драйверах внутри ядра linux. Здесь мы взаимодействуем с интерфейсом, который предоставляет нам драйвер.
Если хочется сделать красиво, то правильно будет чтение из порта осуществлять в отдельном программном потоке, а основная программа будет работать в другом потоке. Дальше уже передачу данных осуществлять с помощью между поточного взаимодействия. Тут можно и посылать сигналы основному потоку, после получения данных (аналог прерывания по получению), либо любое другое приятное решение на любой вкус и цвет.
Для тех, кто ничего не понял в этой статье, либо просто хочет расширить свой кругозор, рекомендую посмотреть мой вебинар о программировании СОМ-портов под линукс. Там я достаточно подробно и с живыми примерами рассказываю об особенностях работы с ними.





Примеры к данным видео можно найти вот тут.

Все программы, которые продемонстрированные были в данной статье можно найти у меня в гитхабе.



  • +17
  • 23 октября 2020, 17:33
  • _dlinyj_

Комментарии (12)

RSS свернуть / развернуть
Перезагружаемся?! Вы серьёзно?!
0
Потружусь пояснить для читателей, что возмущает blacklion .

Для того, чтобы изменения применились, необходимо завершить сеанс. Но поскольку завершение сеанса в разных случаях может означать разное (завершение сеанса всех ssh-сессий, либо через графический интерфейс завершить сеанс), написал что следует перезагрузится. И тот и тот вариант применит изменения, но не всегда есть возможность сделать перезагрузку.
0
Не надо все ssh сессии, просто в новых будет новое, в старых — старое, если мы сидим несколькими сеансами ssh на одном сервер (а зачем? tmux/screen отменили?). Ну а в случае X'ов надо логаут-логин, конечно, там все процессы от одного корня живут.
Но перезагружаться вместо логаута (ssh, консольного или X/Wayland) — это винда какая-то получается :-)
0
Просто некоторые могут подумать, что закрытие окна терминала будет завершение сессии, но это не так.
0
Стаття супер. Познавательно и доступно.
0
Спасибо.
0
Статья хорошая, реализация компорта в линухах — говно. В масдае и то на порядок лучше сделано.
Моя думай — это настоящие пирограмисты вымещали свою ненависть к пра-а-а-ативнаму железу. Ничем другим маниакальную страсть загнать всё многообразие компьютерных потрохов в свинцовые тиски концепции потока — объяснить нельзя.
0
Это вы ещё с IrDA в linux не работали.
0
По поводу fcntl и F_SETFL
не должен ли быть там третий аргумент O_NONBLOCK?
0
  • avatar
  • OlegG
  • 27 октября 2020, 21:58
man fcntl
F_SETFL (int)
Set the file status flags to the value specified by arg. File access mode (O_RDONLY, O_WRONLY,
O_RDWR) and file creation flags (i.e., O_CREAT, O_EXCL, O_NOCTTY, O_TRUNC) in arg are ignored.
On Linux, this command can change only the O_APPEND, O_ASYNC, O_DIRECT, O_NOATIME, and O_NONBLOCK
flags. It is not possible to change the O_DSYNC and O_SYNC flags; see BUGS, below.

/usr/include/x86_64-linux-gnu/bits/fcntl-linux.h
# define FNONBLOCK O_NONBLOCK
# define FNDELAY O_NDELAY
0
Я как то использовал всегда O_NONBLOCK
Но это все одно и то же
# define O_NDELAY O_NONBLOCK
0
Только зарегистрированные и авторизованные пользователи могут оставлять комментарии.