MB LTE 연결 작업
MBIM 모뎀에 대한 LTE 연결 APN 구성
일반적으로 LTE 연결은 등록의 일부로 간주되었으며 Windows는 LTE 연결 절차에 직접 관여하지 않았습니다. 그러나 일반적인 회로 스위치 네트워크 등록과 달리 LTE는 패킷 스위치 전용 네트워크이며 디바이스가 LTE 네트워크에서 등록을 유지하기 위해 기본 EPS 전달자를 사용하도록 설정해야 합니다.
네트워크로 기본 EPS 전달자를 설정하려면 디바이스가 LTE 연결 프로시저 중에 PDP 컨텍스트 활성화를 요청해야 합니다. 이 경우 APN(액세스 지점 이름) 사양이 필요합니다. 3GPP 표준에 따라 디바이스가 LTE 연결을 시도할 때 APN을 지정할 수 있는 네 가지 시나리오가 있습니다.
- 디바이스는 특정 LTE 연결 APN을 지정합니다.
- 디바이스는 특정 LTE 연결 APN을 지정하지만 네트워크는 로밍 중에 디바이스가 다른 APN에 연결되도록 하기로 결정합니다.
- 디바이스는 LTE 연결 APN을 지정하지 않으며 네트워크에서 디바이스에 다시 할당할 수 있습니다.
- 2G/3G 네트워크에서 LTE로 등록된 디바이스에는 이미 하나 이상의 활성 PDP 컨텍스트가 있었습니다. 네트워크는 이를 LTE 연결 APN으로 사용합니다.
현재 모든 LTE 연결 APN 정보는 구성이 있는 각 공급자에 대한 모뎀에서 IHV 및 OEM에서 직접 제공됩니다. 그러나 IHV 및 OEM이 전 세계 모든 운영자에 대해 가능한 모든 LTE 연결 APN 설정을 갖도록 하는 것은 완전히 확장 가능한 모델이 아닙니다. Windows 10 버전 1703부터 OS에서 LTE 연결 APN 구성을 지원하기 위해 NDIS OID 및 MBIM Microsoft 독점 CID 모두에 대해 새 인터페이스가 정의됩니다.
Windows 10 버전 1703부터 기본 하드웨어가 OS에서 LTE 연결 APN 구성을 지원하는 경우 사용자는 설정에서 LTE 연결 APN을 구성할 수 있습니다. 기본 LTE 연결 APN 구성이 있는 하드웨어는 OS에서도 해당 구성을 사용할 수 있도록 해야 합니다.
이 기능은 두 개의 새 OID 및 CID를 추가하여 지원됩니다. MBIM을 구현하는 IHV 파트너의 경우 CID 버전만 지원되어야 합니다.
LTE 연결 작업에 대한 MB 인터페이스 업데이트
LTE 연결 APN 구성을 허용하고 OS가 디바이스의 최신 LTE 연결 상태 검색할 수 있도록 두 개의 새로운 MBIM CID가 만들어졌습니다. IHV 파트너가 OS 기본 LTE 연결 APN 관리를 지원하기로 결정한 경우 두 명령을 모두 지원해야 합니다.
서비스 이름 = 기본 연결 확장
UUID = UUID_BASIC_CONNECT_EXTENSIONS
UUID 값 = 3d01dcc5-fef5-4d05-0d3abef7058e9aaf
| CID | 명령 코드 | 최소 OS 버전 |
|---|---|---|
| MBIM_CID_MS_LTE_ATTACH_CONFIG | 3 | Windows 10, 버전 1703 |
| MBIM_CID_MS_LTE_ATTACH_STATUS | 4 | Windows 10, 버전 1703 |
MBIM_CID_MS_LTE_ATTACH_CONFIG
Description
LTE 연결 컨텍스트는 런타임 중에 네트워크가 디바이스와 상호 작용하는 방법에 따라 다를 수 있습니다. 이 설명서의 나머지 부분에 대해 LTE 연결 컨텍스트는 LTE 연결에 사용되는 현재 PDP 컨텍스트라고 하며, 기본 LTE 연결 컨텍스트는 다른 기존 사용 PDP 컨텍스트가 없을 때 로 LTE 연결을 수행하는 디바이스에서 구성된 컨텍스트라고 합니다. MBIM_CID_MS_LTE_ATTACH_CONFIG OS에서 삽입된 SIM 공급자(MCC/MNC 쌍)의 기본 LTE 연결 컨텍스트를 쿼리하고 설정할 수 있도록 합니다.
LTE 연결 APN은 기술적으로 컨텍스트로 간주될 수 있지만 모뎀에 저장된 다른 모든 컨텍스트와 다릅니다. 다른 모든 컨텍스트의 경우 활성화는 등록 후에 발생하며, 다양한 조건에 따라 OS는 연결에 가장 적합한 컨텍스트를 결정할 수 있습니다. 그러나 LTE 연결 컨텍스트는 LTE 네트워크에서 디바이스 등록의 일부로 사용하도록 설정됩니다. OS는 등록이 완료되기 전에 네트워크 관련 상태 검색할 수 없습니다. 이러한 제한으로 인해 OS는 로밍 상태 무엇인지에 관계없이 디바이스가 LTE 네트워크에 등록할 수 있도록 디바이스의 모든 다른 로밍 조건에 대해 LTE 연결 컨텍스트를 구성할 수 있어야 합니다.
네트워크에서 LTE 연결 컨텍스트 활성화는 OS가 모뎀 자체 시작 컨텍스트 활성화를 인식하지 못하기 때문에 OS 명시적 연결 요청이 필요하지 않습니다. 기본 LTE 연결 컨텍스트는 이 범주에 속합니다. OS가 PDP 컨텍스트를 사용하도록 설정하는 MBIM_CID_CONNECT 요청을 실행하고 지정된 PDP 컨텍스트가 다음 모두와 일치하는 경우 모뎀은 네트워크와 함께 새로운 무선 전달자를 가져오지 않고 성공적으로 CID 활성화 요청을 완료해야 합니다.
- 모뎀에 의해 시작되고 OS에서 사용할 수 없는 기존 사용 가능한 PDP 컨텍스트가 있습니다.
- PDP 컨텍스트는 CID 요청에서 지정된 APN과 일치합니다.
- 활성화된 PDP 컨텍스트의 IP 유형은 CID에서 요청된 IP 유형과 호환됩니다.
이는 OS가 모뎀에 의해 시작된 모든 PDP 컨텍스트를 인식하지 못하기 때문에 중요합니다. 이렇게 하면 네트워크 노이즈 및 부하가 줄어듭니다. 그렇지 않으면 모뎀은 일반적인 컨텍스트 활성화 요청에 따라 OS APN 사양과 일치하는 새로운 무선 전달자를 표시해야 합니다. IP 유형 호환성은 다음과 같이 지정됩니다.
| 모뎀 내에서 활성화된 PDP 컨텍스트의 IP 유형 | 요청된 IP 유형과 호환 | 요청된 IP 유형과 호환되지 않음 |
|---|---|---|
| IPv4 | 기본; IPv4; IPv4v6; IPv4 및 v6 | IPv6 |
| IPv6 | 기본; IPv6; IPv4v6; IPv4 및 v6 | IPv4 |
| IPv4v6 | 기본; IPv4; IPv6; IPv4v6; IPv4 및 v6 | 없음 |
참고
IP 유형 중 하나만 무선으로 사용하도록 설정된 경우 모뎀이 두 번째 PDP 컨텍스트를 표시해서는 안 됩니다. 예를 들어 IPv4를 사용하도록 설정하고 호스트가 IPv4 및 IPv6을 요청하는 경우 모뎀은 IPv6 전달자를 가져오지 않고 활성화 요청을 완료해야 합니다.
OS가 PDP 컨텍스트를 비활성화하는 MBIM_CID_CONNECT 요청을 실행하면 모뎀은 다음을 검사 합니다.
- 디바이스가 LTE에 연결되어 있고 비활성화할 컨텍스트가 LTE 등록을 유지 관리하는 유일한 PDP 컨텍스트인지 여부입니다.
- 비활성화할 컨텍스트가 OS에 노출되지 않은 서비스에 대해 모뎀에서 내부적으로 사용되는지 여부
둘 중 하나가 true인 경우 모뎀은 CID 비활성화 요청을 완료해야 하지만 네트워크를 통해 무선 전달자를 계속 유지 관리해야 합니다. 그렇지 않으면 모뎀이 일반 비활성화 요청에 따라 컨텍스트를 비활성화해야 합니다.
OS에서 제공하는 모든 기본 LTE 연결 APN 구성은 공급자별로 제공되며 삽입된 SIM 카드 홈 공급자 ID(MCC/MNC 쌍)와 일치합니다. 모뎀은 쿼리할 때 현재 삽입된 SIM의 공급자 ID에 대해 구성된 LTE 연결 컨텍스트만 제공해야 합니다. 모뎀은 삽입된 SIM의 공급자 ID와 일치하는 세 가지 기본 LTE 연결 컨텍스트를 항상 반환해야 하며, 각 로밍 조건(홈/파트너/비 파트너)에 대해 하나씩 반환해야 합니다.
SIM 스왑에서 모뎀은 다음 SIM 카드 대한 구성을 적용하기 전에 기본 LTE 연결 컨텍스트를 지워야 합니다. 새로 삽입된 SIM 카드 기본 LTE 연결 컨텍스트 구성이 없는 경우 디바이스는 컨텍스트를 사용하도록 설정하면서 모든 로밍 조건에 대해 LTE 연결 컨텍스트의 APN에 대해 NULL 빈 문자열을 반환해야 합니다. 컨텍스트를 사용하지 않도록 설정하면 LTE 연결에 사용할 수 있는 구성이 없으므로 디바이스가 LTE에 연결되지 않을 것으로 예상됩니다. 사용자가 이전에 디바이스에서 구성한 SIM 카드 다시 교환하는 경우 모뎀은 SIM 카드 대한 공장 기본 LTE 연결 구성을 복원해야 합니다. 런타임 구성이 SIM 스왑 간에 유지되는 것은 아닙니다. 언제든지 로밍 조건당 모뎀에 하나의 기본 LTE 연결 APN만 있어야 합니다(홈/파트너/비 파트너).
SET 명령이 실행될 때 OS는 항상 각 로밍 조건에 대해 하나씩 세 가지 기본 LTE 연결 컨텍스트를 모두 설정합니다. OS에서 제공하는 목록에 정확히 3개가 없는 경우 Set 명령을 거부해야 합니다. 제공된 기본 LTE 연결 컨텍스트 중 하나가 로밍 조건이 현재 등록 상태 일치하는 OS에 의해 구성된 경우 모뎀은 네트워크에서 분리하고 새로 지정된 LTE 연결 컨텍스트를 사용하여 LTE 연결을 다시 수행해야 합니다. 그렇지 않으면 로밍 조건이 일치할 때 디바이스가 다음에 지정된 기본 LTE 연결 컨텍스트를 사용해야 합니다. 디바이스에서 지정한 기본 LTE 연결 컨텍스트가 LTE 네트워크에 등록되지 않으면 디바이스가 적절하게 3G/2G로 대체되어야 합니다. 모뎀이 파트너 네트워크와 비 파트너 네트워크를 구분할 수 없는 경우 모뎀은 모든 로밍 시나리오에 비 파트너 기본 LTE 연결 컨텍스트를 사용해야 합니다. OS가 기본 LTE 연결 컨텍스트를 IP 유형 = 기본값으로 구성하는 경우 모뎀이 LTE 연결 컨텍스트에 가장 적합한 IP 유형을 할당해야 합니다. 그러나 OS는 모뎀이 여전히 파트너 로밍 조건 및 구성을 정확하게 반영하는 LTE 연결 컨텍스트의 IP 유형을 반환할 것으로 예상합니다.
IHV 및 OEM은 LTE 연결 컨텍스트를 모뎀의 기본 구성으로 미리 구성할 수 있지만 이러한 컨텍스트는 MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceModemProvisioned로 태그가 지정되어야 합니다.
3GPP 표준에 따라 기본 LTE 연결 컨텍스트는 UE 시작 및 네트워크 시작의 두 가지 범주로 분할할 수 있습니다. 디바이스가 NULL 빈 액세스 문자열로 구성된 경우 디바이스는 LTE 연결 컨텍스트를 네트워크에 제공하지 않고 네트워크가 디바이스에 다시 할당될 때까지 기다리지 않을 것으로 예상됩니다. MBIM 1.0에서 규정한 것처럼 LTE 연결 컨텍스트의 IP 유형이 기본값으로 구성된 경우 모뎀은 내부 알고리즘에 따라 최상의 IP 유형을 선택해야 합니다.
다음 다이어그램에서는 LTE 연결 구성의 예제 흐름을 보여 줍니다.
쿼리
MBIM_MS_LTE_ATTACH_CONFIG_INFO 완료된 Query 및 InformationBuffer의 메시지 설정에서 반환됩니다. 쿼리의 경우 InformationBuffer는 NULL입니다.
Set
Set의 경우 InformationBuffer에는 MBIM_MS_SET_LTE_ATTACH_CONFIG 포함됩니다.
원치 않는 이벤트
이벤트 정보 버퍼에는 MBIM_MS_LTE_ATTACH_CONFIG_INFO 구조체가 포함되어 있습니다. 경우에 따라 기본 LTE 연결 컨텍스트는 OS에서 MBIM_CID_MS_LTE_ATTACH_CONFIG 명령을 통과하지 않는 네트워크 OTA(무선) 또는 SMS(Short Message Service)에 의해 업데이트됩니다. 함수는 기본 LTE 연결 컨텍스트 및 태그 MBIM_MS_CONTEXT_SOURCE = MbimMsContextSourceOperatorProvisioned를 적절하게 업데이트해야 합니다. 그런 다음 함수는 업데이트된 목록과 함께 이 이벤트를 사용하는 업데이트에 대해 호스트에 알려야 합니다.
매개 변수
| 작업(Operation) | Set | 쿼리 | 알림 |
|---|---|---|---|
| 명령 | MBIM_SET_MS_LTE_ATTACH_CONFIG | 해당 없음 | 해당 없음 |
| 응답 | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO | MBIM_MS_LTE_ATTACH_CONFIG_INFO |
데이터 구조
쿼리
InformationBuffer는 NULL이어야 하며 InformationBufferLength는 0이어야 합니다.
Set
다음 MBIM_MS_SET_LTE_ATTACH_CONFIG 구조체는 InformationBuffer에 사용됩니다. Set 명령은 목록에 각 로밍 조건(홈/파트너/비 파트너)에 대해 하나씩 3개 요소 수를 포함하는 경우에만 유효합니다.
| Offset | 크기 | 필드 | 형식 | Description |
|---|---|---|---|---|
| 0 | 4 | 작업 | MBIM_MS_LTE_CONTEXT_OPERATIONS | Set 명령이 사용되는 작업의 유형을 지정합니다. MbimMsLteAttachContextOperationRestoreFactory로 설정된 경우 다른 모든 필드를 무시해야 합니다. OS에서 만들거나 수정한 기본 LTE 연결 컨텍스트를 제거하고 미리 구성된 기본 팩터리 기본 LTE 연결 컨텍스트를 로드해야 합니다. 모뎀에 기본 구성이 없는 경우 모든 로밍 조건 기본 LTE 연결 컨텍스트를 빈 APN 문자열 및 IP 형식 = 기본값으로 설정해야 합니다. |
| 4 | 4 | ElementCount(EC) | Uint32 | DataBuffer에서 이어지는 MBIM_MS_LTE_ATTACH_CONTEXT 구조체의 수입니다. 이 구성 요소는 현재 각 로밍 조건(홈/파트너/비 파트너)에 대해 하나씩 3개로 지정됩니다. |
| 8 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | 쌍의 첫 번째 요소는 이 MBIM_MS_LTE_ATTACH_CONFIG_INFO 구조체의 시작(오프셋 0)에서 MBIM_MS_LTE_ATTACH_CONTEXT 구조로 계산된 4 바이트 오프셋입니다(자세한 내용은 MBIM_MS_LTE_ATTACH_CONTEXT 테이블 참조). 쌍의 두 번째 요소는 해당 MBIM_MS_LTE_ATTACH_CONTEXT 구조체에 대한 포인터의 4 바이트 크기입니다. |
| 8 + (8 * EC) | DataBuffer | DATABUFFER | MBIM_MS_LTE_ATTACH_CONTEXT 구조체의 배열입니다. |
다음 구조체는 앞의 표에서 사용됩니다.
MBIM_MS_LTE_ATTACH_CONTEXT_OPERATIONS Set 명령에서 사용할 수 있는 작업 유형을 설명합니다.
| 형식 | 값 | Description |
|---|---|---|
| MbimMsLteAttachContextOperationDefault | 0 | 모뎀에서 기존 기본 LTE 연결 컨텍스트를 덮어쓰기 위한 기본 작업입니다. OS는 항상 로밍 조건에 대한 세 가지 기본 LTE 연결 컨텍스트를 모두 대체합니다. |
| MbimMsLteAttachContextOperationRestoreFactory | 1 | 현재 삽입된 SIM의 공급자 ID에 대해 미리 구성된 팩터리 기본 LTE 연결 컨텍스트를 복원합니다. OS에서 대체하거나 만든 모든 기본 LTE 연결 컨텍스트를 제거하고 교체해야 합니다. 하나 이상의 로밍 조건이 있는 현재 삽입된 SIM 공급자 ID에 대해 미리 구성된 기본 LTE 연결 컨텍스트가 없는 경우 기본 LTE 연결은 빈 APN 문자열 및 IP 형식 = default를 반환해야 합니다. |
MBIM_MS_LTE_ATTACH_CONTEXT LTE 연결 구성에 사용할 컨텍스트를 지정합니다.
| Offset | 크기 | 필드 | 형식 | Description |
|---|---|---|---|---|
| 0 | 4 | IPType | MBIM_CONTEXT_IP_TYPE | 자세한 내용은 MBIM_CONTEXT_IP_TYPE 테이블을 참조하세요. |
| 4 | 4 | 로밍 | MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL | 이 기본 LTE 연결 컨텍스트에 적용되는 로밍 조건을 나타냅니다. 자세한 내용은 MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL 테이블을 참조하세요. |
| 8 | 4 | Source | MBIM_MS_CONTEXT_SOURCE | 컨텍스트의 생성 원본을 지정합니다. 자세한 내용은 MBIM_MS_CONTEXT_SOURCE 테이블을 참조하세요. |
| 12 | 4 | AccessStringOffset | OFFSET | 네트워크에 액세스하기 위한 문자열 AccessString에 대한 데이터 버퍼의 오프셋입니다. GSM 기반 네트워크의 경우 "data.thephone-company.com"과 같은 APN(액세스 지점 이름) 문자열입니다. 문자열의 크기는 100자를 초과하면 안 됩니다. AccessString이 비어 있으면 디바이스에서 액세스 문자열을 디바이스에 다시 할당해야 합니다. 이 경우 IP 유형을 지정해야 합니다. |
| 16 | 4 | AccessStringSize | SIZE(0..200) | AccessString에 사용되는 크기입니다. 디바이스에서 LTE 연결을 위해 액세스 문자열을 디바이스에 다시 할당해야 하는 경우 이 값은 0이어야 합니다. |
| 20 | 4 | UserNameOffset | OFFSET | 이 구조체의 시작 부분에서 인증할 사용자 이름을 나타내는 문자열 UserName으로 계산된 바이트 단위의 오프셋입니다. 이 멤버는 NULL일 수 있습니다. |
| 24 | 4 | UserNameSize | SIZE(0..510) | UserName에 사용되는 크기입니다. |
| 28 | 4 | PasswordOffset | OFFSET | 이 구조의 시작 부분에서 계산된 바이트 단위로 사용자 이름 암호를 나타내는 문자열 암호로 오프셋합니다. 이 멤버는 NULL일 수 있습니다. |
| 32 | 4 | PasswordSize | SIZE(0..510) | 암호에 사용되는 크기입니다. |
| 36 | 4 | 압축 | MBIM_COMPRESSION | 헤더 및 데이터에 대한 데이터 연결에서 사용할 압축을 지정합니다. 이 멤버는 GSM 기반 디바이스에만 적용됩니다. 호스트는 CDMA 기반 디바이스의 경우 이 멤버를 MBIMCompressionNone으로 설정합니다. 자세한 내용은 MBIM_COMPRESSION 테이블을 참조하세요. |
| 40 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | PDP 활성화에 사용할 인증 유형입니다. 자세한 내용은 MBIM_AUTH_PROTOCOL 테이블을 참조하세요. |
| 44 | DataBuffer | DATABUFFER | AccessString, UserName 및 Password를 포함하는 데이터 버퍼입니다. |
MBIM_MS_LTE_ATTACH_CONTEXT_ROAMING_CONTROL 이 기본 LTE 연결 컨텍스트에 적용되는 로밍 조건을 나타냅니다.
| 형식 | 값 | Description |
|---|---|---|
| MbimMsLteAttachContextRoamingControlHome | 0 | 기본 LTE 연결 컨텍스트를 홈 네트워크에서 사용할 수 있는지 여부를 나타냅니다. |
| MbimMsLteAttachContextRoamingControlPartner | 1 | 컨텍스트를 파트너 로밍 네트워크에서 사용할 수 있는지 여부를 나타냅니다. |
| MbimMsLteAttachContextRoamingControlNonPartner | 2 | 비 파트너 로밍 네트워크에서 컨텍스트를 사용할 수 있는지 여부를 나타냅니다. |
MBIM_MS_CONTEXT_SOURCE 컨텍스트의 생성 원본을 지정합니다.
| 형식 | 값 | Description |
|---|---|---|
| MbimMsContextSourceAdmin | 0 | 컨텍스트는 OS에서 엔터프라이즈 IT 관리자에 의해 만들어졌습니다. |
| MbimMsContextSourceUser | 1 | 컨텍스트는 OS 설정을 통해 사용자가 만들었습니다. |
| MbimMsContextSourceOperator | 2 | 컨텍스트는 OMA-DM 또는 다른 채널을 통해 연산자에 의해 만들어졌습니다. |
| MbimMsContextSourceModem | 3 | 컨텍스트는 IHV 또는 OEM에 의해 만들어졌습니다. |
| MbimMsContextSourceDevice | 4 | 컨텍스트는 OS APN 데이터베이스에 의해 만들어졌습니다. |
응답
다음 MBIM_MS_LTE_ATTACH_CONFIG_INFO 구조는 InformationBuffer에 사용됩니다.
| Offset | 크기 | 필드 | 형식 | Description |
|---|---|---|---|---|
| 0 | 4 | ElementCount(EC) | Uint32 | DataBuffer에서 이어지는 MBIM_MS_LTE_ATTACH_CONTEXT 구조체의 수입니다. 이 구성 요소는 현재 각 로밍 조건(홈/파트너/비 파트너)에 대해 하나씩 3개로 지정됩니다. |
| 4 | 8 * EC | MsLteAttachContextRefList | OL_PAIR_LIST | 쌍의 첫 번째 요소는 이 MBIM_MS_LTE_ATTACH_CONFIG_INFO 구조체의 시작(오프셋 0)에서 MBIM_MS_LTE_ATTACH_CONTEXT 구조로 계산된 4 바이트 오프셋입니다(자세한 내용은 MBIM_MS_LTE_ATTACH_CONTEXT 테이블 참조). 쌍의 두 번째 요소는 해당 MBIM_MS_LTE_ATTACH_CONTEXT 구조체에 대한 포인터의 4 바이트 크기입니다. |
| 4 + (8 * EC) | DataBuffer | DATABUFFER | MBIM_MS_LTE_ATTACH_CONTEXT 구조체의 배열입니다. |
알림
자세한 내용은 MBIM_MS_LTE_ATTACH_CONFIG_INFO 테이블을 참조하세요.
상태 코드
쿼리 및 설정 작업의 경우:
| 상태 코드 | Description |
|---|---|
| MBIM_STATUS_READ_FAILURE | 디바이스가 프로비전된 컨텍스트를 검색할 수 없어 작업이 실패했습니다. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | 디바이스가 작업을 지원하지 않으므로 작업이 실패했습니다. |
설정 작업의 경우에만 다음을 수행합니다.
| 상태 코드 | Description |
|---|---|
| MBIM_STATUS_INVALID_PARAMETERS | 잘못된 매개 변수로 인해 작업이 실패했습니다. |
| MBIM_STATUS_WRITE_FAILURE | 업데이트 요청이 실패하여 작업이 실패했습니다. |
MBIM_CID_MS_LTE_ATTACH_STATUS
Description
3GPP 요구 사항에 따라 디바이스가 LTE를 사용하도록 설정된 PDP 컨텍스트 없이 네트워크에 연결할 때 사용할 기본 LTE 연결 컨텍스트를 지정할 수 있지만 디바이스가 디바이스에 구성된 기본 LTE 연결 컨텍스트와 다른 PDP 컨텍스트에서 LTE 연결되는 경우가 있을 수 있습니다. 다음은 가능한 모든 시나리오 목록입니다.
- UE는 특정 LTE 연결 APN을 지정합니다.
- UE는 특정 LTE 연결 APN을 지정하지만 네트워크는 로밍 중에 디바이스가 다른 APN에 연결되도록 하기로 결정합니다.
- UE는 LTE 연결 APN을 지정하지 않으며 네트워크에서 디바이스에 다시 할당할 수 있도록 합니다.
- 2G/3G 네트워크에서 LTE로 등록된 UE에는 이미 하나 이상의 활성 PDP 컨텍스트가 있었습니다. 네트워크는 이를 LTE 연결 APN으로 사용합니다.
디바이스 기본 LTE가 연결되면 최신 LTE 첨부 파일에 PDP 컨텍스트의 세부 정보를 제공하기 위해 OS에 MBIM_CID_MS_LTE_ATTACH_STATUS 알림을 보내야 합니다. 기본 LTE 연결은 다음 시나리오 중 하나가 충족될 때 발생합니다.
- 디바이스는 처음에 LTE 네트워크에 연결됩니다.
- 디바이스는 이전에 사용하도록 설정된 PDP 컨텍스트 없이 2G/3G에서 LTE로 전달됩니다.
MBIM_CID_LTE_ATTACH_STATUS 반환된 LTE 연결 컨텍스트는 다음 중 하나일 수 있습니다.
- 모뎀에 저장된 기본 LTE 연결 컨텍스트입니다.
- 네트워크에서 다시 할당된 기본 LTE 연결 컨텍스트입니다.
또한 런타임 중에 OS는 기본 LTE 연결에 마지막으로 사용된 연결 정보를 쿼리할 수 있어야 합니다. 모뎀은 마지막으로 알려진 기본 LTE 연결 컨텍스트를 반환해야 합니다. 디바이스가 LTE에서 2G/3G 네트워크로 전달된 경우 모뎀은 이전 LTE 연결에 사용된 컨텍스트를 반환해야 합니다. 디바이스가 네트워크에서 등록을 취소할 때마다 APN이 비워질 것으로 예상됩니다.
아래 다이어그램은 LTE 연결 상태 대한 예제 메시지 흐름을 보여 줍니다.
쿼리
MBIM_MS_LTE_ATTACH_STATUS InformationBuffer의 전체 메시지 쿼리에서 반환됩니다. 쿼리의 경우 InformationBuffer는 NULL입니다.
Set
설정 작업은 지원되지 않습니다.
원치 않는 이벤트
이벤트 정보 버퍼에는 MBIM_MS_LTE_ATTACH_STATUS 구조체가 포함되어 있습니다.
매개 변수
| 작업(Operation) | Set | 쿼리 | 알림 |
|---|---|---|---|
| 명령 | 해당 없음 | 해당 없음 | 해당 없음 |
| 응답 | 해당 없음 | MBIM_MS_LTE_ATTACH_STATUS | MBIM_MS_LTE_ATTACH_STATUS |
데이터 구조
쿼리
InformationBuffer는 NULL이어야 하며 InformationBufferLength는 0이어야 합니다.
Set
설정 작업은 지원되지 않습니다.
응답
다음 MBIM_MS_LTE_ATTACH_STATUS 구조는 InformationBuffer에 사용됩니다.
| Offset | 크기 | 필드 | 형식 | Description |
|---|---|---|---|---|
| 0 | 4 | LteAttachState | MBIM_MS_LTE_ATTACH_STATE | 디바이스가 현재 LTE 네트워크에 연결되어 있는지 여부를 나타냅니다. 자세한 내용은 MBIM_MS_LTE_ATTACH_STATE 테이블을 참조하세요. |
| 4 | 4 | IPType | MBIM_CONTEXT_IP_TYPES | 자세한 내용은 MBIM_CONTEXT_IP_TYPE 테이블을 참조하세요. |
| 8 | 4 | AccessStringOffset | OFFSET | 네트워크에 액세스하기 위한 문자열 AccessString에 대한 데이터 버퍼의 오프셋입니다. GSM 기반 네트워크의 경우 "data.thephone-company.com"과 같은 APN(액세스 지점 이름) 문자열입니다. CDMA 기반 네트워크의 경우 "#777"과 같은 특수 다이얼 코드 또는 "foo@thephone-company.com"와 같은 NAI(네트워크 액세스 식별자)일 수 있습니다. 이 멤버는 NULL이면 네트워크에서 기본 APN을 할당하도록 요청할 수 있습니다. 참고: 모든 네트워크가 이 NULL APN 규칙을 지원하지는 않습니다. 따라서 잘못된 APN으로 인한 연결 실패가 가능한 결과입니다. 문자열의 크기는 100자를 초과하면 안 됩니다. |
| 12 | 4 | AccessStringSize | SIZE(0..200) | AccessString에 사용되는 바이트 크기입니다. |
| 16 | 4 | UserNameOffset | OFFSET | 이 구조체의 시작 부분에서 인증할 사용자 이름을 나타내는 문자열 UserName으로 계산된 바이트 단위의 오프셋입니다. 이 멤버는 NULL일 수 있습니다. |
| 20 | 4 | UserNameSize | SIZE(0..510) | UserName에 사용되는 크기(바이트)입니다. |
| 24 | 4 | PasswordOffset | OFFSET | 이 구조체의 시작 부분에서 사용자 이름의 암호를 나타내는 문자열 암호로 계산된 바이트 단위의 오프셋입니다. 이 멤버는 NULL일 수 있습니다. |
| 28 | 4 | PasswordSize | SIZE(0..510) | 암호에 사용되는 크기(바이트)입니다. |
| 32 | 4 | 압축 | MBIM_COMPRESSION | 헤더 및 데이터에 대한 데이터 연결에 사용할 압축을 지정합니다. 이 멤버는 GSM 기반 디바이스에만 적용됩니다. 호스트는 CDMA 기반 디바이스의 경우 이 멤버를 MBIMCompressionNone으로 설정합니다. 자세한 내용은 MBIM_COMPRESSION 테이블을 참조하세요. |
| 36 | 4 | AuthProtocol | MBIM_AUTH_PROTOCOL | PDP 활성화에 사용할 인증 유형입니다. 자세한 내용은 MBIM_AUTH_PROTOCOL 테이블을 참조하세요. |
| 40 | 4 | DataBuffer | DATABUFFER |
다음 데이터 구조는 앞의 표에서 사용됩니다.
MBIM_MS_LTE_ATTACH_STATE 디바이스가 현재 LTE 네트워크에 연결되어 있는지 여부를 나타냅니다.
| 형식 | 값 | Description |
|---|---|---|
| MbimMsLteAttachStateDetached | 0 | 디바이스가 LTE 네트워크에 연결되어 있지 않음을 나타냅니다. |
| MbimMsLteAttachStateAttached | 1 | 디바이스가 LTE 네트워크에 연결되어 있음을 나타냅니다. |
알림
자세한 내용은 MBIM_MS_LTE_ATTACH_STATUS 테이블을 참조하세요.
상태 코드
쿼리 및 설정 작업의 경우:
| 상태 코드 | Description |
|---|---|
| MBIM_STATUS_READ_FAILURE | 디바이스가 프로비전된 컨텍스트를 검색할 수 없어 작업이 실패했습니다. |
| MBIM_STATUS_NO_DEVICE_SUPPORT | 디바이스가 작업을 지원하지 않으므로 작업이 실패했습니다. |
HLK(하드웨어 랩 키트) 테스트
HLK 설치 단계를 참조하세요.
HLK Studio에서 디바이스 셀룰러 모뎀 드라이버에 연결하고 테스트를 실행합니다( Win6_4.MB). Gsm. Data.TestLteAttach.
또는 netsh-mbn 및 netsh-mbn-test-installation을 통해 TestLteAttach HLK 테스트 목록을 실행합니다.
netsh mbn test feature=lte testpath="C:\\data\\test\\bin" taefpath="C:\\data\\test\\bin"
HLK 테스트 결과를 보여주는 이 파일은 'netsh mbn test' 명령이 에서 실행된 디렉터리에서 TestLteAttach.htm생성되어야 합니다.
수동 테스트
- 요구 사항: 올바른 APN 설정이 있는 sim과 수동 사용을 위한 APN 정보가 하나 더 있습니다.
- 설정->네트워크 & 인터넷 열기 -> 셀룰러
- 고급 옵션을 클릭합니다.
셀룰러 설정 사용:
- 적어도 sim 정보의 설정인 apn이 있어야 합니다. APN을 클릭하고 "보기" 단추를 클릭하여 APN의 자세한 정보를 가져올 수 있습니다.
수동 설정 사용:
- 셀룰러 설정의 "APN 추가" 섹션에 따라 APN을 수동으로 설정합니다.
- APN을 연결하고 연결된 상태 검사.
MB LTE 연결 문제 해결 가이드
- %ProgramData%\Microsoft\WwanSvc\DMProfiles에서 APN 프로필 연결 모두 가져오기
- 생성 유형 우선 순위에 따라 적용되는 특정 프로필 이해
- 로그를 조사하여 LTE 연결 APN이 잘못 구성된 이유를 검사
- 로그 수집의 지침을 사용하여 로그 수집 및 디코딩
- TextAnalysisTool에서 생성된 .txt 파일 열기
- LTE 연결 필터 로드
LTE 연결의 샘플 로그
10409 [0]0370.0434::2020-03-06 01:16:13.118424000 [WwanDimCommon] ReadyState : WwanReadyStateInitialized (0x1)
14137 [0]0370.0684::2020-03-06 01:16:13.146883200 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14362 [0]0370.0684::2020-03-06 01:16:13.149255900 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14476 [1]0370.0434::2020-03-06 01:16:13.149677900 [WwanDimCommon] ReadyState : WwanReadyStateInitialized (0x1)
14503 [0]0370.0684::2020-03-06 01:16:13.151412000 [WwanProfileManager]INFO: SaveModemConfiguredLteAttachConfig: added modem configured LTE attach profile
14962 [0]0370.0684::2020-03-06 01:16:13.156860700 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanDataExecutor::OnLteAttachProfileUpdate: WwanPmGetLteAttachProfileInEffect() didn't find anything, using Network Assigned.
14963 [0]0370.0684::2020-03-06 01:16:13.156862600 [Microsoft-Windows-WWAN-SVC-EVENTS]WWAN Service event: [Info] CWwanDataExecutor::OnLteAttachProfileUpdate: LTEAttachConfig has same config as modem has, skip