GM03-16bit Library and Sample Code User`s Manual
Contents
1. Generalplus Technology Inc PAGE 6 V2 0 May 05 2009 G Generalplus GMO03 16bit Library and Sample Code User s Manual 3 API Functions Description 3 1 API Function List of Library 1 F GMOS3 Initial F GM03 SetMode F GMO03 Decode Start F GM03 Get RemainFrame Num F GMO03 Decode ServiceLoop C1 J N 3 2 API Function Description Void F GMO3 Initial int isGrayorMono Description Desc This function is to set decode format to Gray or Mon Input isGrayorMono 0 is Mono 1 is Gray Output Null void F GMOS3 SetMode int Mode Description Desc This function is to set decode format to Auto mod or Manual mode Input Mode 0 Auto mode 1 Manual mode Output Null void GMOS3 Decode Start int Index Description Desc If Auto mode is selected users should assign GMO3 resource index After this function is completed first frame will be decoded Input Index The GMO03 resource index of GMO3 Resource Table Output Null int GMO3 Decode ServiceLoop voidg Description Desc GMO3 library will decode next frame when this function is called Input Null Output return 1 GMO03 decode is completed return 0 GMO3 decode is not completed2. int F GMO3 Get RemainFrame Num void Description Desc GMO3 library will return the remaining frame number when this function is called Input Null Output Remaining frame number Generalplus Technology Inc PAGE 7 V2 0 May 05 2009 G Generalplus GMO03 16bit Library and Sample Code User s Manual 4 Variables Description 4 1 Variable List of Library Index syntax 1 R Frame Data Size R GMO03 Frame Wiath R GrayorMono Flag R Dec In Length R GMO038 DEC Out Buffer R GMOS3 DEC In Buffer Oo jo jo N 4 2 Variable Description R_Frame_Data_Size This variable is public from GMOS Library lt will show the byte number of GM03 Decode out raw data size R GMO03 Frame Width This variable is public from GMOS Library lt will show the pixel number of frame width R GrayorMono Flag This variable is public from GMO3 Library It will show the decoding GMO03 type is Gray or Mono R Dec In Length This variable is public from GMOS3 Library Users should write decode in buffer length to this variable when selecting Manual mode R GMO03 DEC Out Buffer This variable is public from GMO3 User asm Users should designate one decode out buffer for GM03 library to store decode out data R GMO03 DEC In Buffer This variable is public from GMO3 User asm Users should designate one decode in buffer for GMO3 library to read Decode in data Th
3. G Generalplus GM03 16bit Library and Sample Code User s Manual V2 0 May 5 09 3F No 8 Dusing Rd Hsinchu Science Park Hsinchu City 30078 Taiwan R O C Tel 886 3 6662118 Fax 886 3 6662117 Web www generalplus com G Generalplus GMO03 16bit Library and Sample Code User s Manual Important Notice GENERALPLUS TECHNOLOGY INC reserves the right to change this documentation without prior notice Information provided by GENERALPLUS TECHNOLOGY INC is believed to be accurate and reliable However GENERALPLUS TECHNOLOGY INC makes no warranty for any errors which may appear in this document Contact GENERALPLUS TECHNOLOGY INC to obtain the latest version of device specifications before placing your order No responsibility is assumed by GENERALPLUS TECHNOLOGY INC for any infringement of patent or other rights of third parties which may result from its use In addition GENERALPLUS products are not authorized for use as critical components in life support systems or aviation systems where a malfunction or failure of the product may reasonably be expected to result in significant injury to the user without the express written approval of Generalplus Generalplus Documentation The following documents are available from Generalplus These documents provide useful information regarding the software programming and application designing xxx Instruction set user s manual This document explains the xxx instru
4. RIPTION e eee ee ee eroe tn sesto sesto enses sn ese eo aes eaae sesso eee so sese eaae e seen s sata sesta 9 5 1 FUNCTION EIST OF GMO3 USERASM s esee scs vere Ep PEE US RSEN FREE VEEo ERAS KEEN EIAS EESTI ENS sssasuees FERES SER CR FERE N S REX SEE e Eae ENTE 9 5 2 USER S FUNCTION DESCRIPTION 5 eterne bv Torte i erre bei Pie Pr Po e Pe tret NE voie ie Pecbestvi steer ete dei E re He kde una 9 6 GMO03 USER S FUNCTION DESCRIPTION sscssssssssssssscscssscssssccsscecscsscsencssnsssessccscsscnecssensssssecsessssseccssssssssscssssssocces 10 6 1 EXAMPLES tienen iiie ENIMS 10 D e AME Generalplus Technology Inc PAGE 3 V2 0 May 05 2009 G Generalplus GMO03 16bit Library and Sample Code User s Manual Revision History Revision Date By Remark 2 0 2009 05 05 Wilson Wu 1 Add Mono animation GMO3 Decode function 1 0 2009 02 25 Wilson Wu First edition Generalplus Technology Inc PAGE 4 V2 0 May 05 2009 G Generalplus GMO03 16bit Library and Sample Code User s Manual 1 Introduction 1 1 General Description GMO3 is a decoding algorithm for 4 Gray and Mono Image We offer users the easy to use API and library to develop applications Only the header file GCO3 h and LIB need to be added and GMO03 User asm can be modified to meet various system requirements 1 2 Structure Diagram Structure diagram for encode Encode Animation Bitmap to GMO3 Con
5. ction sets xxx confirmation sheet A check list for releasing code Generalplus Technology Inc PAGE 2 V2 0 May 05 2009 G Generalplus GMO03 16bit Library and Sample Code User s Manual Table of Content PAGE 1 INTRODUCTION 5 1 1 GENERAL DESCRIPTION adserit ied EAr AAAS E rr ed rhe EAO OAA ird Ed edes 5 1 2 STRUCTURE DIAGRAM Sete eI A E IEEE CHEN Ie IsIeE e OE EA EIEEE 5 2 RESOURCE ALLOCATION c 6 2 1 RESOURCE ROM RAM SIZE ccssssscccccessssssccecceeeesssseeccccessnsaeeccceeeesseeeececessessseeeeceseessseeeececeessssaeeeeceeeesaseeeeeeeeeetaeees 6 2 2 EXAMP E TEPHEEEEEE ds es eaa 6 3 APIFUNCTIONS DESCRIPTION os sscsisessecssssssoessesssnessecssessiccssesssnsesessiesssoeseessseesiecssessssscsnssiacssesesesssoctiesssansessacessscssoesse 7 3 1 APL FUNCTION EISTOETIBRARY 5 teri icrcixe feet tecto tos nre ire lebe greed risate taedet ES bey ode eee 7 3 2 APT PUNCTION DESCRIPTION 55 5 5 5 Pbi tetrepi t ire teste ir D EE DOS UE HS Peer aire epa EP HD ERES 7 4 VARIABLES DESCRIPTION scck sexeeeve cevc cose eyueeeve eue veecenseeuss eese esos sb Ve eure ce ep due ve eue eae TFET eee Cae pee VUE ee Se EXE e 8 4 1 VARTABLE LIST OE LIBRARY 5 2 ner ei is ew a E e E ise aS 8 4 2 VARIABLE DESCRIPTION esce ee ee eene EXE REESE YS NEUE RON YE ENS ERE RE EVEN REESE EAE NES ENDE E isan ER E E RR 8 5 GM03USER S FUNCTION DESC
6. is variable is necessary when selecting manual mode Generalplus Technology Inc PAGE 8 V2 0 May 05 2009 G Generalplus GMO03 16bit Library and Sample Code User s Manual 5 1 5 2 5 GMO03 User s Function Description Function List of GMO3 User asm Index syntax 1 F_GM03_User_lnitial 2 F GMO03 SetBufferAddr User 3 F GMO0S3 User Get Data 4 F GMO03 User Process User s Function Description F GMO03 User Initial Description Desc sets decode in length or initializes LCD settings in this function Input R Frame Data Size F GMO03 SetBufferAddr User Description Desc sets manual mode decode in buffer address in this function Input Decode in buffer address F GMO03 User Get Data Description Desc GMO3 library will call this function to read decode in data Input R1 Write GMOS3 decode in buffer start point R2 Write GMO03 decode in buffer data size F GMO03 User Process Description Desc For GPL16 LCD controller only supports 4bpp and 1bpp format it allows to process data format from 2bpp to 4bpp in this function Users can also refer to R GrayorMono Flag to identify Decode out data format at 1bpp or 2bpp Input R GrayorMono Flag Generalplus Technology Inc PAGE 9 V2 0 May 05 2009 G Generalplus GMO03 16bit Library and Sample Code User s Manual 6 GMO03 User
7. ology Inc PAGE 11 V2 0 May 05 2009
8. s Function Description 6 1 Examples Manual mode example code Int ret System Initial TimeBase Flag 0 FrameCnt 0 LCD_Enable EnableTimeBase while 1 F GMO3 Initial C Mono Set decode format is Mono F GM03 SetMode C Manual Mode Set decode mode is manual mode F_GM03_SetBufferAddr_User DecodelnBuffer Set decode in buffer address F_GM03_Decode_Start 0 Start decode FrameCnt F_GM03_Get_RemainFrame_Num Get remain Frame number while ret 1 Decode GMOS until return value 1 if TimeBase_Flag 1 ret F GMO3 Decode ServiceLoop TimeBase Flag 0 ret 0 Auto mode example code Int ret System_Initial TimeBase_Flag 0 FrameCnt 0 LCD_Enable EnableTimeBase while 1 Generalplus Technology Inc PAGE 10 V2 0 May 05 2009 G Generalplus GMO03 16bit Library and Sample Code User s Manual F GMO3 Initial C Gray F GM03 SetMode C Auto Mode F GMO03 Decode Start 0 FrameCnt F GMO3 Get RemainFrame Num while ret 1 if TimeBase Flag 1 ret F GMO3 Decode ServiceLoop TimeBase Flag 0 ret 0 GM03_Decode_Start Set decode format is Gray Set decode mode is Auto mode Set GMO3 decode the index 0 of GMO3 Resource Table Start Decode Get remain Frame number Decode GMOS until return value 1 GM03_Decode_ServiceLoop Return value Decode End Generalplus Techn
9. vert BMP Files Encode Tool NS RIS Structure diagram for decode Decode GM03 File gt Software Decode gt RAW data GPLxxx Series Generalplus Technology Inc PAGE 5 V2 0 May 05 2009 G Generalplus GMO03 16bit Library and Sample Code User s Manual 2 1 2 2 2 Resource Allocation Resource ROM RAM Size The resources taken by GMOS Decoder are as follows RAM 13 Decode Out buffer Size for 4 gray GM03 decode only words ROM 358 words In GPL16 series the LCD controller only supports 1bpp and 4 bpp formats Thus users should reserve one decode buffer to store 4 gray GM03 decode out data and convert decode out data type form 4 gray 2bpp to 16 gray 4bpp For Mono GMO03 decode this buffer can be assigned to LCD buffer Example The decoding time of the corresponding frame size is as follows 4 Gray animation 6 Gy Be Bis i Ee ee Size 32 64 Rate 32 11 Decode Time Frame secong AUTO mode 2 5 ms max 48MHz SYSCLK MANUAL mode 2 86 ms max 48MHz SYSCLK Mono animation d d 3 egea Size 32 64 Rate 32 11 Decode Time Frame secong AUTO mode 1 16 ms max 48MHz SYSCLK MANUAL mode 1 4 ms max 48MHz SYSCLK Manual mode does not include the time accessing external memory SPI Flash
Download Pdf Manuals
Related Search