Implementation of predefined keyboard related layouts management. More...

#include <string.h>
#include <stdlib.h>
#include <stdio.h>
#include "nbgl_debug.h"
#include "nbgl_front.h"
#include "nbgl_layout_internal.h"
#include "nbgl_obj.h"
#include "nbgl_draw.h"
#include "nbgl_screen.h"
#include "nbgl_touch.h"
#include "glyphs.h"
#include "os_io_seph_cmd.h"
#include "os_io_seph_ux.h"
#include "os_pic.h"
#include "os_helpers.h"

Include dependency graph for nbgl_layout_keyboard.c:

Go to the source code of this file.

Macros
#define	SUGGESTION_BUTTONS_SIDE_MARGIN BORDER_MARGIN

#define	LINE_THICKNESS 2

#define	LINE_COLOR LIGHT_GRAY

Enumerations
enum	{ PAGE_INDICATOR_INDEX = 0 , FIRST_BUTTON_INDEX , SECOND_BUTTON_INDEX , THIRD_BUTTON_INDEX , FOURTH_BUTTON_INDEX , NB_SUGGESTION_CHILDREN }

enum	{ NUMBER_INDEX = 0 , TEXT_INDEX , DELETE_INDEX , LINE_INDEX }

Functions
bool	keyboardSwipeCallback (nbgl_obj_t *obj, nbgl_touchType_t eventType)

int	nbgl_layoutAddKeyboard (nbgl_layout_t layout, const nbgl_layoutKbd_t kbdInfo)
	Creates a keyboard on bottom of the screen, with the given configuration.

int	nbgl_layoutUpdateKeyboard (nbgl_layout_t *layout, uint8_t index, uint32_t keyMask, bool updateCasing, keyboardCase_t casing)
	Updates an existing keyboard on bottom of the screen, with the given configuration.

bool	nbgl_layoutKeyboardNeedsRefresh (nbgl_layout_t *layout, uint8_t index)
	function called to know whether the keyboard has been redrawn and needs a refresh

int	nbgl_layoutAddEnteredText (nbgl_layout_t layout, bool numbered, uint8_t number, const char text, bool grayedOut, int offsetY, int token)
	Adds a "text entry" area under the previously entered object. This area can be preceded (beginning of line) by an index, indicating for example the entered world. A vertical gray line is placed under the text. This text must be vertical placed in the screen with offsetY.

int	nbgl_layoutUpdateEnteredText (nbgl_layout_t layout, uint8_t index, bool numbered, uint8_t number, const char text, bool grayedOut)
	Updates an existing "text entry" area, created with nbgl_layoutAddEnteredText()

int	nbgl_layoutAddConfirmationButton (nbgl_layout_t layout, bool active, const char text, int token, tune_index_e tuneId)
	Adds a black full width confirmation button on top of the previously added keyboard.

int	nbgl_layoutUpdateConfirmationButton (nbgl_layout_t layout, uint8_t index, bool active, const char text)
	Updates an existing black full width confirmation button on top of the previously added keyboard.

int	nbgl_layoutAddKeyboardContent (nbgl_layout_t layout, nbgl_layoutKeyboardContent_t content)
	Adds an area containing a potential title, a text entry and either confirmation or suggestion buttons, on top of the keyboard.

int	nbgl_layoutUpdateKeyboardContent (nbgl_layout_t layout, nbgl_layoutKeyboardContent_t content)
	Updates an area containing a potential title, a text entry and either confirmation or suggestion buttons, on top of the keyboard This area must have been built with nbgl_layoutAddKeyboardContent, and the type must not change.

Detailed Description

Implementation of predefined keyboard related layouts management.

Note: This file applies only to wallet size products (Stax, Flex...)

Definition in file nbgl_layout_keyboard.c.

Macro Definition Documentation

◆ LINE_COLOR

#define LINE_COLOR LIGHT_GRAY

Definition at line 123 of file nbgl_layout_keyboard.c.

◆ LINE_THICKNESS

#define LINE_THICKNESS 2

Definition at line 122 of file nbgl_layout_keyboard.c.

◆ SUGGESTION_BUTTONS_SIDE_MARGIN

#define SUGGESTION_BUTTONS_SIDE_MARGIN BORDER_MARGIN

Definition at line 117 of file nbgl_layout_keyboard.c.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

Enumerator
PAGE_INDICATOR_INDEX
FIRST_BUTTON_INDEX
SECOND_BUTTON_INDEX
THIRD_BUTTON_INDEX
FOURTH_BUTTON_INDEX
NB_SUGGESTION_CHILDREN

Definition at line 36 of file nbgl_layout_keyboard.c.

◆ anonymous enum

anonymous enum

Enumerator
NUMBER_INDEX
TEXT_INDEX
DELETE_INDEX
LINE_INDEX

Definition at line 52 of file nbgl_layout_keyboard.c.

Function Documentation

◆ keyboardSwipeCallback()

bool keyboardSwipeCallback	(	nbgl_obj_t *	obj,
		nbgl_touchType_t	eventType
	)

Definition at line 254 of file nbgl_layout_keyboard.c.

◆ nbgl_layoutAddConfirmationButton()

int nbgl_layoutAddConfirmationButton	(	nbgl_layout_t *	layout,
		bool	active,
		const char *	text,
		int	token,
		tune_index_e	tuneId
	)

Adds a black full width confirmation button on top of the previously added keyboard.

Deprecated:: Use nbgl_layoutAddKeyboardContent instead

Parameters

layout	the current layout
active	if true, button is active, otherwise inactive (grayed-out)
text	text of the button
token	token of the button, used in onActionCallback
tuneId	tune to play when button is pressed

Returns: >= 0 if OK

Definition at line 813 of file nbgl_layout_keyboard.c.

◆ nbgl_layoutAddEnteredText()

int nbgl_layoutAddEnteredText	(	nbgl_layout_t *	layout,
		bool	numbered,
		uint8_t	number,
		const char *	text,
		bool	grayedOut,
		int	offsetY,
		int	token
	)

Adds a "text entry" area under the previously entered object. This area can be preceded (beginning of line) by an index, indicating for example the entered world. A vertical gray line is placed under the text. This text must be vertical placed in the screen with offsetY.

Deprecated:: Use nbgl_layoutAddKeyboardContent instead

Note: This area is touchable

Parameters

layout	the current layout
numbered	if true, the "number" param is used as index
number	index of the text
text	string to display in the area
grayedOut	if true, the text is grayed out (unused)
offsetY	vertical offset from the top of the page
token	token provided in onActionCallback when the "cross" is touched

Returns: >= 0 if OK

Definition at line 687 of file nbgl_layout_keyboard.c.

◆ nbgl_layoutAddKeyboard()

int nbgl_layoutAddKeyboard	(	nbgl_layout_t *	layout,
		const nbgl_layoutKbd_t *	kbdInfo
	)

Creates a keyboard on bottom of the screen, with the given configuration.

Parameters

layout	the current layout
kbdInfo	configuration of the keyboard to draw (including the callback when touched)

Returns: the index of keyboard, to use in nbgl_layoutUpdateKeyboard()

Definition at line 540 of file nbgl_layout_keyboard.c.

◆ nbgl_layoutAddKeyboardContent()

int nbgl_layoutAddKeyboardContent	(	nbgl_layout_t *	layout,
		nbgl_layoutKeyboardContent_t *	content
	)

Adds an area containing a potential title, a text entry and either confirmation or suggestion buttons, on top of the keyboard.

Parameters

layout	the current layout
content	structure containing the info

Returns: the height of the area if OK

Definition at line 899 of file nbgl_layout_keyboard.c.

◆ nbgl_layoutKeyboardNeedsRefresh()

bool nbgl_layoutKeyboardNeedsRefresh	(	nbgl_layout_t *	layout,
		uint8_t	index
	)

function called to know whether the keyboard has been redrawn and needs a refresh

Parameters

layout	the current layout
index	index returned by nbgl_layoutAddKeyboard() (unused)

Returns: true if keyboard needs a refresh

Definition at line 646 of file nbgl_layout_keyboard.c.

◆ nbgl_layoutUpdateConfirmationButton()

int nbgl_layoutUpdateConfirmationButton	(	nbgl_layout_t *	layout,
		uint8_t	index,
		bool	active,
		const char *	text
	)

Updates an existing black full width confirmation button on top of the previously added keyboard.

Deprecated:: Use nbgl_layoutUpdateKeyboardContent instead

Parameters

layout	the current layout
index	returned value of nbgl_layoutAddConfirmationButton()
active	if true, button is active
text	text of the button = *

Returns: >= 0 if OK

Definition at line 854 of file nbgl_layout_keyboard.c.

◆ nbgl_layoutUpdateEnteredText()

int nbgl_layoutUpdateEnteredText	(	nbgl_layout_t *	layout,
		uint8_t	index,
		bool	numbered,
		uint8_t	number,
		const char *	text,
		bool	grayedOut
	)

Updates an existing "text entry" area, created with nbgl_layoutAddEnteredText()

Deprecated:: Use nbgl_layoutUpdateKeyboardContent instead

Parameters

layout	the current layout
index	index of the text (return value of nbgl_layoutAddEnteredText())
numbered	if set to true, the text is preceded on the left by 'number.'
number	if numbered is true, number used to build 'number.' text
text	string to display in the area
grayedOut	if true, the text is grayed out (but not the potential number)

Returns: <0 if error, 0 if OK with text fitting the area, 1 of 0K with text not fitting the area

Definition at line 755 of file nbgl_layout_keyboard.c.

◆ nbgl_layoutUpdateKeyboard()

int nbgl_layoutUpdateKeyboard	(	nbgl_layout_t *	layout,
		uint8_t	index,
		uint32_t	keyMask,
		bool	updateCasing,
		keyboardCase_t	casing
	)

Updates an existing keyboard on bottom of the screen, with the given configuration.

Parameters

layout	the current layout
index	index returned by nbgl_layoutAddKeyboard() (unused)
keyMask	mask of keys to activate/deactivate on keyboard
updateCasing	if true, update keyboard casing with given value
casing	casing to use

Returns: >=0 if OK

Definition at line 609 of file nbgl_layout_keyboard.c.

◆ nbgl_layoutUpdateKeyboardContent()

int nbgl_layoutUpdateKeyboardContent	(	nbgl_layout_t *	layout,
		nbgl_layoutKeyboardContent_t *	content
	)

Updates an area containing a potential title, a text entry and either confirmation or suggestion buttons, on top of the keyboard This area must have been built with nbgl_layoutAddKeyboardContent, and the type must not change.

Parameters

layout	the current layout
content	structure containing the updated info

Returns: the height of the area if OK

Definition at line 970 of file nbgl_layout_keyboard.c.

Macros

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ LINE_COLOR

◆ LINE_THICKNESS

◆ SUGGESTION_BUTTONS_SIDE_MARGIN

Enumeration Type Documentation

◆ anonymous enum

◆ anonymous enum

Function Documentation

◆ keyboardSwipeCallback()

◆ nbgl_layoutAddConfirmationButton()

◆ nbgl_layoutAddEnteredText()

◆ nbgl_layoutAddKeyboard()

◆ nbgl_layoutAddKeyboardContent()

◆ nbgl_layoutKeyboardNeedsRefresh()

◆ nbgl_layoutUpdateConfirmationButton()

◆ nbgl_layoutUpdateEnteredText()

◆ nbgl_layoutUpdateKeyboard()

◆ nbgl_layoutUpdateKeyboardContent()