diff -r 000000000000 -r 88d965579617 components/u8g2/csrc/u8x8_d_ssd1606_172x72.c --- /dev/null Thu Jan 01 00:00:00 1970 +0000 +++ b/components/u8g2/csrc/u8x8_d_ssd1606_172x72.c Tue Oct 08 12:00:31 2019 +0200 @@ -0,0 +1,394 @@ +/* + + u8x8_d_ssd1606_172x72.c + + Universal 8bit Graphics Library (https://github.com/olikraus/u8g2/) + + Copyright (c) 2016, olikraus@gmail.com + All rights reserved. + + Redistribution and use in source and binary forms, with or without modification, + are permitted provided that the following conditions are met: + + * Redistributions of source code must retain the above copyright notice, this list + of conditions and the following disclaimer. + + * 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. + + 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 HOLDER 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. + + SSD1606: 128x180x2 + two-bit, four graylevels + command + 0x22: assign actions + 0x20: execute actions + + action for command 0x022 are (more or less guessed) + bit 7: Enable Clock + bit 6: Enable Charge Pump + bit 5: Load Temparture Value (???) + bit 4: Load LUT (???) + bit 3: Initial Display (???) + bit 2: Pattern Display --> Requires about 945ms with the LUT from below + bit 1: Disable Charge Pump + bit 0: Disable Clock + + Disable Charge Pump and Clock require about 267ms + Enable Charge Pump and Clock require about 10ms + + Notes: + - Introduced a refresh display message, which copies RAM to display + - Charge pump and clock are only enabled for the transfer RAM to display + - U8x8 will not really work because of the two buffers in the SSD1606, however U8g2 should be ok. + +*/ + + +#include "u8x8.h" + + +#define L(a,b,c,d) (((a)<<6)|((b)<<4)|((c)<<2)|(d)) + + +/* GDE021A1, 2.1" EPD */ +static const uint8_t u8x8_d_ssd1606_172x72_gde021a1_init_seq[] = { + + U8X8_START_TRANSFER(), /* enable chip, delay is part of the transfer start */ + + U8X8_CA(0x10, 0x00), /* Deep Sleep mode Control: Disable */ + U8X8_CA(0x11, 0x03), /* Define data entry mode, x&y inc, x first */ + U8X8_CAA(0x44, 0, 31), /* RAM x start & end, each byte has 4 pixel, 32*4=128 */ + U8X8_CAA(0x45, 0, 179), /* RAM y start & end, 179 MAX */ + + U8X8_CA(0x4e, 0), /* set x pos, 0..31 */ + U8X8_CA(0x4f, 0), /* set y pos, 0...179 */ + + U8X8_CA(0xf0, 0x1f), /* set booster feedback to internal */ + U8X8_CA(0x22, 0xc0), /* display update seq. option: enable clk, enable CP, .... todo: this is never activated */ + + U8X8_C(0x32), /* write LUT register*/ + +#ifdef ORIGINAL_LUT + + /* wavefrom part of the LUT: absolute LUT... this will always force the destination color */ + U8X8_A4(0x00,0x00,0x00,0x55), /* step 0 */ + U8X8_A4(0x00,0x00,0x55,0x55), /* step 1 */ + U8X8_A4(0x00,0x55,0x55,0x55), + U8X8_A4(0xAA,0xAA,0xAA,0xAA), + U8X8_A4(0x15,0x15,0x15,0x15), + U8X8_A4(0x05,0x05,0x05,0x05), + U8X8_A4(0x01,0x01,0x01,0x01), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), /* step 19 */ + + /* timing part of the LUT */ + U8X8_A8(0x22,0xFB,0x22,0x1B,0x00,0x00,0x00,0x00), + U8X8_A(0x00),U8X8_A(0x00), + +#else + + /* the following LUT will not change anything if the old and the new values are the same */ + /* 03 02 01 00 13 12 11 10 23 22 21 20 33 32 31 30 original */ + U8X8_A4(L(0, 0, 0, 0), L(0, 0, 0, 0), L(0, 0, 0, 0), L(0, 1, 1, 1)), // 0x00,0x00,0x00,0x55, step 0 + U8X8_A4(L(0, 0, 0, 0), L(0, 0, 0, 0), L(1, 0, 1, 1), L(0, 1, 1, 1)), // 0x00,0x00,0x55,0x55, step 1 + U8X8_A4(L(0, 0, 0, 0), L(1, 1, 0, 1), L(1, 0, 1, 1), L(0, 1, 1, 1)), // 0x00,0x55,0x55,0x55, step 2 + U8X8_A4(L(2, 2, 2, 0), L(2, 2, 0, 2), L(2, 0, 2, 2), L(0, 2, 2, 2)), // 0xAA,0xAA,0xAA,0xAA, step 3 + U8X8_A4(L(0, 1, 1, 0), L(0, 1, 0, 1), L(0, 0, 1, 1), L(0, 1, 1, 1)), // 0x15,0x15,0x15,0x15, step 4 + U8X8_A4(L(0, 0, 1, 0), L(0, 0, 0, 1), L(0, 0, 1, 1), L(0, 0, 1, 1)), // 0x05,0x05,0x05,0x05, step 5 + U8X8_A4(L(0, 0, 0, 0), L(0, 0, 0, 1), L(0, 0, 0, 1), L(0, 0, 0, 1)), // 0x01,0x01,0x01,0x01, step 6 + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), + U8X8_A4(0x00,0x00,0x00,0x00), /* step 19 */ + + /* timing part of the LUT */ + U8X8_A8(0x22,0xFB,0x22,0x1B,0x00,0x00,0x00,0x00), + U8X8_A(0x00),U8X8_A(0x00), + +#endif + + U8X8_CA(0x2c, 0xa0), /* write vcom value*/ + U8X8_CA(0x3c, 0x63), /* select boarder waveform */ + U8X8_CA(0x22, 0xc4), /* display update seq. option: clk -> CP -> LUT -> initial display -> pattern display */ + /* 0x0c4 is mentioned in chapter 9.2 of the GDE021A1 data sheet */ + + U8X8_END_TRANSFER(), /* disable chip */ + U8X8_END() /* end of sequence */ +}; + +static const uint8_t u8x8_d_ssd1606_to_display_seq[] = { + U8X8_START_TRANSFER(), /* enable chip, delay is part of the transfer start */ + + + //U8X8_CA(0x22, 0xc0), /* display update seq. option: Enable clock and charge pump */ + //U8X8_C(0x20), /* execute sequence */ + //U8X8_DLY(10), + /* strange, splitting 0x0c0 does not work reliable */ + + U8X8_CA(0x22, 0xc4), /* display update seq. option: clk -> CP -> LUT -> initial display -> pattern display */ + U8X8_C(0x20), /* execute sequence */ + U8X8_DLY(250), /* the sequence above requires about 970ms */ + U8X8_DLY(250), + U8X8_DLY(250), + U8X8_DLY(230), + + U8X8_CA(0x22, 0x03), /* disable clock and charge pump */ + U8X8_DLY(200), /* this requres about 270ms */ + U8X8_DLY(90), + + //U8X8_CA(0x10, 0x01), /* deep sleep mode */ + //U8X8_C(0x20), /* execute sequence */ + U8X8_DLY(50), + + U8X8_END_TRANSFER(), /* disable chip */ + U8X8_END() /* end of sequence */ +}; + + +// static const uint8_t u8x8_d_ssd1606_172x72_powersave0_seq[] = { +// U8X8_START_TRANSFER(), /* enable chip, delay is part of the transfer start */ +// U8X8_END_TRANSFER(), /* disable chip */ +// U8X8_END() /* end of sequence */ +// }; + + +// static const uint8_t u8x8_d_ssd1606_172x72_powersave1_seq[] = { +// U8X8_START_TRANSFER(), /* enable chip, delay is part of the transfer start */ +// U8X8_END_TRANSFER(), /* disable chip */ +// U8X8_END() /* end of sequence */ +// }; + +// static const uint8_t u8x8_d_ssd1606_172x72_flip0_seq[] = { +// U8X8_START_TRANSFER(), /* enable chip, delay is part of the transfer start */ +// U8X8_END_TRANSFER(), /* disable chip */ +// U8X8_END() /* end of sequence */ +// }; + +// static const uint8_t u8x8_d_ssd1606_172x72_flip1_seq[] = { +// U8X8_START_TRANSFER(), /* enable chip, delay is part of the transfer start */ +// U8X8_END_TRANSFER(), /* disable chip */ +// U8X8_END() /* end of sequence */ +// }; + + +static uint8_t *u8x8_convert_tile_for_ssd1606(uint8_t *t) +{ + uint8_t i; + uint16_t r; + static uint8_t buf[16]; + uint8_t *pbuf = buf; + + for( i = 0; i < 8; i++ ) + { + r = u8x8_upscale_byte(~(*t++)); + *pbuf++ = (r>>8) & 255; + *pbuf++ = r & 255; + } + return buf; +} + +static void u8x8_d_ssd1606_draw_tile(u8x8_t *u8x8, uint8_t arg_int, void *arg_ptr) U8X8_NOINLINE; +static void u8x8_d_ssd1606_draw_tile(u8x8_t *u8x8, uint8_t arg_int, void *arg_ptr) +{ + uint8_t x, c, page; + uint8_t *ptr; + u8x8_cad_StartTransfer(u8x8); + + page = u8x8->display_info->tile_height; + page --; + page -= (((u8x8_tile_t *)arg_ptr)->y_pos); + page *= 2; + + + x = ((u8x8_tile_t *)arg_ptr)->x_pos; + x *= 8; + x += u8x8->x_offset; + + u8x8_cad_SendCmd(u8x8, 0x00f ); /* scan start */ + u8x8_cad_SendArg(u8x8, 0); + + u8x8_cad_SendCmd(u8x8, 0x011 ); /* cursor increment mode */ + u8x8_cad_SendArg(u8x8, 3); + + u8x8_cad_SendCmd(u8x8, 0x045 ); /* window start column */ + u8x8_cad_SendArg(u8x8, 0); + u8x8_cad_SendArg(u8x8, 179); /* end of display */ + + u8x8_cad_SendCmd(u8x8, 0x044 ); /* window end page */ + u8x8_cad_SendArg(u8x8, page); + u8x8_cad_SendArg(u8x8, page+1); + + u8x8_cad_SendCmd(u8x8, 0x04f ); /* window column */ + u8x8_cad_SendArg(u8x8, x); + + u8x8_cad_SendCmd(u8x8, 0x04e ); /* window row */ + u8x8_cad_SendArg(u8x8, page); + + u8x8_cad_SendCmd(u8x8, 0x024 ); + + do + { + c = ((u8x8_tile_t *)arg_ptr)->cnt; + ptr = ((u8x8_tile_t *)arg_ptr)->tile_ptr; + do + { + u8x8_cad_SendData(u8x8, 16, u8x8_convert_tile_for_ssd1606(ptr)); + ptr += 8; + x += 8; + c--; + } while( c > 0 ); + + arg_int--; + } while( arg_int > 0 ); + + u8x8_cad_EndTransfer(u8x8); +} + + +static uint8_t u8x8_d_ssd1606_172x72_generic(u8x8_t *u8x8, uint8_t msg, uint8_t arg_int, void *arg_ptr) +{ + switch(msg) + { + /* handled by the calling function + case U8X8_MSG_DISPLAY_SETUP_MEMORY: + u8x8_d_helper_display_setup_memory(u8x8, &u8x8_ssd1606_172x72_display_info); + break; + */ + case U8X8_MSG_DISPLAY_INIT: + + u8x8_d_helper_display_init(u8x8); + u8x8_cad_SendSequence(u8x8, u8x8_d_ssd1606_172x72_gde021a1_init_seq); + + /* special code for the SSD1606... */ + /* ensure that the initial buffer is clear and all eInk is set to white */ + /* this is done here, because the LUT will be of that kind, that it uses the previous color */ + /* make everything black */ + u8x8_FillDisplay(u8x8); + /* write content to the display */ + u8x8_RefreshDisplay(u8x8); + /* now make everything clear */ + u8x8_FillDisplay(u8x8); + /* write content to the display */ + u8x8_RefreshDisplay(u8x8); + /* now make everything clear */ + u8x8_ClearDisplay(u8x8); + /* write content to the display */ + u8x8_RefreshDisplay(u8x8); + + u8x8_ClearDisplay(u8x8); + /* write content to the display */ + u8x8_RefreshDisplay(u8x8); + + break; + case U8X8_MSG_DISPLAY_SET_POWER_SAVE: +/* + if ( arg_int == 0 ) + u8x8_cad_SendSequence(u8x8, u8x8_d_ssd1606_172x72_powersave0_seq); + else + u8x8_cad_SendSequence(u8x8, u8x8_d_ssd1606_172x72_powersave1_seq); +*/ + break; + case U8X8_MSG_DISPLAY_SET_FLIP_MODE: +/* + if ( arg_int == 0 ) + { + u8x8_cad_SendSequence(u8x8, u8x8_d_ssd1606_172x72_flip0_seq); + u8x8->x_offset = u8x8->display_info->default_x_offset; + } + else + { + u8x8_cad_SendSequence(u8x8, u8x8_d_ssd1606_172x72_flip1_seq); + u8x8->x_offset = u8x8->display_info->flipmode_x_offset; + } +*/ + break; +#ifdef U8X8_WITH_SET_CONTRAST + case U8X8_MSG_DISPLAY_SET_CONTRAST: +/* + u8x8_cad_StartTransfer(u8x8); + u8x8_cad_EndTransfer(u8x8); +*/ + break; +#endif + case U8X8_MSG_DISPLAY_DRAW_TILE: + u8x8_d_ssd1606_draw_tile(u8x8, arg_int, arg_ptr); + break; + case U8X8_MSG_DISPLAY_REFRESH: + u8x8_cad_SendSequence(u8x8, u8x8_d_ssd1606_to_display_seq); + break; + default: + return 0; + } + return 1; +} + + +static const u8x8_display_info_t u8x8_ssd1606_172x72_display_info = +{ + /* chip_enable_level = */ 0, + /* chip_disable_level = */ 1, + + /* post_chip_enable_wait_ns = */ 120, + /* pre_chip_disable_wait_ns = */ 60, + /* reset_pulse_width_ms = */ 100, + /* post_reset_wait_ms = */ 100, + /* sda_setup_time_ns = */ 50, /* SSD1606: */ + /* sck_pulse_width_ns = */ 100, /* SSD1606: 100ns */ + /* sck_clock_hz = */ 4000000UL, /* since Arduino 1.6.0, the SPI bus speed in Hz. Should be 1000000000/sck_pulse_width_ns */ + /* spi_mode = */ 0, /* active high, rising edge */ + /* i2c_bus_clock_100kHz = */ 4, + /* data_setup_time_ns = */ 40, + /* write_pulse_width_ns = */ 150, + /* tile_width = */ 22, /* 22*8 = 176 */ + /* tile_hight = */ 9, /* 9*8 = 72 */ + /* default_x_offset = */ 0, + /* flipmode_x_offset = */ 0, + /* pixel_width = */ 172, + /* pixel_height = */ 72 +}; + +uint8_t u8x8_d_ssd1606_172x72(u8x8_t *u8x8, uint8_t msg, uint8_t arg_int, void *arg_ptr) +{ + if ( msg == U8X8_MSG_DISPLAY_SETUP_MEMORY ) + { + u8x8_d_helper_display_setup_memory(u8x8, &u8x8_ssd1606_172x72_display_info); + return 1; + } + return u8x8_d_ssd1606_172x72_generic(u8x8, msg, arg_int, arg_ptr); +} + +