lcd/ST7565R.h

/**
 * \file ST7565R.h
 * \brief Constants relating to ST7565R LCD controller.
 * \author Andy Gock
 *
 * Constants and functions specific to ST7565R.
 * Tested with Newhaven Display model NHD-C12864WC-FSW-FBW-3V3-M
 * 
 * \todo Need to move functions to be controller independent
 *
 */ 

/*
	Copyright (c) 2012, Andy Gock

	All rights reserved.

	Redistribution and use in source and binary forms, with or without
	modification, are permitted provided that the following conditions are met:
		* Redistributions of source code must retain the above copyright
		  notice, this list of conditions and the following disclaimer.
		* Redistributions in binary form must reproduce the above copyright
		  notice, this list of conditions and the following disclaimer in the
		  documentation and/or other materials provided with the distribution.
		* Neither the name of Andy Gock nor the
		  names of its contributors may be used to endorse or promote products
		  derived from this software without specific prior written permission.

	THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND
	ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
	WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
	DISCLAIMED. IN NO EVENT SHALL ANDY GOCK BE LIABLE FOR ANY
	DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES
	(INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
	LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND
	ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
	(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
	SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/

#ifndef ST7565R_H_
#define ST7565R_H_

#include "stdint.h"

/* Commands */
#define ST7565R_DISPLAY_ON               0xAF /* 0b10101111 */
#define ST7565R_DISPLAY_OFF              0xAE /* 0b10101110 */
#define ST7565R_PAGE_ADDRESS_SET         0xB0 /* 0b10110000 */
#define ST7565R_COLUMN_ADDRESS_SET_LOWER 0x00 
#define ST7565R_COLUMN_ADDRESS_SET_UPPER 0x10 
#define ST7565R_DISPLAY_NORMAL           0xA4 /* 0b10100100 */
#define ST7565R_DISPLAY_ALL_ON           0xA5 /* 0b10100101 */
#define ST7565R_NORMAL                   0xA0 /* 0b10100000 */
#define ST7565R_REVERSE                  0xA1 /* 0b10100001 */
#define ST7565R_RESET                    0xE2 /* 0b11100010 */
#define ST7565R_SET_START_LINE           (1<<6)

	/**
	 * User specified GLCD width in pixels
	 * Set to 0 for automatic assignment based on controller.
	 */
#define GLCD_LCD_WIDTH1  128

	/**
	 * User specified GLCD height in pixels
	 * Set to 0 for automatic assignment based on controller.
	 */

#define GLCD_LCD_HEIGHT1 64


#define GLCD_NUMBER_OF_BANKS1 (GLCD_LCD_WIDTH1 / 8)
#define GLCD_NUMBER_OF_COLS1  GLCD_LCD_WIDTH1

/* These functions only available on ST7565 implementation (for now) */

/* Private functions */
void glcd_set_column_upper(uint8_t addr);
void glcd_set_column_lower(uint8_t addr);

/** All display points on (native) */
void glcd_all_on(void);

/** Set to normal mode */
void glcd_normal(void);

/** Set start line/page */
void glcd_set_start_line(uint8_t addr);

/** Clear the display immediately, does not buffer */
void glcd_clear_now(void);

/** Show a black and white line pattern on the display */
void glcd_pattern(void);

/** Init ST7565R controller / display */
void glcd_ST7565R_init(void);

void glcd_write(void);

void glcd_set_y_address(uint8_t y);

void glcd_set_x_address(uint8_t x);

void glcd_data(uint8_t c);

#endif /* ST7565R_H_ */