Microchip® Advanced Software Framework

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
Scan Parameter

Introduction

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

The Scan Parameter service application bring-up the Scan Parameter service defined by the Bluetooth SIG. This example demonstrates retrieving scan interval window information from a peer device implementing this service. The application implements a GATT server role. For the purpose of demonstration, the example also shows how to get the updated scan interval window value, by configuring the scan refresh characteristic for notification

  • 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 iPhoneŽ/Android phone, enable Bluetooth in the Settings page. Start the Atmel Smart Connect App and scan for devices. ATMEL-SCP will be appear among the devices scanned. Click on ATMEL-SCP to connect to supported platform.
    • 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 paired, the application displays the scan parameter service.
    • 9. On clicking the Scan Parameters service, user keeps getting notifications for scan refresh characteristic value, user can disable notifications.
    • 10. User can write the new value for Scan Interval Window characteristic on mobile app. On the device side, the updated new value for scan interval and scan window will be displayed in the console log.

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 Services-
    • The Scan Parameters Service enables a GATT Client to store the LE scan parameters it is using on a GATT Server device so that the GATT Server can utilize the information to adjust behaviour to optimize power consumption and/or reconnection latency

    • The Scan Parameters Service enables a GATT Server device to expose a characteristic for the GATT Client to write its scan interval and scan window on the GATT Server device.

      Scan Parameters service has two characteristics:

    • Scan Interval Window - The Scan Interval Window characteristic is used to store the scan parameters of the Client. Included in this characteristic are the Scan Interval and Scan Window of the Client.
    • Scan Refresh - The Scan Refresh characteristic is used to notify the Client that the Server requires the Scan Interval Window characteristic to be written with the latest values upon notification
  • 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:28:08 for Scan Parameter Application - SAM D21 Xplained Pro by   doxygen 1.8.5