Microchip® Advanced Software Framework

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
phone alert status

Introduction

******************************Introduction ***********************************

The Phone Alert Status example application bring-up the Phone alert profile defined by the Bluetooth SIG. The Phone Alert Status profile (PAS) is used to obtain the Phone Alert Status exposed by the Phone Alert Status service on a mobile device. Alert Status and Ringer Setting information of a mobile phone can be received and modified by the Phone Alert Status service. The device can also use this profile to configure ringer status on the mobile device.

  • Supported Evolution Kit -
    • ATSAML21-XPRO-B + ATBTLC1000 XPRO
    • ATSAMD21-XPRO + ATBTLC1000 XPRO
    • ATSAMG55-XPRO + ATBTLC1000 XPRO
    • ATSAM4S-XPRO + ATBTLC1000 XPRO
  • Running the demo -
    • 1. Build and flash the binary into supported evaluation board.
    • 2. Open the console using TeraTerm or any serial port monitor.
    • 3. Press the Reset button.
    • 4. Wait for around 10 seconds for the patches to be downloaded device will initialize and start-up.
    • 5. The device is now in advertising mode.
    • 6. On a BLE compatible Android phone enable Bluetooth in the Settings page. Use the Atmel Smart Connect App and scan for devices. ATMEL-PAS will be appear amongst the devices scanned. Click on ATMEL-PAS to connect.
    • 7. Once connected, the client side will request for the pairing procedure . The console log provides a guidance for the user to enter the pass-key.
    • 8. Once the device is connected, notifications are automatically enabled and the application reads the values of ‘Alert Status’, ‘Ringer Settings’, and ‘Ringer Control Point’ characteristics, which are updated on the mobile app as shown.
    • 9. Now, when the SW0 button is pressed on supported platform, the device is set to different modes by using the notifications.

Modules

***************************** MODULES *****************************************

  • BLE Manager -
    • The Event Manager is responsible for handling the following:
      • Generic BLE Event Handling:-
        • BLE Event Manager handles the events triggered by BLE stack and also responsible for invoking all registered callbacks for respective events. BLE Manager handles all GAP related functionality. In addition to that handles multiple connection instances, Pairing, Encryption, Scanning.
      • Handling Multi-role/multi-connection:-
        • BLE Event Manager is responsible for handling multiple connection instances and stores bonding information and Keys to retain the bonded device. BLE Manager is able to identify and remove the device information when pairing/encryption gets failed. In case of multi-role, it handles the state/event handling of both central and peripheral in multiple contexts.
      • Controlling the Advertisement data:-
        • BLE Event Manager is responsible for generating the advertisement and scan response data for BLE profiles/services that are attached with BLE Manager.
  • BLE Profiles -
    • The Phone Alert Status profile is used to obtain the Phone Alert Status exposed by the Phone Alert Status service in the peer device. The information of Alert Status and Ringer Setting of a phone can be received and changed by the Phone Alert Status service. This profile also enables the device to configure ringer status on the peer device. Phone alert Profile supports one service:
      • Phone Alert Status Service -
        • The Phone Alert Status service uses the Alert Status characteristic, Ringer Setting characteristic to expose the phone alert status and Ringer Control Point characteristic to control phone into mute or enable.
  • BLE Services -
    • The Phone Alert Status service uses the Alert Status characteristic, Ringer Setting characteristic to expose the phone alert status and Ringer Control Point characteristic to control phone into mute or enable.
    • Phone alert Profile supports three characteristics:
      • Alert Status - The Alert Status Characteristic includes three fields of information to express the alerting status as follows.
        • Ringer State
        • Vibrator State
        • Display Alert State
      • Ringer Setting -
        • The Ringer Setting characteristic returns the current value of the Ringer Setting when read.
      • Ringer Control point -
        • When the Ringer Control Point characteristic is written, the server device performs an action based on the value (command).
          • The server device implements a state machine with two states, “Ringer Silent” and “Ringer Normal”
          • The command “Set Silent Mode” sets the state to “Ringer Silent”.
          • The command “Cancel Silent Mode” sets the state to “Ringer Normal”.
          • The command “Mute Once” silences the server device’s ringer.
          • The server device’s ringer is silenced when the state is “Ringer Silent” and act according to phone settings when the state is “Ringer Normal”.
  • BLE Platform Services -
    • Interface Settings -
      • Connect ATBTLC1000 XPRO to SAML21-XPRO-B -> EXT1
      • Connect ATBTLC1000 XPRO to SAMD21-XPRO -> EXT1
      • Connect ATBTLC1000 XPRO to SAMG55-XPRO -> EXT1
      • Connect ATBTLC1000 XPRO to SAM4S-XPRO -> EXT1
    • Serial Console COM port settings -
      • Baudrate 115200
      • Parity None, Stop Bit 1, Start Bit 1
      • No Hardware Handshake
    • 6-Wire Mode Connection Setup -
      • Pins are 1:1 match with SAML21/D21 Xpro EXT1 Header to BTLC1000 XPro Header
      • UART(No Flow Control)-SAM L21/D21 XPro Pins (Rx-Pin13, Tx-Pin14)
      • UART(With Flow Control)-SAM G55 Xpro Pins (Rx-Pin13, Tx-Pin14, RTS-Pin5, CTS-Pin6, Rx-Pin16, Tx-Pin17)
      • BTLC1000 Wakeup Pin-SAM G55 XPro Pins(Pin4)
      • BTLC1000 Chip Enable Pin-SAM G55 XPro Pins(Pin10)
      • BTLC1000 Vcc Pin-SAM L21/D21/G55 Xpro Pins(Pin20)
      • BTLC1000 GND Pin-SAM L21/D21/G55 Xpro Pins(Pin19)
    • 4-Wire Mode Connection setup -
      • UART(With Flow Control)-SAM L21/D21 XPro Pins (Rx-Pin15, Tx-Pin17, RTS-Pin16, CTS-Pin18)
      • BTLC1000 Wakeup Pin-SAM L21/D21 XPro Pins (Rx-Pin6)
      • BTLC1000 Chip Enable Pin-SAM L21/D21 XPro Pins (Rx-Pin4)
      • UART(With Flow Control)-SAM G55/4S Xpro Pins (Rx-Pin13, Tx-Pin14, RTS-Pin5, CTS-Pin6)
      • BTLC1000 Wakeup Pin-SAM G55/4S XPro Pins(Pin4)
      • BTLC1000 Chip Enable Pin-SAM G55/4S XPro Pins(Pin10)
      • BTLC1000 Vcc Pin-SAM L21/D21/G55/4S Xpro Pins(Pin20)
      • BTLC1000 GND Pin-SAM L21/D21/G55/4S Xpro Pins(Pin19)

Package

***************************** BluSDK Package *****************************************

Generated on Fri Mar 4 2022 23:27:47 for Phone Alert Status Application - SAM D21 Xplained Pro by   doxygen 1.8.5