1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
|
////////////////////////////////////////////////////////////////////////////////
//
// Copyright (c) 2006-2012 MStar Semiconductor, Inc.
// All rights reserved.
//
// Unless otherwise stipulated in writing, any and all information contained
// herein regardless in any format shall remain the sole proprietary of
// MStar Semiconductor Inc. and be kept in strict confidence
// (??MStar Confidential Information??) by the recipient.
// Any unauthorized act including without limitation unauthorized disclosure,
// copying, use, reproduction, sale, distribution, modification, disassembling,
// reverse engineering and compiling of the contents of MStar Confidential
// Information is unlawful and strictly prohibited. MStar hereby reserves the
// rights to any and all damages, losses, costs and expenses resulting therefrom.
//
////////////////////////////////////////////////////////////////////////////////
/**
*
* @file mstar_drv_self_fw_control.h
*
* @brief This file defines the interface of touch screen
*
* @version v2.2.0.0
*
*/
#ifndef __MSTAR_DRV_SELF_FW_CONTROL_H__
#define __MSTAR_DRV_SELF_FW_CONTROL_H__
/*--------------------------------------------------------------------------*/
/* INCLUDE FILE */
/*--------------------------------------------------------------------------*/
#include "mstar_drv_common.h"
/*--------------------------------------------------------------------------*/
/* COMPILE OPTION DEFINITION */
/*--------------------------------------------------------------------------*/
//#define CONFIG_SWAP_X_Y
//#define CONFIG_REVERSE_X
//#define CONFIG_REVERSE_Y
/*--------------------------------------------------------------------------*/
/* PREPROCESSOR CONSTANT DEFINITION */
/*--------------------------------------------------------------------------*/
#define DEMO_MODE_PACKET_LENGTH (8)
#define MAX_TOUCH_NUM (2)
#define MSG21XXA_FIRMWARE_MAIN_BLOCK_SIZE (32) //32K
#define MSG21XXA_FIRMWARE_INFO_BLOCK_SIZE (1) //1K
#define MSG21XXA_FIRMWARE_WHOLE_SIZE (MSG21XXA_FIRMWARE_MAIN_BLOCK_SIZE+MSG21XXA_FIRMWARE_INFO_BLOCK_SIZE) //33K
#define MSG22XX_FIRMWARE_MAIN_BLOCK_SIZE (48) //48K
#define MSG22XX_FIRMWARE_INFO_BLOCK_SIZE (512) //512Byte
#ifdef CONFIG_ENABLE_FIRMWARE_DATA_LOG
#define FIRMWARE_MODE_DEMO_MODE (0x00)
#define FIRMWARE_MODE_DEBUG_MODE (0x01)
#define FIRMWARE_MODE_RAW_DATA_MODE (0x02)
#endif //CONFIG_ENABLE_FIRMWARE_DATA_LOG
#ifdef CONFIG_UPDATE_FIRMWARE_BY_SW_ID
#define UPDATE_FIRMWARE_RETRY_COUNT (2)
#endif //CONFIG_UPDATE_FIRMWARE_BY_SW_ID
/*--------------------------------------------------------------------------*/
/* DATA TYPE DEFINITION */
/*--------------------------------------------------------------------------*/
typedef struct
{
u16 nX;
u16 nY;
} TouchPoint_t;
typedef struct
{
u8 nTouchKeyMode;
u8 nTouchKeyCode;
u8 nFingerNum;
TouchPoint_t tPoint[MAX_TOUCH_NUM];
} TouchInfo_t;
#ifdef CONFIG_ENABLE_FIRMWARE_DATA_LOG
typedef struct
{
u8 nFirmwareMode;
u8 nLogModePacketHeader;
u16 nLogModePacketLength;
u8 nIsCanChangeFirmwareMode;
} FirmwareInfo_t;
#endif //CONFIG_ENABLE_FIRMWARE_DATA_LOG
#ifdef CONFIG_UPDATE_FIRMWARE_BY_SW_ID
/*
* Note.
* The following is sw id enum definition for MSG22XX.
* 0x0000 and 0xFFFF are not allowed to be defined as SW ID.
* SW_ID_UNDEFINED is a reserved enum value, do not delete it or modify it.
* Please modify the SW ID of the below enum value depends on the TP vendor that you are using.
*/
typedef enum {
MSG22XX_SW_ID_XXXX = 0x0001,
MSG22XX_SW_ID_YYYY = 0x0002,
MSG22XX_SW_ID_UNDEFINED
} Msg22xxSwId_e;
/*
* Note.
* The following is sw id enum definition for MSG21XXA.
* SW_ID_UNDEFINED is a reserved enum value, do not delete it or modify it.
* Please modify the SW ID of the below enum value depends on the TP vendor that you are using.
*/
typedef enum {
MSG21XXA_SW_ID_XXXX = 0x0C,
MSG21XXA_SW_ID_YYYY,
MSG21XXA_SW_ID_UNDEFINED
} Msg21xxaSwId_e;
#endif //CONFIG_UPDATE_FIRMWARE_BY_SW_ID
/*--------------------------------------------------------------------------*/
/* GLOBAL FUNCTION DECLARATION */
/*--------------------------------------------------------------------------*/
#ifdef CONFIG_ENABLE_GESTURE_WAKEUP
extern void DrvFwCtrlOpenGestureWakeup(u16 nMode);
extern void DrvFwCtrlCloseGestureWakeup(void);
#endif //CONFIG_ENABLE_GESTURE_WAKEUP
#ifdef CONFIG_ENABLE_FIRMWARE_DATA_LOG
extern u16 DrvFwCtrlChangeFirmwareMode(u16 nMode);
extern void DrvFwCtrlGetFirmwareInfo(FirmwareInfo_t *pInfo);
extern void DrvFwCtrlRestoreFirmwareModeToLogDataMode(void);
#endif //CONFIG_ENABLE_FIRMWARE_DATA_LOG
#ifdef CONFIG_UPDATE_FIRMWARE_BY_SW_ID
extern void DrvFwCtrlCheckFirmwareUpdateBySwId(void);
#endif //CONFIG_UPDATE_FIRMWARE_BY_SW_ID
extern u8 DrvFwCtrlGetChipType(void);
extern void DrvFwCtrlGetCustomerFirmwareVersion(u16 *pMajor, u16 *pMinor, u8 **ppVersion);
extern void DrvFwCtrlGetPlatformFirmwareVersion(u8 **ppVersion);
extern void DrvFwCtrlHandleFingerTouch(void);
extern s32 DrvFwCtrlUpdateFirmware(u8 szFwData[][1024], EmemType_e eEmemType);
#endif /* __MSTAR_DRV_SELF_FW_CONTROL_H__ */
|
