Filter
Top Products
M851 WristApp Design Guide Rev 1.2
Timex Corporation 24
4.4.5.5 Icon Refresh
Certain application requires that it be called whenever changes are being done to the status of the primary
mode icons. These applications may be the TOD and the Options Mode. The TOD application requires an
icon refresh event whenever the user manually enables/disables NightMode or the system automatically
enables/disables Nightmode so it can update the MOON icon. The Options mode requires the update of the
NightMode or the Chime whenever the system changes the current status so it can display the appropriate
message. In the option mode, the event was used to update the message along with the icon depending on
the UI requirement.
To enable or disable receiving the event COREEVENT_ICON_REFRESH, then the macros below should be
called:
CORE_BACKGROUND_ICON_REFRESH_ENABLE;
CORE_BACKGROUND_ICON_REFRESH_DISABLE;
4.4.5.6 End of Scrolling
The application can request an event everytime a message that is scrolling reaches the end of the message.
The macro is below to send the “end of scrolling” event to the application. This will also stop scrolling the
message once it reaches the end of the message. If the size of the message does not require scrolling, then
the event COREEVENT_END_OF_SCROLLING_MESS is sent after the message is displayed on the LCD.
LCD_SCROLL_RAM_OR_ROM_MSG_MAIN_DM_LINE2 EVENT_ON;
If the application want the message to scroll continuosly, then the macro below is used:
LCD_SCROLL_RAM_OR_ROM_MSG_MAIN_DM_LINE2 EVENT_OFF;
4.4.5.7 Resource Updates
By default, on any state change, resource display updates are disabled by the core. To have resource
display updates event passed to the application, the application must make an API call to the resource to
request for updates. These events can then be used to display the new or updated data.
An application may request different types of resource to send the update events. Each resource type will
send a unique system event. To request (and cancel) a resource update, use the followingAPIs:
KTOD_ENABLE_DISP_UPD_SEC_EVENT
KTOD_DISABLE_DISP_UPD_SEC_EVENT
KSTP_ENABLE_DISP_UPD_EVENT
KSTP_DISABLE_DISP_UPD_EVENT
KTMR_ENABLE_DISP_UPD_EVENT
KTMR_DISABLE_DISP_UPD_EVENT
KSYN_ENABLE_DISP_UPD_EVENT
KSYN_DISABLE_DISP_UPD_EVENT
4.4.5.8 Timeouts
Application must request application timeouts for the system to generate the timeout done events. The
events are passed when the timeout counters decrements to zero.
CORE_REQ_TIMEOUT_HIRES <timeout_count_hires>;
CORE_REQ_TIMEOUT_LORES <timeout_count_lores>;