Bluetooth® Sample Application Programmer's Reference: UI Main

Starts all user interface peripherals in the terminal ready for used by the application. This includes the keyboard, the display and the touch screen peripherals.

Returns

• ERR_UI_DISPLAY_PERIPH_DISPLAY_NOT_OPEN = The display peripheral cannot be openned.
• ERR_UI_DISPLAY_PERIPH_KEYBOARD_NOT_OPEN = The keyboard peripheral cannot be openned.
• ERR_UI_DISPLAY_PERIPH_TFT_NOT_OPEN = The touch screen peripheral cannot be openned.

Stops all user interface peripherals in the terminal. It gives up all handles acquired by the terminal with the display and touch screen and the keyboard.

Returns

• ERR_UI_DISPLAY_PERIPH_DISPLAY_NOT_CLOSE = The display peripheral cannot be closed.
• ERR_UI_DISPLAY_PERIPH_KEYBOARD_NOT_CLOSE = The keyboard peripheral cannot be closed.
• ERR_UI_DISPLAY_PERIPH_TFT_NOT_CLOSE = The touch screen peripheral cannot be closed.

Displays the menu of the sample application.

Toggles the idle display's header/footer. It makes sure that the header and footer are turned off. It will restore the original state of the header/footer display when called the second time.

Displays an error message.

Precondition

The given error code should have been defined first. Only those defined in err.h.

Parameters

errID

The error code defined in err.h. See Error Identifiers

Returns

None

Displays a prompt message.

Parameters

[in]

promptID

The identifier of the prompt to be displayed.

Note

When the specified prompt ID does not exist, the function will display a default prompt message indicating an undefined prompt.

100 milliseconds timeout delay used for GUI dialogs

3-second timeout delay used for GUI dialogs

5-second timeout delay used for GUI dialogs

Indices to the predefined screen prompt list of the application. This indices must be used when calling UI_PromptMsgDisplay(). Note that whatever is defined here should also be defined in the prompt list.