Diff: Hotboards_SpiLcd.cpp

Revision:

0:1d03652e9f7a

Child:

1:b777b6147d99

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/Hotboards_SpiLcd.cpp	Thu Jan 28 22:45:39 2016 +0000
@@ -0,0 +1,262 @@
+/*
+  Hotboards_SpiLcd.cpp - Library for write and control and lcd with spi interfaces and the ST7032 controller.
+  base on Arduino's Liquid Cristal library
+  Library ported by diego from Hotboards January 16, 2016. 
+  and originally cretaed by
+  by David A. Mellis
+  library modified 5 Jul 2009
+  by Limor Fried (http://www.ladyada.net)
+  example added 9 Jul 2009
+  by Tom Igoe
+  modified 22 Nov 2010
+  by Tom Igoe
+  Released into the public domain.
+*/
+
+#include "Hotboards_SpiLcd.h"
+
+Hotboards_SpiLcd::Hotboards_SpiLcd( SPI &spi, PinName cs, PinName rs, PinName rst ) 
+    : _spi(spi), _cs_pin(cs), _rs_pin(rs), _rst_pin(rst) 
+{
+    _cs_pin = 1; /*chip select deactivated*/
+    _rs_pin = 0;
+    _rst_pin = 1; /*reset not active*/
+}
+
+/*
+ * send commands to initialize internal lcd controller
+ */
+void Hotboards_SpiLcd::init( void )
+{
+    _rst_pin = 0;
+    wait( 0.002 );
+    _rst_pin = 1;
+    wait( 0.02 );
+    command( 0x30 );/*wakeup*/
+    wait( 0.002 );
+    command( 0x30 );/*wakeup*/
+    command( 0x30 );/*wakeup*/
+    
+    // configure default display functions, two lines, 5x8 charcters
+    _displayfunction = HT_SPILCD_8BITMODE | HT_SPILCD_2LINE | HT_SPILCD_5x8DOTS | HT_SPILCD_EXTINST;
+    command( HT_SPILCD_FUNCTIONSET | _displayfunction );
+    
+    command( 0x14 );/*internaloscfrequency*/
+    command( 0x56 );/*powercontroll*/
+    command( 0x6d );/*followercontrol*/
+    wait( 0.2 );
+    command( 0x70 );/*constrast*/
+    
+    // reenable shift functions disbling extended instructions
+    _displayfunction &= ~HT_SPILCD_EXTINST;
+    command( HT_SPILCD_FUNCTIONSET | _displayfunction );
+    
+    // turn the display on with no cursor or blinking default
+    _displaycontrol = HT_SPILCD_DISPLAYON | HT_SPILCD_CURSOROFF | HT_SPILCD_BLINKOFF;  
+    display( );
+    
+    // Initialize to default text direction (for romance languages)
+    _displaymode = HT_SPILCD_ENTRYLEFT | HT_SPILCD_ENTRYSHIFTDECREMENT;
+    // set the entry mode
+    command( HT_SPILCD_ENTRYMODESET | _displaymode );
+    clear( );/*clearscreen*/
+}
+
+/*
+ * Clears the LCD screen and positions the cursor in the upper-left corner. 
+ */
+void Hotboards_SpiLcd::clear( void )
+{
+    command( HT_SPILCD_CLEARDISPLAY );  // clear display, set cursor position to zero
+    wait( 0.002 );          // this command takes a long time!   
+}
+
+/*
+ * Positions the cursor in the upper-left of the LCD. That is, use that location 
+ * in outputting subsequent text to the display. To also clear the display, use 
+ * the clear() function instead
+ */
+void Hotboards_SpiLcd::home( void )
+{
+    command( HT_SPILCD_RETURNHOME );      // set cursor position to zero
+    wait( 0.002 );          // this command takes a long time!   
+}
+
+/*
+ * Turns off the LCD display, without losing the text currently shown on it.
+ */
+void Hotboards_SpiLcd::noDisplay( void )
+{
+    _displaycontrol &= ~HT_SPILCD_DISPLAYON;
+    command( HT_SPILCD_DISPLAYCONTROL | _displaycontrol );
+}
+
+/*
+ * Turns on the LCD display, after it's been turned off with noDisplay(). 
+ * This will restore the text (and cursor) that was on the display. 
+ */
+void Hotboards_SpiLcd::display( void )
+{
+    _displaycontrol |= HT_SPILCD_DISPLAYON;
+    command( HT_SPILCD_DISPLAYCONTROL | _displaycontrol );  
+}
+
+/*
+ * Turns off the blinking LCD cursor. 
+ */
+void Hotboards_SpiLcd::noBlink( void )
+{
+    _displaycontrol &= ~HT_SPILCD_BLINKON;
+    command( HT_SPILCD_DISPLAYCONTROL | _displaycontrol );
+}    
+    
+/*
+ * Display the blinking LCD cursor. If used in combination with the cursor() function, 
+ * the result will depend on the particular display. 
+ */
+void Hotboards_SpiLcd::blink( void )
+{
+    _displaycontrol |= HT_SPILCD_BLINKON;
+    command( HT_SPILCD_DISPLAYCONTROL | _displaycontrol );
+}
+
+
+/*
+ * Hides the LCD cursor.
+ */
+void Hotboards_SpiLcd::noCursor( void )
+{
+    _displaycontrol &= ~HT_SPILCD_CURSORON;
+    command( HT_SPILCD_DISPLAYCONTROL | _displaycontrol );
+}
+
+/*
+ * Display the LCD cursor: an underscore (line) at the position to which the 
+ * next character will be written. 
+ */
+void Hotboards_SpiLcd::cursor( void )
+{
+    _displaycontrol |= HT_SPILCD_CURSORON;
+    command( HT_SPILCD_DISPLAYCONTROL | _displaycontrol );
+  
+}
+
+/*
+ * Scrolls the contents of the display (text and cursor) one space to the left. 
+ */
+void Hotboards_SpiLcd::scrollDisplayLeft( void )
+{
+    command( HT_SPILCD_CURSORSHIFT | HT_SPILCD_DISPLAYMOVE | HT_SPILCD_MOVELEFT );
+}
+
+/*
+ * Scrolls the contents of the display (text and cursor) one space to the right. 
+ */
+void Hotboards_SpiLcd::scrollDisplayRight( void )
+{
+    command( HT_SPILCD_CURSORSHIFT | HT_SPILCD_DISPLAYMOVE | HT_SPILCD_MOVERIGHT );  
+}
+
+/*
+ * Set the direction for text written to the LCD to left-to-right, the default. 
+ * This means that subsequent characters written to the display will go from left to right, 
+ * but does not affect previously-output text. 
+ */
+void Hotboards_SpiLcd::leftToRight( void )
+{
+    _displaymode |= HT_SPILCD_ENTRYLEFT;
+    command( HT_SPILCD_ENTRYMODESET | _displaymode );
+}
+
+/*
+ * Set the direction for text written to the LCD to right-to-left (the default is left-to-right). 
+ * This means that subsequent characters written to the display will go from right to left, 
+ * but does not affect previously-output text. 
+ */
+void Hotboards_SpiLcd::rightToLeft( void )
+{
+    _displaymode &= ~HT_SPILCD_ENTRYLEFT;
+    command( HT_SPILCD_ENTRYMODESET | _displaymode );  
+}
+
+/*
+ * Turns on automatic scrolling of the LCD. This causes each character 
+ * output to the display to push previous characters over by one space. 
+ * If the current text direction is left-to-right (the default), 
+ * the display scrolls to the left; if the current direction is right-to-left, 
+ * the display scrolls to the right. This has the effect of outputting 
+ * each new character to the same location on the LCD. 
+ */
+void Hotboards_SpiLcd::autoscroll( void )
+{
+    _displaymode |= HT_SPILCD_ENTRYSHIFTINCREMENT;
+    command( HT_SPILCD_ENTRYMODESET | _displaymode );
+}
+
+/*
+ * Turns off automatic scrolling of the LCD.
+ */
+void Hotboards_SpiLcd::noAutoscroll( void )
+{
+    _displaymode &= ~HT_SPILCD_ENTRYSHIFTINCREMENT;
+    command( HT_SPILCD_ENTRYMODESET | _displaymode );   
+}
+    
+/*
+ * Position the LCD cursor; that is, set the location at which subsequent 
+ * text written to the LCD will be displayed.
+ * col: the column at which to position the cursor (with 0 being the first column)
+ * row: the row at which to position the cursor (with 0 being the first row) 
+ */
+void Hotboards_SpiLcd::setCursor( uint8_t col, uint8_t row )
+{
+    const uint8_t Buffer[ 2 ]= { 0x00u, 0x40u };
+    uint8_t address;
+  
+    if( row > 1 )
+    {
+        row = 1;
+    }
+    address = Buffer[ row ] + col;
+    command( 0x80 | address );
+}
+
+
+/*********** mid level commands, for sending data/cmds */
+/*
+ * Write a character to the LCD.
+ * data: the character to write to the display
+ */
+inline void Hotboards_SpiLcd::command( uint8_t value )
+{
+    _cs_pin = 0;
+    send( value, 0 );
+    _cs_pin = 1;
+    wait( 0.00003 ); // commands need > 27us to settle
+}
+
+/*
+ * Write a character to the LCD.
+ */
+int Hotboards_SpiLcd::_putc(int value)
+{
+    _cs_pin = 0;
+    send( value, 1 );
+    _cs_pin = 1;
+    wait( 0.00003 ); // commands need > 27us to settle
+    return 1;
+}
+
+int Hotboards_SpiLcd::_getc(void)
+{
+    return -1;
+}
+
+/************ low level data pushing commands **********/
+
+// write either command or data, with automatic 4/8-bit selection
+void Hotboards_SpiLcd::send( uint8_t value, uint8_t mode ) 
+{
+    _rs_pin = mode;
+    _spi.write( value );
+}