Browse Source
git-svn-id: http://svn.code.sf.net/p/nuttx/code/trunk@5462 42af7a65-404d-4744-a932-0658087f49c3sbg
10 changed files with 1613 additions and 7 deletions
@ -0,0 +1,161 @@
@@ -0,0 +1,161 @@
|
||||
/****************************************************************************
|
||||
* config/stm32f4discovery/src/up_ug2864hsweg01.c |
||||
* arch/arm/src/board/up_ug2864hsweg01.c |
||||
* |
||||
* Copyright (C) 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. |
||||
* |
||||
****************************************************************************/ |
||||
|
||||
/****************************************************************************
|
||||
* Included Files |
||||
****************************************************************************/ |
||||
|
||||
#include <nuttx/config.h> |
||||
|
||||
#include <debug.h> |
||||
|
||||
#include <nuttx/spi.h> |
||||
#include <nuttx/lcd/lcd.h> |
||||
#include <nuttx/lcd/ug-2864hsweg01.h> |
||||
|
||||
#include "stm32_gpio.h" |
||||
#include "stm32f4discovery-internal.h" |
||||
|
||||
#ifdef CONFIG_LCD_UG2864HSWEG01 |
||||
|
||||
/****************************************************************************
|
||||
* Pre-Processor Definitions |
||||
****************************************************************************/ |
||||
/* Configuration ************************************************************/ |
||||
/* The pin configurations here require that SPI1 is selected */ |
||||
|
||||
#ifndef CONFIG_STM32_SPI1 |
||||
# error "The OLED driver requires CONFIG_STM32_SPI1 in the configuration" |
||||
#endif |
||||
|
||||
#ifndef CONFIG_SPI_CMDDATA |
||||
# error "The OLED driver requires CONFIG_SPI_CMDDATA in the configuration" |
||||
#endif |
||||
|
||||
/* Pin Configuration ********************************************************/ |
||||
/* UG-2864AMBAG01 or UG-2864HSWEG01 OLED Display:
|
||||
* |
||||
* --------------------------+---------------------------------------------- |
||||
* Connector CON10 J1: | STM32F4Discovery |
||||
* --------------+-----------+---------------------------------------------- |
||||
* CON10 J1: | CON20 J2: | P1/P2: |
||||
* --------------+-----------+---------------------------------------------- |
||||
* 1 3v3 | 3,4 3v3 | P2 3V |
||||
* 3 /RESET | 8 /RESET | P2 PB6 (Arbitrary selection) |
||||
* 5 /CS | 7 /CS | P2 PB7 (Arbitrary selection)(2) |
||||
* 7 A0 | 9 A0 | P2 PB8 (Arbitrary selection)(2) |
||||
* 9 LED+ (N/C) | ----- | ----- |
||||
* 2 5V Vcc | 1,2 Vcc | P2 5V |
||||
* 4 DI | 18 D1/SI | P1 PA7 (GPIO_SPI1_MOSI == GPIO_SPI1_MOSI_1 (1)) |
||||
* 6 SCLK | 19 D0/SCL | P1 PA5 (GPIO_SPI1_SCK == GPIO_SPI1_SCK_1 (2)) |
||||
* 8 LED- (N/C) | ----- | ------ |
||||
* 10 GND | 20 GND | P2 GND |
||||
* --------------+-----------+---------------------------------------------- |
||||
* (1) Required because of on-board MEMS |
||||
* (2) Note that the OLED CS and A0 are managed in the up_spi.c file. |
||||
* ------------------------------------------------------------------------- |
||||
*/ |
||||
|
||||
/* Definitions in stm32f4discovery-internal.h */ |
||||
|
||||
/* Debug ********************************************************************/ |
||||
|
||||
#ifdef CONFIG_DEBUG_LCD |
||||
# define lcddbg(format, arg...) dbg(format, ##arg) |
||||
# define lcdvdbg(format, arg...) vdbg(format, ##arg) |
||||
#else |
||||
# define lcddbg(x...) |
||||
# define lcdvdbg(x...) |
||||
#endif |
||||
|
||||
/****************************************************************************
|
||||
* Public Functions |
||||
****************************************************************************/ |
||||
|
||||
/****************************************************************************
|
||||
* Name: up_nxdrvinit |
||||
* |
||||
* Description: |
||||
* Called by NX initialization logic to configure the OLED. |
||||
* |
||||
****************************************************************************/ |
||||
|
||||
FAR struct lcd_dev_s *up_nxdrvinit(unsigned int devno) |
||||
{ |
||||
FAR struct spi_dev_s *spi; |
||||
FAR struct lcd_dev_s *dev; |
||||
|
||||
/* Configure the OLED GPIOs. This initial configuration is RESET low,
|
||||
* putting the OLED into reset state. |
||||
*/ |
||||
|
||||
(void)stm32_configgpio(GPIO_OLED_RESET); |
||||
|
||||
/* Wait a bit then release the OLED from the reset state */ |
||||
|
||||
up_mdelay(20); |
||||
stm32_gpiowrite(GPIO_OLED_RESET, true); |
||||
|
||||
/* Get the SPI1 port interface */ |
||||
|
||||
spi = up_spiinitialize(1); |
||||
if (!spi) |
||||
{ |
||||
lcddbg("Failed to initialize SPI port 1\n"); |
||||
} |
||||
else |
||||
{ |
||||
/* Bind the SPI port to the OLED */ |
||||
|
||||
dev = ug2864hsweg01_initialize(spi, devno); |
||||
if (!dev) |
||||
{ |
||||
lcddbg("Failed to bind SPI port 1 to OLED %d: %d\n", devno); |
||||
} |
||||
else |
||||
{ |
||||
lcdvdbg("Bound SPI port 1 to OLED %d\n", devno); |
||||
|
||||
/* And turn the OLED on */ |
||||
|
||||
(void)dev->setpower(dev, CONFIG_LCD_MAXPOWER); |
||||
return dev; |
||||
} |
||||
} |
||||
|
||||
return NULL; |
||||
} |
||||
#endif /* CONFIG_LCD_UG2864AMBAG01 */ |
File diff suppressed because it is too large
Load Diff
@ -0,0 +1,245 @@
@@ -0,0 +1,245 @@
|
||||
/**************************************************************************************
|
||||
* include/nuttx/lcd/ug-2864hsweg01.h |
||||
* Driver for Univision UG-2864HSWEG01 OLED display (wih SSD1306 controller) in SPI |
||||
* mode |
||||
* |
||||
* Copyright (C) 2012 Gregory Nutt. All rights reserved. |
||||
* Author: Gregory Nutt <gnutt@nuttx.org> |
||||
* |
||||
* References: |
||||
* 1. Product Specification (Preliminary), Part Name: OEL Display Module, Part ID: |
||||
* UG-2864HSWEG01, Doc No: SAS1-9046-B, Univision Technology Inc. |
||||
* 2. SSD1306, 128 X 64 Dot Matrix OLED/PLED, Preliminary Segment/Common Driver with |
||||
* Controller, Solomon Systech |
||||
* |
||||
* 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_UG_8264HSWEG01_H |
||||
#define __INCLUDE_NUTTX_UG_8264HSWEG01_H |
||||
|
||||
/**************************************************************************************
|
||||
* Included Files |
||||
**************************************************************************************/ |
||||
|
||||
#include <nuttx/config.h> |
||||
|
||||
#include <stdbool.h> |
||||
|
||||
#include <nuttx/arch.h> |
||||
|
||||
#ifdef CONFIG_LCD_UG2864HSWEG01 |
||||
|
||||
/**************************************************************************************
|
||||
* Pre-processor Definitions |
||||
**************************************************************************************/ |
||||
/* Configuration **********************************************************************/ |
||||
/* UG-2864HSWEG01 Configuration Settings:
|
||||
* |
||||
* CONFIG_UG2864HSWEG01_SPIMODE - Controls the SPI mode |
||||
* CONFIG_UG2864HSWEG01_FREQUENCY - Define to use a different bus frequency |
||||
* CONFIG_UG2864HSWEG01_NINTERFACES - Specifies the number of physical UG-2864HSWEG01 |
||||
* devices that will be supported. |
||||
* |
||||
* Required LCD driver settings: |
||||
* |
||||
* CONFIG_LCD_UG28HSWEG01 - Enable UG-2864HSWEG01 support |
||||
* CONFIG_LCD_MAXCONTRAST should be 255, but any value >0 and <=255 will be accepted. |
||||
* CONFIG_LCD_MAXPOWER must be 1 |
||||
* |
||||
* Option LCD driver settings: |
||||
* CONFIG_LCD_LANDSCAPE, CONFIG_LCD_PORTRAIT, CONFIG_LCD_RLANDSCAPE, and |
||||
* CONFIG_LCD_RPORTRAIT - Display orientation. |
||||
* |
||||
* Required SPI driver settings: |
||||
* CONFIG_SPI_CMDDATA - Include support for cmd/data selection. |
||||
*/ |
||||
|
||||
/* SPI Interface
|
||||
* |
||||
* "The serial interface consists of serial clock SCL, serial data SI, A0 and |
||||
* CS . SI is shifted into an 8-bit shift register on every rising edge of |
||||
* SCL in the order of D7, D6, … and D0. A0 is sampled on every eighth clock |
||||
* and the data byte in the shift register is written to the display data RAM |
||||
* or command register in the same clock." |
||||
* |
||||
* MODE 3: |
||||
* Clock polarity: High (CPOL=1) |
||||
* Clock phase: Sample on trailing (rising edge) (CPHA 1) |
||||
*/ |
||||
|
||||
#ifndef CONFIG_UG2864HSWEG01_SPIMODE |
||||
# define CONFIG_UG2864HSWEG01_SPIMODE SPIDEV_MODE3 |
||||
#endif |
||||
|
||||
/* "This module determines whether the input data is interpreted as data or
|
||||
* command. When A0 = “H”, the inputs at D7 - D0 are interpreted as data and be |
||||
* written to display RAM. When A0 = “L”, the inputs at D7 - D0 are interpreted |
||||
* as command, they will be decoded and be written to the corresponding command |
||||
* registers. |
||||
*/ |
||||
|
||||
#ifndef CONFIG_SPI_CMDDATA |
||||
# error "CONFIG_SPI_CMDDATA must be defined in your NuttX configuration" |
||||
#endif |
||||
|
||||
/* CONFIG_UG2864HSWEG01_NINTERFACES determines the number of physical interfaces
|
||||
* that will be supported. |
||||
*/ |
||||
|
||||
#ifndef CONFIG_UG2864HSWEG01_NINTERFACES |
||||
# define CONFIG_UG2864HSWEG01_NINTERFACES 1 |
||||
#endif |
||||
|
||||
/* Check contrast selection */ |
||||
|
||||
#if !defined(CONFIG_LCD_MAXCONTRAST) |
||||
# define CONFIG_LCD_MAXCONTRAST 255 |
||||
#endif |
||||
|
||||
#if CONFIG_LCD_MAXCONTRAST <= 0|| CONFIG_LCD_MAXCONTRAST > 255 |
||||
# error "CONFIG_LCD_MAXCONTRAST exceeds supported maximum" |
||||
#endif |
||||
|
||||
#if CONFIG_LCD_MAXCONTRAST < 255 |
||||
# warning "Optimal setting of CONFIG_LCD_MAXCONTRAST is 255" |
||||
#endif |
||||
|
||||
/* Check power setting */ |
||||
|
||||
#if !defined(CONFIG_LCD_MAXPOWER) |
||||
# define CONFIG_LCD_MAXPOWER 1 |
||||
#endif |
||||
|
||||
#if CONFIG_LCD_MAXPOWER != 1 |
||||
# warning "CONFIG_LCD_MAXPOWER exceeds supported maximum" |
||||
# undef CONFIG_LCD_MAXPOWER |
||||
# define CONFIG_LCD_MAXPOWER 1 |
||||
#endif |
||||
|
||||
/* Color is 1bpp monochrome with leftmost column contained in bits 0 */ |
||||
|
||||
#ifdef CONFIG_NX_DISABLE_1BPP |
||||
# warning "1 bit-per-pixel support needed" |
||||
#endif |
||||
|
||||
/* Orientation */ |
||||
|
||||
#if defined(CONFIG_LCD_LANDSCAPE) |
||||
# undef CONFIG_LCD_PORTRAIT |
||||
# undef CONFIG_LCD_RLANDSCAPE |
||||
# undef CONFIG_LCD_RPORTRAIT |
||||
#elif defined(CONFIG_LCD_PORTRAIT) |
||||
# undef CONFIG_LCD_LANDSCAPE |
||||
# undef CONFIG_LCD_RLANDSCAPE |
||||
# undef CONFIG_LCD_RPORTRAIT |
||||
#elif defined(CONFIG_LCD_RLANDSCAPE) |
||||
# undef CONFIG_LCD_LANDSCAPE |
||||
# undef CONFIG_LCD_PORTRAIT |
||||
# undef CONFIG_LCD_RPORTRAIT |
||||
#elif defined(CONFIG_LCD_RPORTRAIT) |
||||
# undef CONFIG_LCD_LANDSCAPE |
||||
# undef CONFIG_LCD_PORTRAIT |
||||
# undef CONFIG_LCD_RLANDSCAPE |
||||
#else |
||||
# define CONFIG_LCD_LANDSCAPE 1 |
||||
# warning "Assuming landscape orientation" |
||||
#endif |
||||
|
||||
/* Some important "colors" */ |
||||
|
||||
#define UG_Y1_BLACK 0 |
||||
#define UG_Y1_WHITE 1 |
||||
|
||||
/**************************************************************************************
|
||||
* Public Types |
||||
**************************************************************************************/ |
||||
|
||||
/**************************************************************************************
|
||||
* Public Data |
||||
**************************************************************************************/ |
||||
|
||||
#ifdef __cplusplus |
||||
extern "C" |
||||
{ |
||||
#endif |
||||
|
||||
/**************************************************************************************
|
||||
* Public Function Prototypes |
||||
**************************************************************************************/ |
||||
|
||||
/**************************************************************************************
|
||||
* Name: ug2864hsweg01_initialize |
||||
* |
||||
* Description: |
||||
* Initialize the UG-2864HSWEG01 video hardware. The initial state of the |
||||
* OLED is fully initialized, display memory cleared, and the OLED 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 through CONFIG_UG2864HSWEG01_NINTERFACES-1. |
||||
* This allows support for multiple OLED devices. |
||||
* |
||||
* Returned Value: |
||||
* |
||||
* On success, this function returns a reference to the LCD object for |
||||
* the specified OLED. NULL is returned on any failure. |
||||
* |
||||
**************************************************************************************/ |
||||
|
||||
struct lcd_dev_s; /* See include/nuttx/lcd/lcd.h */ |
||||
struct spi_dev_s; /* See include/nuttx/spi.h */ |
||||
FAR struct lcd_dev_s *ug2864hsweg01_initialize(FAR struct spi_dev_s *spi, |
||||
unsigned int devno); |
||||
|
||||
/************************************************************************************************
|
||||
* Name: ug2864hsweg01_fill |
||||
* |
||||
* Description: |
||||
* This non-standard method can be used to clear the entire display by writing one |
||||
* color to the display. This is much faster than writing a series of runs. |
||||
* |
||||
* Input Parameters: |
||||
* priv - Reference to private driver structure |
||||
* |
||||
* Assumptions: |
||||
* Caller has selected the OLED section. |
||||
* |
||||
**************************************************************************************/ |
||||
|
||||
void ug2864hsweg01_fill(FAR struct lcd_dev_s *dev, uint8_t color); |
||||
|
||||
#ifdef __cplusplus |
||||
} |
||||
#endif |
||||
|
||||
#endif /* CONFIG_LCD_UG2864HSWEG01 */ |
||||
#endif /* __INCLUDE_NUTTX_UG_8264HSWEG01_H */ |
Loading…
Reference in new issue