mirror of
https://github.com/apache/nuttx.git
synced 2026-05-15 21:19:09 +08:00
Add driver for ST7565 that works with NHD‐C12864KGZ display. From Pierre-noel Bouteville.
This commit is contained in:
Gregory Nutt
+42
-1
@@ -330,6 +330,47 @@ config SSD1306_FREQUENCY
|
||||
|
||||
endif
|
||||
|
||||
config LCD_ST7565
|
||||
bool "ST7565 LCD Display Module"
|
||||
default n
|
||||
---help---
|
||||
LCD Display Module, ST7565, Univision Technology Inc.
|
||||
|
||||
Required LCD driver settings:
|
||||
LCD_MAXCONTRAST should be 255, but any value >0 and <=255 will be accepted.
|
||||
|
||||
if LCD_ST7565
|
||||
|
||||
choice
|
||||
prompt "LCD Display Module initialization sequence"
|
||||
default NHD_C12864KGZ
|
||||
|
||||
config NHD_C12864KGZ
|
||||
bool "like NHD C12864KGZ"
|
||||
|
||||
endchoice
|
||||
|
||||
config ST7565_NINTERFACES
|
||||
int "Number of ST7565 Devices"
|
||||
default 1
|
||||
---help---
|
||||
Specifies the number of physical ST7565 devices that will be
|
||||
supported. NOTE: At present, this must be undefined or defined to be 1.
|
||||
|
||||
config ST7565_XRES
|
||||
int "ST7565 X Resolution"
|
||||
default 128
|
||||
---help---
|
||||
Specifies the X resolution of the LCD.
|
||||
|
||||
config ST7565_YRES
|
||||
int "ST7565 Y Resolution"
|
||||
default 64
|
||||
---help---
|
||||
Specifies the Y resolution of the LCD.
|
||||
|
||||
endif # LCD_ST7565
|
||||
|
||||
config LCD_ST7567
|
||||
bool "ST7567 LCD Display Module"
|
||||
default n
|
||||
@@ -386,7 +427,7 @@ config ST7567_YRES
|
||||
---help---
|
||||
Specifies the Y resolution of the LCD.
|
||||
|
||||
endif
|
||||
endif # LCD_ST7567
|
||||
|
||||
config LCD_UG2864AMBAG01
|
||||
bool "UG-2864AMBAG01 OLED Display Module"
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@@ -0,0 +1,144 @@
|
||||
/**************************************************************************************
|
||||
* drivers/lcd/st7565.h
|
||||
*
|
||||
* Definitions for the ST7565 128x64 Dot Matrix LCD
|
||||
* Driver with C
|
||||
*
|
||||
* Copyright (C) 2014 Pierre-noel Bouteville. All rights reserved.
|
||||
* Author: Pierre-noel Boutevlle <pnb990@gmail.com>
|
||||
*
|
||||
* Based on drivers/lcd/st7567.h
|
||||
* Copyright (C) 2013 Zilogic Systems. All rights reserved.
|
||||
* Author: Manikandan <code@zilogic.com>
|
||||
*
|
||||
* Based on drivers/lcd/ssd1305.h
|
||||
*
|
||||
* Copyright (C) 2010 Gregory Nutt. All rights reserved.
|
||||
* Author: Gregory Nutt <gnutt@nuttx.org>
|
||||
*
|
||||
* References: SSD1305.pdf, "Solomon Systech SSD1305 136x64 Dot Matrix OLED/PLED
|
||||
* Segment/Common Driver with Controller," Solomon Systech Limited,
|
||||
* http://www.solomon-systech.com, May, 2008.
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions
|
||||
* are met:
|
||||
*
|
||||
* 1. Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* 2. 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.
|
||||
* 3. Neither the name NuttX 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 THE
|
||||
* COPYRIGHT OWNER OR CONTRIBUTORS 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 __DRIVERS_LCD_ST7565_H
|
||||
#define __DRIVERS_LCD_ST7565_H
|
||||
|
||||
/**************************************************************************************
|
||||
* Included Files
|
||||
**************************************************************************************/
|
||||
|
||||
/**************************************************************************************
|
||||
* Pre-processor Definitions
|
||||
**************************************************************************************/
|
||||
|
||||
/* Fundamental Commands ***************************************************************/
|
||||
|
||||
#define ST7565_DISPOFF 0xae /* 0xae: Display OFF (sleep mode) */
|
||||
#define ST7565_DISPON 0xaf /* 0xaf: Display ON in normal mode */
|
||||
|
||||
#define ST7565_SETSTARTLINE 0x40 /* 0x40-7f: Set display start line */
|
||||
# define ST7565_STARTLINE_MASK 0x3f
|
||||
|
||||
#define ST7565_SETPAGESTART 0xb0 /* 0xb0-b7: Set page start address */
|
||||
# define ST7565_PAGESTART_MASK 0x0f
|
||||
|
||||
#define ST7565_SETCOLL 0x00 /* 0x00-0x0f: Set lower column address */
|
||||
# define ST7565_COLL_MASK 0x0f
|
||||
#define ST7565_SETCOLH 0x10 /* 0x10-0x1f: Set higher column address */
|
||||
# define ST7565_COLH_MASK 0x0f
|
||||
|
||||
#define ST7565_ADCNORMAL 0xa0 /* 0xa6: ADC Normal */
|
||||
#define ST7565_ADCINVERSE 0xa1 /* 0xa7: ADC Inverse */
|
||||
|
||||
#define ST7565_DISPNORMAL 0xa6 /* 0xa6: Normal display */
|
||||
#define ST7565_DISPINVERSE 0xa7 /* 0xa7: Inverse display */
|
||||
|
||||
#define ST7565_DISPRAM 0xa4 /* 0xa4: Resume to RAM content display */
|
||||
#define ST7565_DISPENTIRE 0xa5 /* 0xa5: Entire display ON */
|
||||
|
||||
#define ST7565_BIAS_1_9 0xa2 /* 0xa2: Select BIAS setting 1/9 */
|
||||
#define ST7565_BIAS_1_7 0xa3 /* 0xa3: Select BIAS setting 1/7 */
|
||||
|
||||
#define ST7565_ENTER_RMWMODE 0xe0 /* 0xe0: Enter the Read Modify Write mode */
|
||||
#define ST7565_EXIT_RMWMODE 0xee /* 0xee: Leave the Read Modify Write mode */
|
||||
#define ST7565_EXIT_SOFTRST 0xe2 /* 0xe2: Software RESET */
|
||||
|
||||
#define ST7565_SETCOMNORMAL 0xc0 /* 0xc0: Set COM output direction, normal mode */
|
||||
#define ST7565_SETCOMREVERSE 0xc8 /* 0xc8: Set COM output direction, reverse mode */
|
||||
|
||||
#define ST7565_POWERCTRL_EXT 0x28 /* 0x28: Only the external power supply is used */
|
||||
#define ST7565_POWERCTRL_VF 0x29 /* 0x29: Only the V/F circuit is used */
|
||||
#define ST7565_POWERCTRL_VR 0x2b /* 0x2b: Only the voltage regulator circuit and the
|
||||
* voltage follower circuit are used
|
||||
*/
|
||||
#define ST7565_POWERCTRL_INT 0x2f /* 0x2f: Only the internal power supply is used */
|
||||
|
||||
/* Regulation Resistior ratio V0 = (1+Rb/Ra)*Vev */
|
||||
|
||||
#define ST7565_REG_RES_3_0 0x20 /* (Ra/Rb = 3.0) */
|
||||
#define ST7565_REG_RES_3_5 0x21 /* (Ra/Rb = 5.5) */
|
||||
#define ST7565_REG_RES_4_0 0x22 /* (Ra/Rb = 4.0) */
|
||||
#define ST7565_REG_RES_4_5 0x23 /* (Ra/Rb = 4.5) */
|
||||
#define ST7565_REG_RES_5_0 0x24 /* (Ra/Rb = 5.0) */
|
||||
#define ST7565_REG_RES_5_5 0x25 /* (Ra/Rb = 5.5) */
|
||||
#define ST7565_REG_RES_6_0 0x26 /* (Ra/Rb = 6.0) */
|
||||
#define ST7565_REG_RES_6_5 0x27 /* (Ra/Rb = 6.5) */
|
||||
|
||||
/* Set Electronic volume mode */
|
||||
|
||||
#define ST7565_SETEVMODE 0x81 /* 0x81: Set contrast control */
|
||||
|
||||
/* Set Ev value register
|
||||
* ratio Vev = (1-a/162)*Vreg, Vreg = 2.1V
|
||||
*/
|
||||
|
||||
#define ST7565_SETEVREG(x) (0x0 | ((x) & 0x3F))
|
||||
|
||||
/* Set booster ratio */
|
||||
|
||||
#define ST7565_MODE_NORMAL 0xac /* Set Normal Mode */
|
||||
#define ST7565_MODE_SLEEP 0xad /* Set Sleep Mode */
|
||||
|
||||
/* Set booster ratio */
|
||||
|
||||
#define ST7565_SETBOOSTER 0xf8
|
||||
#define ST7565_SETBOOSTER4X 0x00 /* x2, x3, x4 */
|
||||
#define ST7565_SETBOOSTER5X 0x01 /* x5 */
|
||||
#define ST7565_SETBOOSTER6X 0x02 /* x6 */
|
||||
|
||||
#define ST7565_NOP 0xe3 /* 0xe3: NOP Command for no operation */
|
||||
|
||||
/**************************************************************************************
|
||||
* Public Data
|
||||
**************************************************************************************/
|
||||
|
||||
#endif /* __DRIVERS_LCD_ST7565_H */
|
||||
Executable
+152
@@ -0,0 +1,152 @@
|
||||
/****************************************************************************
|
||||
* include/nuttx/lcd/st7565.h
|
||||
*
|
||||
* Definitions for the ST7565 128x64 Dot Matrix LCD
|
||||
* Driver with C
|
||||
*
|
||||
* Copyright (C) 2014 Pierre-noel Bouteville. All rights reserved.
|
||||
* Author: Pierre-noel Boutevlle <pnb990@gmail.com>
|
||||
*
|
||||
* Based on drivers/lcd/st7567.h
|
||||
*
|
||||
* Copyright (C) 2013 Zilogic Systems. All rights reserved.
|
||||
* Author: Manikandan <code@zilogic.com>
|
||||
*
|
||||
* Based on include/nuttx/lcd/ug-9664hswag01.h
|
||||
*
|
||||
* Copyright (C) 2011-2012 Gregory Nutt. All rights reserved.
|
||||
* Author: Gregory Nutt <gnutt@nuttx.org>
|
||||
*
|
||||
* Redistribution and use in source and binary forms, with or without
|
||||
* modification, are permitted provided that the following conditions
|
||||
* are met:
|
||||
*
|
||||
* 1. Redistributions of source code must retain the above copyright
|
||||
* notice, this list of conditions and the following disclaimer.
|
||||
* 2. 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.
|
||||
* 3. Neither the name NuttX 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 THE
|
||||
* COPYRIGHT OWNER OR CONTRIBUTORS 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 __INCLUDE_NUTTX_ST7565_H
|
||||
#define __INCLUDE_NUTTX_ST7565_H
|
||||
|
||||
/****************************************************************************
|
||||
* Included Files
|
||||
****************************************************************************/
|
||||
|
||||
#include <stdbool.h>
|
||||
|
||||
/****************************************************************************
|
||||
* Pre-processor Definitions
|
||||
****************************************************************************/
|
||||
|
||||
/* ST7565 Configuration Settings:
|
||||
*
|
||||
* CONFIG_ST7565_NINTERFACES - Specifies the number of physical
|
||||
* ST7565 devices that will be supported. NOTE: At present, this
|
||||
* must be undefined or defined to be 1.
|
||||
*
|
||||
* Required LCD driver settings:
|
||||
* CONFIG_LCD_ST7565 - Enable ST7565 support
|
||||
* CONFIG_LCD_MAXCONTRAST should be 255, but any value >0 and <=255 will be
|
||||
* accepted.
|
||||
*/
|
||||
|
||||
/* Some important "colors" */
|
||||
|
||||
#define ST7565_Y1_BLACK 0
|
||||
#define ST7565_Y1_WHITE 1
|
||||
|
||||
/****************************************************************************
|
||||
* Public Types
|
||||
****************************************************************************/
|
||||
|
||||
struct st7565_lcd_s
|
||||
{
|
||||
/* Interface to control the st7565 like lcd driver
|
||||
*
|
||||
* - reset Switch reset pin of LCD (optional but as your risk).
|
||||
* - select Select the device (as neccessary) before performing any
|
||||
* operations.
|
||||
* - deselect Deselect the device (as necessary).
|
||||
* - cmddata Select command (A0 = 0) or data (A0 = 1) mode .
|
||||
* - senddata Send data to the LCD driver.
|
||||
* - backlight Change the backlight level of the connected display.
|
||||
* In the context of the ili9341 that means change the
|
||||
* backlight level of the connected LED driver.
|
||||
* The implementation in detail is part of the platform
|
||||
* specific sub driver.
|
||||
*/
|
||||
|
||||
void (*reset)(FAR struct st7565_lcd_s *lcd, bool on);
|
||||
void (*select)(FAR struct st7565_lcd_s *lcd);
|
||||
void (*deselect)(FAR struct st7565_lcd_s *lcd);
|
||||
void (*cmddata)(FAR struct st7565_lcd_s *lcd, const uint8_t cmd);
|
||||
int (*senddata)(FAR struct st7565_lcd_s *lcd, FAR const uint8_t *data,
|
||||
int size);
|
||||
int (*backlight)(FAR struct st7565_lcd_s *lcd, int level);
|
||||
|
||||
/* MCU interface specific data following */
|
||||
};
|
||||
|
||||
/****************************************************************************
|
||||
* Public Data
|
||||
****************************************************************************/
|
||||
|
||||
#ifdef __cplusplus
|
||||
extern "C"
|
||||
{
|
||||
#endif
|
||||
|
||||
/****************************************************************************
|
||||
* Public Function Prototypes
|
||||
****************************************************************************/
|
||||
|
||||
/****************************************************************************
|
||||
* Name: st7565_initialize
|
||||
*
|
||||
* Description:
|
||||
* Initialize the ST7565 video hardware. The initial state of the
|
||||
* LCD is fully initialized, display memory cleared, and the LCD ready
|
||||
* to use, but with the power setting at 0 (full off == sleep mode).
|
||||
*
|
||||
* Input Parameters:
|
||||
*
|
||||
* spi - A reference to the SPI driver instance.
|
||||
* devno - A value in the range of 0 throw CONFIG_ST7565_NINTERFACES-1.
|
||||
* This allows support for multiple LCD devices.
|
||||
*
|
||||
* Returned Value:
|
||||
*
|
||||
* On success, this function returns a reference to the LCD object for
|
||||
* the specified LCD. NULL is returned on any failure.
|
||||
*
|
||||
****************************************************************************/
|
||||
|
||||
FAR struct lcd_dev_s *st7565_initialize(FAR struct st7565_lcd_s *lcd,
|
||||
unsigned int devno);
|
||||
|
||||
#ifdef __cplusplus
|
||||
}
|
||||
#endif
|
||||
|
||||
#endif /* __INCLUDE_NUTTX_ST7567_H */
|
||||
Reference in New Issue
Block a user