ux_nbgl.h

Go to the documentation of this file.

 
/*******************************************************************************
 *   Ledger Nano S - Secure firmware
 *   (c) 2022 Ledger
 *
 *  Licensed under the Apache License, Version 2.0 (the "License");
 *  you may not use this file except in compliance with the License.
 *  You may obtain a copy of the License at
 *
 *      http://www.apache.org/licenses/LICENSE-2.0
 *
 *  Unless required by applicable law or agreed to in writing, software
 *  distributed under the License is distributed on an "AS IS" BASIS,
 *  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 *  See the License for the specific language governing permissions and
 *  limitations under the License.
 ********************************************************************************/
 
#pragma once
 
#include "os_math.h"
#include "os_ux.h"
#include "os_task.h"
#include "nbgl_screen.h"
#include "nbgl_touch.h"
#include "seproxyhal_protocol.h"
 
#include <string.h>
 
#define BUTTON_LEFT  SEPROXYHAL_TAG_BUTTON_PUSH_EVENT_LEFT
#define BUTTON_RIGHT SEPROXYHAL_TAG_BUTTON_PUSH_EVENT_RIGHT
 
typedef struct ux_state_s ux_state_t;
 
struct ux_state_s {
    bolos_task_status_t exit_code;
    bool validate_pin_from_dashboard;  // set to true when BOLOS_UX_VALIDATE_PIN is received from
                                       // Dashboard task
 
    char string_buffer[128];
};
 
extern ux_state_t G_ux;
extern bolos_ux_params_t G_ux_params;
 
extern void ux_process_finger_event(const uint8_t seph_packet[]);
extern void ux_process_button_event(const uint8_t seph_packet[]);
extern void ux_process_ticker_event(void);
extern void ux_process_default_event(void);
 
#define UX_INIT() nbgl_objInit();
 
#define UX_WAKE_UP()                      \
    G_ux_params.ux_id = BOLOS_UX_WAKE_UP; \
    G_ux_params.len   = 0;                \
    os_ux(&G_ux_params);                  \
    G_ux_params.len = os_sched_last_status(TASK_BOLOS_UX);
 
#ifdef HAVE_SE_TOUCH
#define UX_BUTTON_PUSH_EVENT(seph_packet)
#else  // HAVE_SE_TOUCH
#define UX_BUTTON_PUSH_EVENT(seph_packet) ux_process_button_event(seph_packet)
#endif  // HAVE_SE_TOUCH
 
#ifdef HAVE_SE_TOUCH
#define UX_FINGER_EVENT(seph_packet) ux_process_finger_event(seph_packet)
#else  // HAVE_SE_TOUCH
#define UX_FINGER_EVENT(seph_packet)
#endif  // HAVE_SE_TOUCH
 
#define UX_TICKER_EVENT(seph_packet, callback) ux_process_ticker_event()
 
#define UX_DEFAULT_EVENT() ux_process_default_event()
 
// discriminated from io to allow for different memory placement
typedef struct ux_seph_s {
    unsigned int button_mask;
    unsigned int button_same_mask_counter;
#ifdef HAVE_BOLOS
    unsigned int ux_id;
    unsigned int ux_status;
#endif  // HAVE_BOLOS
} ux_seph_os_and_app_t;
 
extern ux_seph_os_and_app_t G_ux_os;
 
#include "glyphs.h"