Merged in acassis/nuttx_acassis/pcd8544 (pull request #381)

Pcd8544

Approved-by: Gregory Nutt <gnutt@nuttx.org>
This commit is contained in:
Alan Carvalho 2017-05-26 14:44:23 +00:00 committed by Gregory Nutt
commit 2b3eb7344c
10 changed files with 1510 additions and 1 deletions

View File

@ -14,6 +14,7 @@ Contents
- Using 128KiB of Flash instead of 64KiB
- Quadrature Encoder
- SDCard support
- Nokia 5110 LCD Display support
- USB Console support
- STM32F103 Minimum - specific Configuration Options
- Configurations
@ -307,6 +308,71 @@ SDCard support:
PA5, MOSI to PA7 and MISO to PA6. Note: some chinese boards use MOSO instead
of MISO.
Nokia 5110 LCD Display support:
===============================
You can connect a low cost Nokia 5110 LCD display in the STM32F103 Minimum
board this way: connect PA5 (SPI1 CLK) to CLK; PA7 (SPI1 MOSI) to DIN; PA4
to CE; PA3 to RST; PA2 to DC. Also connect 3.3V to VCC and GND to GND.
You can start with default "stm32f103-minimum/nsh" configuration option and
enable these options using "make menuconfig" :
System Type --->
STM32 Peripheral Support --->
[*] SPI1
Device Drivers --->
-*- SPI Driver Support --->
[*] SPI exchange
[*] SPI CMD/DATA
Device Drivers --->
LCD Driver Support --->
[*] Graphic LCD Driver Support --->
[*] Nokia 5110 LCD Display (Philips PCD8544)
(1) Number of PCD8544 Devices
(84) PCD8544 X Resolution
(48) PCD8544 Y Resolution
Graphics Support --->
[*] NX Graphics
(1) Number of Color Planes
(0x0) Initial background color
Supported Pixel Depths --->
[ ] Disable 1 BPP
[*] Packed MS First
Font Selections --->
(7) Bits in Character Set
[*] Mono 5x8
Application Configuration --->
Examples --->
[*] NX graphics "Hello, World!" example
(1) Bits-Per-Pixel
After compiling and flashing the nuttx.bin inside the board, reset it.
You should see it:
NuttShell (NSH)
nsh> ?
help usage: help [-v] [<cmd>]
[ dd free mb sh usleep
? echo help mh sleep xd
cat exec hexdump mw test
cd exit kill pwd true
cp false ls set unset
Builtin Apps:
nxhello
Now just run nxhello and you should see "Hello World" in the display:
nsh> nxhello
USB Console support:
====================

View File

@ -81,6 +81,10 @@ ifeq ($(CONFIG_LCD_ST7567),y)
CSRCS += stm32_lcd.c
endif
ifeq ($(CONFIG_LCD_PCD8544),y)
CSRCS += stm32_pcd8544.c
endif
ifeq ($(CONFIG_QENCODER),y)
CSRCS += stm32_qencoder.c
endif

View File

@ -0,0 +1,145 @@
/****************************************************************************
* config/stm32f103-minimum/src/stm32_pcd8544.c
*
* Copyright (C) 2011, 2013, 2015 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.
*
****************************************************************************/
/****************************************************************************
* Included Files
****************************************************************************/
#include <nuttx/config.h>
#include <stdio.h>
#include <stdbool.h>
#include <debug.h>
#include <errno.h>
#include <nuttx/arch.h>
#include <nuttx/board.h>
#include <nuttx/spi/spi.h>
#include <nuttx/lcd/lcd.h>
#include <nuttx/lcd/pcd8544.h>
#include "stm32_gpio.h"
#include "stm32_spi.h"
#include "stm32f103_minimum.h"
#ifdef CONFIG_NX_LCDDRIVER
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
#define LCD_SPI_PORTNO 1 /* On SPI1 */
#ifndef CONFIG_LCD_CONTRAST
# define CONFIG_LCD_CONTRAST 60
#endif
/****************************************************************************
* Private Data
****************************************************************************/
FAR struct spi_dev_s *g_spidev;
FAR struct lcd_dev_s *g_lcddev;
/****************************************************************************
* Public Functions
****************************************************************************/
/****************************************************************************
* Name: board_lcd_initialize
****************************************************************************/
int board_lcd_initialize(void)
{
/* Configure the GPIO pins */
stm32_configgpio(STM32_LCD_RST);
stm32_configgpio(STM32_LCD_CD);
stm32_gpiowrite(STM32_LCD_RST, 1);
stm32_gpiowrite(STM32_LCD_CD, 1);
g_spidev = stm32_spibus_initialize(LCD_SPI_PORTNO);
if (!g_spidev)
{
lcderr("ERROR: Failed to initialize SPI port %d\n", LCD_SPI_PORTNO);
return 0;
}
stm32_gpiowrite(STM32_LCD_RST, 0);
up_mdelay(10);
stm32_gpiowrite(STM32_LCD_RST, 1);
return 1;
}
/****************************************************************************
* Name: board_lcd_getdev
****************************************************************************/
FAR struct lcd_dev_s *board_lcd_getdev(int lcddev)
{
g_lcddev = pcd8544_initialize(g_spidev, lcddev);
if (!g_lcddev)
{
lcderr("ERROR: Failed to bind SPI port 1 to LCD %d: %d\n", lcddev);
}
else
{
lcdinfo("SPI port 1 bound to LCD %d\n", lcddev);
/* And turn the LCD on (CONFIG_LCD_MAXPOWER should be 1) */
(void)g_lcddev->setpower(g_lcddev, CONFIG_LCD_MAXPOWER);
/* Set contrast to right value, otherwise background too dark */
(void)g_lcddev->setcontrast(g_lcddev, CONFIG_LCD_CONTRAST);
return g_lcddev;
}
return NULL;
}
/****************************************************************************
* Name: board_lcd_uninitialize
****************************************************************************/
void board_lcd_uninitialize(void)
{
/* TO-FIX */
}
#endif /* CONFIG_NX_LCDDRIVER */

View File

@ -86,6 +86,10 @@ void stm32_spidev_initialize(void)
(void)stm32_configgpio(STM32_LCD_CS); /* ST7567 chip select */
#endif
#ifdef CONFIG_LCD_PCD8544
(void)stm32_configgpio(STM32_LCD_CS); /* ST7567 chip select */
#endif
#ifdef CONFIG_WL_NRF24L01
stm32_configgpio(GPIO_NRF24L01_CS); /* nRF24L01 chip select */
#endif
@ -138,10 +142,17 @@ void stm32_spi1select(FAR struct spi_dev_s *dev, uint32_t devid,
}
#endif
#ifdef CONFIG_LCD_PCD8544
if (devid == SPIDEV_DISPLAY(0))
{
stm32_gpiowrite(STM32_LCD_CS, !selected);
}
#endif
#ifdef CONFIG_LCD_ST7567
if (devid == SPIDEV_DISPLAY(0))
{
stm32_gpiowrite(GPIO_CS_MFRC522, !selected);
stm32_gpiowrite(STM32_LCD_CS, !selected);
}
#endif
@ -236,6 +247,20 @@ int stm32_spi1cmddata(FAR struct spi_dev_s *dev, uint32_t devid,
}
#endif
#ifdef CONFIG_LCD_PCD8544
if (devid == SPIDEV_DISPLAY(0))
{
/* This is the Data/Command control pad which determines whether the
* data bits are data or a command.
*/
(void)stm32_gpiowrite(STM32_LCD_CD, !cmd);
return OK;
}
#endif
return -ENODEV;
}
#endif

View File

@ -101,6 +101,9 @@
#define STM32_LCD_RS (GPIO_OUTPUT|GPIO_CNF_OUTPP|GPIO_MODE_50MHz|\
GPIO_OUTPUT_SET|GPIO_PORTA|GPIO_PIN2)
#define STM32_LCD_CD (GPIO_OUTPUT|GPIO_CNF_OUTPP|GPIO_MODE_50MHz|\
GPIO_OUTPUT_SET|GPIO_PORTA|GPIO_PIN2)
/* PWN Configuration */
#define STM32F103MINIMUM_PWMTIMER 3

View File

@ -576,6 +576,44 @@ config SSD1351_MSTRCONTRAST
endif
config LCD_PCD8544
bool "Nokia 5110 LCD Display (Philips PCD8544)"
default n
---help---
LCD Display Module, PCD8544, Philips
Required LCD driver settings:
LCD_MAXCONTRAST should be 255, but any value >0 and <=255 will be accepted.
if LCD_PCD8544
config PCD8544_NINTERFACES
int "Number of PCD8544 Devices"
default 1
---help---
Specifies the number of physical PCD8544 devices that will be
supported. NOTE: At present, this must be undefined or defined to be 1.
config PCD8544_XRES
int "PCD8544 X Resolution"
default 84
---help---
Specifies the X resolution of the LCD.
config PCD8544_YRES
int "PCD8544 Y Resolution"
default 48
---help---
Specifies the Y resolution of the LCD.
config PCD8544_INVERSE_VIDEO
bool "PCD8544 Inverse video"
default n
---help---
Inverse video on LCD.
endif # LCD_PCD8544
config LCD_ST7565
bool "ST7565 LCD Display Module"
default n

View File

@ -81,6 +81,10 @@ ifeq ($(CONFIG_LCD_MIO283QT9A),y)
CSRCS += mio283qt9a.c
endif
ifeq ($(CONFIG_LCD_PCD8544),y)
CSRCS += pcd8544.c
endif
ifeq ($(CONFIG_LCD_ST7565),y)
CSRCS += st7565.c
endif

1008
drivers/lcd/pcd8544.c Normal file

File diff suppressed because it is too large Load Diff

87
drivers/lcd/pcd8544.h Normal file
View File

@ -0,0 +1,87 @@
/**************************************************************************************
* drivers/lcd/pcd8544.h
*
* Definitions for the PCD8544 LCD Display
*
* Copyright (C) 2017 Alan Carvalho de Assis. All rights reserved.
* Author: Alan Carvalho de Assis <acassis@gmail.com>
*
* 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_PCD8544_H
#define __DRIVERS_LCD_PCD8544_H
/**************************************************************************************
* Included Files
**************************************************************************************/
/**************************************************************************************
* Pre-processor Definitions
**************************************************************************************/
#define PCD8544_MAX_BANKS 6
#define PCD8544_MAX_COLS 84
/* Fundamental Commands *****************************************************/
#define PCD8544_NOP 0x00 /* 0x00: No Operation */
#define PCD8544_FUNC_SET (1 << 5) /* Used to select extend mode */
#define PCD8544_POWER_DOWN (1 << 2) /* Enable power-down mode */
#define PCD8544_MODEV (1 << 1) /* Enable Vertical Addressing */
#define PCD8544_MODEH (1 << 0) /* Enable extended instruction set */
/* Command with Instructon Set H = 0 */
#define PCD8544_DISP_CTRL (1 << 3) /* sets display configuration */
#define PCD8544_DISP_BLANK 0x00 /* display blank */
#define PCD8544_DISP_ALLON 0x01 /* all display segments on */
#define PCD8544_DISP_NORMAL 0x04 /* normal mode */
#define PCD8544_DISP_INVERT 0x05 /* inverse video mode */
#define PCD8544_SET_Y_ADDR (1 << 6) /* Set the Y bank 0-5 */
#define PCD8544_SET_X_ADDR (1 << 7) /* Set the X bank 0-83 */
/* Command with Instructon Set H = 1 */
#define PCD8544_TEMP_COEF (1 << 2) /* set Temperature Coefficient */
#define PCD8544_BIAS_SYSTEM (1 << 4) /* set Bias System */
#define PCD8544_BIAS_BS0 (1 << 0) /* set Bias System */
#define PCD8544_BIAS_BS1 (1 << 1) /* set Bias System */
#define PCD8544_BIAS_BS2 (1 << 2) /* set Bias System */
#define PCD8544_WRITE_VOP (1 << 7) /* write Vop to register*/
#define PCD8544_VOP0 (1 << 0) /* Vop0 */
#define PCD8544_VOP1 (1 << 1) /* Vop1 */
#define PCD8544_VOP2 (1 << 2) /* Vop2 */
#define PCD8544_VOP3 (1 << 3) /* Vop3 */
#define PCD8544_VOP4 (1 << 4) /* Vop4 */
#define PCD8544_VOP5 (1 << 5) /* Vop5 */
#define PCD8544_VOP6 (1 << 6) /* Vop6 */
#endif /* __DRIVERS_LCD_PCD8544_H */

129
include/nuttx/lcd/pcd8544.h Normal file
View File

@ -0,0 +1,129 @@
/****************************************************************************
* include/nuttx/lcd/pcd8544.h
*
* Driver for Displays with the PCD8544 LCD controller.
*
* Copyright (C) 2017 Alan Carvalho de Assis. All rights reserved.
* Author: Alan Carvalho de Assis <acassis@gmail.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_PCD8544_H
#define __INCLUDE_NUTTX_PCD8544_H
/****************************************************************************
* Included Files
****************************************************************************/
#include <stdbool.h>
/****************************************************************************
* Pre-processor Definitions
****************************************************************************/
/* PCD8544 Configuration Settings:
*
* CONFIG_PCD8544_SPIMODE - Controls the SPI mode
* CONFIG_PCD8544_FREQUENCY - Define to use a different bus frequency
* CONFIG_PCD8544_NINTERFACES - Specifies the number of physical
* PCD8544 devices that will be supported. NOTE: At present, this
* must be undefined or defined to be 1.
*
* Required LCD driver settings:
* CONFIG_LCD_PCD8544 - Enable PCD8544 support
* CONFIG_LCD_MAXCONTRAST should be 255, but any value >0 and <=255 will be accepted.
* CONFIG_LCD_MAXPOWER should be 2: 0=off, 1=dim, 2=normal
*
* Required SPI driver settings:
* CONFIG_SPI_CMDDATA - Include support for cmd/data selection.
*/
/* Some important "colors" */
#define PCD8544_Y1_BLACK 0
#define PCD8544_Y1_WHITE 1
/* Only two power settings are supported: */
#define PCD8544_POWER_OFF 0
#define PCD8544_POWER_ON 1
/****************************************************************************
* Public Types
****************************************************************************/
/****************************************************************************
* Public Data
****************************************************************************/
#ifdef __cplusplus
extern "C"
{
#endif
/****************************************************************************
* Public Function Prototypes
****************************************************************************/
/****************************************************************************
* Name: pcd8544_initialize
*
* Description:
* Initialize the PCD8544 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 thropcd8544h CONFIG_PCD8544_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.
*
****************************************************************************/
struct lcd_dev_s; /* see nuttx/lcd.h */
struct spi_dev_s; /* see nuttx/spi/spi.h */
FAR struct lcd_dev_s *pcd8544_initialize(FAR struct spi_dev_s *spi, unsigned int devno);
#ifdef __cplusplus
}
#endif
#endif /* __INCLUDE_NUTTX_PCD8544_H */