User Provisionning
From Openmoko
(→Connection Profile) |
m (removed a broken link.) |
||
(7 intermediate revisions by 2 users not shown) | |||
Line 66: | Line 66: | ||
| IpAddr | | IpAddr | ||
| Internet Address for the DNS server | | Internet Address for the DNS server | ||
+ | |- | ||
+ | | '''''Data Compression''''' | ||
+ | | Boolean | ||
+ | | Use data compression | ||
+ | |- | ||
+ | | '''''Headers Compression''''' | ||
+ | | Boolean | ||
+ | | Use headers compression | ||
|- | |- | ||
|} | |} | ||
+ | This connection profile and PLMN capabilities (more specificaly in term of number of simultaneous PDP contexts availables) will be the basis for network resource contention resolution. | ||
Here is a XML Schema for handling User Provisionning: | Here is a XML Schema for handling User Provisionning: | ||
Line 78: | Line 87: | ||
elementFormDefault="qualified"> | elementFormDefault="qualified"> | ||
− | <xs:element name=" | + | <xs:element name="DialNum"> |
<xs:simpleType> | <xs:simpleType> | ||
<xs:restriction base="xs:string"> | <xs:restriction base="xs:string"> | ||
− | <xs:pattern value="+?[0-9] | + | <xs:pattern value="\+?([0-9])+"/> |
</xs:restriction> | </xs:restriction> | ||
</xs:simpleType> | </xs:simpleType> | ||
</xs:element> | </xs:element> | ||
− | <xs:element name=" | + | <xs:element name="APN" type="xs:string"/> |
− | <xs:element name=" | + | <xs:element name="Name" type="xs:string"/> |
− | <xs:element name=" | + | <xs:element name="UserId" type="xs:string"/> |
− | <xs:element name=" | + | <xs:element name="Password" type="xs:string"/> |
− | <xs:element name=" | + | <xs:element name="AuthentType" type="AuthentType"/> |
− | <xs:element name=" | + | <xs:element name="LingerTime" type="xs:positiveInteger"/> |
− | <xs:element name=" | + | <xs:element name="IpAddr" type="IpAddr"/> |
− | <xs:element name=" | + | <xs:element name="DNS" type="IpAddr"/> |
+ | <xs:element name="DataCompr" type="xs:boolean"/> | ||
+ | <xs:element name="HdrCompr" type="xs:boolean"/> | ||
<xs:simpleType name="quad"> | <xs:simpleType name="quad"> | ||
− | <xs:restriction base | + | <xs:restriction base="xs:integer"> |
<xs:minInclusive value="0"/> | <xs:minInclusive value="0"/> | ||
<xs:maxInclusive value="255"/> | <xs:maxInclusive value="255"/> | ||
Line 102: | Line 113: | ||
</xs:simpleType> | </xs:simpleType> | ||
− | <xs:complexType name=" | + | <xs:complexType name="IpAddr"> |
<xs:sequence> | <xs:sequence> | ||
<!-- IPAddr ::= quad1.quad2.quad3.quad4 --> | <!-- IPAddr ::= quad1.quad2.quad3.quad4 --> | ||
Line 112: | Line 123: | ||
</xs:complexType> | </xs:complexType> | ||
− | <xs:simpleType name=" | + | <xs:simpleType name="AuthentType"> |
<xs:restriction base="xs:string"> | <xs:restriction base="xs:string"> | ||
<xs:enumeration value="None"/> | <xs:enumeration value="None"/> | ||
Line 120: | Line 131: | ||
</xs:simpleType> | </xs:simpleType> | ||
− | <xs:element name=" | + | <xs:element name="ProvCommon"> |
<xs:complexType> | <xs:complexType> | ||
<xs:sequence> | <xs:sequence> | ||
− | <xs:element ref=" | + | <xs:element ref="Name"/> |
− | <xs:element ref=" | + | <xs:element ref="UserId"/> |
− | <xs:element ref=" | + | <xs:element ref="Password"/> |
− | <xs:element ref=" | + | <xs:element ref="AuthentType"/> |
− | <xs:element ref=" | + | <xs:element ref="LingerTime"/> |
− | <xs:element ref=" | + | <xs:element ref="IpAddr"/> |
− | <xs:element ref=" | + | <xs:element ref="DNS"/> |
+ | <xs:element ref="DataCompr"/> | ||
+ | <xs:element ref="HdrCompr"/> | ||
</xs:sequence> | </xs:sequence> | ||
</xs:complexType> | </xs:complexType> | ||
</xs:element> | </xs:element> | ||
− | <xs:element name=" | + | <xs:element name="CsdProvisionning"> |
<xs:complexType> | <xs:complexType> | ||
<xs:sequence> | <xs:sequence> | ||
− | <xs:element ref=" | + | <xs:element ref="DialNum"/> |
− | <xs:element ref=" | + | <xs:element ref="ProvCommon"/> |
</xs:sequence> | </xs:sequence> | ||
</xs:complexType> | </xs:complexType> | ||
</xs:element> | </xs:element> | ||
− | <xs:element name=" | + | <xs:element name="GprsProvisionning"> |
<xs:complexType> | <xs:complexType> | ||
<xs:sequence> | <xs:sequence> | ||
− | <xs:element ref=" | + | <xs:element ref="APN"/> |
− | <xs:element ref=" | + | <xs:element ref="ProvCommon"/> |
</xs:sequence> | </xs:sequence> | ||
</xs:complexType> | </xs:complexType> | ||
</xs:element> | </xs:element> | ||
− | <xs:element name=" | + | <xs:element name="Provisionning"> |
<xs:complexType> | <xs:complexType> | ||
<xs:choice> | <xs:choice> | ||
− | <xs:element | + | <xs:element ref="CsdProvisionning"/> |
− | <xs:element | + | <xs:element ref="GprsProvisionning"/> |
</xs:choice> | </xs:choice> | ||
</xs:complexType> | </xs:complexType> | ||
Line 162: | Line 175: | ||
</xs:schema> | </xs:schema> | ||
+ | |||
+ | == Extra Parameters == | ||
+ | |||
+ | These parameters profiles are used for specifying the way a browser or a specific application will use Connection Profile to access data. | ||
+ | They are: | ||
+ | |||
+ | * Profile name: (string) the name of this set of parameters | ||
+ | * Homepage: (string) the home page URL | ||
+ | * Protocol: (enum(WTP, HTTP)) if the browser or application support WAP this is the protocol used for accessing content (WTP/HTTP) | ||
+ | * ProxySettings: this is a compound parameter for proxy usage. It contains: | ||
+ | ** UseProxy: (boolean) use/don't use a proxy | ||
+ | ** Login: (string) name for proxy user | ||
+ | ** Password: (string) password for proxy user | ||
+ | ** IP Addr: (ipaddr) IP address of the proxy | ||
+ | ** Secured Port: (positive integer) port for secured communication | ||
+ | ** Unsecured Port: (positive integer) port for unsecured communication | ||
+ | * Connection Profile: (string) name of the connection profile to use | ||
+ | |||
+ | For specific applications, some other parameters could be defined. For example, for an audio streaming application some could define QoS parameters or a home SDP. | ||
+ | |||
+ | [[Category:Software ideas]] |
Latest revision as of 00:10, 22 September 2008
This page is an attempt to specify User Provisionning parameters for data bearer services ("Point-To-Point Connection Orientated Network Service" as specified in GSM 02.60). It is more a proposal, a way to share thoughts about it than a final formal specification. These parameters are used by the phone stacks to establish and setup a packet switched communication with the network. They are mainly grouped in two categories:
- Connection profile: the parameters used for activating the PDP context.
- Extra parameters: the parameters used for customizing the usage of the connection by the application, browser, J2ME MIDlet or any other
[edit] Connection Profile
The proposed parameters are grouped in the following table. Each row is a parameter and is introduced with its name, type and description. The first set of parameters are used for CSD (Circuit Switched Data) service.
Name | Type | Description |
---|---|---|
Dial Number | String | Phone number to dial for connecting data service |
The second set of parameters is used for GPRS connections
Name | Type | Description |
---|---|---|
APN | String | Access Point Name (as specified in 3GPP TS 07.60) |
The third set of parameters is common to both:
Name | Type | Description |
---|---|---|
Name | String | A name for identifying this connection profile object |
User Identity | String | User you'll authenticate as |
Password | String | Password to authenticate as User specified by User Identity |
Authentication Type | enum(None, Secured,Unsecured) | Kind of authentication used, None, PAP, CHAP |
Linger Time | Number | Number of seconds after last request before releasing connection |
IP Addr | IpAddr | Requested Internet Address |
DNS | IpAddr | Internet Address for the DNS server |
Data Compression | Boolean | Use data compression |
Headers Compression | Boolean | Use headers compression |
This connection profile and PLMN capabilities (more specificaly in term of number of simultaneous PDP contexts availables) will be the basis for network resource contention resolution.
Here is a XML Schema for handling User Provisionning:
<?xml version="1.0"?> <xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema" targetNamespace="http://www.openmoko.org" xmlns="http://www.openmoko.org" elementFormDefault="qualified"> <xs:element name="DialNum"> <xs:simpleType> <xs:restriction base="xs:string"> <xs:pattern value="\+?([0-9])+"/> </xs:restriction> </xs:simpleType> </xs:element> <xs:element name="APN" type="xs:string"/> <xs:element name="Name" type="xs:string"/> <xs:element name="UserId" type="xs:string"/> <xs:element name="Password" type="xs:string"/> <xs:element name="AuthentType" type="AuthentType"/> <xs:element name="LingerTime" type="xs:positiveInteger"/> <xs:element name="IpAddr" type="IpAddr"/> <xs:element name="DNS" type="IpAddr"/> <xs:element name="DataCompr" type="xs:boolean"/> <xs:element name="HdrCompr" type="xs:boolean"/> <xs:simpleType name="quad"> <xs:restriction base="xs:integer"> <xs:minInclusive value="0"/> <xs:maxInclusive value="255"/> </xs:restriction> </xs:simpleType> <xs:complexType name="IpAddr"> <xs:sequence> <xs:element name="quad1" type="quad"/> <xs:element name="quad2" type="quad"/> <xs:element name="quad3" type="quad"/> <xs:element name="quad4" type="quad"/> </xs:sequence> </xs:complexType> <xs:simpleType name="AuthentType"> <xs:restriction base="xs:string"> <xs:enumeration value="None"/> <xs:enumeration value="Unsecured"/> <xs:enumeration value="Secured"/> </xs:restriction> </xs:simpleType> <xs:element name="ProvCommon"> <xs:complexType> <xs:sequence> <xs:element ref="Name"/> <xs:element ref="UserId"/> <xs:element ref="Password"/> <xs:element ref="AuthentType"/> <xs:element ref="LingerTime"/> <xs:element ref="IpAddr"/> <xs:element ref="DNS"/> <xs:element ref="DataCompr"/> <xs:element ref="HdrCompr"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="CsdProvisionning"> <xs:complexType> <xs:sequence> <xs:element ref="DialNum"/> <xs:element ref="ProvCommon"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="GprsProvisionning"> <xs:complexType> <xs:sequence> <xs:element ref="APN"/> <xs:element ref="ProvCommon"/> </xs:sequence> </xs:complexType> </xs:element> <xs:element name="Provisionning"> <xs:complexType> <xs:choice> <xs:element ref="CsdProvisionning"/> <xs:element ref="GprsProvisionning"/> </xs:choice> </xs:complexType> </xs:element> </xs:schema>
[edit] Extra Parameters
These parameters profiles are used for specifying the way a browser or a specific application will use Connection Profile to access data. They are:
- Profile name: (string) the name of this set of parameters
- Homepage: (string) the home page URL
- Protocol: (enum(WTP, HTTP)) if the browser or application support WAP this is the protocol used for accessing content (WTP/HTTP)
- ProxySettings: this is a compound parameter for proxy usage. It contains:
- UseProxy: (boolean) use/don't use a proxy
- Login: (string) name for proxy user
- Password: (string) password for proxy user
- IP Addr: (ipaddr) IP address of the proxy
- Secured Port: (positive integer) port for secured communication
- Unsecured Port: (positive integer) port for unsecured communication
- Connection Profile: (string) name of the connection profile to use
For specific applications, some other parameters could be defined. For example, for an audio streaming application some could define QoS parameters or a home SDP.