GATTSService

home Introduction

done Pycom Helium Miner
done Pycom Products
done Getting Started
done Tutorials & Examples
done Firmware & API Reference
- done Pycom Modules
  - done machine
  - done network
    - done WLAN
    - done CoAP
    - done Server
    - done Bluetooth
      - done GATT
      - done GATTCConnection
      - done GATTCService
      - done GATTCCharacteristic
      - done GATTSService
      - done GATTSCharacteristic
      - done Pymesh BLE
    - done LoRa
    - done Sigfox
    - done LTE
    - done MDNS
    - done Ethernet
  - done AES
  - done Pycom
  - done Shields
- done MicroPython Modules
- done Interrupts
done Product Info, Datasheets
done Update Firmware
done Pybytes
done Cellular Services
done Pylife
done Pymesh
done Micropython Support
done Advanced topics
done License

Ask on the forum

GATTSService

The GATT Server allows the device to act as a peripheral and hold its own ATT lookup data, server & characteristic definitions. In this mode, the device acts as a slave and a master must initiate a request.

Services are used to categorise data up into specific chunks of data known as characteristics. A service may have multiple characteristics, and each service has a unique numeric ID called a UUID.

The following class allows control over Server services.

Methods

service.start()

Starts the service if not already started.

service.stop()

Stops the service if previously started.

service.characteristic(uuid, * , permissions, properties, value)

Creates a new characteristic on the service. Returns an object of the class GATTSCharacteristic. The arguments are:

uuid is the UUID of the service. Can take an integer or a 16 byte long string or bytes object.

permissions configures the permissions of the characteristic. Takes an integer with a combination of the flags. When bluetooth object is initialized with PIN, read and write permissions are set to encrypted. Setting PIN later with set_pin() call does not affect the permissions of the already existing characteristics, thus they will remain not secured.

properties sets the properties. Takes an integer with an OR-ed combination of the flags.

value sets the initial value. Can take an integer, a string or a bytes object.


service.characteristic('temp', value=25)