/**************************************************************************** * drivers/lcd/ssd1306_base.c * * 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. * ****************************************************************************/ /* Driver for Univision UG-2864HSWEG01 OLED display or UG-2832HSWEG04 both * with the Univision SSD1306 controller in SPI mode and Densitron * DD-12864WO-4A with SSD1309 in SPI mode. * * References: * 1. Product Specification, Part Name: OEL Display Module, Part ID: * UG-2864HSWEG01, Doc No: SAS1-9046-B, Univision Technology Inc. * 2. Product Specification, Part Name: OEL Display Module, Part ID: * UG-2832HSWEG04, Doc No.: SAS1-B020-B, Univision Technology Inc. * 3. SSD1306, 128 X 64 Dot Matrix OLED/PLED, Preliminary Segment/Common * Driver with Controller, Solomon Systech * 4. SSD1309, 128 x 64 Dot Matrix OLED/PLED Segment/Common Driver with * Controller, Solomon Systech */ /**************************************************************************** * Device memory organization: * * +----------------------------+ * | Column | * --------+----+---+---+---+-...-+-----+ * Page | 0 | 1 | 2 | 3 | ... | 127 | * --------+----+---+---+---+-...-+-----+ * Page 0 | D0 | X | | | | | * | D1 | X | | | | | * | D2 | X | | | | | * | D3 | X | | | | | * | D4 | X | | | | | * | D5 | X | | | | | * | D6 | X | | | | | * | D7 | X | | | | | * --------+----+---+---+---+-...-+-----+ * Page 1 | | | | | | | * --------+----+---+---+---+-...-+-----+ * Page 2 | | | | | | | * --------+----+---+---+---+-...-+-----+ * Page 3 | | | | | | | * --------+----+---+---+---+-...-+-----+ * Page 4 | | | | | | | * --------+----+---+---+---+-...-+-----+ * Page 5 | | | | | | | * --------+----+---+---+---+-...-+-----+ * Page 6 | | | | | | | * --------+----+---+---+---+-...-+-----+ * Page 7 | | | | | | | * --------+----+---+---+---+-...-+-----+ * * ----------------------------------+-------------------------------------- * Landscape Display: | Reverse Landscape Display: * --------+----------------------+ | --------+--------------------------+ * | Column | | | Column | * --------+---+---+---+-..-+-----+ | --------+-----+-----+-----+-..-+---+ * Page 0 | 0 | 1 | 2 | | 127 | | Page 7 | 127 | 126 | 125 | | 0 | * --------+---+---+---+-..-+-----+ | --------+-----+-----+-----+-..-+---+ * Page 1 | V | | Page 6 | ^ | * --------+---+---+---+-..-+-----+ | --------+-----+-----+-----+-..-+---+ * Page 2 | V | | Page 5 | ^ | * --------+---+---+---+-..-+-----+ | --------+-----+-----+-----+-..-+---+ * Page 3 | V | | Page 4 | ^ | * --------+---+---+---+-..-+-----+ | --------+-----+-----+-----+-..-+---+ * Page 4 | V | | Page 3 | ^ | * --------+---+---+---+-..-+-----+ | --------+-----+-----+-----+-..-+---+ * Page 5 | V | | Page 2 | ^ | * --------+---+---+---+-..-+-----+ | --------+-----+-----+-----+-..-+---+ * Page 6 | V | | Page 1 | ^ | * --------+---+---+---+-..-+-----+ | --------+-----+-----+-----+-..-+---+ * Page 7 | V | | Page 0 | ^ | * --------+---+---+---+-..-+-----+ | --------+-----+-----+-----+-..-+---+ * ----------------------------------+-------------------------------------- * * -----------------------------------+------------------------------------- * Portrait Display: | Reverse Portrait Display: * -----------+---------------------+ | -----------+---------------------+ * | Page | | | Page | * -----------+---+---+---+-...-+---+ | -----------+---+---+---+-...-+---+ * Column 0 | 0 | 1 | 2 | | 7 | | Column 127 | 7 | 6 | 5 | | 0 | * -----------+---+---+---+-...-+---+ | -----------+---+---+---+-...-+---+ * Column 1 | > > > > > | | Column 126 | | * -----------+---+---+---+-...-+---+ | -----------+---+---+---+-...-+---+ * Column 2 | | | Column 125 | | * -----------+---+---+---+-...-+---+ | -----------+---+---+---+-...-+---+ * ... | | | ... | | * -----------+---+---+---+-...-+---+ | -----------+---+---+---+-...-+---+ * Column 127 | | | Column 0 | < < < < < | * -----------+---+---+---+-...-+---+ | -----------+---+---+---+-...-+---+ * -----------------------------------+------------------------------------- ****************************************************************************/ /**************************************************************************** * Included Files ****************************************************************************/ #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include #include "ssd1306.h" #ifdef CONFIG_LCD_SSD1306 /**************************************************************************** * Private Function Prototypes ****************************************************************************/ /* LCD Data Transfer Methods */ static int ssd1306_putrun(FAR struct lcd_dev_s *dev, fb_coord_t row, fb_coord_t col, FAR const uint8_t *buffer, size_t npixels); static int ssd1306_getrun(FAR struct lcd_dev_s *dev, fb_coord_t row, fb_coord_t col, FAR uint8_t *buffer, size_t npixels); /* LCD Configuration */ static int ssd1306_getvideoinfo(FAR struct lcd_dev_s *dev, FAR struct fb_videoinfo_s *vinfo); static int ssd1306_getplaneinfo(FAR struct lcd_dev_s *dev, unsigned int planeno, FAR struct lcd_planeinfo_s *pinfo); /* LCD RGB Mapping */ #ifdef CONFIG_FB_CMAP # error "RGB color mapping not supported by this driver" #endif /* Cursor Controls */ #ifdef CONFIG_FB_HWCURSOR # error "Cursor control not supported by this driver" #endif /* LCD Specific Controls */ static int ssd1306_getpower(struct lcd_dev_s *dev); static int ssd1306_setpower(struct lcd_dev_s *dev, int power); static int ssd1306_getcontrast(struct lcd_dev_s *dev); static int ssd1306_setcontrast(struct lcd_dev_s *dev, unsigned int contrast); static int ssd1306_do_disponoff(struct ssd1306_dev_s *priv, bool on); static int ssd1306_configuredisplay(struct ssd1306_dev_s *priv); static int ssd1306_redrawfb(struct ssd1306_dev_s *priv); /**************************************************************************** * Private Data ****************************************************************************/ /* This structure describes the overall LCD video controller */ static const struct fb_videoinfo_s g_videoinfo = { .fmt = SSD1306_DEV_COLORFMT, /* Color format: B&W */ .xres = SSD1306_DEV_XRES, /* Horizontal resolution in pixel columns */ .yres = SSD1306_DEV_YRES, /* Vertical resolution in pixel rows */ .nplanes = 1, /* Number of color planes supported */ }; /* This is the outside visible interface for the OLED driver */ static const struct lcd_dev_s g_oleddev_dev = { /* LCD Configuration */ .getvideoinfo = ssd1306_getvideoinfo, .getplaneinfo = ssd1306_getplaneinfo, /* LCD RGB Mapping -- Not supported */ /* Cursor Controls -- Not supported */ /* LCD Specific Controls */ .getpower = ssd1306_getpower, .setpower = ssd1306_setpower, .getcontrast = ssd1306_getcontrast, .setcontrast = ssd1306_setcontrast, }; /* This is the OLED driver instance. Only a single device is supported * for now. */ static struct ssd1306_dev_s g_oleddev[CONFIG_SSD1306_NUMDEVS]; /**************************************************************************** * Private Functions ****************************************************************************/ /**************************************************************************** * Name: ssd1306_putrun * * Description: * This method can be used to write a partial raster line to the LCD. * * Input Parameters: * row - Starting row to write to (range: 0 <= row < yres) * col - Starting column to write to (range: 0 <= col <= xres-npixels) * buffer - The buffer containing the run to be written to the LCD * npixels - The number of pixels to write to the LCD * (range: 0 < npixels <= xres-col) * ****************************************************************************/ #if defined(CONFIG_LCD_LANDSCAPE) || defined(CONFIG_LCD_RLANDSCAPE) static int ssd1306_putrun(FAR struct lcd_dev_s *dev, fb_coord_t row, fb_coord_t col, FAR const uint8_t *buffer, size_t npixels) { FAR struct ssd1306_dev_s *priv = (FAR struct ssd1306_dev_s *)dev; FAR uint8_t *fbptr; FAR uint8_t *ptr; uint8_t devcol; uint8_t fbmask; uint8_t page; uint8_t usrmask; int pixlen; uint8_t i; int ret; lcdinfo("row: %d col: %d npixels: %d\n", row, col, npixels); DEBUGASSERT(buffer); /* Clip the run to the display */ pixlen = npixels; if ((unsigned int)col + (unsigned int)pixlen > (unsigned int)SSD1306_DEV_XRES) { pixlen = (int)SSD1306_DEV_XRES - (int)col; } /* Verify that some portion of the run remains on the display */ if (pixlen <= 0 || row > SSD1306_DEV_YRES) { return OK; } /* Perform coordinate conversion for reverse landscape mode. * If the rows are reversed then rows are are a mirror reflection of * top to bottom. */ #ifdef SSD1306_DEV_REVERSEY row = (SSD1306_DEV_YRES - 1) - row; #endif /* If the column is switched then the start of the run is the mirror of * the end of the run. * * col+pixlen-1 * col | * 0 | | XRES * . S>>>>>>E . * . E<<<<<> 3; /* Update the shadow frame buffer memory. First determine the pixel * position in the frame buffer memory. Pixels are organized like * this: * * --------+---+---+---+---+-...-+-----+ * Segment | 0 | 1 | 2 | 3 | ... | 131 | * --------+---+---+---+---+-...-+-----+ * D0 | | X | | | | | * D1 | | X | | | | | * D2 | | X | | | | | * D3 | | X | | | | | * D4 | | X | | | | | * D5 | | X | | | | | * D6 | | X | | | | | * D7 | | X | | | | | * --------+---+---+---+---+-...-+-----+ * * So, in order to draw a white, horizontal line, at row 45. we * would have to modify all of the bytes in page 45/8 = 5. We * would have to set bit 45%8 = 5 in every byte in the page. */ fbmask = 1 << (row & 7); fbptr = &priv->fb[page * SSD1306_DEV_XRES + col]; #ifdef SSD1306_DEV_REVERSEX ptr = fbptr + (pixlen - 1); #else ptr = fbptr; #endif #ifdef CONFIG_LCD_PACKEDMSFIRST usrmask = MS_BIT; #else usrmask = LS_BIT; #endif for (i = 0; i < pixlen; i++) { /* Set or clear the corresponding bit */ #ifdef SSD1306_DEV_REVERSEX if ((*buffer & usrmask) != 0) { *ptr-- |= fbmask; } else { *ptr-- &= ~fbmask; } #else if ((*buffer & usrmask) != 0) { *ptr++ |= fbmask; } else { *ptr++ &= ~fbmask; } #endif /* Inc/Decrement to the next source pixel */ #ifdef CONFIG_LCD_PACKEDMSFIRST if (usrmask == LS_BIT) { buffer++; usrmask = MS_BIT; } else { usrmask >>= 1; } #else if (usrmask == MS_BIT) { buffer++; usrmask = LS_BIT; } else { usrmask <<= 1; } #endif } /* Offset the column position to account for smaller horizontal * display range. */ devcol = col + SSD1306_DEV_XOFFSET; /* Lock and select device */ ssd1306_select(priv, true); /* Select command transfer */ ssd1306_cmddata(priv, true); /* Set the starting position for the run */ /* Set the column address to the XOFFSET value */ ret = ssd1306_sendbyte(priv, SSD1306_SETCOLL(devcol & 0x0f)); if (ret < 0) { return ret; } ret = ssd1306_sendbyte(priv, SSD1306_SETCOLH(devcol >> 4)); if (ret < 0) { return ret; } /* Set the page address */ ret = ssd1306_sendbyte(priv, SSD1306_PAGEADDR(page)); if (ret < 0) { return ret; } /* Select data transfer */ ssd1306_cmddata(priv, false); /* Then transfer all of the data */ ret = ssd1306_sendblk(priv, fbptr, pixlen); if (ret < 0) { return ret; } /* De-select and unlock the device */ ssd1306_select(priv, false); return OK; } #else # error "Configuration not implemented" #endif /**************************************************************************** * Name: ssd1306_getrun * * Description: * This method can be used to read a partial raster line from the LCD. * * Description: * This method can be used to write a partial raster line to the LCD. * * row - Starting row to read from (range: 0 <= row < yres) * col - Starting column to read read (range: 0 <= col <= xres-npixels) * buffer - The buffer in which to return the run read from the LCD * npixels - The number of pixels to read from the LCD * (range: 0 < npixels <= xres-col) * ****************************************************************************/ #if defined(CONFIG_LCD_LANDSCAPE) || defined(CONFIG_LCD_RLANDSCAPE) static int ssd1306_getrun(FAR struct lcd_dev_s *dev, fb_coord_t row, fb_coord_t col, FAR uint8_t *buffer, size_t npixels) { FAR struct ssd1306_dev_s *priv = (FAR struct ssd1306_dev_s *)dev; FAR uint8_t *fbptr; uint8_t page; uint8_t fbmask; uint8_t usrmask; int pixlen; uint8_t i; lcdinfo("row: %d col: %d npixels: %d\n", row, col, npixels); DEBUGASSERT(buffer); /* Clip the run to the display */ pixlen = npixels; if ((unsigned int)col + (unsigned int)pixlen > (unsigned int)SSD1306_DEV_XRES) { pixlen = (int)SSD1306_DEV_XRES - (int)col; } /* Verify that some portion of the run is actually the display */ if (pixlen <= 0 || row > SSD1306_DEV_YRES) { return -EINVAL; } /* Perform coordinate conversion for reverse landscape mode. * If the rows are reversed then rows are are a mirror reflection of * top to bottom. */ #ifdef SSD1306_DEV_REVERSEY row = (SSD1306_DEV_YRES - 1) - row; #endif /* If the column is switched then the start of the run is the mirror of * the end of the run. * * col+pixlen-1 * col | * 0 | | XRES * . S>>>>>>E . * . E<<<<<> 3; /* Update the shadow frame buffer memory. First determine the pixel * position in the frame buffer memory. Pixels are organized like * this: * * --------+---+---+---+---+-...-+-----+ * Segment | 0 | 1 | 2 | 3 | ... | 131 | * --------+---+---+---+---+-...-+-----+ * D0 | | X | | | | | * D1 | | X | | | | | * D2 | | X | | | | | * D3 | | X | | | | | * D4 | | X | | | | | * D5 | | X | | | | | * D6 | | X | | | | | * D7 | | X | | | | | * --------+---+---+---+---+-...-+-----+ * * So, in order to draw a white, horizontal line, at row 45. we * would have to modify all of the bytes in page 45/8 = 5. We * would have to set bit 45%8 = 5 in every byte in the page. */ fbmask = 1 << (row & 7); fbptr = &priv->fb[page * SSD1306_DEV_XRES + col]; #ifdef CONFIG_LCD_PACKEDMSFIRST usrmask = MS_BIT; #else usrmask = LS_BIT; #endif for (i = 0; i < pixlen; i++) { /* Set or clear the corresponding bit */ #ifdef SSD1306_DEV_REVERSEX uint8_t byte = *fbptr--; #else uint8_t byte = *fbptr++; #endif if ((byte & fbmask) != 0) { *buffer |= usrmask; } else { *buffer &= ~usrmask; } /* Inc/Decrement to the next destination pixel. */ #ifdef CONFIG_LCD_PACKEDMSFIRST if (usrmask == LS_BIT) { buffer++; usrmask = MS_BIT; } else { usrmask >>= 1; } #else if (usrmask == MS_BIT) { buffer++; usrmask = LS_BIT; } else { usrmask <<= 1; } #endif } return OK; } #else # error "Configuration not implemented" #endif /**************************************************************************** * Name: ssd1306_getvideoinfo * * Description: * Get information about the LCD video controller configuration. * ****************************************************************************/ static int ssd1306_getvideoinfo(FAR struct lcd_dev_s *dev, FAR struct fb_videoinfo_s *vinfo) { DEBUGASSERT(dev && vinfo); lcdinfo("fmt: %d xres: %d yres: %d nplanes: %d\n", g_videoinfo.fmt, g_videoinfo.xres, g_videoinfo.yres, g_videoinfo.nplanes); memcpy(vinfo, &g_videoinfo, sizeof(struct fb_videoinfo_s)); return OK; } /**************************************************************************** * Name: ssd1306_getplaneinfo * * Description: * Get information about the configuration of each LCD color plane. * ****************************************************************************/ static int ssd1306_getplaneinfo(FAR struct lcd_dev_s *dev, unsigned int planeno, FAR struct lcd_planeinfo_s *pinfo) { FAR struct ssd1306_dev_s *priv = (FAR struct ssd1306_dev_s *)dev; DEBUGASSERT(pinfo && planeno == 0); lcdinfo("planeno: %d bpp: %d\n", planeno, SSD1306_DEV_BPP); memset(pinfo, 0, sizeof(struct lcd_planeinfo_s)); pinfo->putrun = ssd1306_putrun; pinfo->getrun = ssd1306_getrun; pinfo->bpp = SSD1306_DEV_BPP; pinfo->buffer = (FAR uint8_t *)priv->runbuffer; pinfo->dev = dev; return OK; } /**************************************************************************** * Name: ssd1306_getpower * * Description: * Get the LCD panel power status: * 0: full off * CONFIG_LCD_MAXPOWER: full on * On backlit LCDs, this setting may correspond to the backlight setting. * ****************************************************************************/ static int ssd1306_getpower(FAR struct lcd_dev_s *dev) { FAR struct ssd1306_dev_s *priv = (FAR struct ssd1306_dev_s *)dev; DEBUGASSERT(priv); lcdinfo("power: %s\n", priv->on ? "ON" : "OFF"); return priv->on ? CONFIG_LCD_MAXPOWER : 0; } /**************************************************************************** * Name: ssd1306_do_disponoff * * Description: * Enable/disable LCD panel power * ****************************************************************************/ static int ssd1306_do_disponoff(struct ssd1306_dev_s *priv, bool on) { int ret; /* Lock and select device */ ssd1306_select(priv, true); /* Select command transfer */ ssd1306_cmddata(priv, true); /* Turn the display on/off */ ret = ssd1306_sendbyte(priv, (on ? SSD1306_DISPON : SSD1306_DISPOFF)); /* De-select and unlock the device */ ssd1306_cmddata(priv, false); ssd1306_select(priv, false); return ret; } /**************************************************************************** * Name: ssd1306_setpower * * Description: * Enable/disable LCD panel power: * 0: full off * CONFIG_LCD_MAXPOWER: full on * On backlit LCDs, this setting may correspond to the backlight setting. * ****************************************************************************/ static int ssd1306_setpower(FAR struct lcd_dev_s *dev, int power) { struct ssd1306_dev_s *priv = (struct ssd1306_dev_s *)dev; int ret; DEBUGASSERT(priv); lcdinfo("power: %d [%d]\n", power, priv->on ? CONFIG_LCD_MAXPOWER : 0); DEBUGASSERT((unsigned)power <= CONFIG_LCD_MAXPOWER); if (power <= 0) { /* Turn the display off */ ret = ssd1306_do_disponoff(priv, false); if (ret < 0) { return ret; } priv->on = false; #ifdef CONFIG_SSD1306_POWEROFF_RECONFIGURE /* Display is not configured anymore. */ priv->is_conf = false; #else /* Try turn off power completely */ if (priv->board_priv && priv->board_priv->set_vcc) { /* Do power off. */ if (priv->board_priv->set_vcc(false)) { /* Display is completely powered off, not configured anymore. */ priv->is_conf = false; } } #endif } else { if (priv->board_priv && priv->board_priv->set_vcc) { /* Do power on. */ priv->board_priv->set_vcc(true); } if (!priv->is_conf) { /* Configure display and turn the display on */ ret = ssd1306_configuredisplay(priv); if (ret < 0) { return ret; } /* Draw the framebuffer */ ret = ssd1306_redrawfb(priv); } else { /* Turn the display on */ ret = ssd1306_do_disponoff(priv, true); } if (ret < 0) { return ret; } priv->on = true; } return OK; } /**************************************************************************** * Name: ssd1306_getcontrast * * Description: * Get the current contrast setting (0-CONFIG_LCD_MAXCONTRAST). * ****************************************************************************/ static int ssd1306_getcontrast(struct lcd_dev_s *dev) { struct ssd1306_dev_s *priv = (struct ssd1306_dev_s *)dev; DEBUGASSERT(priv); lcdinfo("contrast: %d\n", priv->contrast); return priv->contrast; } /**************************************************************************** * Name: ssd1306_setcontrast * * Description: * Set LCD panel contrast (0-CONFIG_LCD_MAXCONTRAST). * ****************************************************************************/ static int ssd1306_setcontrast(struct lcd_dev_s *dev, unsigned int contrast) { struct ssd1306_dev_s *priv = (struct ssd1306_dev_s *)dev; unsigned int scaled; int ret; lcdinfo("contrast: %d\n", contrast); DEBUGASSERT(priv); /* Verify the contrast value */ #ifdef CONFIG_DEBUG_FEATURES if (contrast > CONFIG_LCD_MAXCONTRAST) { return -EINVAL; } #endif /* Scale contrast: newcontrast = 255 * contrast / CONFIG_LCD_MAXCONTRAST * Where contrast is in the range {1,255} */ #if CONFIG_LCD_MAXCONTRAST != 255 scaled = ((contrast << 8) - 1) / CONFIG_LCD_MAXCONTRAST; #else scaled = contrast; #endif /* Lock and select device */ ssd1306_select(priv, true); /* Select command transfer */ ssd1306_cmddata(priv, true); /* Set the contrast */ ret = ssd1306_sendbyte(priv, SSD1306_CONTRAST_MODE); /* Set contrast control register */ if (ret < 0) { return ret; } ret = ssd1306_sendbyte(priv, SSD1306_CONTRAST(scaled)); /* Data 1: Set 1 of 256 contrast steps */ if (ret < 0) { return ret; } priv->contrast = contrast; /* De-select and unlock the device */ ssd1306_select(priv, false); return OK; } /**************************************************************************** * Name: ssd1306_configuredisplay * * Description: * Setup LCD display. * ****************************************************************************/ static int ssd1306_configuredisplay(struct ssd1306_dev_s *priv) { int ret; /* Lock and select device */ ssd1306_select(priv, true); /* Select command transfer */ ssd1306_cmddata(priv, true); /* Configure OLED SPI or I/O, must be delayed 1-10ms */ nxsig_usleep(5000); /* Configure the device */ #ifdef IS_SSD1309 /* Unlock driver IC */ ret = ssd1306_sendbyte(priv, SSD1309_PROTOFF); if (ret < 0) { return ret; } /* Display off 0xae */ ret = ssd1306_sendbyte(priv, SSD1306_DISPOFF); if (ret < 0) { return ret; } /* Set page addressing mode: 0x0, 0x01 or 0x02 */ ret = ssd1306_sendbyte(priv, SSD1309_SETMEMORY); if (ret < 0) { return ret; } ret = ssd1306_sendbyte(priv, SSD1309_MEMADDR(0x02)); if (ret < 0) { return ret; } /* Set lower column address 0x00 */ ret = ssd1306_sendbyte(priv, SSD1306_SETCOLL(0)); if (ret < 0) { return ret; } /* Set higher column address 0x10 */ ret = ssd1306_sendbyte(priv, SSD1306_SETCOLH(0)); if (ret < 0) { return ret; } /* Set display start line 0x40 */ ret = ssd1306_sendbyte(priv, SSD1306_STARTLINE(0)); if (ret < 0) { return ret; } /* Set page address (Can ignore) */ ret = ssd1306_sendbyte(priv, SSD1306_PAGEADDR(0)); if (ret < 0) { return ret; } /* Contrast control 0x81 */ ret = ssd1306_sendbyte(priv, SSD1306_CONTRAST_MODE); if (ret < 0) { return ret; } /* Default contrast 0xff */ ret = ssd1306_sendbyte(priv, SSD1306_CONTRAST(SSD1309_DEV_CONTRAST)); if (ret < 0) { return ret; } /* Set segment remap left 95 to 0 | 0xa1 */ ret = ssd1306_sendbyte(priv, SSD1306_REMAPPLEFT); if (ret < 0) { return ret; } /* Normal display off 0xa4 (Can ignore) */ ret = ssd1306_sendbyte(priv, SSD1306_EDISPOFF); if (ret < 0) { return ret; } /* Normal (un-reversed) display mode 0xa6 */ ret = ssd1306_sendbyte(priv, SSD1306_NORMAL); if (ret < 0) { return ret; } /* Multiplex ratio 0xa8 */ ret = ssd1306_sendbyte(priv, SSD1306_MRATIO_MODE); if (ret < 0) { return ret; } /* Duty = 1/64 or 1/32 */ ret = ssd1306_sendbyte(priv, SSD1306_MRATIO(SSD1306_DEV_DUTY)); if (ret < 0) { return ret; } /* Com scan direction: Scan from COM[0] to COM[n-1] */ ret = ssd1306_sendbyte(priv, SSD1306_SCANFROMCOM0); if (ret < 0) { return ret; } /* Set display offset 0xd3 */ ret = ssd1306_sendbyte(priv, SSD1306_DISPOFFS_MODE); if (ret < 0) { return ret; } ret = ssd1306_sendbyte(priv, SSD1306_DISPOFFS(0)); if (ret < 0) { return ret; } /* Set clock divider 0xd5 */ ret = ssd1306_sendbyte(priv, SSD1306_CLKDIV_SET); if (ret < 0) { return ret; } /* 0x70 */ ret = ssd1306_sendbyte(priv, SSD1306_CLKDIV(7, 0)); if (ret < 0) { return ret; } /* Set pre-charge period 0xd9 */ ret = ssd1306_sendbyte(priv, SSD1306_CHRGPER_SET); if (ret < 0) { return ret; } /* 0xfa: Fh cycles for discharge and Ah cycles for pre-charge */ ret = ssd1306_sendbyte(priv, SSD1306_CHRGPER(0x0f, 0x0a)); if (ret < 0) { return ret; } /* Set common pads / set com pins hardware configuration 0xda */ ret = ssd1306_sendbyte(priv, SSD1306_CMNPAD_CONFIG); if (ret < 0) { return ret; } /* 0x12 or 0x02 */ ret = ssd1306_sendbyte(priv, SSD1306_CMNPAD(SSD1306_DEV_CMNPAD)); if (ret < 0) { return ret; } /* set vcomh 0xdb */ ret = ssd1306_sendbyte(priv, SSD1306_VCOM_SET); if (ret < 0) { return ret; } ret = ssd1306_sendbyte(priv, SSD1306_VCOM(0x3c)); if (ret < 0) { return ret; } #else /* Display off 0xae */ ret = ssd1306_sendbyte(priv, SSD1306_DISPOFF); if (ret < 0) { return ret; } /* Set lower column address 0x00 */ ret = ssd1306_sendbyte(priv, SSD1306_SETCOLL(0)); if (ret < 0) { return ret; } /* Set higher column address 0x10 */ ret = ssd1306_sendbyte(priv, SSD1306_SETCOLH(0)); if (ret < 0) { return ret; } /* Set display start line 0x40 */ ret = ssd1306_sendbyte(priv, SSD1306_STARTLINE(0)); if (ret < 0) { return ret; } /* Contrast control 0x81 */ ret = ssd1306_sendbyte(priv, SSD1306_CONTRAST_MODE); if (ret < 0) { return ret; } /* Default contrast 0xcf */ ret = ssd1306_sendbyte(priv, SSD1306_CONTRAST(SSD1306_DEV_CONTRAST)); if (ret < 0) { return ret; } /* Set segment remap left 95 to 0 | 0xa1 */ ret = ssd1306_sendbyte(priv, SSD1306_REMAPPLEFT); if (ret < 0) { return ret; } /* Normal (un-reversed) display mode 0xa6 */ ret = ssd1306_sendbyte(priv, SSD1306_NORMAL); if (ret < 0) { return ret; } /* Multiplex ratio 0xa8 */ ret = ssd1306_sendbyte(priv, SSD1306_MRATIO_MODE); if (ret < 0) { return ret; } /* Duty = 1/64 or 1/32 */ ret = ssd1306_sendbyte(priv, SSD1306_MRATIO(SSD1306_DEV_DUTY)); if (ret < 0) { return ret; } /* Set display offset 0xd3 */ ret = ssd1306_sendbyte(priv, SSD1306_DISPOFFS_MODE); if (ret < 0) { return ret; } ret = ssd1306_sendbyte(priv, SSD1306_DISPOFFS(0)); if (ret < 0) { return ret; } /* Set clock divider 0xd5 */ ret = ssd1306_sendbyte(priv, SSD1306_CLKDIV_SET); if (ret < 0) { return ret; } /* 0x80 */ ret = ssd1306_sendbyte(priv, SSD1306_CLKDIV(8, 0)); if (ret < 0) { return ret; } /* Set pre-charge period 0xd9 */ ret = ssd1306_sendbyte(priv, SSD1306_CHRGPER_SET); if (ret < 0) { return ret; } /* 0xf1 or 0x22 Enhanced mode */ ret = ssd1306_sendbyte(priv, SSD1306_CHRGPER(0x0f, 1)); if (ret < 0) { return ret; } /* Set common pads / set com pins hardware configuration 0xda */ ret = ssd1306_sendbyte(priv, SSD1306_CMNPAD_CONFIG); if (ret < 0) { return ret; } /* 0x12 or 0x02 */ ret = ssd1306_sendbyte(priv, SSD1306_CMNPAD(SSD1306_DEV_CMNPAD)); if (ret < 0) { return ret; } /* set vcomh 0xdb */ ret = ssd1306_sendbyte(priv, SSD1306_VCOM_SET); if (ret < 0) { return ret; } ret = ssd1306_sendbyte(priv, SSD1306_VCOM(0x40)); if (ret < 0) { return ret; } /* Set Charge Pump enable/disable 0x8d ssd1306 */ ret = ssd1306_sendbyte(priv, SSD1306_CHRPUMP_SET); if (ret < 0) { return ret; } /* 0x14 close 0x10 */ ret = ssd1306_sendbyte(priv, SSD1306_CHRPUMP_ON); if (ret < 0) { return ret; } #endif /* Display ON 0xaf */ ret = ssd1306_sendbyte(priv, SSD1306_DISPON); if (ret < 0) { return ret; } /* De-select and unlock the device */ ssd1306_select(priv, false); nxsig_usleep(100000); priv->is_conf = true; return OK; } /**************************************************************************** * Name: ssd1306_redrawfb * * Description: * Redraw full framebuffer to display * * Input Parameters: * priv - Reference to private driver structure * * Assumptions: * Caller has selected the OLED section. * ****************************************************************************/ static int ssd1306_redrawfb(struct ssd1306_dev_s *priv) { unsigned int page; int ret; /* Lock and select device */ ssd1306_select(priv, true); /* Visit each page */ for (page = 0; page < SSD1306_DEV_PAGES; page++) { /* Select command transfer */ ssd1306_cmddata(priv, true); /* Set the column address to the XOFFSET value */ ret = ssd1306_sendbyte(priv, SSD1306_SETCOLL(SSD1306_DEV_XOFFSET)); if (ret < 0) { return ret; } ret = ssd1306_sendbyte(priv, SSD1306_SETCOLH(0)); if (ret < 0) { return ret; } /* Set the page address */ ret = ssd1306_sendbyte(priv, SSD1306_PAGEADDR(page)); if (ret < 0) { return ret; } /* Select data transfer */ ssd1306_cmddata(priv, false); /* Transfer one page of the selected color */ ret = ssd1306_sendblk(priv, &priv->fb[page * SSD1306_DEV_XRES], SSD1306_DEV_XRES); if (ret < 0) { return ret; } } /* De-select and unlock the device */ ssd1306_select(priv, false); return OK; } /**************************************************************************** * Public Functions ****************************************************************************/ /**************************************************************************** * Name: ssd1306_initialize * * Description: * Initialize the 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: * * dev - A reference to the SPI/I2C driver instance. * board_priv - Board specific structure. * devno - A device number when there are multiple OLED devices. * Currently must be zero. * * Returned Value: * * On success, this function returns a reference to the LCD object for * the specified OLED. NULL is returned on any failure. * ****************************************************************************/ #ifdef CONFIG_LCD_SSD1306_SPI FAR struct lcd_dev_s *ssd1306_initialize(FAR struct spi_dev_s *dev, FAR const struct ssd1306_priv_s *board_priv, unsigned int devno) #else FAR struct lcd_dev_s *ssd1306_initialize(FAR struct i2c_master_s *dev, FAR const struct ssd1306_priv_s *board_priv, unsigned int devno) #endif { FAR struct ssd1306_dev_s *priv = &g_oleddev[devno]; priv->dev = g_oleddev_dev; DEBUGASSERT(dev && devno < CONFIG_SSD1306_NUMDEVS); priv->devno = (uint8_t)devno; priv->on = false; priv->is_conf = false; /* Register board specific functions */ priv->board_priv = board_priv; #ifdef CONFIG_LCD_SSD1306_SPI priv->spi = dev; /* Configure the SPI */ ssd1306_configspi(priv->spi); #else /* Remember the I2C configuration */ priv->i2c = dev; priv->addr = CONFIG_SSD1306_I2CADDR; #endif /* Initialize the framebuffer */ memset(priv->fb, SSD1306_Y1_BLACK & 1 ? 0xff : 0x00, SSD1306_DEV_FBSIZE); /* Power on and configure display */ ssd1306_setpower(&priv->dev, true); return &priv->dev; } /**************************************************************************** * Name: ssd1306_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: * dev - Reference to LCD object * color - Desired color * * Assumptions: * Caller has selected the OLED section. * ****************************************************************************/ int ssd1306_fill(FAR struct lcd_dev_s *dev, uint8_t color) { FAR struct ssd1306_dev_s *priv = (struct ssd1306_dev_s *)dev; /* Make an 8-bit version of the selected color */ if (color & 1) { color = 0xff; } else { color = 0; } /* Initialize the framebuffer */ memset(priv->fb, color, SSD1306_DEV_FBSIZE); /* Draw the framebuffer */ return ssd1306_redrawfb(priv); } #endif /* CONFIG_LCD_SSD1306 */