driver_ssd1315_advance.c

Go to the documentation of this file.

 
#include "driver_ssd1315_advance.h"
 
static ssd1315_handle_t gs_handle;        

uint8_t ssd1315_advance_init(ssd1315_interface_t interface, ssd1315_address_t addr)
{
    uint8_t res;
    
    /* link functions */
    DRIVER_SSD1315_LINK_INIT(&gs_handle, ssd1315_handle_t);
    DRIVER_SSD1315_LINK_IIC_INIT(&gs_handle, ssd1315_interface_iic_init);
    DRIVER_SSD1315_LINK_IIC_DEINIT(&gs_handle, ssd1315_interface_iic_deinit);
    DRIVER_SSD1315_LINK_IIC_WRITE(&gs_handle, ssd1315_interface_iic_write);
    DRIVER_SSD1315_LINK_SPI_INIT(&gs_handle, ssd1315_interface_spi_init);
    DRIVER_SSD1315_LINK_SPI_DEINIT(&gs_handle, ssd1315_interface_spi_deinit);
    DRIVER_SSD1315_LINK_SPI_WRITE_COMMAND(&gs_handle, ssd1315_interface_spi_write_cmd);
    DRIVER_SSD1315_LINK_SPI_COMMAND_DATA_GPIO_INIT(&gs_handle, ssd1315_interface_spi_cmd_data_gpio_init);
    DRIVER_SSD1315_LINK_SPI_COMMAND_DATA_GPIO_DEINIT(&gs_handle, ssd1315_interface_spi_cmd_data_gpio_deinit);
    DRIVER_SSD1315_LINK_SPI_COMMAND_DATA_GPIO_WRITE(&gs_handle, ssd1315_interface_spi_cmd_data_gpio_write);
    DRIVER_SSD1315_LINK_RESET_GPIO_INIT(&gs_handle, ssd1315_interface_reset_gpio_init);
    DRIVER_SSD1315_LINK_RESET_GPIO_DEINIT(&gs_handle, ssd1315_interface_reset_gpio_deinit);
    DRIVER_SSD1315_LINK_RESET_GPIO_WRITE(&gs_handle, ssd1315_interface_reset_gpio_write);
    DRIVER_SSD1315_LINK_DELAY_MS(&gs_handle, ssd1315_interface_delay_ms);
    DRIVER_SSD1315_LINK_DEBUG_PRINT(&gs_handle, ssd1315_interface_debug_print);
    
    /* set interface */
    res = ssd1315_set_interface(&gs_handle, interface);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set interface failed.\n");
        
        return 1;
    }
    
    /* set addr pin */
    res = ssd1315_set_addr_pin(&gs_handle, addr);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set addr failed.\n");
        
        return 1;
    }
    
    /* ssd1315 init */
    res = ssd1315_init(&gs_handle);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: init failed.\n");
        
        return 1;
    }
    
    /* close display */
    res = ssd1315_set_display(&gs_handle, SSD1315_DISPLAY_OFF);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set display failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set column address range */
    res = ssd1315_set_column_address_range(&gs_handle, SSD1315_ADVANCE_DEFAULT_COLUMN_ADDRESS_RANGE_START, SSD1315_ADVANCE_DEFAULT_COLUMN_ADDRESS_RANGE_END);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set column address range failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set page address range */
    res = ssd1315_set_page_address_range(&gs_handle, SSD1315_ADVANCE_DEFAULT_PAGE_ADDRESS_RANGE_START, SSD1315_ADVANCE_DEFAULT_PAGE_ADDRESS_RANGE_END);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set page address range failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set low column start address */
    res = ssd1315_set_low_column_start_address(&gs_handle, SSD1315_ADVANCE_DEFAULT_LOW_COLUMN_START_ADDRESS);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set low column start address failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set high column start address */
    res = ssd1315_set_high_column_start_address(&gs_handle, SSD1315_ADVANCE_DEFAULT_HIGH_COLUMN_START_ADDRESS);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set high column start address failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set display start line */
    res = ssd1315_set_display_start_line(&gs_handle, SSD1315_ADVANCE_DEFAULT_DISPLAY_START_LINE);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set display start line failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set fade blinking mode */
    res = ssd1315_set_fade_blinking_mode(&gs_handle, SSD1315_ADVANCE_DEFAULT_FADE_BLINKING_MODE, SSD1315_ADVANCE_DEFAULT_FADE_FRAMES);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set fade blinking failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* deactivate scroll */
    res = ssd1315_deactivate_scroll(&gs_handle);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set deactivate scroll failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set zoom in */
    res = ssd1315_set_zoom_in(&gs_handle, SSD1315_ADVANCE_DEFAULT_ZOOM_IN);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set set zoom in failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set contrast */
    res = ssd1315_set_contrast(&gs_handle, SSD1315_ADVANCE_DEFAULT_CONTRAST);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set contrast failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set segment remap */
    res = ssd1315_set_segment_remap(&gs_handle, SSD1315_ADVANCE_DEFAULT_SEGMENT);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set segment remap failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set scan direction */
    res = ssd1315_set_scan_direction(&gs_handle, SSD1315_ADVANCE_DEFAULT_SCAN_DIRECTION);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set scan direction failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set display mode */
    res = ssd1315_set_display_mode(&gs_handle, SSD1315_ADVANCE_DEFAULT_DISPLAY_MODE);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set display mode failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set multiplex ratio */
    res = ssd1315_set_multiplex_ratio(&gs_handle, SSD1315_ADVANCE_DEFAULT_MULTIPLEX_RATIO);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set multiplex ratio failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set display offset */
    res = ssd1315_set_display_offset(&gs_handle, SSD1315_ADVANCE_DEFAULT_DISPLAY_OFFSET);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set display offset failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set display clock */
    res = ssd1315_set_display_clock(&gs_handle, SSD1315_ADVANCE_DEFAULT_OSCILLATOR_FREQUENCY, SSD1315_ADVANCE_DEFAULT_CLOCK_DIVIDE);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set display clock failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set pre charge period */
    res = ssd1315_set_precharge_period(&gs_handle, SSD1315_ADVANCE_DEFAULT_PHASE1_PERIOD, SSD1315_ADVANCE_DEFAULT_PHASE2_PERIOD);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set pre charge period failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set iref */
    res = ssd1315_set_iref(&gs_handle, SSD1315_ADVANCE_DEFAULT_IREF, SSD1315_ADVANCE_DEFAULT_IREF_VALUE);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set iref failed.\n");
        (void)ssd1315_deinit(&gs_handle);
 
        return 1;
    }
    
    /* set hardware pins conf */
    res = ssd1315_set_com_pins_hardware_conf(&gs_handle, SSD1315_ADVANCE_DEFAULT_PIN_CONF, SSD1315_ADVANCE_DEFAULT_LEFT_RIGHT_REMAP);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set com pins hardware conf failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set deselect level 0.77 */
    res = ssd1315_set_deselect_level(&gs_handle, SSD1315_ADVANCE_DEFAULT_DESELECT_LEVEL);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set deselect level failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* set page memory addressing mode */
    res = ssd1315_set_memory_addressing_mode(&gs_handle, SSD1315_MEMORY_ADDRESSING_MODE_PAGE);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set memory addressing level failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* enable charge pump */
    res = ssd1315_set_charge_pump(&gs_handle, SSD1315_CHARGE_PUMP_ENABLE, SSD1315_CHARGE_PUMP_MODE_7P5V);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set charge pump failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* entire display off */
    res = ssd1315_set_entire_display(&gs_handle, SSD1315_ENTIRE_DISPLAY_OFF);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set entire display failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* enable display */
    res = ssd1315_set_display(&gs_handle, SSD1315_DISPLAY_ON);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: set display failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    /* clear screen */
    res = ssd1315_clear(&gs_handle);
    if (res != 0)
    {
        ssd1315_interface_debug_print("ssd1315: clear failed.\n");
        (void)ssd1315_deinit(&gs_handle);
        
        return 1;
    }
    
    return 0;
}

uint8_t ssd1315_advance_deinit(void)
{
    /* deinit ssd1315 */
    if (ssd1315_deinit(&gs_handle) != 0)
    {
        return 1;
    }
    else
    {
        return 0;
    }
}

uint8_t ssd1315_advance_display_on(void)
{
    uint8_t res;
    
    /* display on */
    res = ssd1315_set_display(&gs_handle, SSD1315_DISPLAY_ON);
    if (res != 0)
    {
        return 1;
    }
    else
    {
        return 0;
    }
}

uint8_t ssd1315_advance_display_off(void)
{
    uint8_t res;
    
    /* display off */
    res = ssd1315_set_display(&gs_handle, SSD1315_DISPLAY_OFF);
    if (res != 0)
    {
        return 1;
    }
    else
    {
        return 0;
    }
}

uint8_t ssd1315_advance_clear(void)
{
    /* clear */
    if (ssd1315_clear(&gs_handle) != 0)
    {
        return 1;
    }
    else
    {
        return 0;
    }
}

uint8_t ssd1315_advance_write_point(uint8_t x, uint8_t y, uint8_t data)
{
    uint8_t res;
    
    /* write point */
    res = ssd1315_write_point(&gs_handle, x, y, data);
    if (res != 0)
    {
        return 1;
    }
    
    return 0;
}

uint8_t ssd1315_advance_read_point(uint8_t x, uint8_t y, uint8_t *data)
{
    uint8_t res;
    
    /* read point in gram */
    res = ssd1315_read_point(&gs_handle, x, y, data);
    if (res != 0)
    {
        return 1;
    }
    
    return 0;
}

uint8_t ssd1315_advance_string(uint8_t x, uint8_t y, char *str, uint16_t len, uint8_t color, ssd1315_font_t font)
{
    uint8_t res;
    
    /* write string in gram */
    res = ssd1315_gram_write_string(&gs_handle, x, y, str, len, color, font);
    if (res != 0)
    {
        return 1;
    }
    
    /* update gram */
    if (ssd1315_gram_update(&gs_handle) != 0)
    {
        return 1;
    }
    else
    {
        return 0;
    }
}

uint8_t ssd1315_advance_rect(uint8_t left, uint8_t top, uint8_t right, uint8_t bottom, uint8_t color)
{
    uint8_t res;
    
    /* fill rect in gram */
    res = ssd1315_gram_fill_rect(&gs_handle, left, top, right, bottom, color);
    if (res != 0)
    {
        return 1;
    }
    
    /* update gram */
    if (ssd1315_gram_update(&gs_handle) != 0)
    {
        return 1;
    }
    else
    {
        return 0;
    }
}

uint8_t ssd1315_advance_picture(uint8_t left, uint8_t top, uint8_t right, uint8_t bottom, uint8_t *img)
{
    uint8_t res;
    
    /* draw picture in gram */
    res = ssd1315_gram_draw_picture(&gs_handle, left, top, right, bottom, img);
    if (res != 0)
    {
        return 1;
    }
    
    /* update gram */
    if (ssd1315_gram_update(&gs_handle) != 0)
    {
        return 1;
    }
    else
    {
        return 0;
    }
}

uint8_t ssd1315_advance_enable_zoom_in(void)
{
    uint8_t res;
    
    /* enable zoom in */
    res = ssd1315_set_zoom_in(&gs_handle, SSD1315_ZOOM_IN_ENABLE);
    if (res != 0)
    {
        return 1;
    }
    
    return 0;
}

uint8_t ssd1315_advance_disable_zoom_in(void)
{
    uint8_t res;
    
    /* disable zoom in */
    res = ssd1315_set_zoom_in(&gs_handle, SSD1315_ZOOM_IN_DISABLE);
    if (res != 0)
    {
        return 1;
    }
    
    return 0;
}

uint8_t ssd1315_advance_fade_blinking(ssd1315_fade_blinking_mode_t mode, uint8_t frames)
{
    uint8_t res;
    
    /* set fade blinking mode */
    res = ssd1315_set_fade_blinking_mode(&gs_handle, mode, frames);
    if (res != 0)
    {
        return 1;
    }
    
    return 0;
}

uint8_t ssd1315_advance_deactivate_scroll(void)
{
    uint8_t res;
    
    /* deactivate scroll */
    res = ssd1315_deactivate_scroll(&gs_handle);
    if (res != 0)
    {
        return 1;
    }
    
    return 0;
}

uint8_t ssd1315_advance_vertical_left_horizontal_scroll(uint8_t start_page_addr, uint8_t end_page_addr, 
                                                        uint8_t vertical_scrolling_offset, 
                                                        ssd1315_scroll_frame_t frames)
{
    uint8_t res;
    
    /* deactivate scroll */
    res = ssd1315_deactivate_scroll(&gs_handle);
    if (res != 0)
    {
        return 1;
    }
    
    /* set vertical left horizontal scroll */
    res = ssd1315_set_vertical_left_horizontal_scroll(&gs_handle, SSD1315_HORIZONTAL_SCROLL_ENABLE, start_page_addr, end_page_addr,
                                                      vertical_scrolling_offset, frames, 0x00, 0x7F);
    if (res != 0)
    {
        return 1;
    }
    
    /* activate scroll */
    res = ssd1315_activate_scroll(&gs_handle);
    if (res != 0)
    {
        return 1;
    }
    
    return 0;
}

uint8_t ssd1315_advance_vertical_right_horizontal_scroll(uint8_t start_page_addr, uint8_t end_page_addr,
                                                         uint8_t vertical_scrolling_offset, 
                                                         ssd1315_scroll_frame_t frames)
{
    uint8_t res;
    
    /* deactivate scroll */
    res = ssd1315_deactivate_scroll(&gs_handle);
    if (res != 0)
    {
        return 1;
    }
    
    /* set vertical right horizontal scroll */
    res = ssd1315_set_vertical_right_horizontal_scroll(&gs_handle, SSD1315_HORIZONTAL_SCROLL_ENABLE, start_page_addr, end_page_addr,
                                                       vertical_scrolling_offset, frames, 0x00, 0x7F);
    if (res != 0)
    {
        return 1;
    }
    
    /* activate scroll */
    res = ssd1315_activate_scroll(&gs_handle);
    if (res != 0)
    {
        return 1;
    }
    
    return 0;
}