image/svg+xml
Brteve's API for EveApps
Version 0.0.1
The reference document for common folder of EveApps project.
 
Loading...
Searching...
No Matches
Data Fields
BT8XXEMU_EmulatorParameters Struct Reference

#include <bt8xxemu.h>

Data Fields

void(* Main )(BT8XXEMU_Emulator *sender, void *context)
 
int Flags
 
BT8XXEMU_EmulatorMode Mode
 
uint32_t MousePressure
 
uint32_t ExternalFrequency
 
uint32_t ReduceGraphicsThreads
 
void(* MCUSleep )(BT8XXEMU_Emulator *sender, void *context, int ms)
 
eve_tchar_t RomFilePath [260]
 
eve_tchar_t OtpFilePath [260]
 
eve_tchar_t CoprocessorRomFilePath [260]
 
int(* Graphics )(BT8XXEMU_Emulator *sender, void *context, int output, const argb8888 *buffer, uint32_t hsize, uint32_t vsize, BT8XXEMU_FrameFlags flags)
 
void(* Log )(BT8XXEMU_Emulator *sender, void *context, BT8XXEMU_LogType type, const char *message)
 
void(* Close )(BT8XXEMU_Emulator *sender, void *context)
 
void * UserContext
 
BT8XXEMU_Flash * Flash
 

Detailed Description

Definition at line 177 of file bt8xxemu.h.

Field Documentation

◆ Close

void(* BT8XXEMU_EmulatorParameters::Close) (BT8XXEMU_Emulator *sender, void *context)

Safe exit. Called when the emulator window is closed

Definition at line 233 of file bt8xxemu.h.

◆ CoprocessorRomFilePath

eve_tchar_t BT8XXEMU_EmulatorParameters::CoprocessorRomFilePath[260]

Replaces the builtin coprocessor ROM. NOTE: String is copied and may be deallocated after call to run(...)

Definition at line 205 of file bt8xxemu.h.

◆ ExternalFrequency

uint32_t BT8XXEMU_EmulatorParameters::ExternalFrequency

External frequency. See CLK, etc.

Definition at line 189 of file bt8xxemu.h.

◆ Flags

int BT8XXEMU_EmulatorParameters::Flags

See EmulatorFlags.

Definition at line 182 of file bt8xxemu.h.

◆ Flash

BT8XXEMU_Flash* BT8XXEMU_EmulatorParameters::Flash

Flash device to connect with, default NULL

Definition at line 239 of file bt8xxemu.h.

◆ Graphics

int(* BT8XXEMU_EmulatorParameters::Graphics) (BT8XXEMU_Emulator *sender, void *context, int output, const argb8888 *buffer, uint32_t hsize, uint32_t vsize, BT8XXEMU_FrameFlags flags)

Graphics driverless mode

Setting this callback means no window will be created, and all rendered graphics will be automatically sent to this function.

For enabling touch functionality, the functions Memory.setTouchScreenXY and Memory.resetTouchScreenXY must be called manually from the host application.

Builtin keyboard functionality is not supported and must be implemented manually when using this mode.

The output parameter is false (0) when the display is turned off. The contents of the buffer pointer are undefined after this function returns. Create a copy to use it on another thread.

Returns
false (0) when the application must exit, otherwise return true (1).

Definition at line 224 of file bt8xxemu.h.

◆ Log

void(* BT8XXEMU_EmulatorParameters::Log) (BT8XXEMU_Emulator *sender, void *context, BT8XXEMU_LogType type, const char *message)

Log callback

Definition at line 230 of file bt8xxemu.h.

◆ Main

void(* BT8XXEMU_EmulatorParameters::Main) (BT8XXEMU_Emulator *sender, void *context)

Microcontroller main function.This will be run on a new thread managed by the emulator.When not provided the calling thread is assumed to be the MCU thread

Definition at line 180 of file bt8xxemu.h.

◆ MCUSleep

void(* BT8XXEMU_EmulatorParameters::MCUSleep) (BT8XXEMU_Emulator *sender, void *context, int ms)

Sleep function for MCU thread usage throttle. Defaults to generic system sleep

Definition at line 195 of file bt8xxemu.h.

◆ Mode

BT8XXEMU_EmulatorMode BT8XXEMU_EmulatorParameters::Mode

Emulator mode

Definition at line 184 of file bt8xxemu.h.

◆ MousePressure

uint32_t BT8XXEMU_EmulatorParameters::MousePressure

The default mouse pressure, default 0 (maximum). See REG_TOUCH_RZTRESH, etc.

Definition at line 187 of file bt8xxemu.h.

◆ OtpFilePath

eve_tchar_t BT8XXEMU_EmulatorParameters::OtpFilePath[260]

Replaces the default builtin OTP with a custom OTP from a file. NOTE: String is copied and may be deallocated after call to run(...)

Definition at line 202 of file bt8xxemu.h.

◆ ReduceGraphicsThreads

uint32_t BT8XXEMU_EmulatorParameters::ReduceGraphicsThreads

Reduce graphics processor threads by specified number, default 0. Necessary when doing very heavy work on the MCU or Coprocessor

Definition at line 192 of file bt8xxemu.h.

◆ RomFilePath

eve_tchar_t BT8XXEMU_EmulatorParameters::RomFilePath[260]

Replaces the default builtin ROM with a custom ROM from a file. NOTE: String is copied and may be deallocated after call to run(...)

Definition at line 199 of file bt8xxemu.h.

◆ UserContext

void* BT8XXEMU_EmulatorParameters::UserContext

User context that will be passed along to callbacks

Definition at line 236 of file bt8xxemu.h.

The documentation for this struct was generated from the following file: