net.rim.device.api.system
Class Radio

java.lang.Object
  net.rim.device.api.system.Radio

public final class Radio
extends Object

Provides access to the device's radios.

See Also:

RadioInfo

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.2.1

Method Summary
	static boolean	activateWAFs(int WAFs) This method requests that the radios that belong to the provided Wireless Access Families (WAFs) be powered on.
	static void	deactivateWAFs(int WAFs) Requests that the radios belonging to the provided Wireless Access Families be powered off.

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

activateWAFs

public static boolean activateWAFs(int WAFs)

This method requests that the radios that belong to the provided Wireless Access Families (WAFs) be powered on. A request will not be successful if the BlackBerry device is in the process of an Upgrade over the wireless network, or if the CryptoBlock or USBPasswordRedirectManager does not allow the radio to be turned on.

If the request is successful, and all the specified WAF(s) are supported, the activateWAFs method activates the specified WAF(s). To determine if a WAF is supported, call RadioInfo.areWAFsSupported(int).

Parameters:

WAFs - A bitfield of RadioInfo.WAF_* flags indicating the Wireless Access Families whose radios should be turned on.

Returns:

True if the request was successful and false if not. If the request was successful, it does not guarantee that the specified WAFs were activated.

Throws:

ControlledAccessException - if this operation is not allowed.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.2.1, 4.2.1

deactivateWAFs

public static void deactivateWAFs(int WAFs)

Requests that the radios belonging to the provided Wireless Access Families be powered off.

Parameters:

WAFs - A bitfield of RadioInfo.WAF_* flags indicating the Wireless Access Families whose radios should be turned off.

Throws:

ControlledAccessException - if this operation is not allowed.

Category:

Signed: This element is only accessible by signed applications. If you intend to use this element, please visit http://www.blackberry.com/go/codesigning to obtain a set of code signing keys. Code signing is only required for applications running on BlackBerry smartphones; development on BlackBerry Smartphone Simulators can occur without code signing.

Since:

BlackBerry API 4.2.1