nbgl_use_case_nanos.c

Go to the documentation of this file.

 
#ifdef NBGL_USE_CASE
#ifndef HAVE_SE_TOUCH
/*********************
 *      INCLUDES
 *********************/
#include <string.h>
#include <stdio.h>
#include "nbgl_debug.h"
#include "nbgl_use_case.h"
#include "glyphs.h"
#include "os_pic.h"
#include "os_helpers.h"
#include "ux.h"
 
/*********************
 *      DEFINES
 *********************/
#define WITH_HORIZONTAL_CHOICES_LIST
#define WITH_HORIZONTAL_BARS_LIST
 
#define RISKY_OPERATION (1 << 6)
 
#define NO_THREAT_OPERATION (1 << 7)
 
/**********************
 *      TYPEDEFS
 **********************/
 
typedef struct ReviewContext_s {
    nbgl_choiceCallback_t             onChoice;
    const nbgl_contentTagValueList_t *tagValueList;
    const nbgl_icon_details_t        *icon;
    const char                       *reviewTitle;
    const char                       *reviewSubTitle;
    const char                       *finishTitle;
    const char                       *address;       // for address confirmation review
    nbgl_callback_t                   skipCallback;  // callback provided by used
    uint8_t nbDataSets;     // number of sets of data received by StreamingContinue
    bool    skipDisplay;    // if set to true, means that we are displaying the skip page
    uint8_t dataDirection;  // used to know whether the skip page is reached from back or forward
    uint8_t currentTagValueIndex;
    uint8_t currentExtensionPage;
    uint8_t nbExtensionPages;
    const nbgl_contentValueExt_t *extension;
    nbgl_step_t                   extensionStepCtx;
 
} ReviewContext_t;
 
typedef struct ChoiceContext_s {
    const nbgl_icon_details_t   *icon;
    const char                  *message;
    const char                  *subMessage;
    const char                  *confirmText;
    const char                  *cancelText;
    nbgl_choiceCallback_t        onChoice;
    const nbgl_genericDetails_t *details;
} ChoiceContext_t;
 
typedef struct ConfirmContext_s {
    const char     *message;
    const char     *subMessage;
    const char     *confirmText;
    const char     *cancelText;
    nbgl_callback_t onConfirm;
    nbgl_step_t     currentStep;
} ConfirmContext_t;
 
typedef struct ContentContext_s {
    const char                *title;  // For CHOICES_LIST /BARS_LIST
    nbgl_genericContents_t     genericContents;
    const char                *rejectText;
    nbgl_layoutTouchCallback_t controlsCallback;
    nbgl_navCallback_t         navCallback;
    nbgl_callback_t            quitCallback;
} ContentContext_t;
 
typedef struct HomeContext_s {
    const char                   *appName;
    const nbgl_icon_details_t    *appIcon;
    const char                   *tagline;
    const nbgl_genericContents_t *settingContents;
    const nbgl_contentInfoList_t *infosList;
    const nbgl_homeAction_t      *homeAction;
    nbgl_callback_t               quitCallback;
} HomeContext_t;
 
typedef struct ActionContext_s {
    nbgl_callback_t actionCallback;
} ActionContext_t;
 
#ifdef NBGL_KEYPAD
typedef struct KeypadContext_s {
    uint8_t                 pinEntry[8];
    uint8_t                 pinLen;
    uint8_t                 pinMinDigits;
    uint8_t                 pinMaxDigits;
    nbgl_layout_t          *layoutCtx;
    bool                    hidden;
    uint8_t                 keypadIndex;
    nbgl_pinValidCallback_t validatePin;
    nbgl_callback_t         backCallback;
} KeypadContext_t;
#endif
 
typedef enum {
    NONE_USE_CASE,
    SPINNER_USE_CASE,
    REVIEW_USE_CASE,
    GENERIC_REVIEW_USE_CASE,
    ADDRESS_REVIEW_USE_CASE,
    STREAMING_START_REVIEW_USE_CASE,
    STREAMING_CONTINUE_REVIEW_USE_CASE,
    STREAMING_FINISH_REVIEW_USE_CASE,
    CHOICE_USE_CASE,
    STATUS_USE_CASE,
    CONFIRM_USE_CASE,
    KEYPAD_USE_CASE,
    HOME_USE_CASE,
    INFO_USE_CASE,
    SETTINGS_USE_CASE,
    GENERIC_SETTINGS,
    CONTENT_USE_CASE,
    ACTION_USE_CASE
} ContextType_t;
 
typedef struct UseCaseContext_s {
    ContextType_t        type;
    nbgl_operationType_t operationType;
    uint8_t              nbPages;
    int8_t               currentPage;
    int8_t               firstPairPage;
    nbgl_stepCallback_t
        stepCallback;  
    union {
        ReviewContext_t  review;
        ChoiceContext_t  choice;
        ConfirmContext_t confirm;
        HomeContext_t    home;
        ContentContext_t content;
#ifdef NBGL_KEYPAD
        KeypadContext_t keypad;
#endif
        ActionContext_t action;
    };
} UseCaseContext_t;
 
typedef struct PageContent_s {
    bool                          isSwitch;
    const char                   *text;
    const char                   *subText;
    const nbgl_icon_details_t    *icon;
    const nbgl_contentValueExt_t *extension;
    nbgl_state_t                  state;
    bool                          isCenteredInfo;
} PageContent_t;
 
typedef struct ReviewWithWarningContext_s {
    ContextType_t                     type;
    nbgl_operationType_t              operationType;
    const nbgl_contentTagValueList_t *tagValueList;
    const nbgl_icon_details_t        *icon;
    const char                       *reviewTitle;
    const char                       *reviewSubTitle;
    const char                       *finishTitle;
    const nbgl_warning_t             *warning;
    nbgl_choiceCallback_t             choiceCallback;
    uint8_t                           securityReportLevel;  // level 1 is the first level of menus
    bool                              isIntro;  // set to true during intro (before actual review)
    uint8_t                           warningPage;
    uint8_t                           nbWarningPages;
} ReviewWithWarningContext_t;
 
typedef enum {
    NO_FORCED_TYPE = 0,
    FORCE_BUTTON,
    FORCE_CENTERED_INFO
} ForcedType_t;
 
/**********************
 *  STATIC VARIABLES
 **********************/
static UseCaseContext_t context;
 
static ReviewWithWarningContext_t reviewWithWarnCtx;
// configuration of warning when using @ref nbgl_useCaseReviewBlindSigning()
static const nbgl_warning_t blindSigningWarning = {.predefinedSet = (1 << BLIND_SIGNING_WARN)};
 
// Operation type for streaming (because the one in 'context' is reset at each streaming API call)
nbgl_operationType_t streamingOpType;
 
/**********************
 *  STATIC FUNCTIONS
 **********************/
static void displayReviewPage(nbgl_stepPosition_t pos);
static void displayStreamingReviewPage(nbgl_stepPosition_t pos);
static void displayHomePage(nbgl_stepPosition_t pos);
static void displayInfoPage(nbgl_stepPosition_t pos);
static void displaySettingsPage(nbgl_stepPosition_t pos, bool toogle_state);
static void displayChoicePage(nbgl_stepPosition_t pos);
static void displayConfirm(nbgl_stepPosition_t pos);
static void displayContent(nbgl_stepPosition_t pos, bool toogle_state);
static void displaySpinner(const char *text);
 
static void startUseCaseHome(void);
static void startUseCaseInfo(void);
static void startUseCaseSettings(void);
static void startUseCaseSettingsAtPage(uint8_t initSettingPage);
static void startUseCaseContent(void);
 
static void statusTickerCallback(void);
 
static void displayExtensionStep(nbgl_stepPosition_t pos);
static void displayWarningStep(void);
 
// Simple helper to get the number of elements inside a nbgl_content_t
static uint8_t getContentNbElement(const nbgl_content_t *content)
{
    switch (content->type) {
        case CENTERED_INFO:
            return 1;
        case INFO_BUTTON:
            return 1;
        case TAG_VALUE_LIST:
            return content->content.tagValueList.nbPairs;
        case SWITCHES_LIST:
            return content->content.switchesList.nbSwitches;
        case INFOS_LIST:
            return content->content.infosList.nbInfos;
        case CHOICES_LIST:
            return content->content.choicesList.nbChoices;
        case BARS_LIST:
            return content->content.barsList.nbBars;
        default:
            return 0;
    }
}
 
// Helper to retrieve the content inside a nbgl_genericContents_t using
// either the contentsList or using the contentGetterCallback
static const nbgl_content_t *getContentAtIdx(const nbgl_genericContents_t *genericContents,
                                             int8_t                        contentIdx,
                                             nbgl_content_t               *content)
{
    nbgl_pageContent_t pageContent = {0};
    if (contentIdx < 0 || contentIdx >= genericContents->nbContents) {
        LOG_DEBUG(USE_CASE_LOGGER, "No content available at %d\n", contentIdx);
        return NULL;
    }
 
    if (genericContents->callbackCallNeeded) {
        if (content == NULL) {
            LOG_DEBUG(USE_CASE_LOGGER, "Invalid content variable\n");
            return NULL;
        }
        // Retrieve content through callback, but first memset the content.
        memset(content, 0, sizeof(nbgl_content_t));
        if (context.content.navCallback) {
            if (context.content.navCallback(contentIdx, &pageContent) == true) {
                // Copy the Page Content to the Content variable
                content->type = pageContent.type;
                switch (content->type) {
                    case CENTERED_INFO:
                        content->content.centeredInfo = pageContent.centeredInfo;
                        break;
                    case INFO_BUTTON:
                        content->content.infoButton = pageContent.infoButton;
                        break;
                    case TAG_VALUE_LIST:
                        content->content.tagValueList = pageContent.tagValueList;
                        break;
                    case SWITCHES_LIST:
                        content->content.switchesList = pageContent.switchesList;
                        break;
                    case INFOS_LIST:
                        content->content.infosList = pageContent.infosList;
                        break;
                    case CHOICES_LIST:
                        content->content.choicesList = pageContent.choicesList;
                        break;
                    case BARS_LIST:
                        content->content.barsList = pageContent.barsList;
                        break;
                    default:
                        LOG_DEBUG(USE_CASE_LOGGER, "Invalid content type\n");
                        return NULL;
                }
            }
            else {
                LOG_DEBUG(USE_CASE_LOGGER, "Error getting page content\n");
                return NULL;
            }
        }
        else {
            genericContents->contentGetterCallback(contentIdx, content);
        }
        return content;
    }
    else {
        // Retrieve content through list
        return PIC(&genericContents->contentsList[contentIdx]);
    }
}
 
// Helper to retrieve the content inside a nbgl_genericContents_t using
// either the contentsList or using the contentGetterCallback
static const nbgl_content_t *getContentElemAtIdx(uint8_t         elemIdx,
                                                 uint8_t        *elemContentIdx,
                                                 nbgl_content_t *content)
{
    const nbgl_genericContents_t *genericContents = NULL;
    const nbgl_content_t         *p_content       = NULL;
    uint8_t                       nbPages         = 0;
    uint8_t                       elemNbPages     = 0;
 
    switch (context.type) {
        case SETTINGS_USE_CASE:
        case HOME_USE_CASE:
        case GENERIC_SETTINGS:
            genericContents = context.home.settingContents;
            break;
        case CONTENT_USE_CASE:
        case GENERIC_REVIEW_USE_CASE:
            genericContents = &context.content.genericContents;
            break;
        default:
            return NULL;
    }
    for (int i = 0; i < genericContents->nbContents; i++) {
        p_content   = getContentAtIdx(genericContents, i, content);
        elemNbPages = getContentNbElement(p_content);
        if (nbPages + elemNbPages > elemIdx) {
            *elemContentIdx = context.currentPage - nbPages;
            break;
        }
        nbPages += elemNbPages;
    }
 
    return p_content;
}
 
static const char *getChoiceName(uint8_t choiceIndex)
{
    uint8_t                    elemIdx;
    uint8_t                    nbValues;
    const nbgl_content_t      *p_content      = NULL;
    nbgl_content_t             content        = {0};
    nbgl_contentRadioChoice_t *contentChoices = NULL;
    nbgl_contentBarsList_t    *contentBars    = NULL;
    char                     **names          = NULL;
 
    p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
    if (p_content == NULL) {
        return NULL;
    }
    switch (p_content->type) {
        case CHOICES_LIST:
            contentChoices = (nbgl_contentRadioChoice_t *) PIC(&p_content->content.choicesList);
            names          = (char **) PIC(contentChoices->names);
            nbValues       = contentChoices->nbChoices;
            break;
        case BARS_LIST:
            contentBars = ((nbgl_contentBarsList_t *) PIC(&p_content->content.barsList));
            names       = (char **) PIC(contentBars->barTexts);
            nbValues    = contentBars->nbBars;
            break;
        default:
            // Not supported as vertical MenuList
            return NULL;
    }
    if (choiceIndex >= nbValues) {
        // Last item is always "Back" button
        return "Back";
    }
    return (const char *) PIC(names[choiceIndex]);
}
 
static void onChoiceSelected(uint8_t choiceIndex)
{
    uint8_t                    elemIdx;
    uint8_t                    token          = 255;
    const nbgl_content_t      *p_content      = NULL;
    nbgl_content_t             content        = {0};
    nbgl_contentRadioChoice_t *contentChoices = NULL;
    nbgl_contentBarsList_t    *contentBars    = NULL;
 
    p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
    if (p_content == NULL) {
        return;
    }
    switch (p_content->type) {
        case CHOICES_LIST:
            contentChoices = (nbgl_contentRadioChoice_t *) PIC(&p_content->content.choicesList);
            if (choiceIndex < contentChoices->nbChoices) {
                token = contentChoices->token;
            }
            break;
        case BARS_LIST:
            contentBars = ((nbgl_contentBarsList_t *) PIC(&p_content->content.barsList));
            if (choiceIndex < contentBars->nbBars) {
                token = contentBars->tokens[choiceIndex];
            }
            break;
        default:
            // Not supported as vertical MenuList
            break;
    }
    if ((token != 255) && (context.content.controlsCallback != NULL)) {
        context.content.controlsCallback(token, 0);
    }
    else if (context.content.quitCallback != NULL) {
        context.content.quitCallback();
    }
}
 
static void getPairData(const nbgl_contentTagValueList_t *tagValueList,
                        uint8_t                           index,
                        const char                      **item,
                        const char                      **value,
                        const nbgl_contentValueExt_t    **extension,
                        const nbgl_icon_details_t       **icon,
                        bool                             *isCenteredInfo)
{
    const nbgl_contentTagValue_t *pair;
 
    if (tagValueList->pairs != NULL) {
        pair = PIC(&tagValueList->pairs[index]);
    }
    else {
        pair = PIC(tagValueList->callback(index));
    }
    *item  = pair->item;
    *value = pair->value;
    if (pair->aliasValue) {
        *extension = pair->extension;
    }
    else if (pair->centeredInfo) {
        *isCenteredInfo = true;
        *icon           = pair->valueIcon;
    }
    else {
        *extension = NULL;
    }
}
 
static void onReviewAccept(void)
{
    if (context.review.onChoice) {
        context.review.onChoice(true);
    }
}
 
static void onReviewReject(void)
{
    if (context.review.onChoice) {
        context.review.onChoice(false);
    }
}
 
static void onChoiceAccept(void)
{
    if (context.choice.onChoice) {
        context.choice.onChoice(true);
    }
}
 
static void onChoiceReject(void)
{
    if (context.choice.onChoice) {
        context.choice.onChoice(false);
    }
}
 
static void onConfirmAccept(void)
{
    if (context.confirm.currentStep) {
        nbgl_stepRelease(context.confirm.currentStep);
    }
    if (context.confirm.onConfirm) {
        context.confirm.onConfirm();
    }
}
 
static void onConfirmReject(void)
{
    if (context.confirm.currentStep) {
        nbgl_stepRelease(context.confirm.currentStep);
        nbgl_screenRedraw();
        nbgl_refresh();
    }
}
 
static void onSwitchAction(void)
{
    const nbgl_contentSwitch_t *contentSwitch = NULL;
    const nbgl_content_t       *p_content     = NULL;
    nbgl_content_t              content       = {0};
    uint8_t                     elemIdx;
 
    p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
    if ((p_content == NULL) || (p_content->type != SWITCHES_LIST)) {
        return;
    }
    contentSwitch
        = &((const nbgl_contentSwitch_t *) PIC(p_content->content.switchesList.switches))[elemIdx];
    switch (context.type) {
        case SETTINGS_USE_CASE:
        case HOME_USE_CASE:
        case GENERIC_SETTINGS:
            displaySettingsPage(FORWARD_DIRECTION, true);
            break;
        case CONTENT_USE_CASE:
        case GENERIC_REVIEW_USE_CASE:
            displayContent(FORWARD_DIRECTION, true);
            break;
        default:
            break;
    }
    if (p_content->contentActionCallback != NULL) {
        nbgl_contentActionCallback_t actionCallback = PIC(p_content->contentActionCallback);
        actionCallback(contentSwitch->token,
                       (contentSwitch->initState == ON_STATE) ? OFF_STATE : ON_STATE,
                       context.currentPage);
    }
    else if (context.content.controlsCallback != NULL) {
        context.content.controlsCallback(contentSwitch->token, 0);
    }
}
 
static void drawStep(nbgl_stepPosition_t        pos,
                     const nbgl_icon_details_t *icon,
                     const char                *txt,
                     const char                *subTxt,
                     nbgl_stepButtonCallback_t  onActionCallback,
                     bool                       modal,
                     ForcedType_t               forcedType)
{
    uint8_t                           elemIdx;
    nbgl_step_t                       newStep        = NULL;
    const nbgl_content_t             *p_content      = NULL;
    nbgl_content_t                    content        = {0};
    nbgl_contentRadioChoice_t        *contentChoices = NULL;
    nbgl_contentBarsList_t           *contentBars    = NULL;
    nbgl_screenTickerConfiguration_t *p_ticker       = NULL;
    nbgl_layoutMenuList_t             list           = {0};
    nbgl_screenTickerConfiguration_t  ticker         = {.tickerCallback  = PIC(statusTickerCallback),
                                                        .tickerIntervale = 0,  // not periodic
                                                        .tickerValue     = STATUS_SCREEN_DURATION};
 
    pos |= GET_POS_OF_STEP(context.currentPage, context.nbPages);
    // if we are in streaming+skip case, enable going backward even for first tag/value of the set
    // (except the first set) because the set starts with a "skip" page
    if ((context.type == STREAMING_CONTINUE_REVIEW_USE_CASE)
        && (context.review.skipCallback != NULL) && (context.review.nbDataSets > 1)) {
        pos |= LAST_STEP;
    }
    if ((context.type == STATUS_USE_CASE) || (context.type == SPINNER_USE_CASE)) {
        p_ticker = &ticker;
    }
    if ((context.type == CONFIRM_USE_CASE) && (context.confirm.currentStep != NULL)) {
        nbgl_stepRelease(context.confirm.currentStep);
    }
 
    if (txt == NULL) {
        p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
        if (p_content) {
            switch (p_content->type) {
                case CHOICES_LIST:
                    contentChoices
                        = ((nbgl_contentRadioChoice_t *) PIC(&p_content->content.choicesList));
                    list.nbChoices      = contentChoices->nbChoices + 1;  // For Back button
                    list.selectedChoice = contentChoices->initChoice;
                    list.callback       = getChoiceName;
                    newStep = nbgl_stepDrawMenuList(onChoiceSelected, p_ticker, &list, modal);
                    break;
                case BARS_LIST:
                    contentBars    = ((nbgl_contentBarsList_t *) PIC(&p_content->content.barsList));
                    list.nbChoices = contentBars->nbBars + 1;  // For Back button
                    list.selectedChoice = 0;
                    list.callback       = getChoiceName;
                    newStep = nbgl_stepDrawMenuList(onChoiceSelected, p_ticker, &list, modal);
                    break;
                default:
                    // Not supported as vertical MenuList
                    break;
            }
        }
    }
    else if ((icon == NULL) && (forcedType != FORCE_CENTERED_INFO)) {
        nbgl_contentCenteredInfoStyle_t style;
        if (subTxt != NULL) {
            style = (forcedType == FORCE_BUTTON) ? BUTTON_INFO : BOLD_TEXT1_INFO;
        }
        else {
            style = REGULAR_INFO;
        }
        newStep = nbgl_stepDrawText(pos, onActionCallback, p_ticker, txt, subTxt, style, modal);
    }
    else {
        nbgl_layoutCenteredInfo_t info;
        info.icon  = icon;
        info.text1 = txt;
        info.text2 = subTxt;
        info.onTop = false;
        if ((subTxt != NULL) || (context.stepCallback != NULL)) {
            info.style = BOLD_TEXT1_INFO;
        }
        else {
            info.style = REGULAR_INFO;
        }
        newStep = nbgl_stepDrawCenteredInfo(pos, onActionCallback, p_ticker, &info, modal);
    }
    if (context.type == CONFIRM_USE_CASE) {
        context.confirm.currentStep = newStep;
    }
}
 
static void drawSwitchStep(nbgl_stepPosition_t       pos,
                           const char               *title,
                           const char               *description,
                           bool                      state,
                           nbgl_stepButtonCallback_t onActionCallback,
                           bool                      modal)
{
    nbgl_layoutSwitch_t switchInfo;
 
    pos |= GET_POS_OF_STEP(context.currentPage, context.nbPages);
    switchInfo.initState = state;
    switchInfo.text      = title;
    switchInfo.subText   = description;
    nbgl_stepDrawSwitch(pos, onActionCallback, NULL, &switchInfo, modal);
}
 
static bool buttonGenericCallback(nbgl_buttonEvent_t event, nbgl_stepPosition_t *pos)
{
    uint8_t               elemIdx;
    uint8_t               token     = 0;
    uint8_t               index     = 0;
    const nbgl_content_t *p_content = NULL;
    nbgl_content_t        content   = {0};
 
    if (event == BUTTON_LEFT_PRESSED) {
        if (context.currentPage > 0) {
            context.currentPage--;
        }
        // in streaming+skip case, it is allowed to go backward at the first tag/value, except for
        // the first set
        else if ((context.type != STREAMING_CONTINUE_REVIEW_USE_CASE)
                 || (context.review.skipCallback == NULL) || (context.review.nbDataSets == 1)) {
            // Drop the event
            return false;
        }
        *pos = BACKWARD_DIRECTION;
    }
    else if (event == BUTTON_RIGHT_PRESSED) {
        if (context.currentPage < (int) (context.nbPages - 1)) {
            context.currentPage++;
        }
        else {
            // Drop the event
            return false;
        }
        *pos = FORWARD_DIRECTION;
    }
    else {
        if (event == BUTTON_BOTH_PRESSED) {
            if (context.stepCallback != NULL) {
                context.stepCallback();
            }
            else if ((context.type == CONTENT_USE_CASE) || (context.type == SETTINGS_USE_CASE)
                     || (context.type == GENERIC_SETTINGS)
                     || (context.type == GENERIC_REVIEW_USE_CASE)) {
                p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
                if (p_content != NULL) {
                    switch (p_content->type) {
                        case CENTERED_INFO:
                            // No associated callback
                            return false;
                        case INFO_BUTTON:
                            token = p_content->content.infoButton.buttonToken;
                            break;
                        case SWITCHES_LIST:
                            token = p_content->content.switchesList.switches->token;
                            break;
                        case BARS_LIST:
                            token = p_content->content.barsList.tokens[context.currentPage];
                            break;
                        case CHOICES_LIST:
                            token = p_content->content.choicesList.token;
                            index = context.currentPage;
                            break;
                        default:
                            break;
                    }
 
                    if ((p_content) && (p_content->contentActionCallback != NULL)) {
                        p_content->contentActionCallback(token, 0, context.currentPage);
                    }
                    else if (context.content.controlsCallback != NULL) {
                        context.content.controlsCallback(token, index);
                    }
                }
            }
        }
        return false;
    }
    return true;
}
 
static void reviewCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
    else {
        // memorize last direction
        context.review.dataDirection = pos;
    }
    displayReviewPage(pos);
}
 
// this is the callback used when button action on the "skip" page
static void buttonSkipCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (event == BUTTON_LEFT_PRESSED) {
        // only decrement page if we are going backward but coming from forward (back & forth)
        if ((context.review.dataDirection == FORWARD_DIRECTION)
            && (context.currentPage > context.firstPairPage)) {
            context.currentPage--;
        }
        pos = BACKWARD_DIRECTION;
    }
    else if (event == BUTTON_RIGHT_PRESSED) {
        // only increment page if we are going forward but coming from backward (back & forth)
        if ((context.review.dataDirection == BACKWARD_DIRECTION)
            && (context.currentPage < (int) (context.nbPages - 1))
            && (context.currentPage > context.firstPairPage)) {
            context.currentPage++;
        }
        pos = FORWARD_DIRECTION;
    }
    else if (event == BUTTON_BOTH_PRESSED) {
        // the first tag/value page is at page 0 only in streaming case
        if (context.firstPairPage == 0) {
            // in streaming, we have to call the provided callback
            context.review.skipCallback();
        }
        else {
            // if not in streaming, go directly to the "approve" page
            context.currentPage = context.nbPages - 2;
            displayReviewPage(FORWARD_DIRECTION);
        }
        return;
    }
    else {
        return;
    }
    // the first tag/value page is at page 0 only in streaming case
    if (context.firstPairPage == 0) {
        displayStreamingReviewPage(pos);
    }
    else {
        displayReviewPage(pos);
    }
}
 
// this is the callback used when buttons in "Action" use case are pressed
static void useCaseActionCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
 
    if (event == BUTTON_BOTH_PRESSED) {
        context.action.actionCallback();
    }
}
 
static void streamingReviewCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    nbgl_stepPosition_t pos;
    UNUSED(stepCtx);
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
    else {
        // memorize last direction
        context.review.dataDirection = pos;
    }
 
    displayStreamingReviewPage(pos);
}
 
static void settingsCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displaySettingsPage(pos, false);
}
 
static void infoCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displayInfoPage(pos);
}
 
static void homeCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displayHomePage(pos);
}
 
static void genericChoiceCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displayChoicePage(pos);
}
 
static void genericConfirmCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displayConfirm(pos);
}
 
static void statusButtonCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    // any button press should dismiss the status screen
    if ((event == BUTTON_BOTH_PRESSED) || (event == BUTTON_LEFT_PRESSED)
        || (event == BUTTON_RIGHT_PRESSED)) {
        if (context.stepCallback != NULL) {
            context.stepCallback();
        }
    }
}
 
static void contentCallback(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
    nbgl_stepPosition_t pos;
 
    if (!buttonGenericCallback(event, &pos)) {
        return;
    }
 
    displayContent(pos, false);
}
 
// callback used for timeout
static void statusTickerCallback(void)
{
    if (context.stepCallback != NULL) {
        context.stepCallback();
    }
}
 
// this is the callback used when navigating in extension pages
static void extensionNavigate(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    nbgl_stepPosition_t pos;
    UNUSED(stepCtx);
 
    if (event == BUTTON_LEFT_PRESSED) {
        // only decrement page if we are not at the first page
        if (context.review.currentExtensionPage > 0) {
            context.review.currentExtensionPage--;
        }
        pos = BACKWARD_DIRECTION;
    }
    else if (event == BUTTON_RIGHT_PRESSED) {
        // only increment page if not at last page
        if (context.review.currentExtensionPage < (context.review.nbExtensionPages - 1)) {
            context.review.currentExtensionPage++;
        }
        pos = FORWARD_DIRECTION;
    }
    else if (event == BUTTON_BOTH_PRESSED) {
        // if at last page, leave modal context
        if (context.review.currentExtensionPage == (context.review.nbExtensionPages - 1)) {
            nbgl_stepRelease(context.review.extensionStepCtx);
            nbgl_screenRedraw();
            nbgl_refresh();
        }
        return;
    }
    else {
        return;
    }
    displayExtensionStep(pos);
}
 
// function used to display the extension pages
static void displayExtensionStep(nbgl_stepPosition_t pos)
{
    nbgl_layoutCenteredInfo_t         info         = {0};
    const nbgl_contentTagValueList_t *tagValueList = NULL;
    const nbgl_contentInfoList_t     *infoList     = NULL;
    const char                       *text         = NULL;
    const char                       *subText      = NULL;
 
    if (context.review.extensionStepCtx != NULL) {
        nbgl_stepRelease(context.review.extensionStepCtx);
    }
    if (context.review.currentExtensionPage < (context.review.nbExtensionPages - 1)) {
        if (context.review.currentExtensionPage == 0) {
            pos |= FIRST_STEP;
        }
        else {
            pos |= NEITHER_FIRST_NOR_LAST_STEP;
        }
 
        switch (context.review.extension->aliasType) {
            case ENS_ALIAS:
                text    = context.review.extension->title;
                subText = context.review.extension->fullValue;
                break;
            case INFO_LIST_ALIAS:
                infoList = context.review.extension->infolist;
                text     = PIC(infoList->infoTypes[context.review.currentExtensionPage]);
                subText  = PIC(infoList->infoContents[context.review.currentExtensionPage]);
                break;
            case TAG_VALUE_LIST_ALIAS:
                tagValueList = context.review.extension->tagValuelist;
                text         = PIC(tagValueList->pairs[context.review.currentExtensionPage].item);
                subText      = PIC(tagValueList->pairs[context.review.currentExtensionPage].value);
                break;
            default:
                break;
        }
        if (text != NULL) {
            context.review.extensionStepCtx = nbgl_stepDrawText(
                pos, extensionNavigate, NULL, text, subText, BOLD_TEXT1_INFO, true);
        }
    }
    else if (context.review.currentExtensionPage == (context.review.nbExtensionPages - 1)) {
        // draw the back page
        info.icon  = &C_icon_back_x;
        info.text1 = "Back";
        info.style = BOLD_TEXT1_INFO;
        pos |= LAST_STEP;
        context.review.extensionStepCtx
            = nbgl_stepDrawCenteredInfo(pos, extensionNavigate, NULL, &info, true);
    }
    nbgl_refresh();
}
 
static void displayAliasFullValue(void)
{
    const char                *text    = NULL;
    const char                *subText = NULL;
    const nbgl_icon_details_t *icon;
    bool                       isCenteredInfo;
 
    getPairData(context.review.tagValueList,
                context.review.currentTagValueIndex,
                &text,
                &subText,
                &context.review.extension,
                &icon,
                &isCenteredInfo);
    if (context.review.extension == NULL) {
        // probably an error
        LOG_WARN(USE_CASE_LOGGER,
                 "displayAliasFullValue: extension nor found for pair %d\n",
                 context.review.currentTagValueIndex);
        return;
    }
    context.review.currentExtensionPage = 0;
    context.review.extensionStepCtx     = NULL;
    // create a modal flow to display this extension
    switch (context.review.extension->aliasType) {
        case ENS_ALIAS:
            context.review.nbExtensionPages = 2;
            break;
        case INFO_LIST_ALIAS:
            context.review.nbExtensionPages = context.review.extension->infolist->nbInfos + 1;
            break;
        case TAG_VALUE_LIST_ALIAS:
            context.review.nbExtensionPages = context.review.extension->tagValuelist->nbPairs + 1;
            break;
        default:
            LOG_WARN(USE_CASE_LOGGER,
                     "displayAliasFullValue: unsupported alias type %d\n",
                     context.review.extension->aliasType);
            return;
    }
    displayExtensionStep(FORWARD_DIRECTION);
}
 
static void getLastPageInfo(bool approve, const nbgl_icon_details_t **icon, const char **text)
{
    if (approve) {
        // Approve page
        *icon = &C_icon_validate_14;
        if (context.type == ADDRESS_REVIEW_USE_CASE) {
            *text = "Confirm";
        }
        else {
            // if finish title is provided, use it
            if (context.review.finishTitle != NULL) {
                *text = context.review.finishTitle;
            }
            else {
                switch (context.operationType & REAL_TYPE_MASK) {
                    case TYPE_TRANSACTION:
                        if (context.operationType & RISKY_OPERATION) {
                            *text = "Accept risk and sign transaction";
                        }
                        else {
                            *text = "Sign transaction";
                        }
                        break;
                    case TYPE_MESSAGE:
                        if (context.operationType & RISKY_OPERATION) {
                            *text = "Accept risk and sign message";
                        }
                        else {
                            *text = "Sign message";
                        }
                        break;
                    default:
                        if (context.operationType & RISKY_OPERATION) {
                            *text = "Accept risk and sign operation";
                        }
                        else {
                            *text = "Sign operation";
                        }
                        break;
                }
            }
        }
        context.stepCallback = onReviewAccept;
    }
    else {
        // Reject page
        *icon = &C_icon_crossmark;
        if (context.type == ADDRESS_REVIEW_USE_CASE) {
            *text = "Cancel";
        }
        else if ((context.operationType & REAL_TYPE_MASK) == TYPE_TRANSACTION) {
            *text = "Reject transaction";
        }
        else if ((context.operationType & REAL_TYPE_MASK) == TYPE_MESSAGE) {
            *text = "Reject message";
        }
        else {
            *text = "Reject operation";
        }
        context.stepCallback = onReviewReject;
    }
}
 
// function used to display the current page in review
static void displayReviewPage(nbgl_stepPosition_t pos)
{
    uint8_t                       reviewPages  = 0;
    uint8_t                       finalPages   = 0;
    uint8_t                       pairIndex    = 0;
    const char                   *text         = NULL;
    const char                   *subText      = NULL;
    const nbgl_icon_details_t    *icon         = NULL;
    uint8_t                       currentIndex = 0;
    uint8_t                       titleIndex   = 255;
    uint8_t                       subIndex     = 255;
    uint8_t                       approveIndex = 255;
    uint8_t                       rejectIndex  = 255;
    const nbgl_contentValueExt_t *extension    = NULL;
    ForcedType_t                  forcedType   = NO_FORCED_TYPE;
 
    context.stepCallback = NULL;
 
    // Determine the 1st page to display tag/values
    // Title page to display
    titleIndex = currentIndex++;
    reviewPages++;
    if (context.review.reviewSubTitle) {
        // subtitle page to display
        subIndex = currentIndex++;
        reviewPages++;
    }
    approveIndex = context.nbPages - 2;
    rejectIndex  = context.nbPages - 1;
    finalPages   = approveIndex;
 
    // Determine which page to display
    if (context.currentPage >= finalPages) {
        if (context.currentPage == approveIndex) {
            // Approve page
            getLastPageInfo(true, &icon, &text);
        }
        else if (context.currentPage == rejectIndex) {
            // Reject page
            getLastPageInfo(false, &icon, &text);
        }
    }
    else if (context.currentPage < reviewPages) {
        if (context.currentPage == titleIndex) {
            // Title page
            icon = context.review.icon;
            text = context.review.reviewTitle;
        }
        else if (context.currentPage == subIndex) {
            // SubTitle page
            text = context.review.reviewSubTitle;
        }
    }
    else if ((context.review.address != NULL) && (context.currentPage == reviewPages)) {
        // address confirmation and 2nd page
        text    = "Address";
        subText = context.review.address;
    }
    else {
        // if there is a skip, and we are not already displaying the "skip" page
        // and we are not at the first tag/value of the first set of data (except if going
        // backward) then display the "skip" page
        if ((context.operationType & SKIPPABLE_OPERATION) && (context.review.skipDisplay == false)
            && ((context.currentPage > reviewPages)
                || (context.review.dataDirection == BACKWARD_DIRECTION))) {
            nbgl_stepPosition_t       directions = (pos & BACKWARD_DIRECTION) | FIRST_STEP;
            nbgl_layoutCenteredInfo_t info       = {0};
            if ((context.review.nbDataSets == 1) || (context.currentPage > 0)) {
                directions |= LAST_STEP;
            }
            info.icon  = &C_Information_circle_14px;
            info.text1 = "Press right button to continue message or \bpress both to skip\b";
            nbgl_stepDrawCenteredInfo(directions, buttonSkipCallback, NULL, &info, false);
            nbgl_refresh();
            context.review.skipDisplay = true;
            context.firstPairPage      = reviewPages;
            return;
        }
        context.review.skipDisplay = false;
        bool isCenteredInfo        = false;
        pairIndex                  = context.currentPage - reviewPages;
        if (context.review.address != NULL) {
            pairIndex--;
        }
        getPairData(context.review.tagValueList,
                    pairIndex,
                    &text,
                    &subText,
                    &extension,
                    &icon,
                    &isCenteredInfo);
        if (extension != NULL) {
            context.stepCallback                = displayAliasFullValue;
            context.review.currentTagValueIndex = pairIndex;
            forcedType                          = FORCE_BUTTON;
        }
        else {
            if (isCenteredInfo) {
                forcedType = FORCE_CENTERED_INFO;
            }
        }
    }
 
    drawStep(pos, icon, text, subText, reviewCallback, false, forcedType);
    nbgl_refresh();
}
 
// function used to display the current page in review
static void displayStreamingReviewPage(nbgl_stepPosition_t pos)
{
    const char                   *text        = NULL;
    const char                   *subText     = NULL;
    const nbgl_icon_details_t    *icon        = NULL;
    uint8_t                       reviewPages = 0;
    uint8_t                       titleIndex  = 255;
    uint8_t                       subIndex    = 255;
    const nbgl_contentValueExt_t *extension   = NULL;
    ForcedType_t                  forcedType  = NO_FORCED_TYPE;
 
    context.stepCallback = NULL;
    switch (context.type) {
        case STREAMING_START_REVIEW_USE_CASE:
            // Title page to display
            titleIndex = reviewPages++;
            if (context.review.reviewSubTitle) {
                // subtitle page to display
                subIndex = reviewPages++;
            }
            // Determine which page to display
            if (context.currentPage >= reviewPages) {
                onReviewAccept();
                return;
            }
            // header page(s)
            if (context.currentPage == titleIndex) {
                // title page
                icon = context.review.icon;
                text = context.review.reviewTitle;
            }
            else if (context.currentPage == subIndex) {
                // subtitle page
                text = context.review.reviewSubTitle;
            }
            break;
 
        case STREAMING_CONTINUE_REVIEW_USE_CASE:
            if (context.currentPage >= context.review.tagValueList->nbPairs) {
                onReviewAccept();
                return;
            }
            // if there is a skip, and we are not already displaying the "skip" page
            // and we are not at the first tag/value of the first set of data (except if going
            // backward) then display the "skip" page
            if ((context.review.skipCallback != NULL) && (context.review.skipDisplay == false)
                && ((context.review.nbDataSets > 1) || (context.currentPage > 0)
                    || (context.review.dataDirection == BACKWARD_DIRECTION))) {
                nbgl_stepPosition_t       directions = (pos & BACKWARD_DIRECTION) | FIRST_STEP;
                nbgl_layoutCenteredInfo_t info       = {0};
                if ((context.review.nbDataSets == 1) || (context.currentPage > 0)) {
                    directions |= LAST_STEP;
                }
                info.icon  = &C_Information_circle_14px;
                info.text1 = "Press right button to continue message or \bpress both to skip\b";
                nbgl_stepDrawCenteredInfo(directions, buttonSkipCallback, NULL, &info, false);
                nbgl_refresh();
                context.review.skipDisplay = true;
                return;
            }
            context.review.skipDisplay = false;
            bool isCenteredInfo        = false;
            getPairData(context.review.tagValueList,
                        context.currentPage,
                        &text,
                        &subText,
                        &extension,
                        &icon,
                        &isCenteredInfo);
            if (extension != NULL) {
                forcedType = FORCE_BUTTON;
            }
            else {
                if (isCenteredInfo) {
                    forcedType = FORCE_CENTERED_INFO;
                }
            }
            break;
 
        case STREAMING_FINISH_REVIEW_USE_CASE:
        default:
            if (context.currentPage == 0) {
                // accept page
                getLastPageInfo(true, &icon, &text);
            }
            else {
                // reject page
                getLastPageInfo(false, &icon, &text);
            }
            break;
    }
 
    drawStep(pos, icon, text, subText, streamingReviewCallback, false, forcedType);
    nbgl_refresh();
}
 
// function used to display the current page in info
static void displayInfoPage(nbgl_stepPosition_t pos)
{
    const char                *text    = NULL;
    const char                *subText = NULL;
    const nbgl_icon_details_t *icon    = NULL;
 
    context.stepCallback = NULL;
 
    if (context.currentPage < (context.nbPages - 1)) {
        text = PIC(
            ((const char *const *) PIC(context.home.infosList->infoTypes))[context.currentPage]);
        subText = PIC(
            ((const char *const *) PIC(context.home.infosList->infoContents))[context.currentPage]);
    }
    else {
        icon                 = &C_icon_back_x;
        text                 = "Back";
        context.stepCallback = startUseCaseHome;
    }
 
    drawStep(pos, icon, text, subText, infoCallback, false, FORCE_CENTERED_INFO);
    nbgl_refresh();
}
 
// function used to get the current page content
static void getContentPage(bool toogle_state, PageContent_t *contentPage)
{
    uint8_t               elemIdx       = 0;
    const nbgl_content_t *p_content     = NULL;
    nbgl_content_t        content       = {0};
    nbgl_contentSwitch_t *contentSwitch = NULL;
#ifdef WITH_HORIZONTAL_CHOICES_LIST
    nbgl_contentRadioChoice_t *contentChoices = NULL;
    char                     **names          = NULL;
#endif
#ifdef WITH_HORIZONTAL_BARS_LIST
    nbgl_contentBarsList_t *contentBars = NULL;
    char                  **texts       = NULL;
#endif
    p_content = getContentElemAtIdx(context.currentPage, &elemIdx, &content);
    if (p_content == NULL) {
        return;
    }
    switch (p_content->type) {
        case CENTERED_INFO:
            contentPage->text    = PIC(p_content->content.centeredInfo.text1);
            contentPage->subText = PIC(p_content->content.centeredInfo.text2);
            break;
        case INFO_BUTTON:
            contentPage->icon    = PIC(p_content->content.infoButton.icon);
            contentPage->text    = PIC(p_content->content.infoButton.text);
            contentPage->subText = PIC(p_content->content.infoButton.buttonText);
            break;
        case TAG_VALUE_LIST:
            getPairData(&p_content->content.tagValueList,
                        elemIdx,
                        &contentPage->text,
                        &contentPage->subText,
                        &contentPage->extension,
                        &contentPage->icon,
                        &contentPage->isCenteredInfo);
            break;
        case SWITCHES_LIST:
            contentPage->isSwitch = true;
            contentSwitch         = &(
                (nbgl_contentSwitch_t *) PIC(p_content->content.switchesList.switches))[elemIdx];
            contentPage->text  = contentSwitch->text;
            contentPage->state = contentSwitch->initState;
            if (toogle_state) {
                contentPage->state = (contentPage->state == ON_STATE) ? OFF_STATE : ON_STATE;
            }
            context.stepCallback = onSwitchAction;
            contentPage->subText = contentSwitch->subText;
            break;
        case INFOS_LIST:
            contentPage->text
                = ((const char *const *) PIC(p_content->content.infosList.infoTypes))[elemIdx];
            contentPage->subText
                = ((const char *const *) PIC(p_content->content.infosList.infoContents))[elemIdx];
            break;
        case CHOICES_LIST:
#ifdef WITH_HORIZONTAL_CHOICES_LIST
            contentChoices = (nbgl_contentRadioChoice_t *) PIC(&p_content->content.choicesList);
            names          = (char **) PIC(contentChoices->names);
            if ((context.type == CONTENT_USE_CASE) && (context.content.title != NULL)) {
                contentPage->text    = PIC(context.content.title);
                contentPage->subText = (const char *) PIC(names[elemIdx]);
            }
            else if ((context.type == GENERIC_SETTINGS) && (context.home.appName != NULL)) {
                contentPage->text    = PIC(context.home.appName);
                contentPage->subText = (const char *) PIC(names[elemIdx]);
            }
            else {
                contentPage->text = (const char *) PIC(names[elemIdx]);
            }
#endif
            break;
        case BARS_LIST:
#ifdef WITH_HORIZONTAL_BARS_LIST
            contentBars = (nbgl_contentBarsList_t *) PIC(&p_content->content.barsList);
            texts       = (char **) PIC(contentBars->barTexts);
            if ((context.type == CONTENT_USE_CASE) && (context.content.title != NULL)) {
                contentPage->text    = PIC(context.content.title);
                contentPage->subText = PIC(texts[elemIdx]);
            }
            else if ((context.type == GENERIC_SETTINGS) && (context.home.appName != NULL)) {
                contentPage->text    = PIC(context.home.appName);
                contentPage->subText = PIC(texts[elemIdx]);
            }
            else {
                contentPage->text = PIC(texts[elemIdx]);
            }
#endif
            break;
        default:
            break;
    }
}
 
// function used to display the current page in settings
static void displaySettingsPage(nbgl_stepPosition_t pos, bool toogle_state)
{
    PageContent_t contentPage = {0};
 
    context.stepCallback = NULL;
 
    if (context.currentPage < (context.nbPages - 1)) {
        getContentPage(toogle_state, &contentPage);
    }
    else {  // last page is for quit
        contentPage.icon = &C_icon_back_x;
        contentPage.text = "Back";
        if (context.type == GENERIC_SETTINGS) {
            context.stepCallback = context.home.quitCallback;
        }
        else {
            context.stepCallback = startUseCaseHome;
        }
    }
 
    if (contentPage.isSwitch) {
        drawSwitchStep(
            pos, contentPage.text, contentPage.subText, contentPage.state, settingsCallback, false);
    }
    else {
        drawStep(pos,
                 contentPage.icon,
                 contentPage.text,
                 contentPage.subText,
                 settingsCallback,
                 false,
                 NO_FORCED_TYPE);
    }
 
    nbgl_refresh();
}
 
static void startUseCaseHome(void)
{
    switch (context.type) {
        case SETTINGS_USE_CASE:
            // Settings page index
            context.currentPage = 1;
            if (context.home.homeAction) {
                // Action page is before Settings page
                context.currentPage++;
            }
            break;
        case INFO_USE_CASE:
            // Info page index
            context.currentPage = 1;
            if (context.home.homeAction) {
                // Action page is before Settings and Info pages
                context.currentPage++;
            }
            if (context.home.settingContents) {
                // Settings page is before Info pages
                context.currentPage++;
            }
            break;
        default:
            // Home page index
            context.currentPage = 0;
            break;
    }
 
    context.type    = HOME_USE_CASE;
    context.nbPages = 2;  // Home + Quit
    if (context.home.settingContents) {
        context.nbPages++;
    }
    if (context.home.infosList) {
        context.nbPages++;
    }
    if (context.home.homeAction) {
        context.nbPages++;
    }
    displayHomePage(FORWARD_DIRECTION);
}
 
static void startUseCaseInfo(void)
{
    context.type        = INFO_USE_CASE;
    context.nbPages     = context.home.infosList->nbInfos + 1;  // For back screen
    context.currentPage = 0;
 
    displayInfoPage(FORWARD_DIRECTION);
}
 
static void startUseCaseSettingsAtPage(uint8_t initSettingPage)
{
    nbgl_content_t        content   = {0};
    const nbgl_content_t *p_content = NULL;
 
    // if not coming from GENERIC_SETTINGS, force to SETTINGS_USE_CASE
    if (context.type != GENERIC_SETTINGS) {
        context.type = SETTINGS_USE_CASE;
    }
 
    context.nbPages = 1;  // For back screen
    for (int i = 0; i < context.home.settingContents->nbContents; i++) {
        p_content = getContentAtIdx(context.home.settingContents, i, &content);
        context.nbPages += getContentNbElement(p_content);
    }
    context.currentPage = initSettingPage;
 
    displaySettingsPage(FORWARD_DIRECTION, false);
}
 
static void startUseCaseSettings(void)
{
    startUseCaseSettingsAtPage(0);
}
 
static void startUseCaseContent(void)
{
    uint8_t               contentIdx = 0;
    const nbgl_content_t *p_content  = NULL;
    nbgl_content_t        content    = {0};
 
    context.nbPages = 1;  // Quit
 
    for (contentIdx = 0; contentIdx < context.content.genericContents.nbContents; contentIdx++) {
        p_content = getContentAtIdx(&context.content.genericContents, contentIdx, &content);
        context.nbPages += getContentNbElement(p_content);
    }
 
    // Ensure currentPage is valid
    if (context.currentPage >= context.nbPages) {
        return;
    }
 
    displayContent(FORWARD_DIRECTION, false);
}
 
// function used to display the current page in home
static void displayHomePage(nbgl_stepPosition_t pos)
{
    const char                *text          = NULL;
    const char                *subText       = NULL;
    const nbgl_icon_details_t *icon          = NULL;
    uint8_t                    currentIndex  = 0;
    uint8_t                    homeIndex     = 255;
    uint8_t                    actionIndex   = 255;
    uint8_t                    settingsIndex = 255;
    uint8_t                    infoIndex     = 255;
 
    context.stepCallback = NULL;
 
    // Determine which pages are present
    homeIndex = currentIndex++;
    if (context.home.homeAction) {
        actionIndex = currentIndex++;
    }
    if (context.home.settingContents) {
        settingsIndex = currentIndex++;
    }
    if (context.home.infosList) {
        infoIndex = currentIndex++;
    }
 
    if (context.currentPage == homeIndex) {
        // Home page
        icon = context.home.appIcon;
        if (context.home.tagline != NULL) {
            text = context.home.tagline;
        }
        else {
            text    = context.home.appName;
            subText = "app is ready";
        }
    }
    else if (context.currentPage == actionIndex) {
        // Action page
        icon                 = context.home.homeAction->icon;
        text                 = PIC(context.home.homeAction->text);
        context.stepCallback = context.home.homeAction->callback;
    }
    else if (context.currentPage == settingsIndex) {
        // Settings page
        icon                 = &C_icon_coggle;
        text                 = "App settings";
        context.stepCallback = startUseCaseSettings;
    }
    else if (context.currentPage == infoIndex) {
        // About page
        icon                 = &C_Information_circle_14px;
        text                 = "App info";
        context.stepCallback = startUseCaseInfo;
    }
    else {
        icon                 = &C_Quit_14px;
        text                 = "Quit app";
        context.stepCallback = context.home.quitCallback;
    }
 
    drawStep(pos, icon, text, subText, homeCallback, false, NO_FORCED_TYPE);
    nbgl_refresh();
}
 
// function used to display the current page in choice
static void displayChoicePage(nbgl_stepPosition_t pos)
{
    const char                *text    = NULL;
    const char                *subText = NULL;
    const nbgl_icon_details_t *icon    = NULL;
    // set to 1 if there is only one page for intro (if either icon or subMessage is NULL)
    uint8_t acceptPage = 0;
 
    if (context.choice.message != NULL) {
        if ((context.choice.icon == NULL) || (context.choice.subMessage == NULL)) {
            acceptPage = 1;
        }
        else {
            acceptPage = 2;
        }
    }
    context.stepCallback = NULL;
 
    if (context.currentPage < acceptPage) {
        if (context.currentPage == 0) {  // title page
            text = context.choice.message;
            if (context.choice.icon != NULL) {
                icon = context.choice.icon;
            }
            else {
                subText = context.choice.subMessage;
            }
        }
        else if ((acceptPage == 2) && (context.currentPage == 1)) {  // sub-title page
            // displayed only if there is both icon and submessage
            text    = context.choice.message;
            subText = context.choice.subMessage;
        }
    }
    else if (context.currentPage == acceptPage) {  // confirm page
        icon                 = &C_icon_validate_14;
        text                 = context.choice.confirmText;
        context.stepCallback = onChoiceAccept;
    }
    else if (context.currentPage == (acceptPage + 1)) {  // cancel page
        icon                 = &C_icon_crossmark;
        text                 = context.choice.cancelText;
        context.stepCallback = onChoiceReject;
    }
    else if (context.choice.details != NULL) {
        // only the first level of details and BAR_LIST type are supported
        if (context.choice.details->type == BAR_LIST_WARNING) {
            text = context.choice.details->barList.texts[context.currentPage - (acceptPage + 2)];
            subText
                = context.choice.details->barList.subTexts[context.currentPage - (acceptPage + 2)];
        }
    }
 
    drawStep(pos, icon, text, subText, genericChoiceCallback, false, NO_FORCED_TYPE);
    nbgl_refresh();
}
 
// function used to display the Confirm page
static void displayConfirm(nbgl_stepPosition_t pos)
{
    const char                *text    = NULL;
    const char                *subText = NULL;
    const nbgl_icon_details_t *icon    = NULL;
 
    context.stepCallback = NULL;
    switch (context.currentPage) {
        case 0:
            // title page
            text    = context.confirm.message;
            subText = context.confirm.subMessage;
            break;
        case 1:
            // confirm page
            icon                 = &C_icon_validate_14;
            text                 = context.confirm.confirmText;
            context.stepCallback = onConfirmAccept;
            break;
        case 2:
            // cancel page
            icon                 = &C_icon_crossmark;
            text                 = context.confirm.cancelText;
            context.stepCallback = onConfirmReject;
            break;
    }
 
    drawStep(pos, icon, text, subText, genericConfirmCallback, true, NO_FORCED_TYPE);
    nbgl_refresh();
}
 
// function used to display the current navigable content
static void displayContent(nbgl_stepPosition_t pos, bool toogle_state)
{
    PageContent_t contentPage = {0};
    ForcedType_t  forcedType  = NO_FORCED_TYPE;
 
    context.stepCallback = NULL;
 
    if (context.currentPage < (context.nbPages - 1)) {
        getContentPage(toogle_state, &contentPage);
        if (contentPage.isCenteredInfo) {
            forcedType = FORCE_CENTERED_INFO;
        }
    }
    else {  // last page is for quit
        if (context.content.rejectText) {
            contentPage.text = context.content.rejectText;
        }
        else {
            contentPage.text = "Back";
        }
        if (context.type == GENERIC_REVIEW_USE_CASE) {
            contentPage.icon = &C_icon_crossmark;
        }
        else {
            contentPage.icon = &C_icon_back_x;
        }
        context.stepCallback = context.content.quitCallback;
    }
 
    if (contentPage.isSwitch) {
        drawSwitchStep(
            pos, contentPage.text, contentPage.subText, contentPage.state, contentCallback, false);
    }
    else {
        drawStep(pos,
                 contentPage.icon,
                 contentPage.text,
                 contentPage.subText,
                 contentCallback,
                 false,
                 forcedType);
    }
 
    nbgl_refresh();
}
 
static void displaySpinner(const char *text)
{
    drawStep(SINGLE_STEP, &C_icon_processing, text, NULL, NULL, false, false);
    nbgl_refresh();
}
 
// function to factorize code for all simple reviews
static void useCaseReview(ContextType_t                     type,
                          nbgl_operationType_t              operationType,
                          const nbgl_contentTagValueList_t *tagValueList,
                          const nbgl_icon_details_t        *icon,
                          const char                       *reviewTitle,
                          const char                       *reviewSubTitle,
                          const char                       *finishTitle,
                          nbgl_choiceCallback_t             choiceCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                  = type;
    context.operationType         = operationType;
    context.review.tagValueList   = tagValueList;
    context.review.reviewTitle    = reviewTitle;
    context.review.reviewSubTitle = reviewSubTitle;
    context.review.finishTitle    = finishTitle;
    context.review.icon           = icon;
    context.review.onChoice       = choiceCallback;
    context.currentPage           = 0;
    // 1 page for title and 2 pages at the end for accept/reject
    context.nbPages = tagValueList->nbPairs + 3;
    if (reviewSubTitle) {
        context.nbPages++;  // 1 page for subtitle page
    }
 
    displayReviewPage(FORWARD_DIRECTION);
}
 
#ifdef NBGL_KEYPAD
static void setPinCodeText(void)
{
    bool enableValidate  = false;
    bool enableBackspace = true;
 
    // pin can be validated when min digits is entered
    enableValidate = (context.keypad.pinLen >= context.keypad.pinMinDigits);
    // backspace is disabled when no digit is entered and back vallback is not provided
    enableBackspace = (context.keypad.pinLen > 0) || (context.keypad.backCallback != NULL);
    nbgl_layoutUpdateKeypadContent(context.keypad.layoutCtx,
                                   context.keypad.hidden,
                                   context.keypad.pinLen,
                                   (const char *) context.keypad.pinEntry);
    nbgl_layoutUpdateKeypad(
        context.keypad.layoutCtx, context.keypad.keypadIndex, enableValidate, enableBackspace);
    nbgl_layoutDraw(context.keypad.layoutCtx);
    nbgl_refresh();
}
 
// called when a key is touched on the keypad
static void keypadCallback(char touchedKey)
{
    switch (touchedKey) {
        case BACKSPACE_KEY:
            if (context.keypad.pinLen > 0) {
                context.keypad.pinLen--;
                context.keypad.pinEntry[context.keypad.pinLen] = 0;
            }
            else if (context.keypad.backCallback != NULL) {
                context.keypad.backCallback();
                break;
            }
            setPinCodeText();
            break;
 
        case VALIDATE_KEY:
            context.keypad.validatePin(context.keypad.pinEntry, context.keypad.pinLen);
            break;
 
        default:
            if ((touchedKey >= 0x30) && (touchedKey < 0x40)) {
                if (context.keypad.pinLen < context.keypad.pinMaxDigits) {
                    context.keypad.pinEntry[context.keypad.pinLen] = touchedKey;
                    context.keypad.pinLen++;
                }
                setPinCodeText();
            }
            break;
    }
}
#endif  // NBGL_KEYPAD
 
// this is the function called to start the actual review, from the initial warning pages
static void launchReviewAfterWarning(void)
{
    if (reviewWithWarnCtx.type == REVIEW_USE_CASE) {
        useCaseReview(reviewWithWarnCtx.type,
                      reviewWithWarnCtx.operationType,
                      reviewWithWarnCtx.tagValueList,
                      reviewWithWarnCtx.icon,
                      reviewWithWarnCtx.reviewTitle,
                      reviewWithWarnCtx.reviewSubTitle,
                      reviewWithWarnCtx.finishTitle,
                      reviewWithWarnCtx.choiceCallback);
    }
    else if (reviewWithWarnCtx.type == STREAMING_START_REVIEW_USE_CASE) {
        displayStreamingReviewPage(FORWARD_DIRECTION);
    }
}
 
// this is the callback used when navigating in warning pages
static void warningNavigate(nbgl_step_t stepCtx, nbgl_buttonEvent_t event)
{
    UNUSED(stepCtx);
 
    if (event == BUTTON_LEFT_PRESSED) {
        // only decrement page if we are not at the first page
        if (reviewWithWarnCtx.warningPage > 0) {
            reviewWithWarnCtx.warningPage--;
        }
    }
    else if (event == BUTTON_RIGHT_PRESSED) {
        // only increment page if not at last page
        if (reviewWithWarnCtx.warningPage < (reviewWithWarnCtx.nbWarningPages - 1)) {
            reviewWithWarnCtx.warningPage++;
        }
        else if ((reviewWithWarnCtx.warning->predefinedSet == 0)
                 && (reviewWithWarnCtx.warning->info != NULL)) {
            launchReviewAfterWarning();
            return;
        }
    }
    else if ((event == BUTTON_BOTH_PRESSED)
             && (reviewWithWarnCtx.warning->predefinedSet & (1 << BLIND_SIGNING_WARN))) {
        // if at first page, double press leads to start of review
        if (reviewWithWarnCtx.warningPage == 0) {
            launchReviewAfterWarning();
        }
        // if at last page, reject operation
        else if (reviewWithWarnCtx.warningPage == (reviewWithWarnCtx.nbWarningPages - 1)) {
            reviewWithWarnCtx.choiceCallback(false);
        }
        return;
    }
    else {
        return;
    }
    displayWarningStep();
}
 
// function used to display the initial warning pages when starting a "review with warning"
static void displayWarningStep(void)
{
    nbgl_layoutCenteredInfo_t info = {0};
    nbgl_stepPosition_t       pos  = 0;
    if (reviewWithWarnCtx.warning->predefinedSet & (1 << BLIND_SIGNING_WARN)) {
        if (reviewWithWarnCtx.warningPage == 0) {
            // draw the main warning page
            info.icon  = &C_icon_warning;
            info.text1 = "Blind signing ahead";
            info.text2 = "To accept risk, press both buttons";
            pos        = FIRST_STEP | FORWARD_DIRECTION;
        }
        else if (reviewWithWarnCtx.warningPage == (reviewWithWarnCtx.nbWarningPages - 1)) {
            getLastPageInfo(false, &info.icon, &info.text1);
            pos = LAST_STEP | BACKWARD_DIRECTION;
        }
    }
    else if ((reviewWithWarnCtx.warning->predefinedSet == 0)
             && (reviewWithWarnCtx.warning->info != NULL)) {
        if (reviewWithWarnCtx.warningPage == 0) {
            info.icon  = reviewWithWarnCtx.warning->info->icon;
            info.text1 = reviewWithWarnCtx.warning->info->title;
            info.text2 = reviewWithWarnCtx.warning->info->description;
            pos        = FIRST_STEP | FORWARD_DIRECTION;
        }
        else if (reviewWithWarnCtx.warningPage == (reviewWithWarnCtx.nbWarningPages - 1)) {
            if (reviewWithWarnCtx.warning->introDetails->type == CENTERED_INFO_WARNING) {
                info.icon  = reviewWithWarnCtx.warning->introDetails->centeredInfo.icon;
                info.text1 = reviewWithWarnCtx.warning->introDetails->centeredInfo.title;
                info.text2 = reviewWithWarnCtx.warning->introDetails->centeredInfo.description;
                pos        = NEITHER_FIRST_NOR_LAST_STEP;
            }
            else {
                // not supported
                return;
            }
        }
    }
    else {
        // not supported
        return;
    }
    info.style = BOLD_TEXT1_INFO;
    nbgl_stepDrawCenteredInfo(pos, warningNavigate, NULL, &info, false);
    nbgl_refresh();
}
 
// function used to display the initial warning page when starting a "review with warning"
static void displayInitialWarning(void)
{
    // draw the main warning page
    reviewWithWarnCtx.warningPage    = 0;
    reviewWithWarnCtx.nbWarningPages = 2;
    displayWarningStep();
}
 
/**********************
 *  GLOBAL FUNCTIONS
 **********************/
 
uint8_t nbgl_useCaseGetNbTagValuesInPage(uint8_t                           nbPairs,
                                         const nbgl_contentTagValueList_t *tagValueList,
                                         uint8_t                           startIndex,
                                         bool                             *requireSpecificDisplay)
{
    UNUSED(nbPairs);
    UNUSED(tagValueList);
    UNUSED(startIndex);
    *requireSpecificDisplay = true;
    return 1;
}
 
uint8_t nbgl_useCaseGetNbTagValuesInPageExt(uint8_t                           nbPairs,
                                            const nbgl_contentTagValueList_t *tagValueList,
                                            uint8_t                           startIndex,
                                            bool                              isSkippable,
                                            bool *requireSpecificDisplay)
{
    UNUSED(nbPairs);
    UNUSED(tagValueList);
    UNUSED(startIndex);
    UNUSED(isSkippable);
    *requireSpecificDisplay = true;
    return 1;
}
 
uint8_t nbgl_useCaseGetNbInfosInPage(uint8_t                       nbInfos,
                                     const nbgl_contentInfoList_t *infosList,
                                     uint8_t                       startIndex,
                                     bool                          withNav)
{
    UNUSED(nbInfos);
    UNUSED(infosList);
    UNUSED(startIndex);
    UNUSED(withNav);
    return 1;
}
 
uint8_t nbgl_useCaseGetNbSwitchesInPage(uint8_t                           nbSwitches,
                                        const nbgl_contentSwitchesList_t *switchesList,
                                        uint8_t                           startIndex,
                                        bool                              withNav)
{
    UNUSED(nbSwitches);
    UNUSED(switchesList);
    UNUSED(startIndex);
    UNUSED(withNav);
    return 1;
}
 
uint8_t nbgl_useCaseGetNbBarsInPage(uint8_t                       nbBars,
                                    const nbgl_contentBarsList_t *barsList,
                                    uint8_t                       startIndex,
                                    bool                          withNav)
{
    UNUSED(nbBars);
    UNUSED(barsList);
    UNUSED(startIndex);
    UNUSED(withNav);
    return 1;
}
 
uint8_t nbgl_useCaseGetNbChoicesInPage(uint8_t                          nbChoices,
                                       const nbgl_contentRadioChoice_t *choicesList,
                                       uint8_t                          startIndex,
                                       bool                             withNav)
{
    UNUSED(nbChoices);
    UNUSED(choicesList);
    UNUSED(startIndex);
    UNUSED(withNav);
    return 1;
}
 
uint8_t nbgl_useCaseGetNbPagesForTagValueList(const nbgl_contentTagValueList_t *tagValueList)
{
    uint8_t nbPages = 0;
    uint8_t nbPairs = tagValueList->nbPairs;
    uint8_t nbPairsInPage;
    uint8_t i = 0;
    bool    flag;
 
    while (i < tagValueList->nbPairs) {
        // upper margin
        nbPairsInPage = nbgl_useCaseGetNbTagValuesInPageExt(nbPairs, tagValueList, i, false, &flag);
        i += nbPairsInPage;
        nbPairs -= nbPairsInPage;
        nbPages++;
    }
    return nbPages;
}
 
void nbgl_useCaseNavigableContent(const char                *title,
                                  uint8_t                    initPage,
                                  uint8_t                    nbPages,
                                  nbgl_callback_t            quitCallback,
                                  nbgl_navCallback_t         navCallback,
                                  nbgl_layoutTouchCallback_t controlsCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                                       = CONTENT_USE_CASE;
    context.currentPage                                = initPage;
    context.content.title                              = title;
    context.content.quitCallback                       = quitCallback;
    context.content.navCallback                        = navCallback;
    context.content.controlsCallback                   = controlsCallback;
    context.content.genericContents.callbackCallNeeded = true;
    context.content.genericContents.nbContents         = nbPages;
 
    startUseCaseContent();
}
 
void nbgl_useCaseHomeAndSettings(const char                   *appName,
                                 const nbgl_icon_details_t    *appIcon,
                                 const char                   *tagline,
                                 const uint8_t                 initSettingPage,
                                 const nbgl_genericContents_t *settingContents,
                                 const nbgl_contentInfoList_t *infosList,
                                 const nbgl_homeAction_t      *action,
                                 nbgl_callback_t               quitCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.home.appName         = appName;
    context.home.appIcon         = appIcon;
    context.home.tagline         = tagline;
    context.home.settingContents = PIC(settingContents);
    context.home.infosList       = PIC(infosList);
    context.home.homeAction      = action;
    context.home.quitCallback    = quitCallback;
 
    if ((initSettingPage != INIT_HOME_PAGE) && (settingContents != NULL)) {
        startUseCaseSettingsAtPage(initSettingPage);
    }
    else {
        startUseCaseHome();
    }
}
 
void nbgl_useCaseGenericSettings(const char                   *appName,
                                 uint8_t                       initPage,
                                 const nbgl_genericContents_t *settingContents,
                                 const nbgl_contentInfoList_t *infosList,
                                 nbgl_callback_t               quitCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                 = GENERIC_SETTINGS;
    context.home.appName         = appName;
    context.home.settingContents = PIC(settingContents);
    context.home.infosList       = PIC(infosList);
    context.home.quitCallback    = quitCallback;
 
    startUseCaseSettingsAtPage(initPage);
}
 
void nbgl_useCaseGenericConfiguration(const char                   *title,
                                      uint8_t                       initPage,
                                      const nbgl_genericContents_t *contents,
                                      nbgl_callback_t               quitCallback)
{
    nbgl_useCaseGenericSettings(title, initPage, contents, NULL, quitCallback);
}
 
void nbgl_useCaseReview(nbgl_operationType_t              operationType,
                        const nbgl_contentTagValueList_t *tagValueList,
                        const nbgl_icon_details_t        *icon,
                        const char                       *reviewTitle,
                        const char                       *reviewSubTitle,
                        const char                       *finishTitle,
                        nbgl_choiceCallback_t             choiceCallback)
{
    useCaseReview(REVIEW_USE_CASE,
                  operationType,
                  tagValueList,
                  icon,
                  reviewTitle,
                  reviewSubTitle,
                  finishTitle,
                  choiceCallback);
}
 
void nbgl_useCaseAdvancedReview(nbgl_operationType_t              operationType,
                                const nbgl_contentTagValueList_t *tagValueList,
                                const nbgl_icon_details_t        *icon,
                                const char                       *reviewTitle,
                                const char                       *reviewSubTitle,
                                const char                       *finishTitle,
                                const nbgl_tipBox_t              *tipBox,
                                const nbgl_warning_t             *warning,
                                nbgl_choiceCallback_t             choiceCallback)
{
    UNUSED(tipBox);
    ContextType_t type = REVIEW_USE_CASE;
 
    // if no warning at all, it's a simple review
    if ((warning == NULL)
        || ((warning->predefinedSet == 0) && (warning->introDetails == NULL)
            && (warning->reviewDetails == NULL))) {
        useCaseReview(type,
                      operationType,
                      tagValueList,
                      icon,
                      reviewTitle,
                      reviewSubTitle,
                      finishTitle,
                      choiceCallback);
        return;
    }
    if (warning->predefinedSet == (1 << W3C_NO_THREAT_WARN)) {
        operationType |= NO_THREAT_OPERATION;
    }
    else {
        operationType |= RISKY_OPERATION;
    }
 
    memset(&reviewWithWarnCtx, 0, sizeof(reviewWithWarnCtx));
    reviewWithWarnCtx.type           = type;
    reviewWithWarnCtx.operationType  = operationType;
    reviewWithWarnCtx.tagValueList   = tagValueList;
    reviewWithWarnCtx.icon           = icon;
    reviewWithWarnCtx.reviewTitle    = reviewTitle;
    reviewWithWarnCtx.reviewSubTitle = reviewSubTitle;
    reviewWithWarnCtx.finishTitle    = finishTitle;
    reviewWithWarnCtx.warning        = warning;
    reviewWithWarnCtx.choiceCallback = choiceCallback;
 
    // display the initial warning only of a risk/threat or blind signing
    if ((!(reviewWithWarnCtx.warning->predefinedSet & (1 << W3C_THREAT_DETECTED_WARN))
         && !(reviewWithWarnCtx.warning->predefinedSet & (1 << W3C_RISK_DETECTED_WARN))
         && !(reviewWithWarnCtx.warning->predefinedSet & (1 << BLIND_SIGNING_WARN)))
        && (warning->introDetails == NULL)) {
        useCaseReview(type,
                      operationType,
                      tagValueList,
                      icon,
                      reviewTitle,
                      reviewSubTitle,
                      finishTitle,
                      choiceCallback);
        return;
    }
    displayInitialWarning();
}
 
void nbgl_useCaseReviewBlindSigning(nbgl_operationType_t              operationType,
                                    const nbgl_contentTagValueList_t *tagValueList,
                                    const nbgl_icon_details_t        *icon,
                                    const char                       *reviewTitle,
                                    const char                       *reviewSubTitle,
                                    const char                       *finishTitle,
                                    const nbgl_tipBox_t              *dummy,
                                    nbgl_choiceCallback_t             choiceCallback)
{
    nbgl_useCaseAdvancedReview(operationType,
                               tagValueList,
                               icon,
                               reviewTitle,
                               reviewSubTitle,
                               finishTitle,
                               dummy,
                               &blindSigningWarning,
                               choiceCallback);
}
 
void nbgl_useCaseReviewLight(nbgl_operationType_t              operationType,
                             const nbgl_contentTagValueList_t *tagValueList,
                             const nbgl_icon_details_t        *icon,
                             const char                       *reviewTitle,
                             const char                       *reviewSubTitle,
                             const char                       *finishTitle,
                             nbgl_choiceCallback_t             choiceCallback)
{
    nbgl_useCaseReview(operationType,
                       tagValueList,
                       icon,
                       reviewTitle,
                       reviewSubTitle,
                       finishTitle,
                       choiceCallback);
}
 
void nbgl_useCaseAddressReview(const char                       *address,
                               const nbgl_contentTagValueList_t *additionalTagValueList,
                               const nbgl_icon_details_t        *icon,
                               const char                       *reviewTitle,
                               const char                       *reviewSubTitle,
                               nbgl_choiceCallback_t             choiceCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                  = ADDRESS_REVIEW_USE_CASE;
    context.review.address        = address;
    context.review.reviewTitle    = reviewTitle;
    context.review.reviewSubTitle = reviewSubTitle;
    context.review.icon           = icon;
    context.review.onChoice       = choiceCallback;
    context.currentPage           = 0;
    // + 4 because 1 page for title, 1 for address and 2 pages at the end for approve/reject
    // + 1 if sub Title
    context.nbPages = reviewSubTitle ? 5 : 4;
    if (additionalTagValueList) {
        context.review.tagValueList = PIC(additionalTagValueList);
        context.nbPages += additionalTagValueList->nbPairs;
    }
 
    displayReviewPage(FORWARD_DIRECTION);
}
 
void nbgl_useCaseGenericReview(const nbgl_genericContents_t *contents,
                               const char                   *rejectText,
                               nbgl_callback_t               rejectCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                                       = GENERIC_REVIEW_USE_CASE;
    context.content.rejectText                         = rejectText;
    context.content.quitCallback                       = rejectCallback;
    context.content.genericContents.nbContents         = contents->nbContents;
    context.content.genericContents.callbackCallNeeded = contents->callbackCallNeeded;
    if (contents->callbackCallNeeded) {
        context.content.genericContents.contentGetterCallback = contents->contentGetterCallback;
    }
    else {
        context.content.genericContents.contentsList = PIC(contents->contentsList);
    }
 
    startUseCaseContent();
}
 
void nbgl_useCaseStatus(const char *message, bool isSuccess, nbgl_callback_t quitCallback)
{
    UNUSED(isSuccess);
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type         = STATUS_USE_CASE;
    context.stepCallback = quitCallback;
    context.currentPage  = 0;
    context.nbPages      = 1;
 
    drawStep(SINGLE_STEP | ACTION_ON_ANY_BUTTON,
             NULL,
             message,
             NULL,
             statusButtonCallback,
             false,
             NO_FORCED_TYPE);
}
 
void nbgl_useCaseReviewStatus(nbgl_reviewStatusType_t reviewStatusType,
                              nbgl_callback_t         quitCallback)
{
    const char *msg;
    bool        isSuccess;
    switch (reviewStatusType) {
        case STATUS_TYPE_OPERATION_SIGNED:
            msg       = "Operation signed";
            isSuccess = true;
            break;
        case STATUS_TYPE_OPERATION_REJECTED:
            msg       = "Operation rejected";
            isSuccess = false;
            break;
        case STATUS_TYPE_TRANSACTION_SIGNED:
            msg       = "Transaction signed";
            isSuccess = true;
            break;
        case STATUS_TYPE_TRANSACTION_REJECTED:
            msg       = "Transaction rejected";
            isSuccess = false;
            break;
        case STATUS_TYPE_MESSAGE_SIGNED:
            msg       = "Message signed";
            isSuccess = true;
            break;
        case STATUS_TYPE_MESSAGE_REJECTED:
            msg       = "Message rejected";
            isSuccess = false;
            break;
        case STATUS_TYPE_ADDRESS_VERIFIED:
            msg       = "Address verified";
            isSuccess = true;
            break;
        case STATUS_TYPE_ADDRESS_REJECTED:
            msg       = "Address verification cancelled";
            isSuccess = false;
            break;
        default:
            return;
    }
    nbgl_useCaseStatus(msg, isSuccess, quitCallback);
}
 
void nbgl_useCaseReviewStreamingStart(nbgl_operationType_t       operationType,
                                      const nbgl_icon_details_t *icon,
                                      const char                *reviewTitle,
                                      const char                *reviewSubTitle,
                                      nbgl_choiceCallback_t      choiceCallback)
{
    // memorize streaming operation type for future API calls
    streamingOpType = operationType;
 
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                  = STREAMING_START_REVIEW_USE_CASE;
    context.operationType         = operationType;
    context.review.reviewTitle    = reviewTitle;
    context.review.reviewSubTitle = reviewSubTitle;
    context.review.icon           = icon;
    context.review.onChoice       = choiceCallback;
    context.currentPage           = 0;
    context.nbPages = reviewSubTitle ? 3 : 2;  // Start page(s) + trick for review continue
 
    displayStreamingReviewPage(FORWARD_DIRECTION);
}
 
void nbgl_useCaseReviewStreamingBlindSigningStart(nbgl_operationType_t       operationType,
                                                  const nbgl_icon_details_t *icon,
                                                  const char                *reviewTitle,
                                                  const char                *reviewSubTitle,
                                                  nbgl_choiceCallback_t      choiceCallback)
{
    nbgl_useCaseAdvancedReviewStreamingStart(
        operationType, icon, reviewTitle, reviewSubTitle, &blindSigningWarning, choiceCallback);
}
 
void nbgl_useCaseAdvancedReviewStreamingStart(nbgl_operationType_t       operationType,
                                              const nbgl_icon_details_t *icon,
                                              const char                *reviewTitle,
                                              const char                *reviewSubTitle,
                                              const nbgl_warning_t      *warning,
                                              nbgl_choiceCallback_t      choiceCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                  = STREAMING_START_REVIEW_USE_CASE;
    context.operationType         = operationType;
    context.review.reviewTitle    = reviewTitle;
    context.review.reviewSubTitle = reviewSubTitle;
    context.review.icon           = icon;
    context.review.onChoice       = choiceCallback;
    context.currentPage           = 0;
    context.nbPages = reviewSubTitle ? 3 : 2;  // Start page(s) + trick for review continue
 
    // memorize streaming operation type for future API calls
    streamingOpType = operationType;
 
    // if no warning at all, it's a simple review
    if ((warning == NULL)
        || ((warning->predefinedSet == 0) && (warning->introDetails == NULL)
            && (warning->reviewDetails == NULL))) {
        displayStreamingReviewPage(FORWARD_DIRECTION);
        return;
    }
    if (warning->predefinedSet == (1 << W3C_NO_THREAT_WARN)) {
        operationType |= NO_THREAT_OPERATION;
    }
    else {
        operationType |= RISKY_OPERATION;
    }
    memset(&reviewWithWarnCtx, 0, sizeof(reviewWithWarnCtx));
 
    reviewWithWarnCtx.type           = context.type;
    reviewWithWarnCtx.operationType  = operationType;
    reviewWithWarnCtx.icon           = icon;
    reviewWithWarnCtx.reviewTitle    = reviewTitle;
    reviewWithWarnCtx.reviewSubTitle = reviewSubTitle;
    reviewWithWarnCtx.choiceCallback = choiceCallback;
    reviewWithWarnCtx.warning        = warning;
 
    // display the initial warning only of a risk/threat or blind signing
    if ((!(reviewWithWarnCtx.warning->predefinedSet & (1 << W3C_THREAT_DETECTED_WARN))
         && !(reviewWithWarnCtx.warning->predefinedSet & (1 << W3C_RISK_DETECTED_WARN))
         && !(reviewWithWarnCtx.warning->predefinedSet & (1 << BLIND_SIGNING_WARN)))
        && (warning->introDetails == NULL)) {
        displayStreamingReviewPage(FORWARD_DIRECTION);
        return;
    }
    displayInitialWarning();
}
 
void nbgl_useCaseReviewStreamingContinueExt(const nbgl_contentTagValueList_t *tagValueList,
                                            nbgl_choiceCallback_t             choiceCallback,
                                            nbgl_callback_t                   skipCallback)
{
    uint8_t curNbDataSets = context.review.nbDataSets;
 
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                = STREAMING_CONTINUE_REVIEW_USE_CASE;
    context.operationType       = streamingOpType;
    context.review.tagValueList = tagValueList;
    context.review.onChoice     = choiceCallback;
    context.currentPage         = 0;
    context.nbPages             = tagValueList->nbPairs + 1;  // data + trick for review continue
    context.review.skipCallback = skipCallback;
    context.review.nbDataSets   = curNbDataSets + 1;
 
    displayStreamingReviewPage(FORWARD_DIRECTION);
}
 
void nbgl_useCaseReviewStreamingContinue(const nbgl_contentTagValueList_t *tagValueList,
                                         nbgl_choiceCallback_t             choiceCallback)
{
    nbgl_useCaseReviewStreamingContinueExt(tagValueList, choiceCallback, NULL);
}
 
void nbgl_useCaseReviewStreamingFinish(const char           *finishTitle,
                                       nbgl_choiceCallback_t choiceCallback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type               = STREAMING_FINISH_REVIEW_USE_CASE;
    context.operationType      = streamingOpType;
    context.review.onChoice    = choiceCallback;
    context.review.finishTitle = finishTitle;
    context.currentPage        = 0;
    context.nbPages            = 2;  // 2 pages at the end for accept/reject
 
    displayStreamingReviewPage(FORWARD_DIRECTION);
}
 
void nbgl_useCaseSpinner(const char *text)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type        = SPINNER_USE_CASE;
    context.currentPage = 0;
    context.nbPages     = 1;
 
    displaySpinner(text);
}
 
void nbgl_useCaseChoice(const nbgl_icon_details_t *icon,
                        const char                *message,
                        const char                *subMessage,
                        const char                *confirmText,
                        const char                *cancelText,
                        nbgl_choiceCallback_t      callback)
{
    nbgl_useCaseChoiceWithDetails(
        icon, message, subMessage, confirmText, cancelText, NULL, callback);
};
 
void nbgl_useCaseChoiceWithDetails(const nbgl_icon_details_t *icon,
                                   const char                *message,
                                   const char                *subMessage,
                                   const char                *confirmText,
                                   const char                *cancelText,
                                   nbgl_genericDetails_t     *details,
                                   nbgl_choiceCallback_t      callback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type               = CHOICE_USE_CASE;
    context.choice.icon        = icon;
    context.choice.message     = message;
    context.choice.subMessage  = subMessage;
    context.choice.confirmText = confirmText;
    context.choice.cancelText  = cancelText;
    context.choice.onChoice    = callback;
    context.choice.details     = details;
    context.currentPage        = 0;
    context.nbPages            = 2;  // 2 pages for confirm/cancel
    if (message != NULL) {
        context.nbPages++;
        // if both icon and subMessage are non NULL, add a page
        if ((icon != NULL) && (subMessage != NULL)) {
            context.nbPages++;
        }
    }
    if (details != NULL) {
        // only the first level of details and BAR_LIST type are supported
        if (details->type == BAR_LIST_WARNING) {
            context.nbPages += details->barList.nbBars;
        }
    }
 
    displayChoicePage(FORWARD_DIRECTION);
};
 
void nbgl_useCaseConfirm(const char     *message,
                         const char     *subMessage,
                         const char     *confirmText,
                         const char     *cancelText,
                         nbgl_callback_t callback)
{
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                = CONFIRM_USE_CASE;
    context.confirm.message     = message;
    context.confirm.subMessage  = subMessage;
    context.confirm.confirmText = confirmText;
    context.confirm.cancelText  = cancelText;
    context.confirm.onConfirm   = callback;
    context.currentPage         = 0;
    context.nbPages             = 1 + 2;  // 2 pages at the end for confirm/cancel
 
    displayConfirm(FORWARD_DIRECTION);
}
 
void nbgl_useCaseAction(const nbgl_icon_details_t *icon,
                        const char                *message,
                        const char                *actionText,
                        nbgl_callback_t            callback)
{
    nbgl_layoutCenteredInfo_t centeredInfo = {0};
 
    UNUSED(actionText);
 
    // memorize callback in context
    memset(&context, 0, sizeof(UseCaseContext_t));
    context.type                  = ACTION_USE_CASE;
    context.action.actionCallback = callback;
 
    centeredInfo.icon  = icon;
    centeredInfo.text1 = message;
    centeredInfo.style = BOLD_TEXT1_INFO;
    nbgl_stepDrawCenteredInfo(0, useCaseActionCallback, NULL, &centeredInfo, false);
}
 
#ifdef NBGL_KEYPAD
void nbgl_useCaseKeypad(const char             *title,
                        uint8_t                 minDigits,
                        uint8_t                 maxDigits,
                        bool                    shuffled,
                        bool                    hidden,
                        nbgl_pinValidCallback_t validatePinCallback,
                        nbgl_callback_t         backCallback)
{
    nbgl_layoutDescription_t layoutDescription = {0};
    int                      status            = -1;
 
    // reset the keypad context
    memset(&context, 0, sizeof(KeypadContext_t));
    context.type                = KEYPAD_USE_CASE;
    context.currentPage         = 0;
    context.nbPages             = 1;
    context.keypad.validatePin  = validatePinCallback;
    context.keypad.backCallback = backCallback;
    context.keypad.pinMinDigits = minDigits;
    context.keypad.pinMaxDigits = maxDigits;
    context.keypad.hidden       = hidden;
    context.keypad.layoutCtx    = nbgl_layoutGet(&layoutDescription);
 
    // add keypad
    status = nbgl_layoutAddKeypad(context.keypad.layoutCtx, keypadCallback, title, shuffled);
    if (status < 0) {
        return;
    }
    context.keypad.keypadIndex = status;
    // add digits
    status = nbgl_layoutAddKeypadContent(context.keypad.layoutCtx, hidden, maxDigits, "");
    if (status < 0) {
        return;
    }
 
    nbgl_layoutDraw(context.keypad.layoutCtx);
    if (context.keypad.backCallback != NULL) {
        // force backspace to be visible at first digit, to be used as quit
        nbgl_layoutUpdateKeypad(context.keypad.layoutCtx, context.keypad.keypadIndex, false, true);
    }
    nbgl_refresh();
}
#endif  // NBGL_KEYPAD
 
#endif  // HAVE_SE_TOUCH
#endif  // NBGL_USE_CASE