Foundation API

Connection Manager Foundation API

Client Registration/De-registration APIs

Applications have to register with CM in order to use its services. Application shall use the following APIs in order to register and de-register with CM.
  1. NetCMClientRegister
  2. NetCMClientDeRegister

Manager APIs

  1. NetCMConnectionOpen
  2. NetCMConnectionClose
  3. NetCMDeviceGetInfo
  4. NetCMGetActiveProfileIDs
  5. NetCMConnectionKill
  6. NetCMGetTransportError
  7. NetCMTunnelRequest

Event Callback

This section describes the callback function which will be used to notify the client application about the CM Asynchronous events. This callback function will be called in the CM Client library context. It should not call any of the CM foundation APIs.
The callback function is shown below:

NetAppEvtCb_t

Notifications to Application

Asynchronous Callback Events to Application

The list below contains events which shall be sent by Connection Manager, asynchronously to all the applications which has an active/in progress connection. Each event is sent with a data of type NetEventInfo_t using Callback.

  1. NET_EVENT_OPEN_RSP
  2. NET_EVENT_CLOSE_RSP
  3. NET_EVENT_KILL_RSP
  4. NET_EVENT_CLOSE_IND
  5. NET_EVENT_SUSPEND_IND
  6. NET_EVENT_RESUME_IND
  7. NET_EVENT_TUNNEL_RSP

Asynchronous Event Notification to Application

The list below contains events which shall be sent by Connection Manager Server, asynchronously to all the applications using Event Delivery mechanism.

NET_EVENT_TUNNEL_IND

Note: Client application receives this event from ED in Base64 encoded format. Application needs to decode the event data and typecast the event data into data type: NetEventTunnelIndInfo_t.

definitions

Error values

NetErr_t (Error values)

Callback Event Data structures

  1. NetEvent_t (Net Event type)
  2. NetEventInfo_t (NET Event Information)
  3. NetDevInfo_t (NET Device Information)

Address data structures

In LiMo Foundation Platform Release 1, only IPv4 address type shall be supported. IPv6 may be supported in future releases.

  1. NetAddrType_t (NET Address Type)
  2. NetAddr_t (NET Address)

NET CM API Data Structures

  1. NetTransportType_t (NET Transport type)
  2. NetCMTunnelInfo_t (NET Tunnel Info)

Authentication Data Structures

  1. NetAuthType_t (NET Authentication Type)
  2. NetAuthInfo_t (NET Authentication Information)

QOS Data Stuctures

  1. NetPdpQosType_t (NET PDP QOS Type)
  2. NetPdpQosGprs_t (NET PDP GPRS QOS Type)
  3. NetPdpQosUmts_t (NET PDP 3G QOS Type)
  4. NetPdpQosInfo_t (NET PDP QoS information)

Data Constants

NET_DEVICE_NAME_LEN_MAX
NET_CONNECTIONS_MAX
NET_PDP_APN_LEN_MAX
NET_PDP_AUTH_USERNAME_LEN_MAX
NET_PDP_AUTH_PASSWORD_LEN_MAX
NET_DNS_ADDR_MAX
Generated on Mon Mar 31 01:01:00 2008 by  doxygen 1.5.4