oled.h

Go to the documentation of this file.

 
#ifndef OLED_H_
#define OLED_H_
 
    #ifndef F_CPU
        #define F_CPU 12000000UL
    #endif
 
    #ifndef OLED_USE_SOFT_TWI
        #define OLED_USE_SOFT_TWI
    #endif
    
    #ifndef OLED_HAL_PLATFORM
        #define OLED_HAL_PLATFORM avr
    #endif
 
    #ifndef OLED_ADDRESS
        #define OLED_ADDRESS (0x78>>1)
    #endif
 
    #ifndef OLED_CONTROL_COMMAND
        #define OLED_CONTROL_COMMAND 0x80
    #endif
 
    #ifndef OLED_CONTROL_DATA
        #define OLED_CONTROL_DATA 0x40
    #endif
    
    #ifndef OLED_PAGE_SIZE
        #define OLED_PAGE_SIZE 8UL
    #endif
    
    #ifndef OLED_ROW_SIZE
        #define OLED_ROW_SIZE 64UL
    #endif
    
    #ifndef OLED_COLUMN_SIZE
        #define OLED_COLUMN_SIZE 128UL
    #endif
    
    #ifndef OLED_IDLE_TIME_US
        #define OLED_IDLE_TIME_US 10
    #endif
 
    #ifndef OLED_INIT_ROUTINE_IN_EEPROM
        // #define OLED_INIT_ROUTINE_IN_EEPROM
 
        #ifdef _DOXYGEN_    // Used for documentation, can be ignored
            #define OLED_INIT_ROUTINE_IN_EEPROM
        #endif
    #endif

    #ifndef OLED_CMD_SET_DISPLAY
        #define OLED_CMD_SET_DISPLAY 0xAE
        
        #define OLED_CMD_SET_DISPLAY_ON 0x01

        #define OLED_CMD_SET_DISPLAY_OFF 0x00
    #endif

    #ifndef OLED_CMD_SET_DISPLAY_CLOCK
        #define OLED_CMD_SET_DISPLAY_CLOCK 0xD5
        
        #define OLED_CMD_SET_DISPLAY_CLOCK_DIVIDE_RATIO 0x00
        
        #define OLED_CMD_SET_DISPLAY_CLOCK_FREQUENCY 0x80
    #endif
    
    #ifndef OLED_CMD_SET_MULTIPLEX_RATIO
        #define OLED_CMD_SET_MULTIPLEX_RATIO 0xA8
        
        #define OLED_CMD_SET_MULTIPLEX_RATIO_16_MUX 0x1F
        
        #define OLED_CMD_SET_MULTIPLEX_RATIO_32_MUX 0x2F
        
        #define OLED_CMD_SET_MULTIPLEX_RATIO_64_MUX 0x3F
    #endif
    
    #ifndef OLED_CMD_SET_DISPLAY_OFFSET
        #define OLED_CMD_SET_DISPLAY_OFFSET 0xD3
        
        #define OLED_CMD_SET_DISPLAY_OFFSET_VALUE 0x00
    #endif
    
    #ifndef OLED_CMD_SET_DISPLAY_START_LINE
        /* Possible line offset 0x00 - 0x3F */
        #define OLED_CMD_SET_DISPLAY_START_LINE_OFFSET 0x00
        
        #define OLED_CMD_SET_DISPLAY_START_LINE (0x40 | OLED_CMD_SET_DISPLAY_START_LINE_OFFSET)
    #endif
    
    #ifndef OLED_CMD_SET_CHARGE_PUMP
        #define OLED_CMD_SET_CHARGE_PUMP 0x8D

        #define OLED_CMD_SET_CHARGE_PUMP_EXTERNAL 0x10

        #define OLED_CMD_SET_CHARGE_PUMP_INTERNAL 0x14
    #endif
    
    #ifndef OLED_CMD_SET_SEGMENT_REMAP
        #define OLED_CMD_SET_SEGMENT_REMAP_STANDARD 0x00
        #define OLED_CMD_SET_SEGMENT_REMAP_REVERSED 0x01

        #define OLED_CMD_SET_SEGMENT_REMAP (0xA0 | OLED_CMD_SET_SEGMENT_REMAP_REVERSED)
    #endif
    
    #ifndef OLED_CMD_SET_COM_OUTPUT_SCAN_DIRECTION
        #define OLED_CMD_SET_COM_OUTPUT_SCAN_DIRECTION_NORMAL 0x00
        #define OLED_CMD_SET_COM_OUTPUT_SCAN_DIRECTION_REVERSED 0x08

        #define OLED_CMD_SET_COM_OUTPUT_SCAN_DIRECTION (0xC0 | OLED_CMD_SET_COM_OUTPUT_SCAN_DIRECTION_REVERSED)
    #endif
    
    #ifndef OLED_CMD_SET_COM_PINS_HARDWARE_CONFIGURATION
        #define OLED_CMD_SET_COM_PINS_HARDWARE_CONFIGURATION 0xDA
        
        #define OLED_CMD_SET_COM_PINS_HARDWARE_CONFIGURATION_SEQUENTIAL  0x02
        
        #define OLED_CMD_SET_COM_PINS_HARDWARE_CONFIGURATION_ALTERNATIVE 0x12
        
        #define OLED_CMD_SET_COM_PINS_HARDWARE_CONFIGURATION_NOREMAP 0x02
        
        #define OLED_CMD_SET_COM_PINS_HARDWARE_CONFIGURATION_REMAP 0x22

        #define OLED_CMD_SET_COM_PINS_HARDWARE_CONFIGURATION_SETUP (OLED_CMD_SET_COM_PINS_HARDWARE_CONFIGURATION_ALTERNATIVE | OLED_CMD_SET_COM_PINS_HARDWARE_CONFIGURATION_NOREMAP)
    #endif
    
    #ifndef OLED_CMD_SET_CONTRAST
        #define OLED_CMD_SET_CONTRAST 0x81

        #define OLED_CMD_SET_CONTRAST_VALUE 0x7F
    #endif
    
    #ifndef OLED_CMD_ENTIRE_DISPLAY_ON
        #define OLED_CMD_ENTIRE_DISPLAY_ON_RESUME_RAM 0x00
        #define OLED_CMD_ENTIRE_DISPLAY_ON_IGNORE_RAM 0x01

        #define OLED_CMD_ENTIRE_DISPLAY_ON (0xA4 | OLED_CMD_ENTIRE_DISPLAY_ON_RESUME_RAM)
    #endif
    
    #ifndef OLED_CMD_SET_DISPLAY_MODE
        #define OLED_CMD_SET_DISPLAY_MODE_NORMAL 0x00
        #define OLED_CMD_SET_DISPLAY_MODE_INVERSE 0x01

        #define OLED_CMD_SET_DISPLAY_MODE (0xA6 | OLED_CMD_SET_DISPLAY_MODE_NORMAL)
    #endif
    
    #ifndef OLED_CMD_SET_MEMORY_ADDRESSING_MODE
        #define OLED_CMD_SET_MEMORY_ADDRESSING_MODE 0x20

        #define OLED_CMD_SET_MEMORY_ADDRESSING_MODE_HORIZONTAL 0x00

        #define OLED_CMD_SET_MEMORY_ADDRESSING_MODE_VERTICAL   0x01

        #define OLED_CMD_SET_MEMORY_ADDRESSING_MODE_PAGE       0x02
    #endif
    
    #ifndef OLED_CMD_SET_PAGE_START_ADDRESS
        #define OLED_CMD_SET_PAGE_START_ADDRESS 0xB0
    #endif
    
    #ifndef OLED_CMD_SET_LOWER_START_COLUMN_ADDRESS
        #define OLED_CMD_SET_LOWER_START_COLUMN_ADDRESS 0x00
    #endif

    #ifndef OLED_CMD_SET_HIGHER_START_COLUMN_ADDRESS
        #define OLED_CMD_SET_HIGHER_START_COLUMN_ADDRESS 0x10
    #endif
    
    #include <avr/io.h>
    #include <util/delay.h>
    
    #ifdef OLED_INIT_ROUTINE_IN_EEPROM
        #include <avr/eeprom.h>
    #else
        #include <avr/pgmspace.h>
    #endif
 
    #include "../common/macros/STRING_macros.h"

    #ifdef OLED_USE_SOFT_TWI
        #define TWI_SOFT_HEADER _STR(../hal/OLED_HAL_PLATFORM/twi_soft/twi_soft.h)
        #include TWI_SOFT_HEADER
 
        #define OLED_START(MODE) { twi_soft_start(); twi_soft_address(OLED_ADDRESS, MODE); }
        #define OLED_STOP() { twi_soft_stop(); _delay_us(OLED_IDLE_TIME_US); }
        #define OLED_DATA() (twi_soft_set(OLED_CONTROL_DATA))
    #else
        #define TWI_HEADER _STR(../hal/OLED_HAL_PLATFORM/twi/twi.h)
        #include TWI_HEADER
 
        #define OLED_START(MODE) { twi_start(); twi_address(OLED_ADDRESS, MODE); }
        #define OLED_STOP() { twi_stop(); _delay_us(OLED_IDLE_TIME_US); }
        #define OLED_DATA() (twi_set(OLED_CONTROL_DATA))
    #endif

    #define OLED_HOME() (oled_position(0, 0))
    
    void oled_init(void);
    void oled_disable(void);
    void oled_home(void);
    void oled_position(unsigned char column, unsigned char row);
    void oled_scroll_vertical(unsigned char scroll);
    void oled_frame(unsigned char *frame);
    void oled_page(unsigned char *data, unsigned char page);
    void oled_page_segment(unsigned char *data, unsigned char column_start, unsigned char column_stop, unsigned char page);
    void oled_column(unsigned char data, unsigned char column, unsigned char page);
    void oled_clear(void);
    void oled_clear_page(unsigned char page);
    void oled_clear_page_segment(unsigned char column_start, unsigned char column_stop, unsigned char page);
    void oled_clear_column(unsigned char column, unsigned char page);
 
#endif /* OLED_H_ */