API for interacting with the Pebble communication subsystem. More...

Collaboration diagram for App Communication:

Enumerations
enum	SniffInterval { SNIFF_INTERVAL_NORMAL = 0, SNIFF_INTERVAL_REDUCED = 1 }

Functions
void	app_comm_set_sniff_interval (const SniffInterval interval)

SniffInterval	app_comm_get_sniff_interval (void)

Detailed Description

API for interacting with the Pebble communication subsystem.

Note: To send messages to a remote device, see the AppMessage or AppSync modules.

Enumeration Type Documentation

◆ SniffInterval

enum SniffInterval

Intervals during which the Bluetooth module may enter a low power mode. The sniff interval defines the period during which the Bluetooth module may not exchange (ACL) packets. The longer the sniff interval, the more time the Bluetooth module may spend in a low power mode. It may be necessary to reduce the sniff interval if an app requires reduced latency when sending messages.

Note: These settings have a dramatic effect on the Pebble's energy consumption. Use the normal sniff interval whenever possible. Note, however, that switching between modes increases power consumption during the process. Frequent switching between modes is thus discouraged. Ensure you do not drop to normal frequently. The Bluetooth module is a major consumer of the Pebble's energy.

Enumerator
SNIFF_INTERVAL_NORMAL	Set the sniff interval to normal (power-saving) mode.
SNIFF_INTERVAL_REDUCED	Reduce the sniff interval to increase the responsiveness of the radio at the expense of increasing Bluetooth energy consumption by a multiple of 2-5 (very significant)

Function Documentation

◆ app_comm_get_sniff_interval()

SniffInterval app_comm_get_sniff_interval ( void )

Get the Bluetooth module's sniff interval

Returns: The SniffInterval value corresponding to the current interval

◆ app_comm_set_sniff_interval()

void app_comm_set_sniff_interval ( const SniffInterval interval )

Set the Bluetooth module's sniff interval. The sniff interval will be restored to normal by the OS after the app's de-init handler is called. Set the sniff interval to normal whenever possible.