Startseite
User Interface
Mobile UI Applikation
Mobile UI - CONTROL functions
These CTRLfunctions can be used to address sensors, GPS recievers and bluetooth services on mobile devices.
btleDescriptorRead()
The function will try to read a descriptor from a service.

User Interface
- Grundlagen Modul VISION
- Abgesetztes UI
- Desktop UI
- ULC UX
- Dashboard
- Mobile UI Applikation
  - Voraussetzung & Installation
  - Konfiguration
  - Mobile Applikations Interface
  - Device Management
  - Geräteklassen
  - Mobile UI - CONTROL functions
    These CTRLfunctions can be used to address sensors, GPS recievers and bluetooth services on mobile devices.
    - btDiscoverDevicesStart()
      Starts the discovery of nearby Bluetooth devices.
    - btDiscoverDevicesStop()
      This function cancels the running bluetooth discovery.
    - btleCharacteristicRead()
      The function tries to read a characteristic from the service.
    - btleCharacteristicWrite()
      The function tries to write a characteristic to a service.
    - btleClose()
      This function is used to close the access to given bluetooth device.
    - btleDescriptorRead()
      The function will try to read a descriptor from a service.
    - btleDescriptorWrite()
      This function tries to write a descriptor to a service.
    - btleOpen()
      Opens access to the given device (by its address) and returns the list of services offered by the remote device.
    - btleServiceConnect()
      This function connects to the given bluetooth service.
    - btleServiceDisconnect()
      Disconnects from an established service.
    - geoClose()
      Closes the opened source.
    - geoOpen()
      The function opens a geo source.
    - geoPosition()
      Returns a mapping containing position information.
    - geoSourceName()
      Returns the name of the currently open geo source.
    - geoSources()
      Returns a list of available geosources.
    - myDeviceClass()
      The function returns the device class if a class is available.
    - sensorClose()
      The function closes the sensor.
    - sensorGet()
      Get reading data from a sensor.
    - sensorOpen()
      Opens the given sensor.
    - sensorSet()
      Sets some properties of the sensor.
    - sensorStart()
      Starts retrieving values from the sensor.
    - sensorStop()
      Stops retrieving values from the given sensor.
    - sensorTypes()
      This function detects the sensors of a device.
  - [webClient]
  - config.webclient
  - Branding der Informationsliste - Desktop UI /Mobile UIs
  - Hinweise und Einschränkungen
- Grundlagen zum Siemens ITC

btleDescriptorRead()

The function will try to read a descriptor from a service.

Synopsis

int btleDescriptorRead(int serviceId, string characteristicUUID, string uuid, mapping &data);

Parameters


Parameter	Description
serviceId	The Id of the Service
CharacteristicUUID	The uuid of the characteristic.
uuid	The uuid of the descriptor.
data	The cached descriptor value.

Return Value

Returns 0 on success. On error the return value is one of:

-1 ... illegal arguments passed

1 ... OperationError

4 ... UnknownError

6 ... DescriptorReadError

Description

The function will try to read a descriptor from a characteristic, given by its uuid, from the service, which must be connected by a call to btleServiceConnect().

When the descriptor was read, the mapping contains the data as described in the btleServiceConnect() key "descriptors".

Assignment

Mobile UI control functions