/********************************************************************* * Flowcode Graphical LCD Component Code * * File: GFxLCD_Code.c * * (c) 2007 Matrix Multimedia Ltd. * http://www.matrixmultimedia.com * * Software License Agreement * * The software supplied herewith by Matrix Multimedia Ltd (the * “Company”) for its Flowcode graphical programming language is * intended and supplied to you, the Company’s customer, for use * solely and exclusively on the Company's products. The software * is owned by the Company, and is protected under applicable * copyright laws. All rights are reserved. Any use in violation * of the foregoing restrictions may subject the user to criminal * sanctions under applicable laws, as well as to civil liability * for the breach of the terms and conditions of this licence. * * THIS SOFTWARE IS PROVIDED IN AN “AS IS” CONDITION. NO WARRANTIES, * WHETHER EXPRESS, IMPLIED OR STATUTORY, INCLUDING, BUT NOT LIMITED * TO, IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A * PARTICULAR PURPOSE APPLY TO THIS SOFTWARE. THE COMPANY SHALL NOT, * IN ANY CIRCUMSTANCES, BE LIABLE FOR SPECIAL, INCIDENTAL OR * CONSEQUENTIAL DAMAGES, FOR ANY REASON WHATSOEVER. * * Changelog: * * date | by | description * -------+----+----------------------------------------------------- * 240407 | ST | Created * 220108 | BR | Edited for GfxLCD * 300108 | ST | Minor edits to function names, etc. * 300108 | ST | Addition of pin info * 300108 | BR | Edited to include global color functions * 300108 | ST | Removed tabs, fixed a few errors & added extra properties * 010208 | BR | Edited Print fonts, Added DrawBox fill functionality * 040208 | ST | Removed "BackPlot" function and renamed "ForePlot" to "Plot" * 080408 | BR | Added PrintNumber Function * | | * | | * ********************************************************************/ /********************************************************************* Return & Parameter types: void char short char* Pin directions: 0 = OUTPUT 2 = INPUT 3 = BIDIRECTIONAL Macro substitutions: %a = ?? %b = ?? %c = ?? %d = ?? %e = ?? %f = ?? %g = ?? %h = ?? %i = ?? %j = ?? ********************************************************************** [Settings] CLSID={4B174520-75AB-4B14-A0F7-2AA6C203F1DC} IsAnalogue=0 MultipleAllowed=0 Description=Graphical LCD Flowcode Component ********************************************************************** [Port] DesiredPort=0 PortMandatory=0 SamePortAsID=0 [Pins] Count=4 1=Reset 2=Chip Select 3=Clock 4=Data [PinPort] # PORTA = 0 # PORTB = 1 # PORTC = 2 # PORTD = 3 # PORTE = 4 1=0 2=0 3=0 4=0 [PinDesiredBit] 1=3 2=2 3=1 4=0 [PinDirection] # DIR_INPUT = 2 # DIR_OUTPUT = 0 # DIR_BIDIRECTIONAL = 3 1=0 2=0 3=0 4=0 [PinMustUsePort] # boolean 1=1 2=1 3=1 4=1 [SamePortAsPinX] # -1 = any pin # otherwise, the pin number 1=-1 2=0 3=0 4=0 [PinMustUsePin] # boolean 1=1 2=1 3=1 4=1 [PinValue] # boolean (0 = off, 1 = on) 1=0 2=0 3=0 4=0 ********************************************************************** [MacroNames] Count=17 1=GetDefines 2=Init 3=Clear 4=Print 5=PrintNumber 6=Plot 7=DrawLine 8=DrawBox 9=SetForeColor 10=SetBackColor 11=SPI_Init 12=SPI_Send_Char 13=Set_Data_Direction 14=StrobeE 15=Update_Slave 16=CommandWithData 17=CommandWith2Data [MacroReturns] 1=void 2=void 3=void 4=void 5=void 6=void 7=void 8=void 9=void 10=void 11=void 12=void 13=void 14=void 15=void 16=void 17=void [MacroIsPrivate] 1=1 2=0 3=0 4=0 5=0 6=0 7=0 8=0 9=0 10=0 11=1 12=1 13=1 14=1 15=1 16=1 17=1 [MacroParameters_GetDefines] Count=0 [MacroParamTypes_GetDefines] [MacroParameters_Init] Count=0 [MacroParamTypes_Init] [MacroParameters_Clear] Count=0 [MacroParamTypes_Clear] [MacroParameters_Print] Count=5 1=String 2=X 3=Y 4=Font 5=Transparent [MacroParamTypes_Print] 1=char* 2=char 3=char 4=char 5=char [MacroParameters_PrintNumber] Count=5 1=Number 2=X 3=Y 4=Font 5=Transparent [MacroParamTypes_PrintNumber] 1=short 2=char 3=char 4=char 5=char [MacroParameters_Plot] Count=2 1=X1 2=Y1 [MacroParamTypes_Plot] 1=char 2=char [MacroParameters_DrawLine] Count=4 1=X1 2=Y1 3=X2 4=Y2 [MacroParamTypes_DrawLine] 1=char 2=char 3=char 4=char [MacroParameters_DrawBox] Count=6 1=X1 2=Y1 3=X2 4=Y2 5=Transparent 6=Solid [MacroParamTypes_DrawBox] 1=char 2=char 3=char 4=char 5=char 6=char [MacroParameters_SetForeColor] Count=3 1=Red 2=Green 3=Blue [MacroParamTypes_SetForeColor] 1=char 2=char 3=char [MacroParameters_SetBackColor] Count=3 1=Red 2=Green 3=Blue [MacroParamTypes_SetBackColor] 1=char 2=char 3=char [MacroParameters_SPI_Init] Count=0 [MacroParamTypes_SPI_Init] [MacroParameters_SPI_Send_Char] Count=1 1=Char [MacroParamTypes_SPI_Send_Char] 1=char [MacroParameters_Set_Data_Direction] Count=1 1=mode [MacroParamTypes_Set_Data_Direction] 1=char [MacroParameters_StrobeE] Count=0 [MacroParamTypes_StrobeE] [MacroParameters_Update_Slave] Count=0 [MacroParamTypes_Update_Slave] [MacroParameters_CommandWithData] Count=2 1=Command 2=Data [MacroParamTypes_CommandWithData] 1=char 2=char [MacroParameters_CommandWith2Data] Count=3 1=Command 2=Data1 3=Data2 [MacroParamTypes_CommandWith2Data] 1=char 2=char 3=char ********************************************************************/ /******************************************************************** * ADDITIONAL CODE ********************************************************************/ /*InitialisationCode_Start*/ /*InitialisationCode_End*/ /*InterruptCode_Start*/ /*InterruptCode_End*/ /******************************************************************** * FUNCTIONS ********************************************************************/ void GetDefines() { /*Macro_GetDefines_Start*/ } //Dummy end of function to allow defines to be added correctly #include //Common Defines #define MX_GFXLCD_PORT %a //portc I/O port #define MX_GFXLCD_TRIS %b //trisc I/O direction register #define MX_GFXLCD_RS %c //3 Reset #define MX_GFXLCD_CS %d //2 Chip Select #define MX_GFXLCD_SCLK %e //1 Serial Clock #define MX_GFXLCD_SDATA %f //0 Serial Data #define MX_GFXLCD_BCOL %g //255 Background Color - White #define MX_GFXLCD_FCOL %h //0 Foreground Color - Black #define MX_GFXLCD_SIZE %i //0 0 = 132x132 //ASCII Pixel data %j #define MX_GFXLCD_CMD 0 //A "0" tells the display: now a Command is following #define MX_GFXLCD_PARAM 1 //A "1" tells the display: now a Parameter is following //Internal Gfx LCD Functions void gLCD_SendByte (char Command, char Lcdout); void gLCD_Window (char X1, char Y1, char X2, char Y2); short GFX_Fore_Color; short GFX_Back_Color; //EB057 ONLY //I2C I/O Expander Command Defines #define DDR 0x00 #define PORT 0x12 #define CONF 0x0A //Pin Definitions -- These have changed BR 05 05 10 #define EN 0x01 #define RW 0x02 #define RS 0x04 #define CS 0x08 #define RESET 0x10 //global variables char Data = 0; char Control = RESET | CS; //LCD Command Defines #define LCD_Data Control = Control | RS; //Set DC #define LCD_Command Control = Control & ~RS; //Clear DC #define LCD_Read Control = Control | RW; //Set DC #define LCD_Write Control = Control & ~RW; //Clear DC //SPI COMPONENT DEFINES #define SPI_SSPM 0 #define SPI_CKP 0 #define SPI_CKE 64 #define SPI_SMP 0 #ifdef MX_SPI_B #define SPI_CS_TRIS trisb #define SPI_CS_PORT portb #endif #ifdef MX_SPI_C #define SPI_CS_TRIS trisc #define SPI_CS_PORT portc #endif #ifdef MX_SPI_BCB #define SPI_CS_TRIS trisb #define SPI_CS_PORT portb #endif //Internal Implementations //------------------------------------------------------------------------------- //Send Commands or MX_GFXLCD_PARAMeter or data byte //------------------------------------------------------------------------------- void gLCD_SendByte (char Command, char Lcdout) { //EB057 ONLY if (Command == MX_GFXLCD_CMD) LCD_Command; else LCD_Data; LCD_Write; Data = Lcdout; StrobeE(); } //------------------------------------------------------------------------------ //Open output windows with coordinatex x1,y1 and x2,y2 //------------------------------------------------------------------------------ void gLCD_Window (char X1, char Y1, char X2, char Y2) { gLCD_SendByte(MX_GFXLCD_CMD, 0x2A); //Column adress gLCD_SendByte(MX_GFXLCD_PARAM, X1); //X-Position upper left corner gLCD_SendByte(MX_GFXLCD_PARAM, X2); //y-Position upper left corner gLCD_SendByte(MX_GFXLCD_CMD, 0x2B); //Page adressing gLCD_SendByte(MX_GFXLCD_PARAM, Y1); //x-Position of lower right corner gLCD_SendByte(MX_GFXLCD_PARAM, Y2); //y-Position of lower right corner gLCD_SendByte(MX_GFXLCD_CMD, 0x2C); } // Dummy function to close the defines section off void gLCD_Dummy_Function2(); void gLCD_Dummy_Function2() { /*Macro_GetDefines_End*/ } //------------------------------------------------------------------------------- //Initializing of the display //------------------------------------------------------------------------------- void Init (void) { /*Macro_Init_Start*/ char Red, Green, Blue; GFX_Fore_Color = MX_GFXLCD_FCOL; GFX_Back_Color = MX_GFXLCD_BCOL; //Convert Foreground to 16-bit colour Green = (GFX_Fore_Color >> 2) & 0x07; Green = Green << 2; Red = (GFX_Fore_Color >> 5) & 0x07; Red = Red << 3; Blue = (GFX_Fore_Color) & 0x03; Blue = Blue << 3; GFX_Fore_Color = Green | (Red << 5); GFX_Fore_Color = GFX_Fore_Color | (Blue << 11); //Convert Background to 16-bit colour Green = (GFX_Back_Color >> 2) & 0x07; Green = Green << 2; Red = (GFX_Back_Color >> 5) & 0x07; Red = Red << 3; Blue = (GFX_Back_Color) & 0x03; Blue = Blue << 3; GFX_Back_Color = Green | (Red << 5); GFX_Back_Color = GFX_Back_Color | (Blue << 11); //EB057 Initialise SPI_Init(); //Initialise SPI hardware delay_us(10); Set_Data_Direction(0); gLCD_SendByte(MX_GFXLCD_CMD, 0x01); //Software Reset delay_us(100); CommandWithData(0xFD, 0x12); //Unlock Basic Commands CommandWithData(0xFD, 0xB3); //Unlock Supplementary Commands gLCD_SendByte(MX_GFXLCD_CMD, 0x10); //Sleep In CommandWithData(0xD2, 0x10); //Set Display Clock CommandWithData(0xCA, 0x7F); //Set Multiplex Ratio CommandWithData(0xC8, 0x00); //Set Display Offset CommandWith2Data(0x36, 0x88, 0x01); //Memory Access Control CommandWithData(0x3A, 0x05); //Pixel Format CommandWithData(0x35, 0x00); //Tearing Effect Line On CommandWithData(0xB3, 0x03); //Function Selection CommandWithData(0xCC, 0xB0); //-Enable External VSL CommandWithData(0xD6, 0x07); //-High Power Protection CommandWithData(0xBA, 0x43); //Set Contrast A CommandWithData(0xBB, 0x55); //Set Contrast B CommandWithData(0xBC, 0x87); //Set Contrast C CommandWith2Data(0xD1, 0x00, 0x00); //-Set Contrast Compensation CommandWithData(0x51, 0xF0); //Write Luminence CommandWithData(0xE3, 0x02); //Grey Scale Enhance CommandWithData(0xCD, 0x32); //Phase Length CommandWithData(0xBD, 0x09); //Precharge Voltage CommandWith2Data(0xD0, 0x04, 0x3F); //-Pre Charge Compensation CommandWithData(0xCE, 0x0B); //2nd Precharge Period CommandWithData(0xCF, 0x03); //2nd Precharge Speed CommandWithData(0xD3, 0x04); //Set VCOMH gLCD_SendByte(MX_GFXLCD_CMD, 0x29); //Disable Pixels On / Off gLCD_SendByte(MX_GFXLCD_CMD, 0x20); //Display Inversion Off gLCD_SendByte(MX_GFXLCD_CMD, 0x13); //Display Normal Mode gLCD_SendByte(MX_GFXLCD_CMD, 0x11); //Sleep Out delay_ms(200); Clear(); /*Macro_Init_End*/ } //------------------------------------------------------------------------------ //Configures the color of the foreground //------------------------------------------------------------------------------ void SetForeColor (char Red, char Green, char Blue) { /*Macro_SetForeColor_Start*/ if (Red > 0x3F) Red = 0x3F; if (Green > 0x1F) Green = 0x1F; if (Blue > 0x1F) Blue = 0x1F; GFX_Fore_Color = Blue | (Green << 5); GFX_Fore_Color = GFX_Fore_Color | (Red << 11); /*Macro_SetForeColor_End*/ } //------------------------------------------------------------------------------ //Configures the color of the background //------------------------------------------------------------------------------ void SetBackColor (char Red, char Green, char Blue) { /*Macro_SetBackColor_Start*/ if (Red > 0x3F) Red = 0x3F; if (Green > 0x1F) Green = 0x1F; if (Blue > 0x1F) Blue = 0x1F; GFX_Back_Color = Blue | (Green << 5); GFX_Back_Color = GFX_Back_Color | (Red << 11); /*Macro_SetBackColor_End*/ } //------------------------------------------------------------------------------ //Defines window area and fills with color //------------------------------------------------------------------------------ void DrawBox (char X1, char Y1, char X2, char Y2, char Transparent, char Solid) { /*Macro_DrawBox_Start*/ char X,Y; short Pixel,Count,Color; DrawLine(X1, Y1, X2, Y1); //draw border DrawLine(X2, Y1, X2, Y2); DrawLine(X1, Y2, X2, Y2); DrawLine(X1, Y1, X1, Y2); if (!Transparent) { X1 = X1 + 2; //srink box to make room for border Y1 = Y1 + 2; gLCD_Window(X1,Y1,X2,Y2); //define window X = X2 - X1; X++; //# of X-Pixel Y = Y2 - Y1; Y++; //# of Y-Pixel Pixel = X * Y; //# of total pixel if (Solid) Color = GFX_Fore_Color; else Color = GFX_Back_Color; for (Count=0;Count>8); gLCD_SendByte(MX_GFXLCD_PARAM, GFX_Back_Color); } } /*Macro_DrawBox_End*/ } //------------------------------------------------------------------------------- //Clear screen //------------------------------------------------------------------------------- void Clear (void) { /*Macro_Clear_Start*/ char X,Y; short Pixel,Count; gLCD_Window(0,0,131,131);//define window X = 128; //# of X-Pixel Y = 128; //# of Y-Pixel Pixel = X * Y; //# of total pixel for (Count=0;Count>8); gLCD_SendByte(MX_GFXLCD_PARAM, GFX_Back_Color); } /*Macro_Clear_End*/ } //------------------------------------------------------------------------------- //Routine for displaying characters //------------------------------------------------------------------------------- void Print (char* String, char X, char Y, char Font, char Transparent) { /*Macro_Print_Start*/ char xpix, ypix, pos_Str, length_Str, count, xcount, ycount, height, width, i; char Fontwidth = 1; //First we assume small font char Fontheight = 1; char temp[6]; temp[5] = 0x00; //Spacing Line length_Str = strlen(String); //Get length of string if (Font == 1) //Double Height Sizes //Double Width { Fontwidth = 2; } if (Font == 2) //Double Height and Width Sizes { Fontwidth = 2; Fontheight = 2; } if (Font == 3) //Double Height Sizes { Fontheight = 2; } xcount = 0; for (i=0;i>8); gLCD_SendByte(MX_GFXLCD_PARAM, GFX_Back_Color); } ycount++; } } xcount++; } } } /*Macro_Print_End*/ } //------------------------------------------------------------------------------- //Routine for Printing Numbers //------------------------------------------------------------------------------- void PrintNumber (short Number, char X, char Y, char Font, char Transparent) { /*Macro_PrintNumber_Start*/ char temp_str[6]; FCI_TOSTRING(Number,temp_str,6); //Convert number to String Print (temp_str, 6, X, Y, Font, Transparent); //Send string to Print function /*Macro_PrintNumber_End*/ } //--------------------------------------------------------------------------- //Outputs one pixel onto the screen //--------------------------------------------------------------------------- void Plot (char X1, char Y1) { /*Macro_Plot_Start*/ X1 = X1 + 1; Y1 = Y1 + 1; gLCD_Window(X1,Y1,X1,Y1); //Creates output window of 1 pixel gLCD_SendByte(MX_GFXLCD_PARAM, GFX_Fore_Color>>8); //set color of pixel gLCD_SendByte(MX_GFXLCD_PARAM, GFX_Fore_Color); //set color of pixel /*Macro_Plot_End*/ } //--------------------------------------------------------------------------- //Draws a line from one point to another //--------------------------------------------------------------------------- void DrawLine (char X1, char Y1, char X2, char Y2) { /*Macro_DrawLine_Start*/ int C1, M1; signed int D1 = 0; signed int Pixelx = X2 - X1; //number of X-pixels; signed int Pixely = Y2 - Y1; //Number of Y-pixels signed char Xinc = 1; signed char Yinc = 1; if (Pixelx < 0) //If negative X direction { Xinc = -1; Pixelx = Pixelx * -1; } if (Pixely < 0) //If negative Y direction { Yinc = -1; Pixely = Pixely * -1; } if (Pixely <= Pixelx) { C1 = 2 * Pixelx; M1 = 2 * Pixely; while (X1 != X2) { Plot(X1, Y1); //ForePlot line X1 = X1 + Xinc; D1 = D1 + M1; if (D1 > Pixelx) { Y1 = Y1 + Yinc; D1 = D1 - C1; } } } else { C1 = 2 * Pixely; M1 = 2 * Pixelx; while (Y1 != Y2) { Plot(X1, Y1); //ForePlot Line Y1 = Y1 + Yinc; D1 = D1 + M1; if (D1 > Pixely) { X1 = X1 + Xinc; D1 = D1 - C1; } } Plot(X1, Y1); } /*Macro_DrawLine_End*/ } //--------------------------------------------------------------------------- //EB057 Specific Functions //--------------------------------------------------------------------------- void SPI_Init() { /*Macro_SPI_Init_Start*/ //GetSPI_InitCode #ifndef MX_SPI #ifdef _BOOSTC #pragma error "Chip does not have SPI capability" #endif #ifdef HI_TECH_C #error Chip does not have SPI capability #endif #endif //initialise spi #ifdef MX_SPI_B set_bit(trisb,MX_SPI_SDI); clear_bit(trisb,MX_SPI_SDO); clear_bit(trisb,MX_SPI_SCK); clear_bit(SPI_CS_TRIS,MX_GFXLCD_CS); //disable SPI devices set_bit(SPI_CS_PORT, MX_GFXLCD_CS); #endif #ifdef MX_SPI_C set_bit(trisc,MX_SPI_SDI); clear_bit(trisc,MX_SPI_SDO); clear_bit(trisc,MX_SPI_SCK); clear_bit(SPI_CS_TRIS,MX_GFXLCD_CS); //disable SPI devices set_bit(SPI_CS_PORT, MX_GFXLCD_CS); #endif #ifdef MX_SPI_BCB set_bit(trisb,MX_SPI_SDI); clear_bit(trisc,MX_SPI_SDO); clear_bit(trisb,MX_SPI_SCK); clear_bit(SPI_CS_TRIS,MX_GFXLCD_CS); //disable SPI devices set_bit(SPI_CS_PORT, MX_GFXLCD_CS); #endif sspstat = SPI_CKE | SPI_SMP; #ifdef _BOOSTC #ifdef SSPCON // SPI Speed Initialise sspcon = SPI_SSPM | SPI_CKP; st_bit(sspcon, SSPEN); #endif #ifdef SSPCON1 sspcon1 = SPI_SSPM | SPI_CKP; st_bit(sspcon1, SSPEN); #endif #endif #ifdef HI_TECH_C #ifdef sspcon // SPI Speed Initialise sspcon = SPI_SSPM | SPI_CKP; st_bit(sspcon, SSPEN); #endif #ifdef sspcon1 sspcon1 = SPI_SSPM | SPI_CKP; st_bit(sspcon1, SSPEN); #endif #endif /*Macro_SPI_Init_End*/ } void SPI_Send_Char(char Char) { /*Macro_SPI_Send_Char_Start*/ //GetSPI_Send_CharCode #ifndef MX_SPI #ifdef _BOOSTC #pragma error "Chip does not have SPI capability" #endif #ifdef HI_TECH_C #error Chip does not have SPI capability #endif #endif //send the Char sspbuf = Char; //wait until sspbuf is empty while ((sspstat & 0x01) == 0); /*Macro_SPI_Send_Char_End*/ } void Set_Data_Direction (char mode) { /*Macro_Set_Data_Direction_Start*/ //Configure Non Incremental and pair swapping clear_bit(SPI_CS_PORT, MX_GFXLCD_CS); //CS Low SPI_Send_Char(0x40); SPI_Send_Char(CONF); SPI_Send_Char(0x20); SPI_Send_Char(0x20); set_bit(SPI_CS_PORT, MX_GFXLCD_CS); //CS High //Configure DDRs delay_us(10); clear_bit(SPI_CS_PORT, MX_GFXLCD_CS); //CS Low SPI_Send_Char(0x40); SPI_Send_Char(DDR); if(mode) SPI_Send_Char(0xFF); else SPI_Send_Char(0x00); SPI_Send_Char(0x00); set_bit(SPI_CS_PORT, MX_GFXLCD_CS); //CS High /*Macro_Set_Data_Direction_End*/ } void StrobeE (void) { /*Macro_StrobeE_Start*/ Control = Control & ~CS; //Clear CS Control = Control | EN; //Set EN Update_Slave (); Control = Control & ~EN; //Clear EN Control = Control | CS; //Set CS Update_Slave (); /*Macro_StrobeE_End*/ } void Update_Slave () { /*Macro_Update_Slave_Start*/ clear_bit(SPI_CS_PORT, MX_GFXLCD_CS); //CS Low SPI_Send_Char(0x40); SPI_Send_Char(PORT); SPI_Send_Char(Data); // -- The Order of this has changed BR 05 05 10 SPI_Send_Char(Control); // -- The Order of this has changed BR 05 05 10 set_bit(SPI_CS_PORT, MX_GFXLCD_CS); //CS High /*Macro_Update_Slave_End*/ } void CommandWithData (char Command, char Data) { /*Macro_CommandWithData_Start*/ gLCD_SendByte(MX_GFXLCD_CMD, Command); gLCD_SendByte(MX_GFXLCD_PARAM, Data); /*Macro_CommandWithData_End*/ } void CommandWith2Data (char Command, char Data1, char Data2) { /*Macro_CommandWith2Data_Start*/ gLCD_SendByte(MX_GFXLCD_CMD, Command); gLCD_SendByte(MX_GFXLCD_PARAM, Data1); gLCD_SendByte(MX_GFXLCD_PARAM, Data2); /*Macro_CommandWith2Data_End*/ }