ssd1306xled.h

Go to the documentation of this file.

 
#include <stdint.h>
#include <Arduino.h>
#include <util/delay.h>
 
#ifndef SSD1306XLED_H
#define SSD1306XLED_H
 
#define _SSD1306XLED_TINY_INIT_SUPPORTED_
#define _SSD1306XLED_INIT_VERTICAL_SUPPORTED_
 
// ----------------------------------------------------------------------------
// Hardware pin configuration
// ----------------------------------------------------------------------------
 
#ifndef SSD1306_SCL
#define SSD1306_SCL     PB2
#endif
 
#ifndef SSD1306_SDA
#define SSD1306_SDA     PB0
#endif
 
#ifndef SSD1306_SA
#define SSD1306_SA      0X3C
#endif
 
 
// USI register mappings (ATtiny85-specific)
#define DDR_USI             DDRB
#define PORT_USI            PORTB
#define PIN_USI             PINB
#define PORT_USI_SDA        PORTB0
#define PORT_USI_SCL        PORTB2
#define PIN_USI_SDA         PINB0
#define PIN_USI_SCL         PINB2
#define DDR_USI_CL          DDR_USI
#define PORT_USI_CL         PORT_USI
#define PIN_USI_CL          PIN_USI
 
// I2C speed mode
#define TWI_FAST_MODE
 
#ifdef TWI_FAST_MODE                 // TWI FAST mode timing limits. SCL = 100-400kHz
#define DELAY_T2TWI (_delay_us(2))   // >1.3us
#define DELAY_T4TWI (_delay_us(1))   // >0.6us
#else                                // TWI STANDARD mode timing limits. SCL <= 100kHz
#define DELAY_T2TWI (_delay_us(5))   // >4.7us
#define DELAY_T4TWI (_delay_us(4))   // >4.0us
#endif
 
#define TWI_NACK_BIT 0 // Bit position for (N)ACK bit.
 
// USI shift register preloads
const unsigned char USISR_8bit = 1<<USISIF | 1<<USIOIF | 1<<USIPF | 1<<USIDC | 0x0<<USICNT0;
const unsigned char USISR_1bit = 1<<USISIF | 1<<USIOIF | 1<<USIPF | 1<<USIDC | 0xE<<USICNT0;
 
#define SSD1306_COMMAND 0x00
#define SSD1306_DATA 0x40
 
// ----------------------------------------------------------------------------
// Opt-out feature flags
// ----------------------------------------------------------------------------
 
#ifdef DOXYGEN
#define SSD1306_NO_FONT_6X8
 
#define SSD1306_NO_FONT_8X16
 
#define SSD1306_NO_DRAW_BMP
 
#define SSD1306_QUICK_BEGIN
#endif
 
 
// ----------------------------------------------------------------------------
 
class SSD1306Device
{
    public:
        SSD1306Device(void);
 
        void ssd1306_init(void);
 
        void ssd1306_tiny_init(void);
 
        void ssd1306_tiny_init_vertical(void);
 
        void ssd1306_send_data_start(void);
 
        void ssd1306_send_data_stop(void);
 
        void ssd1306_send_byte(uint8_t byte);
 
        void ssd1306_send_command_start(void);
 
        void ssd1306_send_command_stop(void);
 
        void ssd1306_send_command(uint8_t command);
 
        void ssd1306_setpos(uint8_t x, uint8_t y);
 
        void ssd1306_fillscreen(uint8_t fill);
 
        void ssd1306_set_contrast(uint8_t value);
 
        void ssd1306_display_off(void);
 
        void ssd1306_display_on(void);
 
#ifndef SSD1306_NO_FONT_6X8
        void ssd1306_char_font6x8(char ch);
 
        void ssd1306_string_font6x8(const char *s);
#endif
 
#ifndef SSD1306_NO_FONT_8X16
        void ssd1306_string_f8x16(uint8_t x, uint8_t y, const char s[]);
#endif
 
#ifndef SSD1306_NO_DRAW_BMP
        void ssd1306_draw_bmp(uint8_t x0, uint8_t y0, uint8_t x1, uint8_t y1, const uint8_t bitmap[]);
#endif
 
        void ssd1306_draw_bmp_px(uint8_t x, uint8_t y_px, uint8_t w, uint8_t h_pages, const uint8_t bitmap[]);
 
        void ssd1306_clear_area_px(uint8_t x, uint8_t y_px, uint8_t w, uint8_t h_pages);
 
        void ssd1306_draw_bmp_px_clipped(int16_t x, uint8_t y_px, uint8_t w, uint8_t h_pages, const uint8_t bitmap[]);
 
        void ssd1306_clear_area_px_clipped(int16_t x, uint8_t y_px, uint8_t w, uint8_t h_pages);
 
        void ssd1306_compose_bmp_px(uint8_t *buf, uint8_t buf_x, uint8_t buf_w,
            int16_t sprite_x, uint8_t sprite_y_px,
            uint8_t sprite_w, uint8_t sprite_h_pages,
            const uint8_t bitmap[], uint8_t target_page);
 
        void ssd1306_send_buf(uint8_t x, uint8_t page, const uint8_t *buf, uint8_t w);
 
    private:
        void I2CInit();
        bool I2CStart(uint8_t address);
        uint8_t I2CTransfer (uint8_t data);
        void I2CStop (void);
        bool I2CWrite(uint8_t data);
        void begin();
        void _ssd1306_start(uint8_t mode);
        void _ssd1306_init_from(const uint8_t *seq, uint8_t len);
};
 
 
extern SSD1306Device SSD1306;
 
// ----------------------------------------------------------------------------
 
#endif