emu_view.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdint.h>
#include <unicorn/unicorn.h>
 
#include "board_overlay.h"
#include "emu_presentation.h"
#include "ra8_attributes.h"
 
#ifdef __cplusplus
extern "C" {
#endif

typedef enum : uint8_t {
  k_emu_sw_port = 0U, 
  k_emu_sw1_pin = 9U, 
  k_emu_sw2_pin = 8U, 
} emu_sw_pin_t;
 
/* Live-view (--view) and snapshot (--ppm) presentation settings. */
typedef enum : uint32_t {
  k_view_default_w     = 1024U,    
  k_view_default_h     = 600U,     
  k_view_present_every = 16U,      
  k_view_max_chunks    = 4000000U, 
  k_view_idle_us       = 16000U,   
  k_view_frame_us      = 16000U,   
  k_view_yield_us      = 2000U,    
  k_us_per_s           = 1000000U, 
  k_ns_per_us          = 1000U,    
  k_uart_log_max       = 64U,      
  k_reboot_settle      = 1500U,    
  /* --record settings. One outer chunk advances SysTick once (~1 ms of emulated
   * time at the firmware's 1 kHz tick), so ~1000 chunks == one emulated second.
   * Recording dumps a frame every k_record_every chunks for k_record_fps fps. */
  k_record_ms_per_sec = 1000U, 
  k_record_fps        = 20U,   
  k_record_every      = 50U,   
} view_cfg_t;

typedef enum : uint8_t {
  k_core_m85 = 0U, 
  k_core_m33 = 1U, 
} board_primary_core_t;

typedef enum : uint32_t {
  k_rotate_0   = 0U,   
  k_rotate_90  = 90U,  
  k_rotate_180 = 180U, 
  k_rotate_270 = 270U, 
} panel_rotate_t;
 
typedef enum : uint32_t {
  k_strtol_base10  = 10U,   
  k_panel_line_max = 256U,  
  k_panel_name_max = 64U,   
  k_panel_dim_max  = 4096U, 
} panel_limits_t;

typedef struct {
  char     name[k_panel_name_max]; 
  uint16_t width;                  
  uint16_t height;                 
} board_panel_t;

int write_ppm(const char* path, const emu_presentation_workspace_t* presentation);

void unrotate_click(uint16_t  cx,
                    uint16_t  cy,
                    uint16_t  panel_w,
                    uint16_t  panel_h,
                    uint32_t  deg,
                    uint16_t* nx,
                    uint16_t* ny);

void set_switch(board_overlay_btn_t btn, bool pressed);

void apply_battery_click(board_overlay_btn_t btn, uint16_t cx, uint16_t disp_w);

board_overlay_btn_t route_click(uint16_t cx,
                                uint16_t cy,
                                uint16_t panel_w,
                                uint16_t panel_h,
                                uint16_t disp_w,
                                uint32_t rotate_deg);

bool build_composite(uc_engine*                    uc,
                     emu_presentation_workspace_t* presentation,
                     const char*                   app_name);

bool load_panel(const char* path, board_panel_t* out);

void emu_view_publish(uint32_t pc, uint32_t chunks);

void emu_view_mark_stopped(uint32_t pc);

void emu_view_wheel(int32_t notches);

void emu_view_select_console_tab(uint32_t tab_idx);

void emu_view_reset_console(void);

board_primary_core_t emu_primary_core(void);

void emu_set_primary_core(board_primary_core_t core);

bool emu_low_power(void);

void emu_set_low_power(bool on);
 
#ifdef __cplusplus
}
#endif