Windows.Devices.SerialCommunication 네임스페이스

Windows.Devices.SerialCommunication 네임스페이스는 UWP 앱이 직렬 포트 또는 직렬 포트의 일부 추상화 또는 직렬 포트를 노출하는 디바이스와 통신하는 데 사용할 수 있는 Windows 런타임 클래스를 정의합니다. 클래스는 이러한 직렬 디바이스를 검색하고, 데이터를 읽고 쓰고, 흐름 제어에 대한 직렬별 속성(예: 전송 속도, 신호 상태 설정)을 제어하는 기능을 제공합니다.

디바이스 지원

직렬 디바이스는 속성DEVPKEY_Device_ClassGuid{4d36e978-e325-11ce-bfc1-08002be10318} = 으로 시스템에 자신을 노출하고 (GUID_DEVINTERFACE_COMPORT)를 사용하여 DeviceInterface DEVPKEY_DeviceInterface_ClassGuid = {86e0d1e0-8089-11d0-9ce4-08003e301f73} 를 만듭니다.

Windows는 기본적으로 받은 편지함 usbser.sys 드라이버(예: Arduino Uno R3s에서 사용되는 드라이버)를 사용하여 USB-CDC 디바이스 클래스에 속하는 직렬-USB 어댑터에서 노출되는 포트를 지원합니다. USB-CDC 호환 ID는 다음과 같습니다.

• USB\Class_02&SubClass_02&Prot_01
• USB\Class_02&SubClass_02

를 노출 GUID_DEVINTERFACE_COMPORT하는 다른 직렬-USB 어댑터(예: FTDI/Prolific/Silicon-Labs)도 지원되지만 추가 공급업체별 드라이버가 필요합니다.

공급업체 드라이버가 무제한()으로 명시적으로 표시하지 않는 한 컴퓨터 내부DEVPKEY_Device_InLocalMachineContainer == TRUE로 표시된 직렬 포트(DEVPKEY_DeviceInterface_Restricted == TRUE)는 액세스할 수 없습니다. 따라서 대부분의 PCI COM 포트 확장 카드를 통해 연결하는 디바이스는 액세스할 수 없습니다 .

액세스할 수 없는 직렬 포트는 DeviceInformation.FindAllAsync()에서 열거할 수 있지만 SerialDevice.FromIdAsync()에서 열 수 없습니다. 이러한 디바이스를 열면 예외가 throw되거나 null이 반환됩니다. 앱은 사용자가 지원되지 않는 직렬 포트와 상호 작용할 수 없도록 사용자 보기에서 이러한 직렬 포트를 필터링하여 이 사례를 처리해야 합니다.

DeviceInformation.FindAllAsync()에서 반환된 DeviceInformation 컬렉션에 DeviceInformation.Name 속성이 컴퓨터 이름으로 설정된 직렬 디바이스가 있을 수 있습니다. 이는 의도적으로 수행되며 온보드 직렬 포트를 열거할 때 발생할 수 있습니다. 앱은 다음 중 하나를 통해 이 사례를 처리해야 합니다.

• 사용자가 지원되지 않는 직렬 포트와 전혀 상호 작용할 수 없도록 사용자 보기에서 이러한 직렬 포트를 필터링합니다.
• 앱이 사용자가 이러한 직렬 포트와 상호 작용하도록 하기로 결정한 경우 앱이 DeviceAccessInformation.CreateFromId() 함수를 호출할 때 다음과 같은 메시지와 함께 예외가 발생합니다. "시스템에서 지정된 파일을 찾을 수 없습니다. (HRESULT: 0x80070002 예외)"가 throw됩니다. 앱은 이러한 예외를 처리하고 포트가 지원되지 않는다는 것을 사용자에게 알려야 합니다.

사용자 지정 드라이버를 작성하고 하드웨어 지원 앱을 일치시켜 접근성/기능 정책을 항상 재정의할 수 있습니다.

직렬 디바이스 기능

UWP 앱은 앱 패키지 매니페스트에 특정 디바이스 기능을 포함해야 합니다. 기능은 디바이스 및 해당 용도를 식별합니다. 계층적 순서의 필수 요소는 다음과 같습니다.

Windows 10, 버전 1809 이후(2018년 10월 업데이트)

1809 이후 vidpid 및 함수 형식은 더 이상 지정할 필요가 없으며 이러한 시스템에서 무시됩니다. 1809 이전 시스템을 대상으로 하는 경우 아래를 참조하세요.

• <DeviceCapability>: Name 특성은 이어야 serialcommunication합니다.

<DeviceCapability Name="serialcommunication"/>

Windows 10, 버전 1809 이전(2018년 10월 업데이트)

• <DeviceCapability>: Name 특성은 이어야 serialcommunication합니다.

  • <디바이스>: ID 특성은 디바이스 식별자를 지정해야 합니다. 직렬-USB 어댑터를 사용하는 경우 ID 는 공급업체/제품 식별자를 지정해야 합니다. 또는 함수 유형과 일치하는 모든 디바이스에 대한 액세스를 허용하려면 "any"일 수 있습니다.

    • <함수>: Type 특성은 디바이스 함수를 지정합니다. 직렬 디바이스의 경우 이어야 serialPort합니다.

<DeviceCapability Name="serialcommunication">
    <Device Id="vidpid:xxxx xxxx">
      <Function Type="name:serialPort"/>
    </Device>
</DeviceCapability>

직렬 디바이스 기능 예제

다음은 직렬 디바이스 기능을 정의하는 예제입니다. 이를 통해 앱은 직렬-USB 어댑터를 통해 직렬 포트에 액세스할 수 있습니다.

<DeviceCapability Name="serialcommunication">
  <Device Id="vidpid:045E 0610">
    <Function Type="name:serialPort"/>
  </Device>
</DeviceCapability>

문제 해결

• 직렬 기능(serialcommunication)이 애플리케이션 매니페스트에 있는지 확인합니다.
• 사용자가 직렬 디바이스를 활용할 수 있는 권한을 애플리케이션에 부여했는지 확인합니다.
• 컴퓨터 내부 디바이스(DEVPKEY_Device_InLocalMachineContainer == TRUE)는 일반적으로 액세스할 수 없습니다 . (예: PCI COM 포트 확장 카드)
  • 에 대한 GUID_DEVINTERFACE_COMPORT 디바이스 인터페이스 속성을 DEVPKEY_DeviceInterface_Restricted 로 설정FALSE하지 않으면 내부 디바이스에 액세스할 수 없습니다. 특정 드라이버, 특히 IoT SKU에서 이 속성을 FALSE로 설정할 수 있습니다.
  • 1903(2019년 5월 업데이트)에 따라 직렬 컨트롤러에 SerCx 액세스하거나 SerCx2 Windows 10 시작하는 경우 디바이스는 사용자 모드에서 또는 를 사용하도록 설정하여 RhProxy직접 액세스할 수 있도록 옵트인할 수 있습니다.
• 드라이버 개발자와 협력하여 하드웨어 지원 앱을 만들어 사용자 지정 디바이스를 만들 때 이러한 제한을 무시할 수 있습니다.