Модемы и факс-модемы. Программирование для MS-DOS и Windows.

5.9. Стандартные функции библиотеки Си

Библиотеки трансляторов Borland C++ и Turbo C содержат две функции управления портами асинхронного последовательного адаптера - bioscom и _bios_serialcom. Обе эти функции обладают одинаковыми возможностями, но функция _bios_serialcom совместима с функцией _bios_serialcom из библиотек трансляторов фирмы Microsoft. Функция bioscom помечена в документации как устаревшая и оставлена для совместимости с ранними версиями трансляторов фирмы Borland.

Функции _bios_serialcom и bioscom управляют асинхронным последовательным портом компьютера через прерывание BIOS INT 0x14. Вследствие этого функция bioscom может не работать со скоростями больше чем 9600 бит/сек. Если вам нужны программы, обеспечивающие более высокие скорости, необходимо использовать непосредственное программирование портов асинхронного последовательного адаптера.

Рассмотрим функцию _bios_serialcom более подробно. Она объявлена в файле BIOS.H следующим образом:

unsigned _bios_serialcom( unsigned service, unsigned serial_port, unsigned data );

Первый аргумент функции - serial_port - определяет номер порта. Для порта COM1 этот аргумент должен быть равен 0, для COM2 - 1 и так далее.

Второй аргумент - service - определяет производимое функцией действие и может содержать одну из следующих констант:

Назначение третьего аргумента функции - data - зависит от значения аргумента service. Если аргумент service установлен на _COM_RECEIVE или _COM_STATUS, то значение аргумента data безразлично. Если аргумент service установлен как _COM_INIT, то этот аргумент может состоять из одного или нескольких констант, объединенных булевой операцией ИЛИ. Данные константы приведены в следующей таблице:

Функция возвращает 16-битное целое число. В старшем байте возвращаемого значения содержатся биты, определяющие состояние последовательного порта. Содержимое младшего байта зависит от значения параметра service, с которым вызывалась функция.

Назначение отдельных бит старшего байта представлено в следующей таблице:

Когда аргумент service равен _COM_SEND, бит 15 устанавливается в единицу, если данные не могут быть переданы.

Если аргумент service равен _COM_RECEIVE и чтение байта произошло успешно, он находится в младшем байте возвращаемого функцией значения. Если чтение произошло с ошибками, это отражается битами 9, 10, 11 или 15.

Если атрибут service равен _COM_INIT или _COM_STATUS, биты младшего байта определяются следующим образом:

Для того чтобы введенные символы отображались на экране, надо соединить выход COM-порта с входом. Или использовать два компьютера, соединенных нуль-модемом, запустив программу одновременно на обоих компьютерах.

Листинг 5.10. Файл SERIAL.C

// Программа иллюстрирует доступ к последовательному порту
// через функцию _bios_serialcom()

#include 		// необходимо включить при 
									// использовании _bios_serialcom()
#include 

#define COM1					0    		// первый последовательный порт
#define DATA_READY		0x100		// данные приняты и готовы для
														// чтения
int main(void) {

	unsigned in, out, status;

	// Инициализируем последовательный порт
	// устанавливаем скорость 1200 бит/с, 8 битов на символ, один
	// стоповый бит
	_bios_serialcom(	_COM_INIT, COM1, _COM_1200 |
									_COM_CHR8 | _COM_STOP1);

	printf("\n\n Для выхода нажмите клавишу [ESC]\n");

	for(;;)  {

		// Определяем состояние последовательного порта
		status = _bios_serialcom(_COM_STATUS, COM1, 0);

		// Если данные готовы, считываем их из
		// последовательного порта и выводим на экран  дисплея
		if(status & DATA_READY)
			if((out = _bios_serialcom(_COM_RECEIVE, COM1, 0) &
											0x7F) != 0)
				putch(out);

		// Проверяем, не нажата ли клавиша на клавиатуре?
		if(kbhit()) {

			// Если нажата клавиша [ESC] выходим из программы
			if((in = getch()) == 0x1b)
				break;

			// В противном случае передаем код нажатой клавиши
			// на асинхронный последовательный порт
			_bios_serialcom(_COM_SEND, COM1, in);
		}
	}
	return(0);
}

Теперь рассмотрим функцию bioscom() из библиотеки трансляторов Borland C++ и Turbo C. Эта функция отмечена в документации на Borland C++ версии 4.0, как устаревшая:

int bioscom(int service, char data, int serial_port);

Функция аналогична функции _bios_serialcom(), за исключением следующих моментов:

Отличается порядок следования аргументов функции;

Не соответствуют типы аргументов, имеющие одинаковый смысл;

Рассмотрим подробнее аргументы функции bioscom(). Первый аргумент функции - serial_port - определяет номер порта. Для COM1 этот аргумент должен быть равен 0, для COM2 - 1 и так далее.

Назначение второго аргумента функции - data - зависит от значения аргумента service. Если аргумент service равен единице (_COM_RECEIVE) или тройке (_COM_STATUS), то значение аргумента data безразлично. Если аргумент service равен нулю (_COM_INIT), то этот аргумент может состоять из одного или нескольких битовых полей (констант), объединенных булевой операцией ИЛИ (|). Данные константы приведены в следующей таблице:

По умолчанию используется один стоповый бит, не проводится проверка на четность, обмен происходит со скоростью 110 бит/с.

Третий аргумент - service - может принимать следующие значения:

Возможные значения для старшего байта представлены в следующей таблице: