RIOT-OS/RIOT
RIOT-OS/RIOT
1
0
Fork 0
mirror of https://github.com/RIOT-OS/RIOT.git synced 2024-12-29 04:50:03 +01:00
Code Releases Activity
1e9b1992df
RIOT/drivers/st77xx/include/st77xx_params.h

259 lines
8.7 KiB
C
Raw Blame History

/*
* Copyright (C) 2018 Koen Zandberg <koen@bergzand.net>
* 2021 Francisco Molina
* 2023 Gunar Schorcht
*
* This file is subject to the terms and conditions of the GNU Lesser
* General Public License v2.1. See the file LICENSE in the top level
* directory for more details.
*/
/**
* @ingroup drivers_st77xx
*
* @{
* @file
* @brief Default configuration for ST77xx LCD controllers
*
* @author Koen Zandberg <koen@bergzand.net>
* @author Francisco Molina <francois-xavier.molina@inria.fr>
* @author Gunar Schorcht <gunar@schorcht.net>
*/
#ifndef ST77XX_PARAMS_H
#define ST77XX_PARAMS_H
#include "board.h"
#include "lcd.h"
#include "st7735_params.h"
#ifdef __cplusplus
extern "C" {
#endif
#if !DOXYGEN /* hide from documentation */
/**
* @name Mapping of former ST7735 configuration parameters for backward compatibility
*
* If a board definition already used the ST7735 driver, `ST7735_*` macros were
* used in the board definitions to define the default configuration parameter
* set. For backward compatibility these symbols are mapped to the `ST77XX_*`
* macros if they are defined.
*
* @{
*/
#ifdef ST7735_PARAM_SPI
#define ST77XX_PARAM_SPI ST7735_PARAM_SPI
#endif
#ifdef ST7735_PARAM_SPI_CLK
#define ST77XX_PARAM_SPI_CLK ST7735_PARAM_SPI_CLK
#endif
#ifdef ST7735_PARAM_CS
#define ST77XX_PARAM_CS ST7735_PARAM_CS
#endif
#ifdef ST7735_PARAM_DCX
#define ST77XX_PARAM_DCX ST7735_PARAM_DCX
#endif
#ifdef ST7735_PARAM_RST
#define ST77XX_PARAM_RST ST7735_PARAM_RST
#endif
#ifdef ST7735_PARAM_SPI_MODE
#define ST77XX_PARAM_SPI_MODE ST7735_PARAM_SPI_MODE
#endif
#ifdef ST7735_PARAM_RGB
#define ST77XX_PARAM_RGB ST7735_PARAM_RGB
#endif
#ifdef ST7735_PARAM_INVERTED
#define ST77XX_PARAM_INVERTED ST7735_PARAM_INVERTED
#endif
#ifdef ST7735_PARAM_NUM_LINES
#define ST77XX_PARAM_NUM_LINES ST7735_PARAM_NUM_LINES
#endif
#ifdef ST7735_PARAM_RGB_CHANNELS
#define ST77XX_PARAM_RGB_CHANNELS ST7735_PARAM_RGB_CHANNELS
#endif
#ifdef ST7735_PARAM_ROTATION
#define ST77XX_PARAM_ROTATION ST7735_PARAM_ROTATION
#endif
#ifdef ST7735_PARAM_OFFSET_X
#define ST77XX_PARAM_OFFSET_X ST7735_PARAM_OFFSET_X
#endif
#ifdef ST7735_PARAM_OFFSET_Y
#define ST77XX_PARAM_OFFSET_Y ST7735_PARAM_OFFSET_Y
#endif
#ifdef ST7735_PARAMS
#define ST77XX_PARAMS ST7735_PARAMS
#endif
#ifdef ST7735_PARAM_SCREEN_IDS
#define ST77XX_PARAM_SCREEN_IDS ST7735_PARAM_SCREEN_IDS
#endif
#endif /* !DOXYGEN */
/**
* @name Set default configuration parameters for the ST77xx
* @{
*/
#ifndef ST77XX_PARAM_CNTRL
#define ST77XX_PARAM_CNTRL ST77XX_CNTRL_ST7735 /**< ST77xx controller variant */
#endif
#ifndef ST77XX_PARAM_SPI
#define ST77XX_PARAM_SPI SPI_DEV(0) /**< SPI device */
#endif
#ifndef ST77XX_PARAM_SPI_CLK
#define ST77XX_PARAM_SPI_CLK SPI_CLK_5MHZ /**< SPI clock frequency */
#endif
#ifndef ST77XX_PARAM_CS
#define ST77XX_PARAM_CS GPIO_PIN(2, 2) /**< Chip Select pin */
#endif
#ifndef ST77XX_PARAM_DCX
#define ST77XX_PARAM_DCX GPIO_PIN(3, 13) /**< DCX pin */
#endif
#ifndef ST77XX_PARAM_RST
#define ST77XX_PARAM_RST GPIO_UNDEF /**< Reset pin */
#endif
#ifndef ST77XX_PARAM_SPI_MODE
#define ST77XX_PARAM_SPI_MODE SPI_MODE_0 /**< SPI mode */
#endif
#ifndef ST77XX_PARAM_RGB
#define ST77XX_PARAM_RGB 0 /**< RGB mode enable */
#endif
#ifndef ST77XX_PARAM_INVERTED
#define ST77XX_PARAM_INVERTED 0 /**< Inverted mode enable */
#endif
#ifndef ST77XX_PARAM_NUM_LINES
#define ST77XX_PARAM_NUM_LINES 160U /**< Number of lines */
#endif
#ifndef ST77XX_PARAM_RGB_CHANNELS
#define ST77XX_PARAM_RGB_CHANNELS 128U /**< Number of RGB channels (e.g. columns) */
#endif
#ifndef ST77XX_PARAM_ROTATION
#define ST77XX_PARAM_ROTATION ST77XX_ROTATION_HORZ /**< Rotation mode */
#endif
#ifndef ST77XX_PARAM_OFFSET_X
#define ST77XX_PARAM_OFFSET_X 0 /**< Horizontal offset */
#endif
#ifndef ST77XX_PARAM_OFFSET_Y
#define ST77XX_PARAM_OFFSET_Y 0 /**< Vertival offset */
#endif
#if MODULE_LCD_SPI || DOXYGEN
/** Default interface params if SPI serial interface is enabled */
#define ST77XX_PARAM_IF_SPI .spi = ST77XX_PARAM_SPI, \
.spi_clk = ST77XX_PARAM_SPI_CLK, \
.spi_mode = ST77XX_PARAM_SPI_MODE,
#else
#define ST77XX_PARAM_IF_SPI
#endif
#if MODULE_LCD_PARALLEL || DOXYGEN
/** Default interface params if MCU 8080 8-bit parallel interface is enabled */
#define ST77XX_PARAM_IF_PAR .d0_pin = ST77XX_PARAM_D0, \
.d1_pin = ST77XX_PARAM_D1, \
.d2_pin = ST77XX_PARAM_D2, \
.d3_pin = ST77XX_PARAM_D3, \
.d4_pin = ST77XX_PARAM_D4, \
.d5_pin = ST77XX_PARAM_D5, \
.d6_pin = ST77XX_PARAM_D6, \
.d7_pin = ST77XX_PARAM_D7, \
.wrx_pin = ST77XX_PARAM_WRX, \
.rdx_pin = ST77XX_PARAM_RDX,
#else
#define ST77XX_PARAM_IF_PAR
#endif
#if MODULE_LCD_PARALLEL_16BIT || DOXYGEN
/** Additional default interface params if MCU 8080 16-bit parallel interface is enabled */
#define ST77XX_PARAM_IF_PAR_16BIT .d8_pin = ST77XX_PARAM_D8, \
.d9_pin = ST77XX_PARAM_D9, \
.d10_pin = ST77XX_PARAM_D10, \
.d11_pin = ST77XX_PARAM_D11, \
.d12_pin = ST77XX_PARAM_D12, \
.d13_pin = ST77XX_PARAM_D13, \
.d14_pin = ST77XX_PARAM_D14, \
.d15_pin = ST77XX_PARAM_D15,
#else
#define ST77XX_PARAM_IF_PAR_16BIT
#endif
#if MODULE_LCD_PARALLEL_16BIT || DOXYGEN
/** Interface mode is MCU 8080 16-bit parallel */
#define ST77XX_PARAM_IF_MODE .mode = LCD_IF_PARALLEL_16BIT,
#elif MODULE_LCD_PARALLEL
/** Interface mode is MCU 8080 8-bit parallel */
#define ST77XX_PARAM_IF_MODE .mode = LCD_IF_PARALLEL_8BIT,
#else
/** Interface mode parameter is not defined */
#define ST77XX_PARAM_IF_MODE
#endif
/**
* @brief Default params
*
* @note The default parameter set defined here can only be used if a single
* ST77xx display and only one interface mode is used. If multiple
* ST77xx displays are used or if multiple interface modes are enabled
* by the modules `lcd_spi`, lcd_parallel and `lcd_parallel_16bit`, a user
* defined parameter set @ref ST77XX_PARAMS has to be defined. In the
* latter case @ref lcd_params_t::spi must then be set to @ref SPI_UNDEF
* for displays with MCU 8080 8-/16-bit parallel interfaces.
*/
#ifndef ST77XX_PARAMS
#define ST77XX_PARAMS { ST77XX_PARAM_IF_MODE \
ST77XX_PARAM_IF_SPI \
ST77XX_PARAM_IF_PAR \
ST77XX_PARAM_IF_PAR_16BIT \
.cntrl = ST77XX_PARAM_CNTRL, \
.cs_pin = ST77XX_PARAM_CS, \
.dcx_pin = ST77XX_PARAM_DCX, \
.rst_pin = ST77XX_PARAM_RST, \
.rgb = ST77XX_PARAM_RGB, \
.inverted = ST77XX_PARAM_INVERTED, \
.lines = ST77XX_PARAM_NUM_LINES, \
.rgb_channels = ST77XX_PARAM_RGB_CHANNELS, \
.rotation = ST77XX_PARAM_ROTATION, \
.offset_x = ST77XX_PARAM_OFFSET_X, \
.offset_y = ST77XX_PARAM_OFFSET_Y, \
}
#endif /* ST77XX_PARAMS */
/** @} */
/**
* @brief Default screen identifiers
*/
#ifndef ST77XX_PARAM_SCREEN_IDS
#define ST77XX_PARAM_SCREEN_IDS 0
#endif
/**
* @brief Configure LCD
*/
static const lcd_params_t st77xx_params[] =
{
ST77XX_PARAMS,
};
/**
* @brief Configure screen identifiers
*/
static const uint8_t st77xx_screen_ids[] =
{
ST77XX_PARAM_SCREEN_IDS,
};
/**
* @brief Define the number of configured displays
*/
#define ST77XX_NUMOF ARRAY_SIZE(st77xx_params)
/**
* @brief Define the number screens this display driver is attached to
*/
#define ST77XX_SCREEN_NUMOF ARRAY_SIZE(st77xx_screen_ids)
#ifdef __cplusplus
}
#endif
#endif /* ST77XX_PARAMS_H */
/** @} */
View Git Blame Copy Permalink