Home
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.
btleCharacteristicRead()
The function tries to read a characteristic from the service.

User Interface
- User Interface (VISION)
  Das herkömmliche User Interface von WinCC OA.
- Abgesetztes UI
- Desktop UI
  Das WinCC OA Desktop UI ist ein eigenständiger Remote-UI-Client von WinCC OA.
- 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]
    Einstellungen für die WinCC OA mobile UI Applikation und das WinCC OA Desktop UI.
  - config.webclient
  - Hinweise und Einschränkungen
- Grundlagen zum Siemens ITC

btleCharacteristicRead()

The function tries to read a characteristic from the service.

Synopsis

int btleCharacteristicRead(int serviceId, string uuid, mapping &data);

Parameters


Parameter	Description
serviceId	The Id of the service.
uuid	The UUID of the characteristic.
data	Mapping to save the received data. This is dependent on the characteristic addressed

Return Value

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

-1 ... illegal arguments passed

1 ... OperationError

4 ... UnknownError

5 ... CharacteristicReadError

Description

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

When the characteristic was read, the mapping contains the data as described in the btleServiceConnect().callback key "characteristics".

Assignment

Mobile UI control functions