--- title: SUPL DDF file description: View the XML file containing the device description framework (DDF) for the SUPL configuration service provider. ms.date: 06/28/2024 --- # SUPL DDF file The following XML file contains the device description framework (DDF) for the SUPL configuration service provider. ```xml ]> 1.2 SUPL ./Vendor/MSFT/ Defines the account for the SUPL Enabled Terminal (SET) node. Only one SUPL account is supported at a given time. 10.0.10240 1.0 0x4;0x1B;0x30;0x31;0x48;0x54;0x62;0x63;0x64;0x65;0x79;0x7A;0x7D;0x7E;0x81;0x82;0x8A;0x8B;0xA1;0xA2;0xA4;0xA5;0xAB;0xAC;0xAF;0xBC;0xBF;0xCA;0xCB;0xCD;0xCF; SUPL1 Required for SUPL. Defines the account for the SUPL Enabled Terminal (SET) node. Only one SUPL account is supported at a given time. AppID Required. The AppID for SUPL is automatically set to "ap0004". This is a read-only value. 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. Ext Insert Description Here Microsoft Insert Description Here Version 1 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 [1-2] FullVersion 1.0.0 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 10.0.19041 1.2 ^(\d+\.)?(\d+\.)?(\*|\d+)$ 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 do not match, the phone uses the default location service and does not use SUPL. HighAccPositioningMethod 0 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. 0 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 LocMasterSwitchDependencyNII true 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 do not 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. false The NI behavior is independent from the current location toggle setting. true The NI behavior follows the current location toggle setting. NIDefaultTimeout 30 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. ServerAccessInterval 60 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. RootCertificate Required. Specifies the root certificate for the H-SLP server. Windows does not support a non-secure mode. If this node is not included, the configuration service provider will fail but may not return a specific error. Name Specifies the name of the H-SLP root certificate as a string, in the format name.cer. Data The base 64 encoded blob of the H-SLP root certificate. RootCertificate2 Specifies the root certificate for the H-SLP server. Name Specifies the name of the H-SLP root certificate as a string, in the format name.cer. Data The base 64 encoded blob of the H-SLP root certificate. RootCertificate3 Specifies the root certificate for the H-SLP server. Name Specifies the name of the H-SLP root certificate as a string, in the format name.cer. Data The base 64 encoded blob of the H-SLP root certificate. RootCertificate4 Specifies the root certificate for the H-SLP server. 10.0.17763 1.1 Name Specifies the name of the H-SLP root certificate as a string, in the format name.cer. Data The base 64 encoded blob of the H-SLP root certificate. RootCertificate5 Specifies the root certificate for the H-SLP server. 10.0.17763 1.1 Name Specifies the name of the H-SLP root certificate as a string, in the format name.cer. Data The base 64 encoded blob of the H-SLP root certificate. RootCertificate6 Specifies the root certificate for the H-SLP server. 10.0.17763 1.1 Name Specifies the name of the H-SLP root certificate as a string, in the format name.cer. Data The base 64 encoded blob of the H-SLP root certificate. 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. 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. 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. PositioningMethod_MR 0 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. 0 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 LocMasterSwitchDependencyNII true 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. false The NI behavior is independent from the current location toggle setting. true The NI behavior follows the current location toggle setting. ApplicationTypeIndicator_MR Required. This value must always be set to 00000011. NIDefaultTimeout 30 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. ServerAccessInterval 60 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. ``` ## Related articles [SUPL configuration service provider reference](supl-csp.md)