---
title: SUPL CSP
description: Learn more about the SUPL CSP.
ms.date: 01/18/2024
---
# SUPL CSP
The SUPL configuration service provider is used to configure the location client, as shown in the following table:
- **Location Service**: Connection type
- **SUPL**: All connections other than CDMA
- **V2 UPL**: CDMA
- **Location Service**: Configuration
- **SUPL**:
- Settings that need to get pushed to the GNSS driver to configure the SUPL behavior:
- Address of the Home SUPL (H-SLP) server.
- H-SLP server certificate.
- Positioning method.
- Version of the protocol to use by default.
- MCC/MNC value pairs that are used to specify which networks' UUIC the SUPL account matches.
- **V2 UPL**:
- Address of the server—a mobile positioning center for non-trusted mode.
- The positioning method used by the MPC for non-trusted mode.
The SUPL or V2 UPL connection will be reconfigured every time the device is rebooted. A new UICC is inserted, or new settings are provisioned by using OMA Client Provisioning, OMA DM, or test tools. When the device is in roaming mode, it reverts to Mobile Station Standalone mode, in which only the built–in Microsoft location components are used.
The following list shows the SUPL configuration service provider nodes:
- ./Vendor/MSFT//SUPL
- [SUPL1](#supl1)
- [Addr](#supl1addr)
- [AppID](#supl1appid)
- [Ext](#supl1ext)
- [Microsoft](#supl1extmicrosoft)
- [FullVersion](#supl1extmicrosoftfullversion)
- [HighAccPositioningMethod](#supl1extmicrosofthighaccpositioningmethod)
- [LocMasterSwitchDependencyNII](#supl1extmicrosoftlocmasterswitchdependencynii)
- [MCCMNCPairs](#supl1extmicrosoftmccmncpairs)
- [NIDefaultTimeout](#supl1extmicrosoftnidefaulttimeout)
- [RootCertificate](#supl1extmicrosoftrootcertificate)
- [Data](#supl1extmicrosoftrootcertificatedata)
- [Name](#supl1extmicrosoftrootcertificatename)
- [RootCertificate2](#supl1extmicrosoftrootcertificate2)
- [Data](#supl1extmicrosoftrootcertificate2data)
- [Name](#supl1extmicrosoftrootcertificate2name)
- [RootCertificate3](#supl1extmicrosoftrootcertificate3)
- [Data](#supl1extmicrosoftrootcertificate3data)
- [Name](#supl1extmicrosoftrootcertificate3name)
- [RootCertificate4](#supl1extmicrosoftrootcertificate4)
- [Data](#supl1extmicrosoftrootcertificate4data)
- [Name](#supl1extmicrosoftrootcertificate4name)
- [RootCertificate5](#supl1extmicrosoftrootcertificate5)
- [Data](#supl1extmicrosoftrootcertificate5data)
- [Name](#supl1extmicrosoftrootcertificate5name)
- [RootCertificate6](#supl1extmicrosoftrootcertificate6)
- [Data](#supl1extmicrosoftrootcertificate6data)
- [Name](#supl1extmicrosoftrootcertificate6name)
- [ServerAccessInterval](#supl1extmicrosoftserveraccessinterval)
- [Version](#supl1extmicrosoftversion)
- [V2UPL1](#v2upl1)
- [ApplicationTypeIndicator_MR](#v2upl1applicationtypeindicator_mr)
- [LocMasterSwitchDependencyNII](#v2upl1locmasterswitchdependencynii)
- [MPC](#v2upl1mpc)
- [NIDefaultTimeout](#v2upl1nidefaulttimeout)
- [PDE](#v2upl1pde)
- [PositioningMethod_MR](#v2upl1positioningmethod_mr)
- [ServerAccessInterval](#v2upl1serveraccessinterval)
## SUPL1
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1
```
Required for SUPL. Defines the account for the SUPL Enabled Terminal (SET) node. Only one SUPL account is supported at a given time.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
### SUPL1/Addr
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Addr
```
Optional. Specifies the address of the Home SUPL Location Platform (H-SLP) server for non-proxy mode. The value is a server address specified as a fully qualified domain name, and the port specified as an integer, with the format server: port.
If this value isn't specified, the device infers the H-SLP address from the IMSI as defined in the SUPL standard. To use automatic generation of the H-SLP address based on the IMSI, the MNC length must be set correctly on the UICC. Generally, this value is 2 or 3.
For OMA DM, if the format for this node is incorrect the entry will be ignored and an error will be returned. But the configuration service provider will continue processing the rest of the parameters.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
### SUPL1/AppID
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/AppID
```
Required. The AppID for SUPL is automatically set to "ap0004". This is a read-only value.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get |
### SUPL1/Ext
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext
```
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
#### SUPL1/Ext/Microsoft
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft
```
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
##### SUPL1/Ext/Microsoft/FullVersion
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 2004 [10.0.19041] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/FullVersion
```
Optional. Determines the full version (X. Y. Z where X, Y and Z are major version, minor version, service indicator, respectively) of the SUPL protocol to use. The default is 1.0.0. If FullVersion is defined, Version field is ignored.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
| Allowed Values | Regular Expression: `^(\d+\.)?(\d+\.)?(\*|\d+)$` |
| Default Value | 1.0.0 |
##### SUPL1/Ext/Microsoft/HighAccPositioningMethod
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/HighAccPositioningMethod
```
Optional. Specifies the positioning method that the SUPL client will use for mobile originated position requests. The default is 0. The default method in Windows provides high-quality assisted GNSS positioning for mobile originated position requests without loading the mobile operator's network or location services. For OMA DM, if the format for this node is incorrect the entry will be ignored and an error will be returned, but the configuration service provider will continue processing the rest of the parameters.
> [!IMPORTANT]
> The Mobile Station Assisted, OTDOA, and AFLT positioning methods must only be configured for test purposes.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Get, Replace |
| Default Value | 0 |
**Allowed values**:
| Value | Description |
|:--|:--|
| 0 (Default) | None: The device uses the default positioning method. In this default mode, the GNSS obtains assistance (time injection, coarse position injection and ephemeris data) from the Microsoft Positioning Service. |
| 1 | Mobile Station Assisted: The device contacts the H-SLP server to obtain a position. The H-SLP does the calculation of the position and returns it to the device. |
| 2 | Mobile Station Based: The device obtains location-aiding data (almanac, ephemeris data, time and coarse initial position of the device) from the H-SLP server, and the device uses this information to help GPS obtain a fix. All position calculations are done in the device. |
| 3 | Mobile Station Standalone: The device obtains assistance as required from the Microsoft location services. |
| 4 | OTDOA. |
| 5 | AFLT. |
##### SUPL1/Ext/Microsoft/LocMasterSwitchDependencyNII
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/LocMasterSwitchDependencyNII
```
This setting is deprecated in Windows 10. Optional. Boolean. Specifies whether the location toggle on the location screen in Settings is also used to manage SUPL network-initiated (NI) requests for location. If the value is set to 0, the NI behavior is independent from the current location toggle setting. If the value is set to 1, the NI behavior follows the current location toggle setting. The default value is 1. Note that most clients don't support this behavior. This value manages the settings for both SUPL and v2 UPL. If a phone is configured for both SUPL and V2 UPL and these values differ, the SUPL setting will always be used.
| Location toggle setting | LocMasterSwitchDependencyNII setting | NI request processing allowed |
|-------------------------|--------------------------------------|------------------------------------|
| On | 0 | Yes |
| On | 1 | Yes |
| Off | 0 | Yes |
| Off | 1 | No (unless privacyOverride is set) |
When the location toggle is set to Off and this value is set to 1, the following application requests will fail:
- `noNotificationNoVerification`
- `notificationOnly`
- `notificationAndVerficationAllowedNA`
- `notificationAndVerficationDeniedNA`
However, if `privacyOverride` is set in the message, the location will be returned.
When the location toggle is set to Off and this value is set to 0, the location toggle doesn't prevent SUPL network-initiated requests from working.
For OMA DM, if the format for this node is incorrect then an entry will be ignored and an error will be returned, but the configuration service provider will continue processing the rest of the parameters.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `bool` |
| Access Type | Get, Replace |
| Default Value | true |
**Allowed values**:
| Value | Description |
|:--|:--|
| false | The NI behavior is independent from the current location toggle setting. |
| true (Default) | The NI behavior follows the current location toggle setting. |
##### SUPL1/Ext/Microsoft/MCCMNCPairs
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/MCCMNCPairs
```
Required. List all of the MCC and MNC pairs owned by the mobile operator. This list is used to verify that the UICC matches the network and SUPL can be used. When the UICC and network don't match, the phone uses the default location service and doesn't use SUPL.
This value is a string with the format `(X1, Y1)(X2, Y2)…(Xn, Yn)`, in which `X` is an MCC and `Y` is an MNC.
For OMA DM, if the format for this node is incorrect then an entry will be ignored and an error will be returned, but the configuration service provider will continue processing the rest of the parameters.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
##### SUPL1/Ext/Microsoft/NIDefaultTimeout
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/NIDefaultTimeout
```
Optional. Time in seconds that the network-initiated location request is displayed to the user, while awaiting a response and before doing the default action. The default is 30 seconds. A value between 20 and 60 seconds is recommended.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Get, Replace |
| Default Value | 30 |
##### SUPL1/Ext/Microsoft/RootCertificate
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate
```
Required. Specifies the root certificate for the H-SLP server. Windows doesn't support a non-secure mode. If this node isn't included, the configuration service provider will fail but may not return a specific error.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
###### SUPL1/Ext/Microsoft/RootCertificate/Data
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate/Data
```
The base 64 encoded blob of the H-SLP root certificate.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `b64` |
| Access Type | Get, Replace |
###### SUPL1/Ext/Microsoft/RootCertificate/Name
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate/Name
```
Specifies the name of the H-SLP root certificate as a string, in the format name.cer.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
##### SUPL1/Ext/Microsoft/RootCertificate2
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate2
```
Specifies the root certificate for the H-SLP server.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
###### SUPL1/Ext/Microsoft/RootCertificate2/Data
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate2/Data
```
The base 64 encoded blob of the H-SLP root certificate.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `b64` |
| Access Type | Get, Replace |
###### SUPL1/Ext/Microsoft/RootCertificate2/Name
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate2/Name
```
Specifies the name of the H-SLP root certificate as a string, in the format name.cer.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
##### SUPL1/Ext/Microsoft/RootCertificate3
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate3
```
Specifies the root certificate for the H-SLP server.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
###### SUPL1/Ext/Microsoft/RootCertificate3/Data
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate3/Data
```
The base 64 encoded blob of the H-SLP root certificate.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `b64` |
| Access Type | Get, Replace |
###### SUPL1/Ext/Microsoft/RootCertificate3/Name
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate3/Name
```
Specifies the name of the H-SLP root certificate as a string, in the format name.cer.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
##### SUPL1/Ext/Microsoft/RootCertificate4
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1809 [10.0.17763] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate4
```
Specifies the root certificate for the H-SLP server.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
###### SUPL1/Ext/Microsoft/RootCertificate4/Data
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1809 [10.0.17763] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate4/Data
```
The base 64 encoded blob of the H-SLP root certificate.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `b64` |
| Access Type | Get, Replace |
###### SUPL1/Ext/Microsoft/RootCertificate4/Name
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1809 [10.0.17763] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate4/Name
```
Specifies the name of the H-SLP root certificate as a string, in the format name.cer.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
##### SUPL1/Ext/Microsoft/RootCertificate5
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1809 [10.0.17763] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate5
```
Specifies the root certificate for the H-SLP server.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
###### SUPL1/Ext/Microsoft/RootCertificate5/Data
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1809 [10.0.17763] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate5/Data
```
The base 64 encoded blob of the H-SLP root certificate.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `b64` |
| Access Type | Get, Replace |
###### SUPL1/Ext/Microsoft/RootCertificate5/Name
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1809 [10.0.17763] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate5/Name
```
Specifies the name of the H-SLP root certificate as a string, in the format name.cer.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
##### SUPL1/Ext/Microsoft/RootCertificate6
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1809 [10.0.17763] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate6
```
Specifies the root certificate for the H-SLP server.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
###### SUPL1/Ext/Microsoft/RootCertificate6/Data
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1809 [10.0.17763] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate6/Data
```
The base 64 encoded blob of the H-SLP root certificate.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `b64` |
| Access Type | Get, Replace |
###### SUPL1/Ext/Microsoft/RootCertificate6/Name
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1809 [10.0.17763] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/RootCertificate6/Name
```
Specifies the name of the H-SLP root certificate as a string, in the format name.cer.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
##### SUPL1/Ext/Microsoft/ServerAccessInterval
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/ServerAccessInterval
```
Optional. Integer. Defines the minimum interval of time in seconds between mobile originated requests sent to the server to prevent overloading the mobile operator's network. The default value is 60.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Get, Replace |
| Default Value | 60 |
##### SUPL1/Ext/Microsoft/Version
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/SUPL1/Ext/Microsoft/Version
```
Optional. Determines the major version of the SUPL protocol to use. For SUPL 1.0.0, set this value to 1. For SUPL 2.0.0, set this value to 2. The default is 1. Refer to FullVersion to define minor verison and service indicator.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Get, Replace |
| Allowed Values | Range: `[1-2]` |
| Default Value | 1 |
## V2UPL1
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/V2UPL1
```
Required for V2 UPL for CDMA. Specifies the account settings for user plane location and IS-801 for CDMA. Only one account is supported at a given time.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
### V2UPL1/ApplicationTypeIndicator_MR
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/V2UPL1/ApplicationTypeIndicator_MR
```
Required. This value must always be set to 00000011.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `node` |
| Access Type | Get |
### V2UPL1/LocMasterSwitchDependencyNII
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/V2UPL1/LocMasterSwitchDependencyNII
```
Optional. Boolean. Specifies whether the location toggle on the location screen in Settings is also used to manage network-initiated requests for location. If the value is set to 0, the NI behavior is independent from the current location toggle setting. If the value is set to 1, the NI behavior follows the current location toggle setting. For CDMA phones, this value must be set to 1. The default value is 1.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `bool` |
| Access Type | Get, Replace |
| Default Value | true |
**Allowed values**:
| Value | Description |
|:--|:--|
| false | The NI behavior is independent from the current location toggle setting. |
| true (Default) | The NI behavior follows the current location toggle setting. |
### V2UPL1/MPC
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/V2UPL1/MPC
```
Optional. The address of the mobile positioning center (MPC), in the format ipAddress: portNumber. For non-trusted mode of operation, this parameter is mandatory and the PDE parameter must be empty.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
### V2UPL1/NIDefaultTimeout
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/V2UPL1/NIDefaultTimeout
```
Optional. Time in seconds that the network-initiated location request is displayed to the user, while awaiting a response and before doing the default action. The default is 30 seconds. A value between 20 and 60 seconds is recommended.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Get, Replace |
| Default Value | 30 |
### V2UPL1/PDE
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/V2UPL1/PDE
```
Optional. The address of the Position Determination Entity (PDE), in the format ipAddress: portNumber. For non-trusted mode of operation, this parameter must be empty.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `chr` (string) |
| Access Type | Get, Replace |
### V2UPL1/PositioningMethod_MR
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/V2UPL1/PositioningMethod_MR
```
Optional. Specifies the positioning method that the SUPL client will use for mobile originated position requests. The default is 0. The default method in Windows provides high-quality assisted GNSS positioning for mobile originated position requests without loading the mobile operator's network or location services. The Mobile Station Assisted and AFLT positioning methods must only be configured for test purposes. For OMA DM, if the format for this node is incorrect the entry will be ignored and an error will be returned, but the configuration service provider will continue processing the rest of the parameters.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Get, Replace |
| Default Value | 0 |
**Allowed values**:
| Value | Description |
|:--|:--|
| 0 (Default) | None: The device uses the default positioning method. In this default mode, the GNSS obtains assistance (time injection, coarse position injection, and ephemeris data) from the Microsoft Positioning Service. |
| 1 | Mobile Station Assisted: The device contacts the H-SLP server to obtain a position. The H-SLP does the calculation of the position and returns it to the device. |
| 2 | Mobile Station Based: The device obtains location-aiding data (almanac, ephemeris data, time and coarse initial position of the device) from the H-SLP server, and the device uses this information to help GPS obtain a fix. All position calculations are done in the device. |
| 3 | Mobile Station Standalone: The device obtains assistance as required from the Microsoft location services. |
| 4 | AFLT. |
### V2UPL1/ServerAccessInterval
| Scope | Editions | Applicable OS |
|:--|:--|:--|
| ✅ Device
❌ User | ✅ Pro
✅ Enterprise
✅ Education
✅ Windows SE
✅ IoT Enterprise / IoT Enterprise LTSC | ✅ Windows 10, version 1507 [10.0.10240] and later |
```Device
./Vendor/MSFT//SUPL/V2UPL1/ServerAccessInterval
```
Optional. Integer. Defines the minimum interval of time in seconds between mobile originated requests sent to the server to prevent overloading the mobile operator's network. The default value is 60.
**Description framework properties**:
| Property name | Property value |
|:--|:--|
| Format | `int` |
| Access Type | Get, Replace |
| Default Value | 60 |
## Unsupported Nodes
The following optional nodes aren't supported on Windows devices.
- ProviderID
- Name
- PrefConRef
- ToConRef
- ToConRef/<X>
- ToConRef/<X>/ConRef
- AddrType
If the configuration application tries to set, delete or query these nodes, a response indicating this node isn't implemented will be returned over OMA DM. In OMA Client Provisioning, the request to set this node will be ignored and the configuration service provider will continue processing the rest of the nodes.
If a mobile operator requires the communication with the H-SLP to take place over a specific connection rather than a default cellular connection, then this configuration must be done by using the [CM\_CellularEntries configuration service provider](cm-cellularentries-csp.md) and the [CM\_ProxyEntries configuration service provider](cm-proxyentries-csp.md) to map the H-SLP server with the required connection.
## OMA Client Provisioning examples
Adding new configuration information for an H-SLP server for SUPL. Values in italic must be replaced with correct settings for the mobile operator network. A valid binary blob must be included for the root certificate data value.
```xml
```
Adding a SUPL and a V2 UPL account to the same device. Values in italic must be replaced with correct settings for the mobile operator network. A valid binary BLOB must be included for the root certificate data value.
```xml
```
## OMA DM examples
Adding a SUPL account to a device. Values in italic must be replaced with correct settings for the mobile operator network. A valid binary blob must be included for the root certificate data value.
```xml
Add FQDN
-
./Vendor/MSFT/SUPL/SUPL1/Addr
chr
supl.abc.def.example.com:2222
Add MCCMNC
-
./Vendor/MSFT/SUPL/SUPL1/Ext/Microsoft/MCCMNCPairs
chr
(111,000)(222,111)(333,333)(444,222)
Add HighAccPositioningMethod
-
./Vendor/MSFT/SUPL/SUPL1/Ext/Microsoft/HighAccPositioningMethod
int
2
Add LocMasterSWDepend
-
./Vendor/MSFT/SUPL/SUPL1/Ext/Microsoft/LocMasterSwitchDependencyNII
int
1
Add Cert name
-
./Vendor/MSFT/SUPL/SUPL1/Ext/Microsoft/RootCertificate/Name
chr
certName.cer
Add Cert data - 200
-
./Vendor/MSFT/SUPL/SUPL1/Ext/Microsoft/RootCertificate/Data
b64
```
## Microsoft Custom Elements
The following table shows the Microsoft custom elements that this configuration service provider supports for OMA Client Provisioning.
|Elements|Available|
|--- |--- |
|parm-query|Yes|
|characteristic-query|Yes
Recursive query: No
Top level query: No|
## Related articles
[Configuration service provider reference](configuration-service-provider-reference.md)