bt8xxemu.h

Go to the documentation of this file.

 
#ifndef BT8XXEMU_H
#define BT8XXEMU_H
 
#ifdef _MSC_VER
#pragma warning(push)
#pragma warning(disable : 26812) // Unscoped enum
#endif
 
#include "bt8xxemu_inttypes.h"
 
#ifndef EVE_TCHAR_DEFINED
#define EVE_TCHAR_DEFINED
#ifdef _WIN32
typedef wchar_t eve_tchar_t;
#else
typedef char eve_tchar_t;
#endif
#endif
 
// API version is increased whenever BT8XXEMU_EmulatorParameters format changes or functions are modified
#define BT8XXEMU_VERSION_API 12
 
#ifdef BT8XXEMU_REMOTE
#ifndef _WIN32
#undef BT8XXEMU_REMOTE /* Not yet supported */
#else
#define BT8XXEMU_STATIC
#endif
#endif
 
#ifndef BT8XXEMU_STATIC
#ifdef BT8XXEMU_EXPORT_DYNAMIC
#ifdef _WIN32
#define BT8XXEMU_API __declspec(dllexport)
#else
#define BT8XXEMU_API
#endif
#else
#ifdef _WIN32
#define BT8XXEMU_API __declspec(dllimport)
#else
#define BT8XXEMU_API
#endif
#endif
#else
#define BT8XXEMU_API
#endif
 
#ifdef __cplusplus
 
namespace BT8XXEMU
{
class Emulator;
class Flash;
}
 
typedef BT8XXEMU::Emulator BT8XXEMU_Emulator;
typedef BT8XXEMU::Flash BT8XXEMU_Flash;
 
#elif defined(BT8XXEMU_REMOTE)
 
typedef struct BT8XXEMUC_Remote BT8XXEMU_Emulator;
typedef struct BT8XXEMUC_Remote BT8XXEMU_Flash;
 
#else
 
typedef void BT8XXEMU_Emulator;
typedef void BT8XXEMU_Flash;
 
#endif /* #ifdef __cplusplus */
 
typedef enum
{
    BT8XXEMU_LogError = 0,      
    BT8XXEMU_LogWarning = 1,    
    BT8XXEMU_LogMessage = 2,    
} BT8XXEMU_LogType;
 
typedef enum
{
    BT8XXEMU_EmulatorFT800 = 0x0800,    
    BT8XXEMU_EmulatorFT801 = 0x0801,    
    BT8XXEMU_EmulatorFT810 = 0x0810,    
    BT8XXEMU_EmulatorFT811 = 0x0811,    
    BT8XXEMU_EmulatorFT812 = 0x0812,    
    BT8XXEMU_EmulatorFT813 = 0x0813,    
    BT8XXEMU_EmulatorBT880 = 0x0880,    
    BT8XXEMU_EmulatorBT881 = 0x0881,    
    BT8XXEMU_EmulatorBT882 = 0x0882,    
    BT8XXEMU_EmulatorBT883 = 0x0883,    
    BT8XXEMU_EmulatorBT815 = 0x0815,    
    BT8XXEMU_EmulatorBT816 = 0x0816,    
    BT8XXEMU_EmulatorBT817 = 0x0817,    
    BT8XXEMU_EmulatorBT818 = 0x0818,    
} BT8XXEMU_EmulatorMode;
 
typedef enum
{
    BT8XXEMU_EmulatorEnableKeyboard = 0x01,                 
    BT8XXEMU_EmulatorEnableAudio = 0x02,                    
    BT8XXEMU_EmulatorEnableCoprocessor = 0x04,              
    BT8XXEMU_EmulatorEnableMouse = 0x08,                    
    BT8XXEMU_EmulatorEnableDebugShortkeys = 0x10,           
    BT8XXEMU_EmulatorEnableGraphicsMultithread = 0x20,      
    BT8XXEMU_EmulatorEnableDynamicDegrade = 0x40,           
    // BT8XXEMU_EmulatorEnableRegRotate = 0x80,             /**< 0x80; Now always on; enable usage of REG_ROTATE (default: off) */
    BT8XXEMU_EmulatorEnableRegPwmDutyEmulation = 0x100,     
    BT8XXEMU_EmulatorEnableTouchTransformation = 0x200,     
    BT8XXEMU_EmulatorEnableStdOut = 0x400,                  
    BT8XXEMU_EmulatorEnableBackgroundPerformance = 0x800,   
    BT8XXEMU_EmulatorEnableMainPerformance = 0x1000,        
    BT8XXEMU_EmulatorEnableHSFPreview = 0x2000,             
} BT8XXEMU_EmulatorFlags;
 
typedef enum
{
    BT8XXEMU_FrameBufferChanged = 0x01,     
    BT8XXEMU_FrameBufferComplete = 0x02,    
    BT8XXEMU_FrameChanged = 0x04,           
    BT8XXEMU_FrameSwap = 0x08,              
} BT8XXEMU_FrameFlags;
 
typedef struct
{
    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);
 
    // Interrupt handler
    // void (*Interrupt)(void *sender, void *context);
 
    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; 
 
} BT8XXEMU_EmulatorParameters;
 
typedef struct
{
    eve_tchar_t DeviceType[26]; 
 
    ptrdiff_t SizeBytes; 
 
    eve_tchar_t DataFilePath[260]; 
 
    eve_tchar_t StatusFilePath[260]; 
 
    int Persistent;
 
    int StdOut; 
 
    void *Data;
    ptrdiff_t DataSizeBytes;
 
    void (*Log)(BT8XXEMU_Flash *sender, void *context, BT8XXEMU_LogType type, const char *message); 
 
    void *UserContext; 
 
} BT8XXEMU_FlashParameters;
 
#ifdef __cplusplus
extern "C" {
#endif
 
// INIT //
 
 
BT8XXEMU_API extern const char *BT8XXEMU_version();
 
BT8XXEMU_API extern void BT8XXEMU_defaults(uint32_t versionApi, BT8XXEMU_EmulatorParameters *params, BT8XXEMU_EmulatorMode mode);
 
BT8XXEMU_API extern void BT8XXEMU_run(uint32_t versionApi, BT8XXEMU_Emulator **emulator, const BT8XXEMU_EmulatorParameters *params);
 
BT8XXEMU_API extern void BT8XXEMU_stop(BT8XXEMU_Emulator *emulator);
 
BT8XXEMU_API extern void BT8XXEMU_destroy(BT8XXEMU_Emulator *emulator);
 
BT8XXEMU_API extern int BT8XXEMU_isRunning(BT8XXEMU_Emulator *emulator);
 
// RUNTIME //
 
 
BT8XXEMU_API extern uint8_t BT8XXEMU_transfer(BT8XXEMU_Emulator *emulator, uint8_t data);
 
BT8XXEMU_API extern void BT8XXEMU_chipSelect(BT8XXEMU_Emulator *, int cs);
 
BT8XXEMU_API extern int BT8XXEMU_hasInterrupt(BT8XXEMU_Emulator *emulator);
 
// ADVANCED //
 
 
BT8XXEMU_API extern void BT8XXEMU_touchSetXY(BT8XXEMU_Emulator *emulator, int idx, int x, int y, int pressure);
 
BT8XXEMU_API extern void BT8XXEMU_touchResetXY(BT8XXEMU_Emulator *emulator, int idx);
 
BT8XXEMU_API extern int BT8XXEMU_setFlag(BT8XXEMU_Emulator *emulator, BT8XXEMU_EmulatorFlags flag, int value);
 
// FLASH //
 
#ifndef BT8XXEMU_FLASH_LIBRARY
 
BT8XXEMU_API extern void BT8XXEMU_Flash_defaults(uint32_t versionApi, BT8XXEMU_FlashParameters *params);
 
BT8XXEMU_API extern BT8XXEMU_Flash *BT8XXEMU_Flash_create(uint32_t versionApi, const BT8XXEMU_FlashParameters *params);
 
BT8XXEMU_API extern void BT8XXEMU_Flash_destroy(BT8XXEMU_Flash *flash);
 
BT8XXEMU_API extern uint8_t BT8XXEMU_Flash_transferSpi4(BT8XXEMU_Flash *flash, uint8_t signal);
 
#endif
 
#ifdef __cplusplus
} /* extern "C" */
#endif
 
#ifdef _MSC_VER
#pragma warning(pop)
#endif
 
#endif /* #ifndef BT8XXEMU_H */
 
/* end of file */