Release Date: May 29, 2007
Revision: 0.30
Preliminary (Released) Information
Document Number:
High-Level Design Document and User Manual
Mobile Development
Integrated System (MoDIS)
MediaTek
Mobile Development Integrated System (MoDIS)
Preliminary Information High Level Design Document and User Manual
MediaTek Confidential
Revision 0.20 – August 14, 2006 Page: 2 of 71
© 2006 MediaTek Inc.
The information contained in this document can be modified without notice.
Legal Disclaimer
BY OPENING OR USING THIS FILE, BUYER HEREBY UNEQUIVOCALLY ACKNOWLEDGES AND AGREES THAT
THE SOFTWARE/FIRMWARE AND ITS DOCUMENTATIONS (“MoDIS”) RECEIVED FROM MEDIATEK AND/OR ITS
REPRESENTATIVES ARE PROVIDED TO BUYER ON AN “AS-IS” BASIS ONLY. MEDIATEK EXPRESSLY
DISCLAIMS ANY AND ALL WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
IMPLIED WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE OR
NONINFRINGEMENT. NEITHER DOES MEDIATEK PROVIDE ANY WARRANTY WHATSOEVER WITH RESPECT
TO THE SOFTWARE OF ANY THIRD PARTY WHICH MAY BE USED BY, INCORPORATED IN, OR SUPPLIED
WITH THE MEDIATEK SOFTWARE, AND BUYER AGREES TO LOOK ONLY TO SUCH THIRD PARTY FOR ANY
WARRANTY CLAIM RELATING THERETO. MEDIATEK SHALL ALSO NOT BE RESPONSIBLE FOR ANY
MEDIATEK SOFTWARE RELEASES MADE TO BUYER’S SPECIFICATION OR TO CONFORM TO A PARTICULAR
STANDARD OR OPEN FORUM.
BUYER'S SOLE AND EXCLUSIVE REMEDY AND MEDIATEK'S ENTIRE AND CUMULATIVE LIABILITY WITH
RESPECT TO THE MEDIATEK SOFTWARE RELEASED HEREUNDER WILL BE, AT MEDIATEK'S OPTION, TO
REVISE OR REPLACE THE MEDIATEK SOFTWARE AT ISSUE, OR REFUND ANY SOFTWARE LICENSE FEES
OR SERVICE CHARGE PAID BY BUYER TO MEDIATEK FOR SUCH MEDIATEK SOFTWARE AT ISSUE.
THE TRANSACTION CONTEMPLATED HEREUNDER SHALL BE CONSTRUED IN ACCORDANCE WITH THE
LAWS OF THE STATE OF CALIFORNIA, USA, EXCLUDING ITS CONFLICT OF LAWS PRINCIPLES.
Mobile Development Integrated System (MoDIS)
Preliminary Information High Level Design Document and User Manual
MediaTek Confidential
Revision 0.20 – August 14, 2006 Page: 3 of 71
© 2006 MediaTek Inc.
The information contained in this document can be modified without notice.
Revision History
Revision Date (yyyy/mm/dd) Author Comments
0.00 2006/02/15 Max Chen Initial version
0.01 2006/03/19 KS Hsueh
Add Section 5.1 (UART)
0.02 2006/03/19 JI Huang
Add Chapter 3 (File System)
0.03 2006/03/20 Gilbert Wang
Add Section 10.2 (How to Check Call Stack in MoDIS)
0.04 2006/03/24 Karen Hsu
Add Chapter 8 (OS Core Adapter)
0.05 2006/03/25 JI Huang Update File System Simulator Run-Time Configuration in
Section 3.1
0.06 2006/03/26 Joe Wang
Add Chapter 2 (Start Using MoDIS) (draft)
0.07 2006/03/28 PC Huang
Add Chapter 5.3 (LCD Interfaces)
0.08 2006/03/31 Bear Wang
Add Chapter 9 (Add-in Tools)
0.09 2006/04/01 PH Shih
Add Chapter 5.2 (SIM Simulator)
0.10 2006/04/10 Max Chen
Add Chapter 1 (Introduction)
0.11 2006/04/10 KS Hsueh
Add Chapter 7.1 (Log Messages via Catcher)
0.12 2006/04/13 Cylen Yao
Add Chapter 10.1 (How to Format NVRAM)
0.13 2006/04/17 Joe Wang
Refine Chapter 2 (Start Using MoDIS)
0.14 2006/06/13 Naomi Ko English review and document formatting.
0.15 2006/06/30 Wayne Chen
Refine Chapter 9.1 (Skin Layout and Version): add Skin,
LCD Screen and Sub LCD Screen resizing
0.17 2006/07/16 JI Huang
Update Chapter 3.3 to Sync File System API Notes
0.18 2006/07/18 Leo Hu
Update Chapter 2.8 for resource management under
Vendor Release mode.
0.19 2006/07/19 Bear Wang
Update Chapter 2.8 for sample code
0.20 2006/08/14 Naomi Ko English review and document formatting.
0.30 2007/05/30 KS Hsueh Add Ch5.2.2.5-4, Ch6, Ch10
Mobile Development Integrated System (MoDIS)
Preliminary Information High Level Design Document and User Manual
MediaTek Confidential
Revision 0.20 – August 14, 2006 Page: 4 of 71
© 2006 MediaTek Inc.
The information contained in this document can be modified without notice.
Table of Contents
Legal Disclaimer.......................................................................................................................................................... 2
Revision History .......................................................................................................................................................... 3
Table of Contents......................................................................................................................................................... 4
1 Introduction ...................................................................................................................................................... 8
1.1 Overview.................................................................................................................................................... 8
1.2 System Requirement ................................................................................................................................. 8
1.3 Function and Feature List .......................................................................................................................... 9
1.4 File and Folder Structure............................................................................................................................ 9
1.4.1 Major Folders ..................................................................................................................................... 10
1.4.2 Major Files.......................................................................................................................................... 10
1.5 Terms and Definitions ...............................................................................................................................11
2 Start Using MoDIS.......................................................................................................................................... 12
2.1 Build Environment Settings...................................................................................................................... 12
2.2 Configure the MoDIS Workspace Based on Target Load......................................................................... 12
2.2.1 createMoDIS.ini.................................................................................................................................. 13
2.2.2 GLOBAL_SETTINGS Section............................................................................................................ 14
2.2.3 ENABLE_INC_PATH and DISABLE_INC_PATH Sections................................................................. 14
2.2.4 ENABLE_OPTION and DISABLE_OPTION Sections........................................................................ 14
2.2.5 ENABLE_FILE and DISABLE_FILE Sections .................................................................................... 14
2.3 Generate a MoDIS Workspace by Target Load........................................................................................ 14
2.3.1 Generate a MoDIS Project Using the “make” Command.................................................................... 14
2.3.2 Generate a MoDIS Project Using the Batch Utility ............................................................................. 14
2.3.3 Generation Result .............................................................................................................................. 14
2.4 Database Codegen.................................................................................................................................. 15
2.4.1 Database Codegen Using the “make” Command............................................................................... 15
2.4.2 Database Codegen Using the Batch Utility ........................................................................................15
2.5 Compile the Source Code........................................................................................................................ 15
2.5.1 Compile the Source Code Using Microsoft Visual C++ ...................................................................... 15
2.5.2 Compile the Source Code Using the “make” Command..................................................................... 16
2.5.3 Compile the Source Code Using the Batch Utility .............................................................................. 16
2.6 Slim MoDIS.............................................................................................................................................. 16
2.7 Summary of MoDIS Build Command ....................................................................................................... 17
2.8 Vendor Release Sample Code................................................................................................................. 17
3 File System ..................................................................................................................................................... 18
3.1 Overview.................................................................................................................................................. 18
3.2 Design...................................................................................................................................................... 18
3.3 Interfaces/API .......................................................................................................................................... 19
3.3.1 FS_OpenHint() does not speed up..................................................................................................... 19
3.3.2 FS_Extend() does not allocate any clusters....................................................................................... 19
3.3.3 FS_SetSeekHint() does nothing......................................................................................................... 19
3.3.4 FS_GetFirstClusterValue() returns a random integer. ........................................................................ 19
3.3.5 FS_CheckFile() does nothing............................................................................................................. 20
Mobile Development Integrated System (MoDIS)
Preliminary Information High Level Design Document and User Manual
MediaTek Confidential
Revision 0.20 – August 14, 2006 Page: 5 of 71
© 2006 MediaTek Inc.
The information contained in this document can be modified without notice.
3.3.6 FS_GetFolderSize() calculates size on ideal folder assumption. ....................................................... 20
3.3.7 FS_QmGetFree() is based on pseudo disk space calculation............................................................ 20
3.3.8 FS_Abort() cannot abort FS_CheckDrive() and FS_XDelete()........................................................... 20
3.3.9 FS_GetDevStatus() does not support the FS_FEATURE_STATE_ENUM query................................ 20
3.3.10 FS_TestMSDC() always returns FS_MSDC_NOT_PRESENT. .......................................................... 20
3.3.11 FS_CloseMSDC() is an empty function.............................................................................................. 20
3.3.12 FS_CreateBootSector() always returns 32 (meaning FAT32). ........................................................... 20
3.3.13 FS_GetPartitionInfo() fills fake data.................................................................................................... 20
3.3.14 FS_CheckDrive() is an empty function............................................................................................... 20
3.3.15 FS_CreateMasterBootRecord() is an empty function......................................................................... 21
3.3.16 FS_SplitPartition() is an empty function.............................................................................................. 21
3.3.17 FS_Shutdown() is an empty function.................................................................................................. 21
3.3.18 FS_UnlockAll() is an empty function................................................................................................... 21
3.3.19 FS_SanityCheck() tries to trigger fssim_init() only.............................................................................. 21
3.3.20 FS_SetDiskFlag() is an empty function. ............................................................................................. 21
3.3.21 FS_CheckDiskFlag() is an empty function. ........................................................................................21
3.3.22 FS_ClearDiskFlag() is an empty function........................................................................................... 21
3.3.23 FS_LockFAT() is an empty function.................................................................................................... 21
3.3.24 FS_SetTrace() is an empty function................................................................................................... 21
3.3.25 FS_DumpFHTable() is an empty function...........................................................................................21
3.3.26 FS_SetDirCache() is an empty function. ............................................................................................ 22
3.3.27 FS_GetDirCache () always returns FS_DIRCACHE_EXPIRED......................................................... 22
3.3.28 FS_OTPRead() is an empty function.................................................................................................. 22
3.3.29 FS_OTPWrite() is an empty function.................................................................................................. 22
3.3.30 FS_OTPQueryLength() is an empty function. .................................................................................... 22
3.3.31 FS_SweepDevice() is an empty function............................................................................................ 22
4 Network Ability ............................................................................................................................................... 23
4.1 Socket...................................................................................................................................................... 23
4.1.1 Overview ............................................................................................................................................ 23
4.1.2 Design................................................................................................................................................ 23
4.1.3 Interfaces/API..................................................................................................................................... 24
4.1.3.1 soc_create() ........................................................................................................................................ 24
4.1.3.2 soc_shutdown() is an empty function. ................................................................................................. 24
4.1.3.3 soc_select() is an empty function. ....................................................................................................... 24
4.1.3.4 soc_setsockopt() only supports SOC_NBIO and SOC_ASYNC.......................................................... 24
4.1.3.5 soc_getsockopt() only supports SOC_NBIO and SOC_ASYNC. ........................................................ 24
4.1.3.6 soc_gethostbyname() only blocking is supported................................................................................ 25
4.1.3.7 soc_gethostbyaddr() is an empty function........................................................................................... 25
4.1.3.8 soc_get_last_error() is an empty function. .......................................................................................... 25
4.1.3.9 soc_set_last_error() is an empty function............................................................................................ 25
4.1.3.10 soc_abort_dns_query() is an empty function....................................................................................... 25
5 Driver Simulating............................................................................................................................................ 26
5.1 UART....................................................................................................................................................... 26
5.1.1 Overview ............................................................................................................................................ 26
5.1.2 Design................................................................................................................................................ 26
5.1.3 Virtual COM Port ................................................................................................................................ 26
5.1.4 Interfaces/API..................................................................................................................................... 27
- 1
- 2
前往页