362 lines
13 KiB
C
362 lines
13 KiB
C
|
/*
|
||
|
|
ChibiOS/RT - Copyright (C) 2012
|
||
|
|
Joel Bodenmann aka Tectu <joel@unormal.org>
|
||
|
|
|
||
|
|
This file is part of ChibiOS-LCD-Driver.
|
||
|
|
|
||
|
|
ChibiOS-LCD-Driver is free software; you can redistribute it and/or modify
|
||
|
|
it under the terms of the GNU General Public License as published by
|
||
|
|
the Free Software Foundation; either version 3 of the License, or
|
||
|
|
(at your option) any later version.
|
||
|
|
|
||
|
|
ChibiOS-LCD-Driver is distributed in the hope that it will be useful,
|
||
|
|
but WITHOUT ANY WARRANTY; without even the implied warranty of
|
||
|
|
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
|
||
|
|
GNU General Public License for more details.
|
||
|
|
|
||
|
|
You should have received a copy of the GNU General Public License
|
||
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @file gdispTestStub/gdisp_lld.c
|
||
|
|
* @brief GDISP Graphics Driver subsystem low level driver source (stub).
|
||
|
|
*
|
||
|
|
* @addtogroup GDISP
|
||
|
|
* @{
|
||
|
|
*/
|
||
|
|
|
||
|
|
#include "ch.h"
|
||
|
|
#include "hal.h"
|
||
|
|
#include "gdisp.h"
|
||
|
|
|
||
|
|
#if HAL_USE_GDISP || defined(__DOXYGEN__)
|
||
|
|
|
||
|
|
/* Include the emulation code for things we don't support */
|
||
|
|
#include "gdisp_emulation.c"
|
||
|
|
|
||
|
|
/*===========================================================================*/
|
||
|
|
/* Driver local definitions. */
|
||
|
|
/*===========================================================================*/
|
||
|
|
|
||
|
|
/*===========================================================================*/
|
||
|
|
/* Driver exported variables. */
|
||
|
|
/*===========================================================================*/
|
||
|
|
|
||
|
|
/*===========================================================================*/
|
||
|
|
/* Driver local variables. */
|
||
|
|
/*===========================================================================*/
|
||
|
|
|
||
|
|
/*===========================================================================*/
|
||
|
|
/* Driver local functions. */
|
||
|
|
/*===========================================================================*/
|
||
|
|
|
||
|
|
/*===========================================================================*/
|
||
|
|
/* Driver interrupt handlers. */
|
||
|
|
/*===========================================================================*/
|
||
|
|
|
||
|
|
/*===========================================================================*/
|
||
|
|
/* Driver exported functions. */
|
||
|
|
/*===========================================================================*/
|
||
|
|
|
||
|
|
/* ---- Required Routines ---- */
|
||
|
|
/*
|
||
|
|
The following 2 routines are required.
|
||
|
|
All other routines are optional.
|
||
|
|
*/
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Low level GDISP driver initialization.
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
bool_t GDISP_LLD(init)(void) {
|
||
|
|
/* Initialise the GDISP structure */
|
||
|
|
GDISP.Width = 128;
|
||
|
|
GDISP.Height = 128;
|
||
|
|
GDISP.Orientation = portrait;
|
||
|
|
GDISP.Powermode = powerOff;
|
||
|
|
GDISP.Backlight = 100;
|
||
|
|
GDISP.Contrast = 50;
|
||
|
|
return TRUE;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Draws a pixel on the display.
|
||
|
|
*
|
||
|
|
* @param[in] x X location of the pixel
|
||
|
|
* @param[in] y Y location of the pixel
|
||
|
|
* @param[in] color The color of the pixel
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(drawpixel)(coord_t UNUSED(x), coord_t UNUSED(y), color_t UNUSED(color)) {
|
||
|
|
}
|
||
|
|
|
||
|
|
/* ---- Optional Routines ---- */
|
||
|
|
/*
|
||
|
|
All the below routines are optional.
|
||
|
|
Defining them will increase speed but everything
|
||
|
|
will work if they are not defined.
|
||
|
|
If you are not using a routine - turn it off using
|
||
|
|
the appropriate GDISP_HARDWARE_XXXX macro.
|
||
|
|
Don't bother coding for obvious similar routines if
|
||
|
|
there is no performance penalty as the emulation software
|
||
|
|
makes a good job of using similar routines.
|
||
|
|
eg. If fillarea() is defined there is little
|
||
|
|
point in defining clear() unless the
|
||
|
|
performance bonus is significant.
|
||
|
|
For good performance it is suggested to implement
|
||
|
|
fillarea() and blitarea().
|
||
|
|
*/
|
||
|
|
|
||
|
|
#if GDISP_HARDWARE_CLEARS || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Clear the display.
|
||
|
|
* @note Optional - The high level driver can emulate using software.
|
||
|
|
*
|
||
|
|
* @param[in] color The color of the pixel
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(clear)(color_t UNUSED(color)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if GDISP_HARDWARE_LINES || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Draw a line.
|
||
|
|
* @note Optional - The high level driver can emulate using software.
|
||
|
|
*
|
||
|
|
* @param[in] x0, y0 The start of the line
|
||
|
|
* @param[in] x1, y1 The end of the line
|
||
|
|
* @param[in] color The color of the line
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(drawline)(coord_t UNUSED(x0), coord_t UNUSED(y0), coord_t UNUSED(x1), coord_t UNUSED(y1), color_t UNUSED(color)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if GDISP_HARDWARE_FILLS || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Fill an area with a color.
|
||
|
|
* @note Optional - The high level driver can emulate using software.
|
||
|
|
*
|
||
|
|
* @param[in] x, y The start filled area
|
||
|
|
* @param[in] cx, cy The width and height to be filled
|
||
|
|
* @param[in] color The color of the fill
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(fillarea)(coord_t UNUSED(x), coord_t UNUSED(y), coord_t UNUSED(cx), coord_t UNUSED(cy), color_t UNUSED(color)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if GDISP_HARDWARE_BITFILLS || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Fill an area with a bitmap.
|
||
|
|
* @note Optional - The high level driver can emulate using software.
|
||
|
|
*
|
||
|
|
* @param[in] x, y The start filled area
|
||
|
|
* @param[in] cx, cy The width and height to be filled
|
||
|
|
* @param[in] buffer The pixels to use to fill the area.
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(blitarea)(coord_t UNUSED(x), coord_t UNUSED(y), coord_t UNUSED(cx), coord_t UNUSED(cy), const pixel_t *UNUSED(buffer)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
/* Circular Drawing Functions */
|
||
|
|
#if (GDISP_NEED_CIRCLE && GDISP_HARDWARE_CIRCLES) || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Draw a circle.
|
||
|
|
* @note Optional - The high level driver can emulate using software.
|
||
|
|
* @note If GDISP_NEED_CLIPPING is defined this routine MUST behave
|
||
|
|
* correctly if the circle is over the edges of the screen.
|
||
|
|
*
|
||
|
|
* @param[in] x, y The centre of the circle
|
||
|
|
* @param[in] radius The radius of the circle
|
||
|
|
* @param[in] color The color of the circle
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(drawcircle)(coord_t UNUSED(x), coord_t UNUSED(y), coord_t UNUSED(radius), color_t UNUSED(color)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if (GDISP_NEED_CIRCLE && GDISP_HARDWARE_CIRCLEFILLS) || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Create a filled circle.
|
||
|
|
* @note Optional - The high level driver can emulate using software.
|
||
|
|
* @note If GDISP_NEED_CLIPPING is defined this routine MUST behave
|
||
|
|
* correctly if the circle is over the edges of the screen.
|
||
|
|
*
|
||
|
|
* @param[in] x, y The centre of the circle
|
||
|
|
* @param[in] radius The radius of the circle
|
||
|
|
* @param[in] color The color of the circle
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(fillcircle)(coord_t UNUSED(x), coord_t UNUSED(y), coord_t UNUSED(radius), color_t UNUSED(color)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if (GDISP_NEED_ELLIPSE && GDISP_HARDWARE_ELLIPSES) || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Draw an ellipse.
|
||
|
|
* @note Optional - The high level driver can emulate using software.
|
||
|
|
* @note If GDISP_NEED_CLIPPING is defined this routine MUST behave
|
||
|
|
* correctly if the ellipse is over the edges of the screen.
|
||
|
|
*
|
||
|
|
* @param[in] x, y The centre of the ellipse
|
||
|
|
* @param[in] a, b The dimensions of the ellipse
|
||
|
|
* @param[in] color The color of the ellipse
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(drawellipse)(coord_t UNUSED(x), coord_t UNUSED(y), coord_t UNUSED(a), coord_t UNUSED(b), color_t UNUSED(color)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if (GDISP_NEED_ELLIPSE && GDISP_HARDWARE_ELLIPSEFILLS) || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Create a filled ellipse.
|
||
|
|
* @note Optional - The high level driver can emulate using software.
|
||
|
|
* @note If GDISP_NEED_CLIPPING is defined this routine MUST behave
|
||
|
|
* correctly if the ellipse is over the edges of the screen.
|
||
|
|
*
|
||
|
|
* @param[in] x, y The centre of the ellipse
|
||
|
|
* @param[in] a, b The dimensions of the ellipse
|
||
|
|
* @param[in] color The color of the ellipse
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(fillellipse)(coord_t UNUSED(x), coord_t UNUSED(y), coord_t UNUSED(a), coord_t UNUSED(b), color_t UNUSED(color)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if (GDISP_NEED_TEXT && GDISP_HARDWARE_TEXT) || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Draw a character using a transparent background.
|
||
|
|
* @note Optional - The high level driver can emulate using software.
|
||
|
|
*
|
||
|
|
* @param[in] x, y The top-left corner of the text
|
||
|
|
* @param[in] c The character to print
|
||
|
|
* @param[in] color The color of the character
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(drawchar)(coord_t UNUSED(x), coord_t UNUSED(y), char UNUSED(c), font_t UNUSED(font), color_t UNUSED(color)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if (GDISP_NEED_TEXT && GDISP_HARDWARE_TEXTFILLS) || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Draw a character using a filled background.
|
||
|
|
* @note Optional - The high level driver can emulate using software.
|
||
|
|
*
|
||
|
|
* @param[in] x, y The top-left corner of the text
|
||
|
|
* @param[in] c The character to print
|
||
|
|
* @param[in] color The color of the character
|
||
|
|
* @param[in] bgcolor The background color
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(fillchar)(coord_t UNUSED(x), coord_t UNUSED(y), char UNUSED(c), font_t UNUSED(font), color_t UNUSED(color), color_t UNUSED(bgcolor)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if (GDISP_NEED_PIXELREAD && GDISP_HARDWARE_PIXELREAD) || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Get the color of a particular pixel.
|
||
|
|
* @note Optional.
|
||
|
|
* @note If x,y is off the screen, the result is undefined.
|
||
|
|
*
|
||
|
|
* @param[in] x, y The start of the text
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
color_t GDISP_LLD(getpixelcolor)(coord_t UNUSED(x), coord_t UNUSED(y)) {
|
||
|
|
return 0;
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if (GDISP_NEED_SCROLL && GDISP_HARDWARE_SCROLL) || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Scroll vertically a section of the screen.
|
||
|
|
* @note Optional.
|
||
|
|
* @note If x,y + cx,cy is off the screen, the result is undefined.
|
||
|
|
* @note If lines is >= cy, it is equivelent to a area fill with bgcolor.
|
||
|
|
*
|
||
|
|
* @param[in] x, y The start of the area to be scrolled
|
||
|
|
* @param[in] cx, cy The size of the area to be scrolled
|
||
|
|
* @param[in] lines The number of lines to scroll (Can be positive or negative)
|
||
|
|
* @param[in] bgcolor The color to fill the newly exposed area.
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(verticalscroll)(coord_t UNUSED(x), coord_t UNUSED(y), coord_t UNUSED(cx), coord_t UNUSED(cy), int UNUSED(lines), color_t UNUSED(bgcolor)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if (GDISP_NEED_CONTROL && GDISP_HARDWARE_CONTROL) || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Driver Control
|
||
|
|
* @detail Unsupported control codes are ignored.
|
||
|
|
* @note The value parameter should always be typecast to (void *).
|
||
|
|
* @note There are some predefined and some specific to the low level driver.
|
||
|
|
* @note GDISP_CONTROL_POWER - Takes a gdisp_powermode_t
|
||
|
|
* GDISP_CONTROL_ORIENTATION - Takes a gdisp_orientation_t
|
||
|
|
* GDISP_CONTROL_BACKLIGHT - Takes an int from 0 to 100. For a driver
|
||
|
|
* that only supports off/on anything other
|
||
|
|
* than zero is on.
|
||
|
|
* GDISP_CONTROL_CONTRAST - Takes an int from 0 to 100.
|
||
|
|
* GDISP_CONTROL_LLD - Low level driver control constants start at
|
||
|
|
* this value.
|
||
|
|
*
|
||
|
|
* @param[in] what What to do.
|
||
|
|
* @param[in] value The value to use (always cast to a void *).
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void GDISP_LLD(control)(unsigned UNUSED(what), void *UNUSED(value)) {
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#if (GDISP_NEED_QUERY && GDISP_HARDWARE_QUERY) || defined(__DOXYGEN__)
|
||
|
|
/**
|
||
|
|
* @brief Query a driver value.
|
||
|
|
* @detail Typecase the result to the type you want.
|
||
|
|
* @note GDISP_QUERY_WIDTH - (coord_t) Gets the width of the screen
|
||
|
|
* GDISP_QUERY_HEIGHT - (coord_t) Gets the height of the screen
|
||
|
|
* GDISP_QUERY_POWER - (gdisp_powermode_t) Get the current powermode
|
||
|
|
* GDISP_QUERY_ORIENTATION - (gdisp_orientation_t) Get the current screen orientation
|
||
|
|
* GDISP_QUERY_BACKLIGHT - (coord_t) Get the backlight state (0 to 100)
|
||
|
|
* GDISP_QUERY_CONTRAST - (coord_t) Get the contrast (0 to 100).
|
||
|
|
* GDISP_QUERY_LLD - Low level driver control constants start at
|
||
|
|
* this value.
|
||
|
|
*
|
||
|
|
* @param[in] what What to Query
|
||
|
|
*
|
||
|
|
* @notapi
|
||
|
|
*/
|
||
|
|
void *GDISP_LLD(query)(unsigned what) {
|
||
|
|
switch(what) {
|
||
|
|
case GDISP_QUERY_WIDTH: return (void *)(unsigned)GDISP.Width;
|
||
|
|
case GDISP_QUERY_HEIGHT: return (void *)(unsigned)GDISP.Height;
|
||
|
|
case GDISP_QUERY_POWER: return (void *)(unsigned)GDISP.Powermode;
|
||
|
|
case GDISP_QUERY_ORIENTATION: return (void *)(unsigned)GDISP.Orientation;
|
||
|
|
case GDISP_QUERY_BACKLIGHT: return (void *)(unsigned)GDISP.Backlight;
|
||
|
|
case GDISP_QUERY_CONTRAST: return (void *)(unsigned)GDISP.Contrast;
|
||
|
|
case GDISP_QUERY_LLD+0:
|
||
|
|
/* Code here */
|
||
|
|
default: return (void *)-1;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#endif /* HAL_USE_GDISP */
|
||
|
|
/** @} */
|