Resources | developer.brewmp.com Resources | developer.brewmp.com

Developer

resources

Automatic Connection - OEM Only

Using automatic connection means that the application does not need to scan for access points, get the list of available networks, or call to connect to a network. The application can wait for a signal that the connection has been made and then check the connection status.

The process is:

  1. Enable the WLAN subscription.
  2. Add one or more profiles.
  3. Turn on the WLAN by setting the system preference.
    • The call manager attempts to connect to the highest priority profile.
  4. The application gets a signal about the connection status change.
  5. The application gets the connection status.
  6. The application transfers data over the WLAN connection.
  7. The application disconnects from the access point.

Using automatic connections

When the WLAN is turned on, the AMSS Call Manager attempts to connect to the access point with the highest priority profile. If the attempt to connect fails, the AMSS Call Manager then attempts to connect to the access point defined in the next highest profile. If the AMSS Call Manager fails to connect to any of the access points, it pauses, and then starts over with the highest priority profile.

A failure notification is sent after the AMSS Call Manager has failed to connect to any profile. The success notification is sent when the connection is made.

Applications do not need to call wlan_IConnMgr_Connect() to explicitly connect to the access point, but should listen to the WLAN connection status using wlan_IConnMgr_OnConnectStatusChange().

The AMSS Call Manager uses the WLAN profile in net_list, which is maintained by the wlan_IProfileMgr API.

The AMSS Call Manager stops trying to connect when the wlan_IConnMgr_Connect() API is used. A profile for the access point used in the wlan_IConnMgr_Connect() API is stored in the net_user_manual_sys, and the AMSS Call Manager will use this profile to connect to the access point upon device power-cycle.

See Disabling Automatic Connection - OEM Only for information on what changes to make to prevent automatic connection.

Note: The feature of the WLAN starting in automatic mode when WLAN added to the mode preference through IPHONECTL_SetSystemPreference() is available in Brew MP 1.0.2.410 and later releases.

Automatic connection examples

In these examples, P1, P2 and P3 are three profiles with P1 having the highest priority, P2 having the 2nd priority and P3 having the lowest priority. This diagram shows the basic flow for automatic activation of a profile:

The following diagram shows a successfull connect on the third profile.

The following diagram shows the flow when the AMSS Call Manager fails to connect to any of the profiles.

For information on the AMSS Call Manager, see 80-V3568-1_J_Multimode_CM_Overview.pdf.