이 페이지에서는

Qt Serial Port

Qt Serial Port RS-232 핀 배열의 구성, I/O 작업, 제어 신호의 읽기 및 설정과 관련된 기본 기능을 제공합니다.

이 모듈에서는 다음 항목들을 지원하지 않습니다:

  • 에코, CR/LF 제어 등과 같은 터미널 기능.
  • 데이터 전송을 위한 텍스트 모드 표시.
  • 읽기 또는 쓰기 중의 타임아웃 및 지연 설정.
  • 핀 신호 변경에 대한 알림.

모듈 사용법

Qt 모듈의 C++ API를 사용하려면 모듈 라이브러리를 직접 또는 다른 종속성을 통해 링크해야 합니다. CMake 및 qmake를 비롯한 여러 빌드 도구가 이를 위해 전용 지원 기능을 제공합니다.

CMake를 사용한 빌드

find_package() 명령을 사용하여 Qt6 패키지 내에서 필요한 모듈 구성 요소를 찾으십시오:

find_package(Qt6 REQUIRED COMPONENTS SerialPort)
target_link_libraries(mytarget PRIVATE Qt6::SerialPort)

자세한 내용은 ‘CMake를 사용한 빌드’ 개요를 참조하십시오.

qmake를 사용한 빌드

qmake를 사용하여 모듈을 빌드하도록 구성하려면, 프로젝트의 .pro 파일에서 QT 변수의 값으로 해당 모듈을 추가하십시오:

QT += serialport

모듈의 발전

'Qt SerialPort 변경 사항'에는 Qt 6 시리즈를 위해 모듈 API 및 기능에 적용된 주요 변경 사항이 나열되어 있습니다.

라이선스

Qt SerialPort는 The Qt Company의 상용 라이선스에 따라 제공됩니다. 또한, GNU Lesser General Public License 버전 3 또는 GNU General Public License 버전 2에 따라 사용할 수도 있습니다. 자세한 내용은 Qt 라이선싱을 참조하십시오.

© 2026 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.