sergiotarxz/nuttx
1
0
Fork 0
Code Issues Pull Requests Releases Wiki Activity
21501f65b1
nuttx/drivers/lcd/ssd1680.h
Huang Qi e09a79ece9 driver/ssd1680: Add support for 1.54 inch e-paper display 
Add configuration and driver support for the SSD1681 1.54 inch e-paper display,
including the necessary waveforms and settings for proper operation. This extends
the existing SSD1680 e-paper driver to accommodate the new display module.

The changes involve updates to the Kconfig file for additional configuration options,
modifications to the driver implementation in ssd1680.c to include SSD1681 specific
logic, and updates to the header file ssd1680.h to reflect the added support.

Signed-off-by: Huang Qi <huangqi3@xiaomi.com>
2024-08-04 23:14:55 +08:00

235 lines
8.1 KiB
C
Raw Blame History

/****************************************************************************
* drivers/lcd/ssd1680.h
*
* Licensed to the Apache Software Foundation (ASF) under one or more
* contributor license agreements. See the NOTICE file distributed with
* this work for additional information regarding copyright ownership. The
* ASF licenses this file to you under the Apache License, Version 2.0 (the
* "License"); you may not use this file except in compliance with the
* License. You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations
* under the License.
*
****************************************************************************/
#ifndef __DRIVERS_LCD_SSD1680_H
#define __DRIVERS_LCD_SSD1680_H
/****************************************************************************
* Included Files
****************************************************************************/
#include <nuttx/config.h>
#include <stdint.h>
#include <stdbool.h>
#include <nuttx/lcd/lcd.h>
#include <nuttx/lcd/ssd1680.h>
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
/* Configuration ************************************************************/
/* Limitations of the current configuration that I hope to fix someday */
#if !defined(CONFIG_LCD_SSD1680_2_13_V2) && \
!defined(CONFIG_LCD_SSD1680_2_90) && !defined(CONFIG_LCD_SSD1681_1_54)
# error "Unknown and unsupported SSD16800 LCD"
#endif
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
#ifndef CONFIG_NX_BGCOLOR
# define CONFIG_NX_BGCOLOR SSD1680_Y1_BLACK
#endif
/* SSD1680 Commands *********************************************************/
#define SSD1680_DRIVER_CONTROL 0x01
#define SSD1680_GATE_VOLTAGE 0x03
#define SSD1680_SOURCE_VOLTAGE 0x04
#define SSD1680_PROGOTP_INITIAL 0x08
#define SSD1680_PROGREG_INITIAL 0x09
#define SSD1680_READREG_INITIAL 0x0A
#define SSD1680_BOOST_SOFTSTART 0x0C
#define SSD1680_GATE_SCAN_POSITION 0x0F
#define SSD1680_DEEP_SLEEP 0x10
#define SSD1680_DATA_MODE 0x11
#define SSD1680_SW_RESET 0x12
#define SSD1680_TEMP_CONTROL 0x18
#define SSD1680_TEMP_WRITE 0x1A
/* Execute sequence written in Control Register 2
* Wait till SSD1680 is not busy
*/
#define SSD1680_MASTER_ACTIVATE 0x20
#define SSD1680_DISP_CTRL1 0x21
/* Set control register 2.
* 1 byte of data with following bits:
* 0x80 - enable clock signal
* 0x40 - enable analog
* 0x20 - load temperature value (endless busy state. Don't use)
* 0x10 - Load LUT (endless busy state. Probably OTP wasn't prepared)
* 0x08 - Display Mode 2
* 0x04 - disable OSC
* 0x01 - disable clock signal
* 0x02 - disable analog
*/
#define SSD1680_DISP_CTRL2 0x22
#define SSD1680_WRITE_RAM1 0x24
#define SSD1680_WRITE_RAM2 0x26
#define SSD1680_WRITE_VCOM 0x2C
#define SSD1680_READ_OTP 0x2D
#define SSD1680_READ_STATUS 0x2F
#define SSD1680_WRITE_LUT 0x32
#define SSD1680_DUMMY_LINE 0x3A
#define SSD1680_GATE_TIME 0x3B
#define SSD1680_WRITE_BORDER 0x3C
#define SSD1680_SET_RAMXPOS 0x44
#define SSD1680_SET_RAMYPOS 0x45
#define SSD1680_SET_RAMXCOUNT 0x4E
#define SSD1680_SET_RAMYCOUNT 0x4F
#define SSD1680_SET_ANALOG_BLOCK_CTRL 0x74
#define SSD1680_SET_DIGITAL_BLOCK_CTRL 0x7E
#define SSD1680_NOP 0x7F
/* Register Values **********************************************************/
# define SSD1680_VALUE_G_VOLTAGE 0x15
# define SSD1680_VALUE_S_VOLTAGE_1 0x41
# define SSD1680_VALUE_S_VOLTAGE_2 0xA8
# define SSD1680_VALUE_S_VOLTAGE_3 0x32
#if defined(CONFIG_LCD_SSD1680_2_13_V2) || defined(CONFIG_LCD_SSD1680_2_13_RED)
# define SSD1680_VALUE_VCOM 0x55
# define SSD1680_VALUE_DUMMY_LINE 0x30
# define SSD1680_VALUE_GATE_TIME 0x0A
# define SSD1680_VALUE_UPDATE_CTRL 0xC7
#elif defined(CONFIG_LCD_SSD1680_2_90) || defined(CONFIG_LCD_SSD1680_2_90_RED)
# define SSD1680_VALUE_VCOM 0xA8
# define SSD1680_VALUE_DUMMY_LINE 0x1A
# define SSD1680_VALUE_GATE_TIME 0x08
# define SSD1680_VALUE_UPDATE_CTRL 0xC7
#elif defined(CONFIG_LCD_SSD1681_1_54)
# define SSD1680_VALUE_UPDATE_CTRL 0xF7
#else
# error "Not supported display"
#endif
/* Color Properties *********************************************************/
#if defined(CONFIG_LCD_SSD1680_2_13_V2) || \
defined(CONFIG_LCD_SSD1680_2_90) || defined(CONFIG_LCD_SSD1681_1_54)
/* 1 bit per pixel */
# define SSD1680_DEV_COLORFMT FB_FMT_Y1
# define SSD1680_DEV_BPP 1
# define SSD1680_NO_OF_PLANES 1
#elif defined (CONFIG_LCD_SSD1680_2_13_RED) || (CONFIG_LCD_SSD1680_2_90_RED)
/* 2 bits per pixel, it is not agrayscale, but indexed colours */
# define SSD1680_DEV_COLORFMT FB_FMT_Y2
# define SSD1680_DEV_BPP 2
# define SSD1680_NO_OF_PLANES 1
#else
# error "Can't prepare macros for not supported display"
#endif
#if SSD1680_DEV_BPP == 1
# define SSD1680_PDF 3
# define SSD1680_PDV 8
#elif SSD1680_DEV_BPP == 2
# define SSD1680_PDF 2
# define SSD1680_PDV 4
#else
# error "SSD1680: Bits per pixel not defined"
#endif
/* Display Resolution
*
* The SSD1680 display controller can handle a resolution of 176/296.
* The portrait mode is default.
* Display size vs its resolution:
* 2.13 : 122 / 250
* 2.90 : 128 / 296
*/
#if defined(CONFIG_LCD_SSD1680_2_13_V2) || defined(CONFIG_LCD_SSD1680_2_13_RED)
# define SSD1680_DEV_GATE_LAYOUT 0x00
# define SSD1680_DEV_NATIVE_XRES 122
# define SSD1680_DEV_NATIVE_YRES 250
#elif defined(CONFIG_LCD_SSD1680_2_90) || defined(CONFIG_LCD_SSD1680_2_90_RED)
# define SSD1680_DEV_GATE_LAYOUT 0x00
# define SSD1680_DEV_NATIVE_XRES 128
# define SSD1680_DEV_NATIVE_YRES 296
#elif defined(CONFIG_LCD_SSD1681_1_54)
# define SSD1680_DEV_GATE_LAYOUT 0x01
# define SSD1680_DEV_NATIVE_XRES 200
# define SSD1680_DEV_NATIVE_YRES 200
#else
# error "Unknown resolution"
#endif
/* SSD1680 memory write algorithm */
#if defined(CONFIG_LCD_PORTRAIT)
# define SSD1680_VAL_DATA_MODE 0x03
#elif defined(CONFIG_LCD_RPORTRAIT)
# define SSD1680_VAL_DATA_MODE 0x02
#elif defined(CONFIG_LCD_LANDSCAPE)
# define SSD1680_VAL_DATA_MODE 0x07
#elif defined(CONFIG_LCD_RLANDSCAPE)
# define SSD1680_VAL_DATA_MODE 0x07
#else
# define SSD1680_VAL_DATA_MODE 0x03
#endif
/* Rotating screen if the orientation is changed */
#if defined(CONFIG_LCD_PORTRAIT) || defined(CONFIG_LCD_RPORTRAIT)
/* Calculate number of bytes per row.
* In case of tri-color display there are two 1-bit data arrays
* In order to simplify communication with controller, we need to provide
* a number that is multiplication of 8 (not 4 even if we have 2 bpp)
*/
# define SSD1680_DEV_ROWSIZE \
((SSD1680_DEV_NATIVE_XRES + SSD1680_PDV - 1) >> SSD1680_PDF)
# define SSD1680_DEV_FB_XRES SSD1680_DEV_NATIVE_XRES
# define SSD1680_DEV_FB_YRES SSD1680_DEV_NATIVE_YRES
#else /* Landstape */
# define SSD1680_DEV_ROWSIZE \
((SSD1680_DEV_NATIVE_YRES + SSD1680_PDV - 1) >> SSD1680_PDF)
# define SSD1680_DEV_FB_XRES SSD1680_DEV_NATIVE_YRES
# define SSD1680_DEV_FB_YRES SSD1680_DEV_NATIVE_XRES
#endif /* Landstape */
#define SSD1680_DEV_X_ROUND_UP \
(((SSD1680_DEV_NATIVE_XRES + SSD1680_PDV - 1) >> SSD1680_PDF) << SSD1680_PDF)
#define SSD1680_DEV_Y_ROUND_UP \
(((SSD1680_DEV_NATIVE_YRES + SSD1680_PDV - 1) >> SSD1680_PDF) << SSD1680_PDF)
#define SSD1680_DEV_FBSIZE ((SSD1680_DEV_ROWSIZE) * (SSD1680_DEV_FB_YRES))
/****************************************************************************
* Public Type Definition
****************************************************************************/
/****************************************************************************
* Public Function Prototypes
****************************************************************************/
#endif /* __DRIVERS_LCD_SSD1680_H */
Reference in New Issue View Git Blame Copy Permalink