circuitpython/nrf5/drivers/display/epaper_sld00200p_driver.c

/*
 * This file is part of the Micro Python project, http://micropython.org/
 *
 * The MIT License (MIT)
 *
 * Copyright (c) 2017 Glenn Ruben Bakke
 *
 * Permission is hereby granted, free of charge, to any person obtaining a copy
 * of this software and associated documentation files (the "Software"), to deal
 * in the Software without restriction, including without limitation the rights
 * to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
 * copies of the Software, and to permit persons to whom the Software is
 * furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included in
 * all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
 * AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 * OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
 * THE SOFTWARE.
 */

#include "epaper_sld00200p_driver.h"

#if MICROPY_PY_DISPLAY_EPAPER_SLD00200P

#include "py/mphal.h"

#include "epaper_sld00200p_driver.h"
#include "hal_spi.h"
#include "hal_time.h"

#define BYTE_ARRAY(...) ((uint8_t[]){ __VA_ARGS__})
#define DATA_WRITE(...) (data_write_buffer(BYTE_ARRAY(__VA_ARGS__), sizeof(BYTE_ARRAY(__VA_ARGS__))))

static NRF_SPI_Type * mp_spi_instance;
static NRF_PWM_Type * mp_pwm_instance;
static pin_obj_t * mp_pin_cs;
static pin_obj_t * mp_pin_panel_on;
static pin_obj_t * mp_pin_border;
static pin_obj_t * mp_pin_busy;
static pin_obj_t * mp_pin_reset;
static pin_obj_t * mp_pin_discharge;

#if 0
static pin_obj_t * mp_pin_temp_sensor;
#endif

static void wait_for_busy_release(void) {
    while (mp_hal_pin_read(mp_pin_busy) == 1) {
        ;
    }
}

static void data_write_buffer(uint8_t * p_bytes, uint16_t num_of_bytes) {
    mp_hal_pin_low(mp_pin_cs);

    hal_spi_master_tx_rx(mp_spi_instance, num_of_bytes, p_bytes, NULL);

    mp_hal_pin_high(mp_pin_cs);
}

static void raw_write(uint8_t value)
{
    hal_spi_master_tx_rx(mp_spi_instance, 1, &value, NULL);
}

void driver_sld00200p_init(NRF_SPI_Type * p_spi_instance,
                           NRF_PWM_Type * p_pwm_instance,
                           pin_obj_t * p_pin_cs,
                           pin_obj_t * p_pin_panel_on,
                           pin_obj_t * p_pin_border,
                           pin_obj_t * p_pin_busy,
                           pin_obj_t * p_pin_reset,
                           pin_obj_t * p_pin_discharge) {

    mp_spi_instance  = p_spi_instance;
    mp_pwm_instance  = p_pwm_instance;
    mp_pin_cs        = p_pin_cs;
    mp_pin_panel_on  = p_pin_panel_on;
    mp_pin_border    = p_pin_border;
    mp_pin_busy      = p_pin_busy;
    mp_pin_reset     = p_pin_reset;
    mp_pin_discharge = p_pin_discharge;

    driver_sld00200p_reinit();
}

void driver_sld00200p_reinit(void) {
    mp_hal_pin_low(mp_pin_reset);
    mp_hal_pin_low(mp_pin_panel_on);
    mp_hal_pin_low(mp_pin_discharge);
    mp_hal_pin_low(mp_pin_border);

    // start the pwm
    hal_pwm_start(mp_pwm_instance);

    mp_hal_delay_ms(5);

    mp_hal_pin_high(mp_pin_panel_on);

    mp_hal_delay_ms(10);

    mp_hal_pin_high(mp_pin_reset);
    mp_hal_pin_high(mp_pin_border);
    mp_hal_pin_high(mp_pin_cs);

    // make reset square wave
    mp_hal_delay_ms(5);
    mp_hal_pin_low(mp_pin_reset);
    mp_hal_delay_ms(5);
    mp_hal_pin_high(mp_pin_reset);
    mp_hal_delay_ms(5);

    wait_for_busy_release();

    // channel select
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x01);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x00, 0x00, 0x00, 0x7f, 0xff, 0xfe, 0x00, 0x00);

    // DC/DC frequency
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x06);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x00, 0x00, 0x00, 0x7f, 0xff, 0xfe, 0x00, 0x00);

    // high power mode osc
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x07);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x9d);

    // disable ADC
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x08);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x00);

    // Vcom level
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x09);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0xd0, 0x00);

    // gate and source voltage levels
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x04);

    // GS
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x00);

    mp_hal_delay_ms(5);

    // driver latch on
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x03);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x01);

    // driver latch off
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x03);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x00);

    mp_hal_delay_ms(5);

    // charge pump positive voltage on
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x05);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x01);

    // final delay before PWM off
    mp_hal_delay_us(30);

    // stop the pwm
    hal_pwm_stop(mp_pwm_instance);

    // charge pump negative voltage on
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x05);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x03);

    mp_hal_delay_us(30);

    // Vcom driver on
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x05);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x0f);

    mp_hal_delay_ms(30);

    // output enable to disable
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x02);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x24);
}

static void epaper_sld00200p_line(uint16_t line, const uint8_t * data, uint8_t fixed_value, epd_stage_t stage)
{
    mp_hal_delay_ms(10);

    DATA_WRITE(0x70, 0x04);
    wait_for_busy_release();

    // gate source
    DATA_WRITE(0x72, 0x00);
    wait_for_busy_release();

    DATA_WRITE(0x70, 0x0a);
    wait_for_busy_release();

    mp_hal_pin_low(mp_pin_cs);
    raw_write(0x72);
    wait_for_busy_release();

    uint16_t bytes_per_line = 264 / 8;

    // even pixels
    for (uint16_t i = bytes_per_line; i > 0; --i) {
        if (data != NULL) {
            uint8_t pixels = data[i - 1] & 0xaa;

            switch (stage) {
                case EPD_COMP:
                    // B -> W, W -> B (current image)
                    pixels = 0xaa | ((pixels ^ 0xaa) >> 1);
                    break;

                case EPD_WHITE:
                    // B -> N, W -> W (current image)
                    pixels = 0x55 + ((pixels ^ 0xaa) >> 1);
                    break;

                case EPD_INV:
                    // B -> N, W -> B (new image)
                    pixels = 0x55 | (pixels ^ 0xaa);
                    break;

                case EPD_NORM:
                    // B -> B, W -> W (new image)
                    pixels = 0xaa | (pixels >> 1);
                    break;

                default:
                    break;
            }

            raw_write(pixels);
            wait_for_busy_release();
        } else {
            raw_write(fixed_value);
            wait_for_busy_release();
        }
    }

    uint16_t bytes_per_scan = 176 / 4;
    // scan line
    for (uint16_t i = 0; i < bytes_per_scan; i++) {
        if (line / 4 == i) {
            raw_write(0xc0 >> (2 * (line & 0x03)));
            wait_for_busy_release();
        } else {
            raw_write(0x00);
            wait_for_busy_release();
        }
    }

    // odd pixels
    for (uint16_t i = 0; i < bytes_per_line; i++) {
        if (data != NULL) {
            uint8_t pixels;
            pixels = data[i] & 0x55;

            switch (stage) {
                case EPD_COMP:
                    pixels = 0xaa | (pixels ^ 0x55);
                    break;

                case EPD_WHITE:
                    pixels = 0x55 + (pixels ^ 0x55);
                    break;

                case EPD_INV:
                    pixels = 0x55 | ((pixels ^ 0x55) << 1);
                    break;

                case EPD_NORM:
                    pixels = 0xaa | pixels;
                    break;

                default:
                    break;
            }

            uint8_t p1 = (pixels >> 6) & 0x03;
            uint8_t p2 = (pixels >> 4) & 0x03;
            uint8_t p3 = (pixels >> 2) & 0x03;
            uint8_t p4 = (pixels >> 0) & 0x03;
            pixels = (p1 << 0) | (p2 << 2) | (p3 << 4) | (p4 << 6);

            raw_write(pixels);
            wait_for_busy_release();
        } else {
            raw_write(fixed_value);
            wait_for_busy_release();
        }
    }

    // Complete line
    raw_write(0x00);
    wait_for_busy_release();

    mp_hal_pin_high(mp_pin_cs);
    wait_for_busy_release();

    DATA_WRITE(0x70, 0x02);
    wait_for_busy_release();

    DATA_WRITE(0x72, 0x2f);
}

void driver_sld00200p_deinit(void) {
    epaper_sld00200p_line(0x7fffu, 0, 0x55, EPD_NORM);
    mp_hal_delay_ms(25);
    mp_hal_pin_low(mp_pin_border);
    mp_hal_delay_ms(250);
    mp_hal_pin_high(mp_pin_border);

    // latch reset turn on
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x03);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x01);

    // output enable off
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x02);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x05);

    // Vcom power off
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x05);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x0e);

    // power off negative charge pump
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x05);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x02);

    // discharge
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x04);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x0c);
    mp_hal_delay_us(120);

    // all charge pumps off
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x05);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x00);

    // turn of osc
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x07);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x0d);

    // discharge internal - 1
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x04);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x50);
    mp_hal_delay_us(40);

    // discharge internal - 2
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x04);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0xA0);
    mp_hal_delay_us(40);

    // discharge internal - 3
    mp_hal_delay_us(10);
    DATA_WRITE(0x70, 0x04);
    mp_hal_delay_us(10);
    DATA_WRITE(0x72, 0x00);

    // turn of power and all signals
    mp_hal_delay_ms(10);
    mp_hal_pin_low(mp_pin_reset);
    mp_hal_pin_low(mp_pin_panel_on);
    mp_hal_pin_low(mp_pin_border);

    // discharge pulse
    mp_hal_pin_high(mp_pin_discharge);
    mp_hal_delay_us(250);
    mp_hal_pin_low(mp_pin_discharge);
    mp_hal_pin_high(mp_pin_cs);
}

void driver_sld00200p_clear(uint16_t color) {
    uint16_t line_count = 176;
    for (uint16_t i = 0; i < line_count; i++) {
        epaper_sld00200p_line(i, NULL, 0xFF, EPD_COMP);
    }
    mp_hal_delay_ms(100);

    for (uint16_t i = 0; i < line_count; i++) {
        epaper_sld00200p_line(i, NULL, 0xAA, EPD_WHITE);
    }
    mp_hal_delay_ms(100);

    for (uint16_t i = 0; i < line_count; i++) {
        epaper_sld00200p_line(i, NULL, 0xFF, EPD_INV);
    }
    mp_hal_delay_ms(100);

    for (uint16_t i = 0; i < line_count; i++) {
        epaper_sld00200p_line(i, NULL, 0xAA, EPD_NORM);
    }
    mp_hal_delay_ms(100);
}

void driver_sld00200p_update_line(uint16_t line, fb_byte_t * p_bytes, fb_byte_t * p_old, uint16_t len, bool compressed) {
    epaper_sld00200p_line(line, (uint8_t *)p_old, 0x00, EPD_COMP);
    epaper_sld00200p_line(line, (uint8_t *)p_old, 0xAA, EPD_WHITE);
    epaper_sld00200p_line(line, (uint8_t *)p_bytes, 0xAA, EPD_INV);
    epaper_sld00200p_line(line, (uint8_t *)p_bytes, 0xFF, EPD_NORM);
}

#endif