Microchip® Advanced Software Framework

 All Data Structures Files Functions Variables Typedefs Enumerations Enumerator Macros Groups Pages
BATTERY INFO Example

Introduction

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

  • The Battery Application is an example application that bring-up Bluetooth Battery Service.
  • Battery service provides the capability to report battery level of the device using the battery characteristics.
  • Any application discovering the database can access the Battery service instance during discovery services.
  • For the purpose of demonstration, the example simulates battery level of the device. The battery level will be increased by 1% for every 100ms and decreased by 1% every 1 second. The range of battery level is from 0% to 100%.

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. Enable Bluetooth® from the Settings page on a BLE compatible Android device or iPhone®. Use the Atmel Smart Connect application to scan for peripheral devices. A device with the name ‘ATMEL-BAS’ will appear in the list of scanned devices.
  • 7. Click on the “ATMEL-BAS” device. A pop-up will appear requesting pass-key. Enter “123456” and click on ‘Pair’.
  • 8. Once the “Battery Service” is clicked user gets notifications for battery level characteristic. User can stop receiving the notifications by disabling notifications.

Modules

***************************** Modules **************************************

  • BLE Manger - Refer more info to 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 Battery Service exposes the state of a battery within a device.
    • The Battery Service exposes the Battery State and Battery Level of a single battery or set of batteries in a device.
    • Battery service has one characteristic:
      • Battery Level:
        • The Battery Level characteristic is read using the GATT Read Characteristic Value sub-procedure and returns the current battery level as a percentage from 0% to 100%; 0% represents a battery that is fully discharged, 100% represents a battery that is fully charged.
  • 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)

SDK Package

***************************** BLE SDK Package ******************************************

Generated on Fri Mar 4 2022 23:24:33 for Battery Service Application - SAM D21 Xplained Pro by   doxygen 1.8.5