Fork of Silabs MemoryLCD library

Dependents:   demoUI whrmDemoUI Host_Software_MAX32664GWEB_HR_EXTENDED Host_Software_MAX32664GWEC_SpO2_HR-_EXTE ... more

C++ library for Sharp Microelectronics 1.28 inch LCD TFT, LS013B7DH03, SPI bus. Forked from Silicon Labs MemoryLCD display driver.

Committer:
stevew817
Date:
Tue May 05 14:32:28 2015 +0000
Revision:
3:c34c3e4e33fc
Parent:
2:2f10f00fe56c
Child:
12:ca0bcb4777e9
CallbackPointer.h got deprecated

Who changed what in which revision?

UserRevisionLine numberNew contents of line
Steven Cooreman 0:a0faa86660d4 1 /***************************************************************************//**
Steven Cooreman 0:a0faa86660d4 2 * @file LS013B7DH03.h
Steven Cooreman 0:a0faa86660d4 3 * @brief Driver class for the Sharp LS013B7DH03 memory LCD on some kits.
Steven Cooreman 0:a0faa86660d4 4 *******************************************************************************
Steven Cooreman 0:a0faa86660d4 5 * @section License
Steven Cooreman 0:a0faa86660d4 6 * <b>(C) Copyright 2015 Silicon Labs, http://www.silabs.com</b>
Steven Cooreman 0:a0faa86660d4 7 *******************************************************************************
Steven Cooreman 0:a0faa86660d4 8 *
Steven Cooreman 0:a0faa86660d4 9 * Permission is granted to anyone to use this software for any purpose,
Steven Cooreman 0:a0faa86660d4 10 * including commercial applications, and to alter it and redistribute it
Steven Cooreman 0:a0faa86660d4 11 * freely, subject to the following restrictions:
Steven Cooreman 0:a0faa86660d4 12 *
Steven Cooreman 0:a0faa86660d4 13 * 1. The origin of this software must not be misrepresented; you must not
Steven Cooreman 0:a0faa86660d4 14 * claim that you wrote the original software.
Steven Cooreman 0:a0faa86660d4 15 * 2. Altered source versions must be plainly marked as such, and must not be
Steven Cooreman 0:a0faa86660d4 16 * misrepresented as being the original software.
Steven Cooreman 0:a0faa86660d4 17 * 3. This notice may not be removed or altered from any source distribution.
Steven Cooreman 0:a0faa86660d4 18 *
Steven Cooreman 0:a0faa86660d4 19 * DISCLAIMER OF WARRANTY/LIMITATION OF REMEDIES: Silicon Labs has no
Steven Cooreman 0:a0faa86660d4 20 * obligation to support this Software. Silicon Labs is providing the
Steven Cooreman 0:a0faa86660d4 21 * Software "AS IS", with no express or implied warranties of any kind,
Steven Cooreman 0:a0faa86660d4 22 * including, but not limited to, any implied warranties of merchantability
Steven Cooreman 0:a0faa86660d4 23 * or fitness for any particular purpose or warranties against infringement
Steven Cooreman 0:a0faa86660d4 24 * of any proprietary rights of a third party.
Steven Cooreman 0:a0faa86660d4 25 *
Steven Cooreman 0:a0faa86660d4 26 * Silicon Labs will not be liable for any consequential, incidental, or
Steven Cooreman 0:a0faa86660d4 27 * special damages, or any other relief, or for any claim by any third party,
Steven Cooreman 0:a0faa86660d4 28 * arising from your use of this Software.
Steven Cooreman 0:a0faa86660d4 29 *
Steven Cooreman 0:a0faa86660d4 30 ******************************************************************************/
Steven Cooreman 0:a0faa86660d4 31
Steven Cooreman 0:a0faa86660d4 32 #ifndef SILABS_LS013B7DH03_H
Steven Cooreman 0:a0faa86660d4 33 #define SILABS_LS013B7DH03_H
Steven Cooreman 0:a0faa86660d4 34
Steven Cooreman 0:a0faa86660d4 35 #include "platform.h"
Steven Cooreman 0:a0faa86660d4 36 #include <mbed.h>
Steven Cooreman 0:a0faa86660d4 37 #include "LCDSettings.h"
Steven Cooreman 0:a0faa86660d4 38 #include "BufferedDisplay.h"
Steven Cooreman 0:a0faa86660d4 39
Steven Cooreman 0:a0faa86660d4 40 typedef void (*cbptr_t)(void);
Steven Cooreman 0:a0faa86660d4 41
Steven Cooreman 0:a0faa86660d4 42 #define LS013B7DH03_ERROR_BUSY -1
Steven Cooreman 0:a0faa86660d4 43 #define LS013B7DH03_ERROR_SPI_BUSY -2
Steven Cooreman 0:a0faa86660d4 44 #define LS013B7DH03_NO_ACTION -3
Steven Cooreman 0:a0faa86660d4 45 #define LS013B7DH03_ERROR_ARGUMENT -4
Steven Cooreman 0:a0faa86660d4 46 #define LS013B7DH03_OK 0
Steven Cooreman 0:a0faa86660d4 47
Steven Cooreman 0:a0faa86660d4 48 typedef enum {
Steven Cooreman 0:a0faa86660d4 49 IDLE, // No operation currently ongoing
Steven Cooreman 0:a0faa86660d4 50 CLEARING, // In the process of clearing the display
Steven Cooreman 0:a0faa86660d4 51 WRITING, // In the process of sending a display update
Steven Cooreman 0:a0faa86660d4 52 WAIT_CLEAR, // Going to clear after CS pin timeout
Steven Cooreman 0:a0faa86660d4 53 WAIT_WRITE, // Going to write after CS pin timeout
Steven Cooreman 0:a0faa86660d4 54 TRANSFERS_DONE, // Last transfer in progress
Steven Cooreman 0:a0faa86660d4 55 DONE // Done with transmission, waiting for CS pin to become high
Steven Cooreman 0:a0faa86660d4 56 } LS013B7DH03_state_t;
Steven Cooreman 0:a0faa86660d4 57
Steven Cooreman 0:a0faa86660d4 58 namespace silabs {
Steven Cooreman 1:6332f3383fb6 59 class LS013B7DH03 : public BufferedDisplay {
Steven Cooreman 2:2f10f00fe56c 60
Steven Cooreman 0:a0faa86660d4 61 public:
Steven Cooreman 0:a0faa86660d4 62
Steven Cooreman 0:a0faa86660d4 63 LS013B7DH03(SPI * spi, DigitalOut * CS, DigitalOut * ExtCom, const char *name=NULL);
Steven Cooreman 0:a0faa86660d4 64
Steven Cooreman 0:a0faa86660d4 65 /**
Steven Cooreman 0:a0faa86660d4 66 * Call this function to push all changes to the display
Steven Cooreman 0:a0faa86660d4 67 */
Steven Cooreman 0:a0faa86660d4 68 int update( cbptr_t callback = NULL );
Steven Cooreman 0:a0faa86660d4 69
Steven Cooreman 0:a0faa86660d4 70 /**
Steven Cooreman 0:a0faa86660d4 71 * Immediately clear the display: set pixel buffer to zero and clear out the display.
Steven Cooreman 0:a0faa86660d4 72 */
Steven Cooreman 0:a0faa86660d4 73 int clearImmediate( cbptr_t callback = NULL );
Steven Cooreman 0:a0faa86660d4 74
Steven Cooreman 0:a0faa86660d4 75 /**
Steven Cooreman 0:a0faa86660d4 76 * Function to test display buffer
Steven Cooreman 0:a0faa86660d4 77 */
Steven Cooreman 0:a0faa86660d4 78 int showDemo();
Steven Cooreman 0:a0faa86660d4 79
Steven Cooreman 0:a0faa86660d4 80 /**
Steven Cooreman 2:2f10f00fe56c 81 * Function to get internal refresh counter
Steven Cooreman 0:a0faa86660d4 82 */
Steven Cooreman 0:a0faa86660d4 83 uint32_t getRefreshTicks();
Steven Cooreman 0:a0faa86660d4 84
Steven Cooreman 0:a0faa86660d4 85 protected:
Steven Cooreman 0:a0faa86660d4 86 mbed::SPI *_spi;
Steven Cooreman 0:a0faa86660d4 87 mbed::DigitalOut *_EXTCOM;
Steven Cooreman 0:a0faa86660d4 88 mbed::DigitalOut *_CS;
Steven Cooreman 0:a0faa86660d4 89
Steven Cooreman 0:a0faa86660d4 90 mbed::LowPowerTicker _displayToggler;
Steven Cooreman 0:a0faa86660d4 91 mbed::LowPowerTimeout _csTimeout;
Steven Cooreman 0:a0faa86660d4 92
Steven Cooreman 2:2f10f00fe56c 93 event_callback_t _internalEventCallback;
Steven Cooreman 0:a0faa86660d4 94 volatile uint32_t _refreshCount;
Steven Cooreman 0:a0faa86660d4 95 uint8_t _lcdPolarity;
Steven Cooreman 0:a0faa86660d4 96 LS013B7DH03_state_t _state;
Steven Cooreman 0:a0faa86660d4 97 cbptr_t _completionCallbackPtr;
Steven Cooreman 0:a0faa86660d4 98 volatile uint32_t _rowCount;
Steven Cooreman 0:a0faa86660d4 99 uint8_t _cmd[2 + (DISPLAY_WIDTH / DISPLAY_BUFFER_TYPE_SIZE * sizeof(DISPLAY_BUFFER_TYPE))];
Steven Cooreman 0:a0faa86660d4 100
Steven Cooreman 0:a0faa86660d4 101 /**
Steven Cooreman 0:a0faa86660d4 102 * Callback handler for internal SPI transfers.
Steven Cooreman 0:a0faa86660d4 103 */
Steven Cooreman 0:a0faa86660d4 104 void _cbHandler( int event );
Steven Cooreman 0:a0faa86660d4 105
Steven Cooreman 0:a0faa86660d4 106 /**
Steven Cooreman 0:a0faa86660d4 107 * Callback handler for internal SPI transfers triggered by timeout.
Steven Cooreman 0:a0faa86660d4 108 */
Steven Cooreman 0:a0faa86660d4 109 void _cbHandlerTimeout( void );
Steven Cooreman 0:a0faa86660d4 110
Steven Cooreman 0:a0faa86660d4 111 /**
Steven Cooreman 2:2f10f00fe56c 112 * Call this function at 55 ~ 65 Hz to keep the display from losing contrast.
Steven Cooreman 0:a0faa86660d4 113 */
Steven Cooreman 0:a0faa86660d4 114 void toggle();
Steven Cooreman 0:a0faa86660d4 115 };
Steven Cooreman 0:a0faa86660d4 116
Steven Cooreman 0:a0faa86660d4 117 } // namespace silabs
Steven Cooreman 0:a0faa86660d4 118
Steven Cooreman 0:a0faa86660d4 119 #endif //SILABS_LS013B7DH03_H