Developers guide

Chapter 8: Indicators
Controlling Pulses
52 Psion Teklogix Mobile Devices SDK Developers Guide
8.3 Controlling Pulses
The following terms are used to describe the behaviour of a pulsing LED:
Independent colour: On multi-colour LEDs, if the independent colour flag is set, this pulse can
add to the colour being displayed by the LED.
Extend current pulse: This feature only applies when the independent colour flag is also set. If
the LED is in the process of performing a pulse using the same colour, the duration of this new
pulse replaces the duration of the existing pulse. This can result in the duration either being ex-
tended or reduced.
Several overlapping pulses can exist. The effects depend on the settings of the independent colour
flag and the extend current pulse flag.
8.4 Controlling Illumination Patterns
The Mobile Devices SDK provides the ability to display a two-colour illumination pattern on
a LED.
The following diagram shows how an illumination pattern is structured:
The two colours, their duration times, the delay between repeats, and the number of repeats can be
defined in the application. See the API Reference manual for your programming language for in-
formation on how to specify these values.
8.5 Indicator API Elements
C++: The display on all Psion Teklogix computers is controlled using the
PsionTeklogix::Indicators namespace.
Java: The display on all Psion Teklogix computers is controlled using the
com.teklogix.indicators package.
.NET: The display on all Psion Teklogix computers is controlled using the
PsionTeklogix.Indicators namespace.
Duration1 Duration2 Delay
Repeat
Duration1 Duration2
Colour1 Colour2
Time
Colour1 Colour2