리눅스 시리얼 프로그래밍 하우투

Peter H. Baumann, Peter.Baumann@dir.de

v1.0, 22 January 1998 전성민, schun@crypto.pe.kr

v1.0.1, 2 July 2007 이우성, 제가 보기 좋게 위키문법으로 바꿔보았습니다. 근데 왜 잘 안 나오는지 모르겠습니다...:(

이 문서는 리눅스 시스템에서 시리얼 통신을 어떻게 프로그래밍하는가를 설명하는 하우투 문서이다.

5 September 2007 Linuxdoc Sgml/Serial-Programming-HOWTO 가 제대로 렌더링 되지 않는 것 같아서 복사 및 편집 하였습니다. -webtk

이 문서는 리눅스 시스템에서 시리얼 통신을 어떻게 프로그래밍하는가를 설명하는 하우투 문서이다. 다양한 시리얼 통신 프로그램 기법들(Canonical I/O, 비동기 I/O, I/O 멀티플렉싱)을 설명한다.

시리얼 포트를 셋업하는 방법에 대해서는 Greg Hankins의 Serial-HOWTO 문서를 읽어보기 바란다.

나는 이 분야의 전문가가 아님을 먼저 밝혀둔다. 그러나 프로젝트를 하면서 많은 문제들에 부딪혔다. 이 문서에 소개된 코드 예제들은 LDP(Linux Document Project) 프로그래머 가이드 에서 구할 수 있는 miniterm code에 근거하여 만들었다.

1997년 6월에 이 문서를 작성한 뒤에 나는 고객의 요구에 의해 Win NT 환경으로 옮기게 되어서 더 이상 깊은 지식을 얻을 수 없었다. 누구든지 커맨트가 있으면 이 문서를 관리하는데에 기꺼이 활용하겠다.(Feedback 부분을 볼 것) 또한 이 문서의 유지 및 관리를 맡고 싶거나 version UP을 원한다면 e-mail을 주기 바란다.

이 문서의 모든 예제는 i386 Linux Kernel 2.0.29에서 테스트를 하였다.

The Linux Serial-Programming-HOWTO is copyright (C) 1997 by Peter Baumann. Linux HOWTO documents may be reproduced and distributed in whole or in part, in any medium physical or electronic, as long as this copyright notice si retained on all copies. Commercial redistribution is allowed and encouraged; however, the author would like to be notified of any such distributions.

All translations, derivative works, or aggregate works incorporating any Linux HOWTO documents must be covered under this copyright notice. That is, you may not produce a derivative work from a HOWTO and impose additional restrictions on its distribution. Exceptions to thes rules may be granted under certain conditions; please contact the Linux HOWTO coordinator at the address given below.

In short, we wish to promote dissemination of this information through as many channels as possible. However, we do wish to retain copyright on the HOWTO documents, and would like to be notified of any plans to redistribute the HOWTOs.

If you have questions, please contact Tim Bynum, the Linux HOWTO coordinator, at linux-howto@sunsite.unc.edu via email.

이 문서의 최신 버전은 ftp://sunsite.unc.edu/pub/Linux/docs/HOWTO/Serial-Programming-HOWTO 와 미러 사이트에서 찾을 수 있다. PostScript 및 DVI 버전도 다른 포맷들을 갖고 있는 디렉토리에 있다. http://sunsite.unc.edu/LDP/HOWTO/Serial-Programming-HOWTO.html 에서도 구할 수 있으며, news:comp.os.linux.answers 에 매달 포스팅 될 것이다.

오류, 질문, 커맨트, 건의사항이나 그 외 추가할 사항이 있다면 알려주기 바란다. 이 HOWTO를 계속적으로 업데이트 하기를 원한다. 당신이 정확히 이해하지 못하는 부분이 있거나 더 명확해야 할 부분이 있다면 알려줘라. 내 e-mail 주소는 Peter.Baumann@dir.de 이다. 이 문서에 관한 e-mail을 보낼 때는 문서의 버전도 같이 알려줘라. 이 문서 버전은 1.0이다.

코드를 디버깅하는 가장 좋은 방법은 또 하나의 리눅스 박스를 셋업하고 두 리눅스 박스를 null-modem 케이블로 연결하는 것이다. Miniterm 프로그램을 이용하여 문자들을 전송해보라. Miniterm은 컴파일하기도 쉽고, 키보드에서 입력되는 문자들(특수문자 포함)을 시리얼 포트로 전송할 수 있다. 컴파일할 때 체크해야 할 것은

문장이 제대로 설정되어 있는가 하는 것이다. COM1으로 맞추려면 /dev/ttyS0, COM2로 하려면 /dev/ttyS1으로 수정한다. 테스팅을 할 때 가장 중요한 것은 문자가 시리얼 포트로 출력될 때 데이터가 출력 데이터 처리(output processing)을 하지 않고 그대로(raw) 전송이 되는가를 확인하는 것이다. 테스트 과정은 다음과 같다. 두 대의 리눅스 박스에서 각각 miniterm 프로그램을 실행시키고 키보드를 쳐본다. 한 곳에서 타이핑한 문자가 다른 곳에서 그대로 나타나는 지 확인한다.

Null-modem 케이블의 TxD와 RxD가 서로 cross 연결이 되어야 한다. 잘 모르겠으면 Serial-HOWTO 문서의 7장을 본다.

위의 테스트는 한 대의 컴퓨터만 갖고도 가능하다. 사용할 수 있는 시리얼 포트가 두 개 있다면 케이블을 각각의 시리얼 포트에 연결하고 miniterm을 두 개 실행하여 테스트하면 된다.

장치 파일인 /dev/ttyS*는 리눅스에서 터미널을 연결하기 위한 목적으로 사용된다. 이 사실은 시리얼 통신 프로그래밍을 하는데 반드시 기억해야 할 사항이다. 예를 들어, 시리얼 포트도 문자 에코를 하도록 설정되어 있다. 이 설정은 보통 데이터 전송시에 바꿔야 할 사항이다. (역자 주: 시리얼 장치 파일도 터미널 장치로 분류되기 때문에 초기 설정은 일반 터미널에서 사용되는 에코가 되도록 설정되어 있는 것이다.)

모든 파라미터들은 프로그램 코드에서 쉽게 설정할 수 있다. 파라미터들은 <asm/termbits.h>에 정의되어 있는 struct termios 구조체에 저장되어 있다.

이 파일은 모든 flag들을 정의하고 있다. c_iflag(입력 모드 flag)는 모든 입력 처리(input processing)를 정의한다. 입력 처리란 read() 함수에 의해 시리얼 포트로 들어온 데이터를 read에 의해 읽기 전에 데이터들을 c_iflag에 정의한 대로 처리하는 것을 의마한다. c_oflag(출력 모드 flag)는 출력 처리(output processing) 하는 방법을 정의한다. c_cflag(제어 모드 flag)는 baudrate, data bits, stop bits 등의 포트 세팅을 정의한다. c_lflag(local 모드 flag)는 echo를 할 것인지 등을 결정한다. 마지막으로 c_cc(제어 문자) 배열은 EOF(End of File), STOP 등의 제어 동작들을 어떤 문자로 정의할 것인가를 설정한다. 제어 문자의 디폴트 문자는 <asm/termios.h>에 정의되어 있다. 위 flag들에 관한 설명은 termios(3) man page에 나와있다. termios 구조체의 c_line 항목은 POSIX 호환 시스템에서 사용되지 않는다.

이 섹션에서는 세 가지의 입력 방법을 기술하기로 한다. 응용 분야에 따라서 알맞은 방법을 사용해야 한다. 한 문자씩 읽는 루프를 돌려서 전체 문자열을 받는 방법은 가능하다면 피해야 한다. 내가 이런 방법으로 했을 때, 문자를 잃어버리는 경우가 생긴 반면, 전체 문자열을 한번에 읽을 때는 에러가 발생하지 않았다.

Canonical 입력 처리는 터미널의 기본 처리 방법이다. 이 방법은 한 줄 단위로 처리하는 다른 프로그램과 통신하는데에 사용할 수 있다. 한 줄은 디폴트로 NL(New Line, ASCII는 LF) 문자, EOF(End of File) 문자, 혹은 EOL(End of Line)에 의해 종료되는 문자열을 의미한다. CR(Carriage Return, DOS/Windows의 디폴트 EOL 문자임) 문자는 디폴트 세팅에서 한 줄의 종료 문자로 인식되지 않는다.

또한 Canonical 입력 처리 모드에서는 ERASE, DELETE WORD, REPRINT CHARACTERS 문자들을 처리할 수 있고, CR 문자를 NL 문자로 변환 처리를 할 수 있다.

Non-Canonical 입력 처리 모드에서는 한 번 읽을 때마다 정해진 크기의 문자만을 읽어낼 수 있다. 또한 타이머를 두어서 일정 시간까지 read()가 리턴하지 않는 경우 강제 리턴을 할 수 있다. 이 모드는 항상 정해진 크기의 문자들만을 읽어내거나 대량의 문자들을 전송하고자 할 때 사용한다.

위에서 설명한 두 가지 모드는 동기 방식이나 비동기 방식으로 사용될 수 있다. 동기 방식은 read의 조건이 만족될 때까지 block되는 방식으로서 디폴트로 설정되어 있다. 비동기 방식에서는 read() 함수가 바로 리턴되며, 호출한 프로그램에게 signal을 보낸다. 이 signal은 signal handler(시그널 처리 함수)로 보내진다.

위에서 설명한 입력 모드에 해당하진 않지만 여러 개의 장치들을 다루고자 할 때 유용하다. 예를 들어 내 응용 프로그램에서 TCP/IP 소켓과 시리얼 통신에서 동시에 입력을 받아야 했다. 아래 3.4의 예제는 두 개의 서로 다른 장치로부터 동시에 입력을 기다리는 코드이다. 둘 중 한 개의 장치에서 입력이 들어오면 처리를 하고 또 다시 새로운 입력이 올 때까지 기다린다.

아래 3.4의 예제는 복잡해 보일 수 있지만, 리눅스가 multi-processing OS임을 알고 있기에 매우 중요하다. select() 시스템 호출 함수는 입력을 기다리는 동안 CPU에 부하를 주지 않는다. 반면 입력이 들어왔는지 루프를 돌면서 체크하는 polling 방식은 시스템에 부하를 주게 되어 다른 프로세스의 수행 속도를 저하시키게 된다.

여기의 모든 예제는 miniterm.c에서 따왔다. Canonical 입력 처리에서 처리할 수 있는 최대 길이의 문자는 255개(<linux/limits.h> 혹은 <posix1_lim.h>에 정의됨) 로서 버퍼의 최대 길이는 255로 제한된다.

여러 입력 처리 모드의 사용법에 대한 설명을 원하면 코드 내의 comment를 참조하라. 코드가 이해하기 쉽기를 바란다. Canonical 입력 처리 모드의 예제는 comment를 가장 잘 해놓았다. 다른 예제는 canonical 모드 예제와 다른 부분에만 comment를 달았다.

설명이 완벽하진 않지만, 이 예제로 직접 테스트를 해보면 당신의 프로그램에 적용할 때 최적의 방법을 찾을 수 있을 것이다.

시리얼 포트 장치 파일의 선택을 제대로 했는가를 다시 한 번 확인하고, 파일 접근 허가는 제대로 되어 있는지 보기를 바란다. (예: chmod a+rw /dev/ttyS1)

Non-Canonical 입력 처리 모드에서는 입력이 한 줄 단위로 처리되지 않는다. erase, kill, delete 등의 입력 처리도 수행되지 않는다. 이 모드에서 설정하는 파라미터는 c_ccVTIME과 c_ccVMIN 두 가지이다. c_ccVTIME은 타이머의 시간을 설정하고, c_ccVMIN은 read할 때 리턴되기 위한 최소의 문자 개수를 지정한다.

MIN > 0, TIME = 0 MIN은 read가 리턴되기 위한 최소한의 문자 개수. TIME이 0이면 타이머는 사용되지 않는다.(무한대로 기다린다.)

MIN = 0, TIME > 0 TIME은 time-out 값으로 사용된다. Time-out 값은 TIME * 0.1 초이다. Time-out이 일어나기 전에 한 문자라도 들어오면 read는 리턴된다.

MIN > 0, TIME > 0 TIME은 time-out이 아닌 inter-character 타이머로 동작한다. 최소 MIN 개의 문자가 들어오거나 두 문자 사이의 시간이 TIME 값을 넘으면 리턴된다. 문자가 처음 들어올 때 타이머는 동작을 시작하고 이후 문자가 들어올 때마다 재시작된다.

MIN = 0, TIME = 0 read는 즉시 리턴된다. 현재 읽을 수 있는 문자의 개수나 요청한 문자 개수가 반환된다. Antonino씨에 의하면 read하기 전에 fcntl(fd, F_SETFL, FNDELAY); 를 호출하면 똑같은 결과를 얻을 수 있다.

newtio.c_ccVTIME과 newtio.c_ccVMIN을 수정하여 위 네 가지 방식을 테스트 할 수 있다.

이 섹션은 간략한 설명만을 하겠다. 어떻게 하는 지에 대한 간단한 힌트만을 주기 위한 것이므로 짧은 예제 코드만을 담았다. 이 방법은 시리얼 포트에만 적용되는 것이 아니라 file descriptor를 사용하는 모든 입출력에 사용할 수 있다.

select() 시스템 호출 함수와 해당하는 매크로 함수들은 fd_set을 사용한다. fd_set는 bit array로서 file descriptor의 bit entry로 작용한다. select()는 해당하는 file descriptor의 bit들을 세팅한 fd_set을 입력 파라미터로 받아서 입력, 출력 혹은 예외 발생이 일어난 경우 리턴한다. fd_set은 FD_로 시작하는 매크로 함수들을 통해서 관리한다. select(2)의 man page를 참조하라.

위의 예제 코드는 입력이 들어올 때까지 계속 block 되는 동작을 보여준다. Time-out이 필요하다면, 다음과 같이 바꾼다.

이 예제는 1초 후에 time-out이 되는 것을 보여준다. Time-out이 일어나면 select()는 0을 반환한다. 여기서 주의할 점은, 설정한 Timeout 값은 select()에 의해서 감소하기 때문에 다시 select()를 호출한다면 Timeout.tv_usec과 Timeout.tv_sec 값을 다시 설정해야 한다. Timeout 값이 0이 되면 time-out이 발생하고 select()는 즉시 리턴된다.

Serial-HOWTO 문서는 시리얼 포트를 어떻게 셋업하는지를 설명하고 하드웨어 정보를 제공한다.

Michael Sweet의 Serial Programming Guide for POSIX Compliant Operating Systems 이 링크는 옛날 것이고 최신 위치를 찾을 수가 없다. 이거 찾아줄 분 누구 없수? 이 문서는 매우 잘 정리된 것이다. (역자 주: 다시 이 위치가 부활했다. 예전에 잠시 폐쇄된 적이 있었다.)

termios(3) man page는 termios 구조체의 모든 flag에 대해 정의되어 있다.

1장의 소개 부분에서 언급했듯이, 나는 이 분야의 전문가가 아니다. 그러나 여러 문제에 부딪혔었고, 다른 이들의 도움을 받아서 문제들을 해결했다. Strudthoff 씨, Michael Carter(mcarter@rocke.electro.swri.edu)씨 및 Peter Walternberg(p.waltenberg@karaka.chch.cri.nz) 씨의 도움에 감사한다.

Antonino Ianella(antonino@usa.net)씨는 내가 이 문서를 작성할 때 Serial-Port-Programming Mini HOWTO를 썼다. Greg Hankins씨는 Antonino의 Mini-HOWTO를 이 문서에 넣으라고 권했다.

이 문서의 구조와 SGML 포맷은 Greg Hankins씨의 Serial-HOWTO에서 따왔다. 이 글에서 오류를 수정할 수 있도록 도와주신 많은 분들이 있다. Dave Pfaltzgraff(Dave_Pfaltzgraff@patapsco.com), Sean Lincolne(slincol@tpgi.com.au), Michael Wiedmann(mw@miwie.in-berlin.de), Adrey Bonar(andy@tipas.lt) 씨에게 감사한다.

CategoryDevelopment