rockbox/firmware/target/arm/as3525/lcd-ssd1303.c
William Wilgus cfeeb7889d Lcd save function pointer to frame buffer get_address_fn before loops
Calling multiple levels of indirection in a loop slows things down

Really these need to be rewritten to take a start and end address
like most of the rest of the codebase

But this is safer without having test hardware in hand

Change-Id: Idae7b92ee779d020ed7fcc9334e2d5a9c710e64d
2022-03-21 23:53:48 -04:00

374 lines
11 KiB
C

/***************************************************************************
* __________ __ ___.
* Open \______ \ ____ ____ | | _\_ |__ _______ ___
* Source | _// _ \_/ ___\| |/ /| __ \ / _ \ \/ /
* Jukebox | | ( <_> ) \___| < | \_\ ( <_> > < <
* Firmware |____|_ /\____/ \___ >__|_ \|___ /\____/__/\_ \
* \/ \/ \/ \/ \/
* $Id$
*
* Copyright (C) 2002 by Alan Korr
* Copyright (C) 2008 François Dinel
* Copyright (C) 2008-2009 Rafaël Carré
* Copyright (C) 2017 William Wilgus
*
* This program is free software; you can redistribute it and/or
* modify it under the terms of the GNU General Public License
* as published by the Free Software Foundation; either version 2
* of the License, or (at your option) any later version.
*
* This software is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY
* KIND, either express or implied.
*
****************************************************************************/
#include "config.h"
#include "kernel.h"
#include "lcd.h"
#include "system.h"
#include "cpu.h"
#include "string.h"
#include "lcd-clip.h"
/*** definitions ***/
#define LCD_SET_LOWER_COLUMN_ADDRESS ((char)0x00)
#define LCD_SET_HIGHER_COLUMN_ADDRESS ((char)0x10)
#define LCD_SET_DISPLAY_START_LINE ((char)0x40)
#define LCD_SET_CONTRAST_CONTROL_REGISTER ((char)0x81)
#define LCD_SET_SEGMENT_REMAP ((char)0xA0)
#define LCD_SET_SEGMENT_REMAP_INV ((char)0xA1)
#define LCD_SET_ENTIRE_DISPLAY_OFF ((char)0xA4)
#define LCD_SET_ENTIRE_DISPLAY_ON ((char)0xA5)
#define LCD_SET_NORMAL_DISPLAY ((char)0xA6)
#define LCD_SET_REVERSE_DISPLAY ((char)0xA7)
#define LCD_SET_MULTIPLEX_RATIO ((char)0xA8)
#define LCD_SET_DC_DC ((char)0xAD)
#define LCD_SET_DISPLAY_OFF ((char)0xAE)
#define LCD_SET_DISPLAY_ON ((char)0xAF)
#define LCD_SET_PAGE_ADDRESS ((char)0xB0)
#define LCD_SET_COM_OUTPUT_SCAN_DIRECTION ((char)0xC0)
#define LCD_SET_COM_OUTPUT_SCAN_DIRECTION_INV ((char)0xC8)
#define LCD_SET_DISPLAY_CLOCK_AND_OSC_FREQ ((char)0xD5)
#define LCD_SET_VCOM_DESELECT_LEVEL ((char)0xDB)
#define LCD_SET_PRECHARGE_PERIOD ((char)0xD9)
#define LCD_NOP ((char)0xE3)
/* LCD command codes */
#define LCD_CNTL_CONTRAST 0x81 /* Contrast */
#define LCD_CNTL_OUTSCAN 0xc8 /* Output scan direction */
#define LCD_CNTL_SEGREMAP 0xa1 /* Segment remap */
#define LCD_CNTL_DISPON 0xaf /* Display on */
#define LCD_CNTL_PAGE 0xb0 /* Page address */
#define LCD_CNTL_HIGHCOL 0x10 /* Upper column address */
#define LCD_CNTL_LOWCOL 0x00 /* Lower column address */
/** globals **/
static bool display_on; /* used by lcd_enable */
/* Display variant, always 0 in clipv1, clipv2, can be 0 or 1 in clip+
* variant 0: has 132 pixel wide framebuffer, max brightness about 50
* variant 1: has 128 pixel wide framebuffer, max brightness about 128
*/
static int variant;
static int offset; /* column offset */
/*** hardware configuration ***/
int lcd_default_contrast(void)
{
return DEFAULT_CONTRAST_SETTING;
}
void lcd_set_contrast(int val)
{
lcd_write_command(LCD_CNTL_CONTRAST);
if (variant == 1) {
val = val * 5 / 2;
}
lcd_write_command(val);
}
void lcd_set_invert_display(bool yesno)
{
if (yesno)
lcd_write_command(LCD_SET_REVERSE_DISPLAY);
else
lcd_write_command(LCD_SET_NORMAL_DISPLAY);
}
/* turn the display upside down (call lcd_update() afterwards) */
void lcd_set_flip(bool yesno)
{
if (yesno)
{
lcd_write_command(LCD_SET_SEGMENT_REMAP);
lcd_write_command(LCD_SET_COM_OUTPUT_SCAN_DIRECTION);
}
else
{
lcd_write_command(LCD_SET_SEGMENT_REMAP_INV);
lcd_write_command(LCD_SET_COM_OUTPUT_SCAN_DIRECTION_INV);
}
}
#ifdef HAVE_LCD_ENABLE
void lcd_enable(bool enable)
{
if (display_on == enable)
return;
if ( (display_on = enable) ) /* simple '=' is not a typo ! */
{
lcd_enable_power(enable);
lcd_write_command(LCD_SET_DISPLAY_ON);
send_event(LCD_EVENT_ACTIVATION, NULL);
}
else
{
lcd_write_command(LCD_SET_DISPLAY_OFF);
lcd_enable_power(enable);
}
}
bool lcd_active(void)
{
return display_on;
}
#endif
/* LCD init, largely based on what OF does */
void lcd_init_device(void)
{
int i;
variant = lcd_hw_init();
offset = (variant == 0) ? 2 : 0;
/* power on display to accept commands */
lcd_enable_power(true);
lcd_write_cmd_triplet
(
/* Set display clock */
(LCD_SET_DISPLAY_CLOCK_AND_OSC_FREQ),
/* Set display clock (divide ratio = 1) and oscillator frequency (1) */
(0x10),
/* Set VCOM deselect level */
(LCD_SET_VCOM_DESELECT_LEVEL)
);
lcd_write_cmd_triplet
(
/* Set VCOM deselect level to 0.76V */
(0x34),
/* Set pre-charge period */
(LCD_SET_PRECHARGE_PERIOD),
/* Set pre-charge period (p1period is 2 dclk and p2period is 5 dclk) */
(0x25)
);
/* Set contrast register to 12% */
lcd_set_contrast(lcd_default_contrast());
lcd_write_cmd_triplet
(
/* Configure DC-DC */
(LCD_SET_DC_DC),
/* Configure DC-DC */
((variant == 0) ? 0x8A : 0x10),
/* Set starting line as 0 */
(LCD_SET_DISPLAY_START_LINE /*|(0 & 0x3f)*/)
);
lcd_write_cmd_triplet
(
/* Column 131 is remapped to SEG0 */
(LCD_SET_SEGMENT_REMAP_INV),
/* Invert COM scan direction (N-1 to 0) */
(LCD_SET_COM_OUTPUT_SCAN_DIRECTION_INV),
/* Set normal display mode (not every pixel ON) */
(LCD_SET_ENTIRE_DISPLAY_OFF)
);
lcd_write_cmd_triplet
(
/* Set normal display mode (not inverted) */
(LCD_SET_NORMAL_DISPLAY),
/* set upper 4 bits of 8-bit column address */
(LCD_SET_HIGHER_COLUMN_ADDRESS /*| 0*/),
/* set lower 4 bits of 8-bit column address */
(LCD_SET_LOWER_COLUMN_ADDRESS /*| 0*/)
);
fb_data p_bytes[LCD_WIDTH + 2 * offset];
memset(p_bytes, 0, sizeof(p_bytes)); /* fills with 0 : pixel off */
for (i = 0; i < 8; i++)
{
lcd_write_command (LCD_SET_PAGE_ADDRESS | (i /*& 0xf*/));
lcd_write_data(p_bytes, LCD_WIDTH + 2 * offset);
}
lcd_enable(true);
lcd_update();
}
/*** Update functions ***/
/* returns LCD_CNTL_HIGHCOL or'd with higher 4 bits of
the 8-bit column address for the display data RAM.
*/
static inline int get_column_high_byte(const int x)
{
return (LCD_CNTL_HIGHCOL | (((x+offset) >> 4) & 0xf));
}
/* returns LCD_CNTL_LOWCOL or'd with lower 4 bits of
the 8-bit column address for the display data RAM.
*/
static inline int get_column_low_byte(const int x)
{
return (LCD_CNTL_LOWCOL | ((x+offset) & 0xf));
}
/* Performance function that works with an external buffer
note that by and bheight are in 8-pixel units! */
void lcd_blit_mono(const unsigned char *data, int x, int by, int width,
int bheight, int stride)
{
if (!display_on)
return;
const int column_high = get_column_high_byte(x);
const int column_low = get_column_low_byte(x);
/* Copy display bitmap to hardware */
while (bheight--)
{
lcd_write_cmd_triplet
(
(LCD_CNTL_PAGE | (by++ & 0xf)),
(column_high),
(column_low)
);
lcd_write_data(data, width);
data += stride;
}
}
#ifndef BOOTLOADER
/* Helper function for lcd_grey_phase_blit(). */
void lcd_grey_data(unsigned char *values, unsigned char *phases, int count);
/* Performance function that works with an external buffer
note that by and bheight are in 8-pixel units! */
void lcd_blit_grey_phase(unsigned char *values, unsigned char *phases,
int x, int by, int width, int bheight, int stride)
{
if (!display_on)
return;
const int column_high = get_column_high_byte(x);
const int column_low = get_column_low_byte(x);
stride <<= 3; /* 8 pixels per block */
/* Copy display bitmap to hardware */
while (bheight--)
{
lcd_write_cmd_triplet
(
(LCD_CNTL_PAGE | (by++ & 0xf)),
(column_high),
(column_low)
);
lcd_grey_data(values, phases, width);
values += stride;
phases += stride;
}
}
#endif
/* Shared internal function for lcd_update and lcd_update_rect
WARNING does NOT check bounds
*/
static void internal_update_rect(int, int, int, int) ICODE_ATTR;
static void internal_update_rect(int x, int y, int width, int height)
{
if (!display_on)
return;
const int column_high = get_column_high_byte(x);
const int column_low = get_column_low_byte(x);
void* (*fbaddr)(int x, int y) = FB_CURRENTVP_BUFFER->get_address_fn;
/* Copy specified rectange bitmap to hardware */
for (; y <= height; y++)
{
lcd_write_cmd_triplet
(
(LCD_CNTL_PAGE | (y & 0xf)),
(column_high),
(column_low)
);
lcd_write_data (fbaddr(x,y), width);
}
lcd_write_command (LCD_NOP); /* return to command mode */
}
/* Update the display.
This must be called after all other LCD functions that change the display. */
void lcd_update(void) ICODE_ATTR;
void lcd_update(void)
{
/* Copy display bitmap to hardware */
internal_update_rect(0, 0, LCD_WIDTH, LCD_FBHEIGHT - 1);
}
/* Update a fraction of the display. */
void lcd_update_rect(int, int, int, int) ICODE_ATTR;
void lcd_update_rect(int x, int y, int width, int height)
{
int ymax;
if (!display_on)
return;
/* make sure the rectangle is bounded in the screen */
if (width > LCD_WIDTH - x)/* Clip right */
width = LCD_WIDTH - x;
if (x < 0)/* Clip left */
{
width += x;
x = 0;
}
if (width <= 0)
return; /* nothing left to do, 0 is harmful to lcd_write_data() */
if (height > LCD_HEIGHT - y) /* Clip bottom */
height = LCD_HEIGHT - y;
if (y < 0) /* Clip top */
{
height += y;
y = 0;
}
if (height <= 0)
return; /* nothing left to do */
/* The Y coordinates have to work on even 8 pixel rows */
ymax = (y + height-1) >> 3;
y >>= 3;
/* Copy specified rectange bitmap to hardware */
internal_update_rect(x, y, width, ymax);
}