User`s guide

Architecture
AT85C51SND3Bx Firmware User’s Guide 5-31
7691A–MP3–08/07
– Secondly, from this application up to the top one, their screens are redrawn one
after the others.
Thus, this mechanism makes it possible to redraw superimposed non-full-screen win-
dows automatically.
5.4.5 Automatic display The automatic display module is charged with managing the display of time-related
graphical objects. It enables to make easily animations from pictures placed in a special
directory “tools\picture_maker\pictures_demo_default\Animations”. The basic pictures
composing a future animation picture must be named as follows:
animationpicturename__index.bmp
index can be digits and letters: it is useful to define the integration order.
The animation pictures are generated at the same time as the other ordinary pictures by
the picture maker tool. Make live animation pictures in the firmware with the following
functions and macros:
Table 5-3. Functions and macros controlling the automatic display
Note: Event EVT_ANIMATION with parameter ANIMATION_END is mailed when animation
stops in mode AD_SINGLE.
5.4.6 Software Timers The software timers are data structures integrating a 32-bit register. Their static values
are compared to the value of the tick counter every scheduler round. If the tick counter
value has reached a software timer time register, an overflow timer message is mailed
once.
Functions or macros
Description
ad_allocate (U8 obj_type,
Ad_p_prm
_MEM_TYPE_SLOW_
*p_param_struct)
Allocates one of the graphical object slots still available and returns a 8-bit
ID. The ID is equal to “UNDEF_AD_OBJ” if failure in allocation.
If success, this ID is to store by the MMI application in order to control the
object with the help of the other functions and macros below.
Note: No risk of object identity usurpation after a cold reset since the
value of “UNDEF_AD_OBJ” is 0.
Parameters:
Only object type is currently supported: AD_ID_ANIMATION.
The parameter structure “Ad_p_prm _MEM_TYPE_SLOW_” configured
the object in its appearance and its behavior. As the only one object type
actually supported is animation, the structure “Ad_p_prm” is always
“Ad_prm_animation” as follows:
typedef struct
{
U8 x; // x-coordinate
U8 y; // y-coordinate
U32 IDP; // ID of the animation picture
U8 time_10ms; // Time with 10ms granularity
U8 mode; // Repeat: AD_SINGLE or AD_FOREVER
}Ad_prm_animation;
ad_start( U8 id ) Starts the graphical object running
ad_pause( U8 id ) Suspends the graphical object in running
ad_stop( U8 id ) Stops the graphical object running and resets its state machine
ad_refresh( U8 id ) Requests the display refresh of the graphical object
Ad_free( U8 id ) Releases one of the graphical object and sets the variable storing the id to
the value “UNDEF_AD_OBJ” in order to prevent from identity usurpation.