Help
Menu

Providers

Providers are data sources and get data from different sources like system or environment values, MQTT data, REST API results or calculate times like solar or lunar times. They continuously collect and process information from device sensors, network services, public APIs, and internal calculations, then feed it to facelets through the expression parser. This architecture cleanly separates data acquisition from visual presentation, so any facelet can display data from any provider simply by referencing the appropriate output value.


Status

Every provider returns a status value which informs about its actual condition.
Some providers use their output value as status, others the accuracy of their source depending on the function.
The status can be used to set color of text or icons, hide Facelets on N/A etc.
The following values are used:

Text

Value

Color

Condition

N/A

0

Gray

Absent, value not available, provider not initialized/available

Excellent

1

Green

Excellent, very good

Good

2

Blue

Good

Fair

3

Yellow

Fair, medium

Poor

4

Orange

Poor, bad

Fail

5

Red

Fail, critical, very bad


Status as Color Source

Whenever a Facelet has a color input, a provider status value can be used as direct color source.
For example, a text color input can be set to the status value of e.g the Battery Provider to reflect its current status as color of the table above.

Tip
 It’s handy to use the center dot of the Clock Facelet or the colon of the Digital Clock Facelet as status indicator of the Time Provider.
A green dot means the time is accurate, a red dot means the time is not accurate.
Simply select "Actual Time" / "Status" as according color input.


Available Providers

Alarm
The Alarm Provider gets the time of the next scheduled alarm event from the device alarm manager.
Battery
The Battery Provider gives all kind of information about the status of the battery.
Body
The Body Provider gets the actual measured body metrics from the sensors.
Calendar
The Calendar Provider accesses the local calendar of the device.
Complication Data
The Complication Provider gives access to the data of the defined complications of the watch.
Connectivity
The Connectivity Info Provider gives all kind of information about the actual internet connection state.
Duration
The Duration Provider calculates the duration between two timepoints.
Environment
The Environment Provider gives environment sensor values like temperature or pressure.
Geocoding
The Geocoding Provider translates GPS coordinates into a real street address.
Geofence
The Geofence Provider tests whether the device's actual location falls within a specified area.
GPS Location
The GPS Provider gets location coordinates from the integrated GNSS receiver.
Health
The Health Info Provider gets information from health related sensors.
Location
The Location Provider gets actual fused coordinates from different input sources.
Lunar Times
The Lunar Provider calculates dates, times, moon phases and related information.
Marine
The Marine Provider gets tidal times information, wave conditions, water temperature and UV index data.
MQTT
The MQTT Provider connects to a MQTT broker and receives or stores data.
MySQL
The MySQL Provider connects to a MySQL database and executes queries.
Navigation
The Navigation Provider calculates the direction, bearing and distance between two points.
Online Check
The Online Check Provider checks by Ping or HTTP request if a server or website is online.
Orientation
The Orientation provider gets the X-, Y- and Z-axis orientation of the device.
Prayer Times
The Prayer Times Provider calculates high precision islamic prayer times for a given GPS location.
Push Notification
The Push Notification Provider gets data from the push notification service.
Recorder
The Recorder Provider records a data source.
REST
The REST Provider makes HTTP API requests to the given URL and parses the result with a given expression.
Solar Times
The Solar Provider calculates sun rise, set and noon dates for a given location.
Stock Data
The Stock Data Provider gets actual stock and crypto currency data information.
Stopwatch
The Stopwatch Provider measures the time from a start event.
Syndication
The Syndication Provider loads and processes periodically an ATOM or RSS feed.
System Info
The System Info Provider gives different information about the device and system.
Time
The Time Provider gets its actual time from different sources like NTP or GPS/GNSS to offer high precision time.
Timer
The Timer Provider is triggered by an event and sets an output for the specified timer interval time.
UDP Receiver
The UDP Receiver Provider, as the name says, receives UPD packets and extracts data of them.
Value
The Value Provider generates values.
Weather
The Weather Provider gets weather data and several additional information from different weather services.
Web Scraper
The Web Scraper Provider finds and extracts any data out of a HTML website.
WebSocket
The WebSocket Provider connects to a WebSocket and receives (or can send) data messages.
Providers