#include "fw_hal.h"

Data Structures
struct	FontDef_t

Macros
#define	ST7567_MODEL ST7567_MODEL_ST7567

#define	ST7567_CS P35

#define	ST7567_MOSI P34

#define	ST7567_SCK P32

#define	ST7567_RES P37

#define	ST7567_DC P36

#define	ST7567_BL P12

#define	ST7567_WIDTH 128

#define	ST7567_HEIGHT 64

#define	ST7567_COLUMN_EXPAND 4

#define	ST7567_PAGES 8

#define	ST7567_X_ORIENT ST7567_SEG_DIRECTION_NORMAL

#define	ST7567_Y_ORIENT ST7567_COM_DIRECTION_NORMAL

#define	ST7567_MODEL_ST7565 0

#define	ST7567_MODEL_ST7567 1

#define	ST7567_DISPLAY_OFF 0xAE /* 0xae: Display OFF (sleep mode), default */

#define	ST7567_DISPLAY_ON 0xAF /* 0xaf: Display ON in normal mode */

#define	ST7567_SET_START_LINE 0x40 /* 0x40-7f: Set display start line */

#define	ST7567_SET_START_LINE_MASK 0x3f

#define	ST7567_SET_PAGE_ADDRESS 0xB0 /* 0xb0-b7: Set page start address, 0 - 8 */

#define	ST7567_SET_PAGE_ADDRESS_MASK 0x07

#define	ST7567_SET_COLUMN_ADDRESS_MSB 0x10 /* 0x10-0x1f: Set 8bit column address - high 4 bits of 0 - 131 */

#define	ST7567_SET_COLUMN_ADDRESS_MSB_MASK 0x0F

#define	ST7567_SET_COLUMN_ADDRESS_LSB 0x00 /* 0x00-0x0f: Set 8bit column address - low 4 bits of 0 - 131 */

#define	ST7567_SET_COLUMN_ADDRESS_LSB_MASK 0x0F

#define	ST7567_SEG_DIRECTION_NORMAL 0xA0 /* 0xa0: Column address 0 is mapped to SEG0, default*/

#define	ST7567_SEG_DIRECTION_REVERSE 0xA1 /* 0xa1: Column address 83H(131) is mapped to SEG0 */

#define	ST7567_COM_DIRECTION_NORMAL 0xC0 /* 0xc0: Set COM output direction, normal mode */

#define	ST7567_COM_DIRECTION_REVERSE 0xC8 /* 0xc8: Set COM output direction, reverse mode */

#define	ST7567_INVERSE_DISPLAY_OFF 0xA6 /* 0xa6: Normal display */

#define	ST7567_INVERSE_DISPLAY_ON 0xA7 /* 0xa7: Inverse display */

#define	ST7567_ALL_PIXEL_ON 0xA5 /* 0xa5: Entire display ON */

#define	ST7567_ALL_PIXEL_NORMAL 0xA4 /* 0xa4: Resume to RAM content display */

#define	ST7567_BIAS_1_9 0xA2 /* 0xa2: Select BIAS setting 1/9 */

#define	ST7567_BIAS_1_7 0xA3 /* 0xa3: Select BIAS setting 1/7 */

#define	ST7567_READ_MODIFY_WRITE_START 0xE0 /* 0xe0: Enter the Read Modify Write mode */

#define	ST7567_READ_MODIFY_WRITE_END 0xEE /* 0xee: Leave the Read Modify Write mode */

#define	ST7567_RESET 0xE2 /* 0xe2: Software RESET */

#define	ST7567_POWER_CONTROL 0x28

#define	ST7567_POWER_CONTROL_VF 0x01

#define	ST7567_POWER_CONTROL_VR 0x02

#define	ST7567_POWER_CONTROL_VB 0x04

#define	ST7567_REGULATION_RATIO 0x20

#define	ST7567_REGULATION_RATIO_3_0 0x00

#define	ST7567_REGULATION_RATIO_3_5 0x01

#define	ST7567_REGULATION_RATIO_4_0 0x02

#define	ST7567_REGULATION_RATIO_4_5 0x03

#define	ST7567_REGULATION_RATIO_5_0 0x04 /* Default */

#define	ST7567_REGULATION_RATIO_5_5 0x05

#define	ST7567_REGULATION_RATIO_6_0 0x06

#define	ST7567_REGULATION_RATIO_6_5 0x07

#define	ST7567_SET_EV 0x81

#define	ST7567_SET_EV_MASK 0x3F

#define	ST7567_SET_BOOSTER 0xF8 /* Set booster level */

#define	ST7567_SET_BOOSTER_4X 0x00

#define	ST7567_SET_BOOSTER_5X 0x01

#define	ST7567_SET_BOOSTER_6X 0x11

#define	ST7567_NOP 0xE3

#define	ST7567_TEST 0xFE

#define	ST7567_TIMEOUT 20000

#define	ST7567_COLOR_FRONT 1U

#define	ST7567_COLOR_BACK 0U

Functions
void	ST7567_WriteData (uint8_t dat)
	Write a single byte data to ST7567.

void	ST7567_WriteSameData (uint8_t dat, uint32_t size)

void	ST7567_WriteCommand (uint8_t command)
	Write a single byte command to ST7567.

void	ST7567_Reset (void)
	Hardware reset ST7567 LCD.

void	ST7567_Init (void)
	Initializes ST7567 LCD.

void	ST7567_SetPowerSaveMode (HAL_State_t state)
	Powersave mode control.

void	ST7567_SetBackLightState (HAL_State_t state)
	Turn ST7567 LCD backlight on or off.

void	ST7567_SetContrast (uint8_t val)
	Turn ST7567 LCD backlight off.

void	ST7567_UpdateScreen (void)
	Update LCD display with buffer changes.

void	ST7567_ToggleInvert (void)
	Toggles pixels invertion inside internal RAM.

void	ST7567_Fill (uint8_t Color)
	Fills entire LCD with specified color.

void	ST7567_DrawPixel (uint8_t x, uint8_t y, uint8_t color)
	Draws pixel at desired location.

void	ST7567_GotoXY (uint16_t x, uint16_t y)
	Sets cursor pointer to desired location for strings.

char	ST7567_Putc (char ch, FontDef_t *Font, uint8_t color)
	Puts character to internal RAM.

char	ST7567_Puts (char str, FontDef_t Font, uint8_t color)
	Puts string to internal RAM.

void	ST7567_DrawLine (uint16_t x0, uint16_t y0, uint16_t x1, uint16_t y1, uint8_t c)
	Draws line on LCD.

Variables
__CODE FontDef_t	Font_3x5

__CODE FontDef_t	Font_5x7

Macro Definition Documentation

◆ ST7567_ALL_PIXEL_NORMAL

#define ST7567_ALL_PIXEL_NORMAL 0xA4 /* 0xa4: Resume to RAM content display */

Definition at line 79 of file st7567.h.

◆ ST7567_ALL_PIXEL_ON

#define ST7567_ALL_PIXEL_ON 0xA5 /* 0xa5: Entire display ON */

Definition at line 78 of file st7567.h.

◆ ST7567_BIAS_1_7

#define ST7567_BIAS_1_7 0xA3 /* 0xa3: Select BIAS setting 1/7 */

Definition at line 83 of file st7567.h.

◆ ST7567_BIAS_1_9

#define ST7567_BIAS_1_9 0xA2 /* 0xa2: Select BIAS setting 1/9 */

Definition at line 82 of file st7567.h.

◆ ST7567_BL

#define ST7567_BL P12

Definition at line 35 of file st7567.h.

◆ ST7567_COLOR_BACK

#define ST7567_COLOR_BACK 0U

Background color

Definition at line 145 of file st7567.h.

◆ ST7567_COLOR_FRONT

#define ST7567_COLOR_FRONT 1U

Front color

Definition at line 143 of file st7567.h.

◆ ST7567_COLUMN_EXPAND

#define ST7567_COLUMN_EXPAND 4

Definition at line 42 of file st7567.h.

◆ ST7567_COM_DIRECTION_NORMAL

#define ST7567_COM_DIRECTION_NORMAL 0xC0 /* 0xc0: Set COM output direction, normal mode */

Definition at line 72 of file st7567.h.

◆ ST7567_COM_DIRECTION_REVERSE

#define ST7567_COM_DIRECTION_REVERSE 0xC8 /* 0xc8: Set COM output direction, reverse mode */

Definition at line 73 of file st7567.h.

◆ ST7567_CS

#define ST7567_CS P35

Definition at line 30 of file st7567.h.

◆ ST7567_DC

#define ST7567_DC P36

Definition at line 34 of file st7567.h.

◆ ST7567_DISPLAY_OFF

#define ST7567_DISPLAY_OFF 0xAE /* 0xae: Display OFF (sleep mode), default */

Definition at line 54 of file st7567.h.

◆ ST7567_DISPLAY_ON

#define ST7567_DISPLAY_ON 0xAF /* 0xaf: Display ON in normal mode */

Definition at line 55 of file st7567.h.

◆ ST7567_HEIGHT

#define ST7567_HEIGHT 64

Definition at line 40 of file st7567.h.

◆ ST7567_INVERSE_DISPLAY_OFF

#define ST7567_INVERSE_DISPLAY_OFF 0xA6 /* 0xa6: Normal display */

Definition at line 75 of file st7567.h.

◆ ST7567_INVERSE_DISPLAY_ON

#define ST7567_INVERSE_DISPLAY_ON 0xA7 /* 0xa7: Inverse display */

Definition at line 76 of file st7567.h.

◆ ST7567_MODEL

#define ST7567_MODEL ST7567_MODEL_ST7567

ST7565, ST7567

Display Data RAM has a matrix of 65 by 132 bits. The address ranges are: X=0~131(83H) (column address), Y=0~8 (page address)

Definition at line 28 of file st7567.h.

◆ ST7567_MODEL_ST7565

#define ST7567_MODEL_ST7565 0

Definition at line 50 of file st7567.h.

◆ ST7567_MODEL_ST7567

#define ST7567_MODEL_ST7567 1

Definition at line 51 of file st7567.h.

◆ ST7567_MOSI

#define ST7567_MOSI P34

Definition at line 31 of file st7567.h.

◆ ST7567_NOP

#define ST7567_NOP 0xE3

Definition at line 134 of file st7567.h.

◆ ST7567_PAGES

#define ST7567_PAGES 8

Definition at line 44 of file st7567.h.

◆ ST7567_POWER_CONTROL

#define ST7567_POWER_CONTROL 0x28

This instruction controls the built-in power circuits. Typically, these 3 flags are turned ON at the same time.

Definition at line 94 of file st7567.h.

◆ ST7567_POWER_CONTROL_VB

#define ST7567_POWER_CONTROL_VB 0x04

Definition at line 97 of file st7567.h.

◆ ST7567_POWER_CONTROL_VF

#define ST7567_POWER_CONTROL_VF 0x01

Definition at line 95 of file st7567.h.

◆ ST7567_POWER_CONTROL_VR

#define ST7567_POWER_CONTROL_VR 0x02

Definition at line 96 of file st7567.h.

◆ ST7567_READ_MODIFY_WRITE_END

#define ST7567_READ_MODIFY_WRITE_END 0xEE /* 0xee: Leave the Read Modify Write mode */

Definition at line 86 of file st7567.h.

◆ ST7567_READ_MODIFY_WRITE_START

#define ST7567_READ_MODIFY_WRITE_START 0xE0 /* 0xe0: Enter the Read Modify Write mode */

Definition at line 85 of file st7567.h.

◆ ST7567_REGULATION_RATIO

#define ST7567_REGULATION_RATIO 0x20

The operation voltage (V0) calculation formula is shown below: (RR comes from Regulation Ratio, EV comes from EV[5:0]) V0 = RR X [ 1 – (63 – EV) / 162 ] X 2.1, or V0 = RR X [ ( 99 + EV ) / 162 ] X 2.1

Definition at line 105 of file st7567.h.

◆ ST7567_REGULATION_RATIO_3_0

#define ST7567_REGULATION_RATIO_3_0 0x00

Definition at line 106 of file st7567.h.

◆ ST7567_REGULATION_RATIO_3_5

#define ST7567_REGULATION_RATIO_3_5 0x01

Definition at line 107 of file st7567.h.

◆ ST7567_REGULATION_RATIO_4_0

#define ST7567_REGULATION_RATIO_4_0 0x02

Definition at line 108 of file st7567.h.

◆ ST7567_REGULATION_RATIO_4_5

#define ST7567_REGULATION_RATIO_4_5 0x03

Definition at line 109 of file st7567.h.

◆ ST7567_REGULATION_RATIO_5_0

#define ST7567_REGULATION_RATIO_5_0 0x04 /* Default */

Definition at line 110 of file st7567.h.

◆ ST7567_REGULATION_RATIO_5_5

#define ST7567_REGULATION_RATIO_5_5 0x05

Definition at line 111 of file st7567.h.

◆ ST7567_REGULATION_RATIO_6_0

#define ST7567_REGULATION_RATIO_6_0 0x06

Definition at line 112 of file st7567.h.

◆ ST7567_REGULATION_RATIO_6_5

#define ST7567_REGULATION_RATIO_6_5 0x07

Definition at line 113 of file st7567.h.

◆ ST7567_RES

#define ST7567_RES P37

Definition at line 33 of file st7567.h.

◆ ST7567_RESET

#define ST7567_RESET 0xE2 /* 0xe2: Software RESET */

Definition at line 88 of file st7567.h.

◆ ST7567_SCK

#define ST7567_SCK P32

Definition at line 32 of file st7567.h.

◆ ST7567_SEG_DIRECTION_NORMAL

#define ST7567_SEG_DIRECTION_NORMAL 0xA0 /* 0xa0: Column address 0 is mapped to SEG0, default*/

Definition at line 69 of file st7567.h.

◆ ST7567_SEG_DIRECTION_REVERSE

#define ST7567_SEG_DIRECTION_REVERSE 0xA1 /* 0xa1: Column address 83H(131) is mapped to SEG0 */

Definition at line 70 of file st7567.h.

◆ ST7567_SET_BOOSTER

#define ST7567_SET_BOOSTER 0xF8 /* Set booster level */

Definition at line 129 of file st7567.h.

◆ ST7567_SET_BOOSTER_4X

#define ST7567_SET_BOOSTER_4X 0x00

Definition at line 130 of file st7567.h.

◆ ST7567_SET_BOOSTER_5X

#define ST7567_SET_BOOSTER_5X 0x01

Definition at line 131 of file st7567.h.

◆ ST7567_SET_BOOSTER_6X

#define ST7567_SET_BOOSTER_6X 0x11

Definition at line 132 of file st7567.h.

◆ ST7567_SET_COLUMN_ADDRESS_LSB

#define ST7567_SET_COLUMN_ADDRESS_LSB 0x00 /* 0x00-0x0f: Set 8bit column address - low 4 bits of 0 - 131 */

Definition at line 66 of file st7567.h.

◆ ST7567_SET_COLUMN_ADDRESS_LSB_MASK

#define ST7567_SET_COLUMN_ADDRESS_LSB_MASK 0x0F

Definition at line 67 of file st7567.h.

◆ ST7567_SET_COLUMN_ADDRESS_MSB

#define ST7567_SET_COLUMN_ADDRESS_MSB 0x10 /* 0x10-0x1f: Set 8bit column address - high 4 bits of 0 - 131 */

Definition at line 63 of file st7567.h.

◆ ST7567_SET_COLUMN_ADDRESS_MSB_MASK

#define ST7567_SET_COLUMN_ADDRESS_MSB_MASK 0x0F

Definition at line 64 of file st7567.h.

◆ ST7567_SET_EV

#define ST7567_SET_EV 0x81

This is double byte instruction. The first byte set ST7567 into EV adjust mode and the following instruction will change the EV setting. That means these 2 bytes must be used together. They control the electronic volume to adjust a suitable V0 voltage for the LCD.

Definition at line 121 of file st7567.h.

◆ ST7567_SET_EV_MASK

#define ST7567_SET_EV_MASK 0x3F

Definition at line 122 of file st7567.h.

◆ ST7567_SET_PAGE_ADDRESS

#define ST7567_SET_PAGE_ADDRESS 0xB0 /* 0xb0-b7: Set page start address, 0 - 8 */

Definition at line 60 of file st7567.h.

◆ ST7567_SET_PAGE_ADDRESS_MASK

#define ST7567_SET_PAGE_ADDRESS_MASK 0x07

Definition at line 61 of file st7567.h.

◆ ST7567_SET_START_LINE

#define ST7567_SET_START_LINE 0x40 /* 0x40-7f: Set display start line */

Definition at line 57 of file st7567.h.

◆ ST7567_SET_START_LINE_MASK

#define ST7567_SET_START_LINE_MASK 0x3f

Definition at line 58 of file st7567.h.

◆ ST7567_TEST

#define ST7567_TEST 0xFE

Definition at line 135 of file st7567.h.

◆ ST7567_TIMEOUT

#define ST7567_TIMEOUT 20000

Definition at line 139 of file st7567.h.

◆ ST7567_WIDTH

#define ST7567_WIDTH 128

Definition at line 38 of file st7567.h.

◆ ST7567_X_ORIENT

#define ST7567_X_ORIENT ST7567_SEG_DIRECTION_NORMAL

Definition at line 46 of file st7567.h.

◆ ST7567_Y_ORIENT

#define ST7567_Y_ORIENT ST7567_COM_DIRECTION_NORMAL

Definition at line 48 of file st7567.h.

Function Documentation

◆ ST7567_DrawLine()

void ST7567_DrawLine	(	uint16_t	x0,
		uint16_t	y0,
		uint16_t	x1,
		uint16_t	y1,
		uint8_t	c
	)

Draws line on LCD.

Note: ST7567_UpdateScreen() must be called after that in order to see updated LCD screen

Parameters

x0	Line X start point. Valid input is 0 to ST7567_WIDTH - 1
y0	Line Y start point. Valid input is 0 to ST7567_HEIGHT - 1
x1	Line X end point. Valid input is 0 to ST7567_WIDTH - 1
y1	Line Y end point. Valid input is 0 to ST7567_HEIGHT - 1
c	Color to be used. This parameter can be a value of ST7567_COLOR_t enumeration

Return values

None

Definition at line 257 of file st7567.c.

{
    int16_t dx, dy, sx, sy, err, e2, i, tmp; 
    
    /* Check for overflow */
    if (x0 >= ST7567_WIDTH)
    {
        x0 = ST7567_WIDTH - 1;
    }
    if (x1 >= ST7567_WIDTH)
    {
        x1 = ST7567_WIDTH - 1;
    }
    if (y0 >= ST7567_HEIGHT)
    {
        y0 = ST7567_HEIGHT - 1;
    }
    if (y1 >= ST7567_HEIGHT)
    {
        y1 = ST7567_HEIGHT - 1;
    }
    
    dx = (x0 < x1) ? (x1 - x0) : (x0 - x1); 
    dy = (y0 < y1) ? (y1 - y0) : (y0 - y1); 
    sx = (x0 < x1) ? 1 : -1; 
    sy = (y0 < y1) ? 1 : -1; 
    err = ((dx > dy) ? dx : -dy) / 2; 
 
    if (dx == 0)
    {
        if (y1 < y0)
        {
            tmp = y1;
            y1 = y0;
            y0 = tmp;
        }
        
        if (x1 < x0)
        {
            tmp = x1;
            x1 = x0;
            x0 = tmp;
        }
        
        /* Vertical line */
        for (i = y0; i <= y1; i++)
        {
            ST7567_DrawPixel(x0, i, c);
        }
        
        /* Return from function */
        return;
    }
    
    if (dy == 0)
    {
        if (y1 < y0)
        {
            tmp = y1;
            y1 = y0;
            y0 = tmp;
        }
        
        if (x1 < x0)
        {
            tmp = x1;
            x1 = x0;
            x0 = tmp;
        }
        
        /* Horizontal line */
        for (i = x0; i <= x1; i++)
        {
            ST7567_DrawPixel(i, y0, c);
        }
        
        /* Return from function */
        return;
    }
 
    while (1)
    {
        ST7567_DrawPixel(x0, y0, c);
        if (x0 == x1 && y0 == y1)
        {
            break;
        }
        e2 = err;
        if (e2 > -dx)
        {
            err -= dy;
            x0 += sx;
        }
        if (e2 < dy)
        {
            err += dx;
            y0 += sy;
        }
    }
}

◆ ST7567_DrawPixel()

void ST7567_DrawPixel	(	uint8_t	x,
		uint8_t	y,
		uint8_t	color
	)

Draws pixel at desired location.

Note: ST7567_UpdateScreen() must called after that in order to see updates

Parameters

x	X location. This parameter can be a value between 0 and ST7567_WIDTH - 1
y	Y location. This parameter can be a value between 0 and ST7567_HEIGHT - 1
color	Color to be used for screen fill. This parameter can be a value of ST7567_COLOR_t enumeration

Return values

None

Definition at line 164 of file st7567.c.

{
    uint8_t page, column;
    if (x >= ST7567_WIDTH || y >= ST7567_HEIGHT)
    {
        /* Error */
        return;
    }
 
    if (color == ST7567_COLOR_FRONT)
    {
        ST7567_Buffer_all[x + (y / 8) * ST7567_WIDTH] |= 1 << (y % 8);
    }
    else
    {
        ST7567_Buffer_all[x + (y / 8) * ST7567_WIDTH] &= ~(1 << (y % 8));
    }
}

◆ ST7567_Fill()

void ST7567_Fill ( uint8_t Color )

Fills entire LCD with specified color.

Note: ST7567_UpdateScreen() must be called after that in order to see updates

Parameters

Color Color to be used for screen fill, ST7567_COLOR_FRONT or ST7567_COLOR_BACK

Return values

None

Definition at line 158 of file st7567.c.

{
    /* Set memory */
    memset((uint8_t *)ST7567_Buffer_all, (color == ST7567_COLOR_BACK) ? 0x00 : 0xFF, sizeof(ST7567_Buffer_all));
}

◆ ST7567_GotoXY()

void ST7567_GotoXY	(	uint16_t	x,
		uint16_t	y
	)

Sets cursor pointer to desired location for strings.

Parameters

x	X location. This parameter can be a value between 0 and ST7567_WIDTH - 1
y	Y location. This parameter can be a value between 0 and ST7567_HEIGHT - 1

Return values

None

Definition at line 183 of file st7567.c.

{
    /* Set write pointers */
    ST7567_currentX = x;
    ST7567_currentY = y;
}

◆ ST7567_Init()

void ST7567_Init ( void )

Initializes ST7567 LCD.

Parameters

None

Return values

None

Definition at line 68 of file st7567.c.

{
    ST7567_Reset();
    ST7567_SetBackLightState(HAL_State_ON);
 
    ST7567_WriteCommand(ST7567_RESET);
    // adjust contrast 
    ST7567_WriteCommand(ST7567_SET_EV);
    ST7567_WriteCommand(ST7567_SET_EV_MASK & 0x20); 
    // adjust regular voltage. LCD may fail to display if it is set too low.
    ST7567_WriteCommand(ST7567_REGULATION_RATIO | ST7567_REGULATION_RATIO_5_0);
    ST7567_WriteCommand(ST7567_BIAS_1_9);
    ST7567_WriteCommand(ST7567_X_ORIENT);
    ST7567_WriteCommand(ST7567_Y_ORIENT);
    ST7567_WriteCommand(ST7567_INVERSE_DISPLAY_OFF);
    // Start from line 0
    ST7567_WriteCommand(ST7567_SET_START_LINE | (0x00 & ST7567_SET_START_LINE_MASK));
    // Start from page 0
    ST7567_WriteCommand(ST7567_SET_PAGE_ADDRESS | (0x00 & ST7567_SET_PAGE_ADDRESS_MASK));
    // Start from column 0
    ST7567_WriteCommand(ST7567_SET_COLUMN_ADDRESS_MSB | (0x00 & ST7567_SET_COLUMN_ADDRESS_MSB_MASK));
    ST7567_WriteCommand(ST7567_SET_COLUMN_ADDRESS_LSB | (0x00 & ST7567_SET_COLUMN_ADDRESS_LSB_MASK));
    // power control, LCD may fail to display if it is not properly set.
    // recommend to set them all
    ST7567_WriteCommand(ST7567_POWER_CONTROL
        |ST7567_POWER_CONTROL_VB
        |ST7567_POWER_CONTROL_VR
        |ST7567_POWER_CONTROL_VF);
    ST7567_WriteCommand(ST7567_DISPLAY_ON);
    ST7567_WriteCommand(ST7567_ALL_PIXEL_NORMAL);
}

◆ ST7567_Putc()

char ST7567_Putc	(	char	ch,
		FontDef_t *	Font,
		uint8_t	color
	)

Puts character to internal RAM.

Note: ST7567_UpdateScreen() must be called after that in order to see updated LCD screen

Parameters

ch	Character to be written
*Font	Pointer to FontDef_t structure with used font
color	Color used for drawing. This parameter can be a value of ST7567_COLOR_t enumeration

Return values

Character written

Definition at line 190 of file st7567.c.

{
    uint32_t i, b, j, k;
 
    for (i = 0; i < font->height; i++)
    {
        for (j = 0; j < font->bytes; j++)
        {
            b = font->dat[((ch - 32) * font->height + i) * font->bytes + j];
            if (font->order == 0)
            {
                for (k = 0; k < 8 && k < font->width - j * 8; k++)
                {
                    if ((b << k) & 0x80)
                    {
                        ST7567_DrawPixel(ST7567_currentX + (j * 8) + k, (ST7567_currentY + i), (uint8_t) color);
                    }
                    else
                    {
                        ST7567_DrawPixel(ST7567_currentX + (j * 8) + k, (ST7567_currentY + i), (uint8_t) !color);
                    }
                }
            }
            else
            {
                for (k = 0; k < 8 && k < font->width - j * 8; k++)
                {
                    if (b & (0x0001 << k))
                    {
                        ST7567_DrawPixel(ST7567_currentX + (j * 8) + k, (ST7567_currentY + i), (uint8_t) color);
                    }
                    else
                    {
                        ST7567_DrawPixel(ST7567_currentX + (j * 8) + k, (ST7567_currentY + i), (uint8_t) !color);
                    }
                }
            }
        }
    }
 
    /* Increase pointer */
    ST7567_currentX += font->width + 1;
 
    /* Return character written */
    return ch;
}

◆ ST7567_Puts()

char ST7567_Puts	(	char *	str,
		FontDef_t *	Font,
		uint8_t	color
	)

Puts string to internal RAM.

Note: ST7567_UpdateScreen() must be called after that in order to see updated LCD screen

Parameters

*str	String to be written
*Font	Pointer to FontDef_t structure with used font
color	Color used for drawing. This parameter can be a value of ST7567_COLOR_t enumeration

Return values

Zero	on success or character value when function failed

Definition at line 237 of file st7567.c.

{
    /* Write characters */
    while (*str)
    {
        /* Write character by character */
        if (ST7567_Putc(*str, Font, color) != *str)
        {
            /* Return error */
            return *str;
        }
        
        /* Increase string pointer */
        str++;
    }
    
    /* Everything OK, zero should be returned */
    return *str;
}

◆ ST7567_Reset()

void ST7567_Reset ( void )

Hardware reset ST7567 LCD.

Parameters

None

Return values

None

Definition at line 61 of file st7567.c.

{
    ST7567_RES = 0;
    SYS_Delay(5);
    ST7567_RES = 1;
}

◆ ST7567_SetBackLightState()

void ST7567_SetBackLightState ( HAL_State_t state )

Turn ST7567 LCD backlight on or off.

Parameters

state HAL_State_ON:on, HAL_State_OFF:off

Return values

None

Definition at line 121 of file st7567.c.

{
    ST7567_BL = (state == HAL_State_ON)? SET : RESET;
}

◆ ST7567_SetContrast()

void ST7567_SetContrast ( uint8_t val )

Turn ST7567 LCD backlight off.

Parameters

val	value between 0x00 ~ 0x3F

Return values

None

Definition at line 126 of file st7567.c.

{
    ST7567_WriteCommand(ST7567_SET_EV);
    ST7567_WriteCommand(ST7567_SET_EV_MASK & val);
}

◆ ST7567_SetPowerSaveMode()

void ST7567_SetPowerSaveMode ( HAL_State_t state )

Powersave mode control.

Parameters

state HAL_State_ON:powersave mode, HAL_State_OFF:work mode

Return values

None

Definition at line 100 of file st7567.c.

{
#if (ST7567_MODEL == ST7567_MODEL_ST7565)
    if (state == HAL_State_ON)
        ST7567_WriteCommand(ST7567_MODE_SLEEP);
    else
        ST7567_WriteCommand(ST7567_MODE_NORMAL);
#else
    if (state == HAL_State_ON)
    {
        ST7567_WriteCommand(ST7567_DISPLAY_OFF);
        ST7567_WriteCommand(ST7567_ALL_PIXEL_ON);
    }
    else
    {
        ST7567_WriteCommand(ST7567_ALL_PIXEL_NORMAL);
        ST7567_WriteCommand(ST7567_DISPLAY_ON);
    }
#endif
}

◆ ST7567_ToggleInvert()

void ST7567_ToggleInvert ( void )

Toggles pixels invertion inside internal RAM.

Note: ST7567_UpdateScreen() must be called after that in order to see updated LCD screen

Parameters

None

Return values

None

Definition at line 144 of file st7567.c.

{
    /* Toggle invert */
    ST7567_colorInverted = !ST7567_colorInverted;
    if (ST7567_colorInverted)
    {
        ST7567_WriteCommand(ST7567_INVERSE_DISPLAY_ON);
    }
    else
    {
        ST7567_WriteCommand(ST7567_INVERSE_DISPLAY_OFF);
    }
}

◆ ST7567_UpdateScreen()

void ST7567_UpdateScreen ( void )

Update LCD display with buffer changes.

Note: Call this function each time when display is changed

Parameters

None

Return values

None

Definition at line 132 of file st7567.c.

{
    uint8_t i = 0, *pt = ST7567_Buffer_all;
    for (i = 0; i < ST7567_PAGES; i++)
    {
        ST7567_WriteCommand(ST7567_SET_PAGE_ADDRESS|(i & ST7567_SET_PAGE_ADDRESS_MASK));
        ST7567_WriteCommand(ST7567_SET_COLUMN_ADDRESS_MSB|(0 >> 4));
        ST7567_WriteCommand(ST7567_SET_COLUMN_ADDRESS_LSB|(0 & 0x0F));
        ST7567_Transmit(pt + (ST7567_WIDTH * i), ST7567_WIDTH);
    }
}

◆ ST7567_WriteCommand()

void ST7567_WriteCommand ( uint8_t command )

Write a single byte command to ST7567.

Parameters

command command

Return values

None

Definition at line 44 of file st7567.c.

{
    ST7567_DC = 0;
    ST7567_WriteData(command);
    ST7567_DC = 1;
}

◆ ST7567_WriteData()

void ST7567_WriteData ( uint8_t dat )

Write a single byte data to ST7567.

Parameters

dat data

Return values

None

Definition at line 27 of file st7567.c.

{
    ST7567_CS = 0;
    SPI_TxRx(dat);
    ST7567_CS = 1;
}

◆ ST7567_WriteSameData()

void ST7567_WriteSameData	(	uint8_t	dat,
		uint32_t	size
	)

Definition at line 34 of file st7567.c.

{
    ST7567_CS = 0;
    do
    {
        SPI_TxRx(dat);
    } while (--size);
    ST7567_CS = 1;
}

Variable Documentation

◆ Font_3x5

__CODE FontDef_t Font_3x5

extern

Definition at line 547 of file pcd8544.c.

◆ Font_5x7

__CODE FontDef_t Font_5x7

extern

Definition at line 548 of file pcd8544.c.

Data Structures

Macros

Functions

Variables

Macro Definition Documentation

◆ ST7567_ALL_PIXEL_NORMAL

◆ ST7567_ALL_PIXEL_ON

◆ ST7567_BIAS_1_7

◆ ST7567_BIAS_1_9

◆ ST7567_BL

◆ ST7567_COLOR_BACK

◆ ST7567_COLOR_FRONT

◆ ST7567_COLUMN_EXPAND

◆ ST7567_COM_DIRECTION_NORMAL

◆ ST7567_COM_DIRECTION_REVERSE

◆ ST7567_CS

◆ ST7567_DC

◆ ST7567_DISPLAY_OFF

◆ ST7567_DISPLAY_ON

◆ ST7567_HEIGHT

◆ ST7567_INVERSE_DISPLAY_OFF

◆ ST7567_INVERSE_DISPLAY_ON

◆ ST7567_MODEL

◆ ST7567_MODEL_ST7565

◆ ST7567_MODEL_ST7567

◆ ST7567_MOSI

◆ ST7567_NOP

◆ ST7567_PAGES

◆ ST7567_POWER_CONTROL

◆ ST7567_POWER_CONTROL_VB

◆ ST7567_POWER_CONTROL_VF

◆ ST7567_POWER_CONTROL_VR

◆ ST7567_READ_MODIFY_WRITE_END

◆ ST7567_READ_MODIFY_WRITE_START

◆ ST7567_REGULATION_RATIO

◆ ST7567_REGULATION_RATIO_3_0

◆ ST7567_REGULATION_RATIO_3_5

◆ ST7567_REGULATION_RATIO_4_0

◆ ST7567_REGULATION_RATIO_4_5

◆ ST7567_REGULATION_RATIO_5_0

◆ ST7567_REGULATION_RATIO_5_5

◆ ST7567_REGULATION_RATIO_6_0

◆ ST7567_REGULATION_RATIO_6_5

◆ ST7567_RES

◆ ST7567_RESET

◆ ST7567_SCK

◆ ST7567_SEG_DIRECTION_NORMAL

◆ ST7567_SEG_DIRECTION_REVERSE

◆ ST7567_SET_BOOSTER

◆ ST7567_SET_BOOSTER_4X

◆ ST7567_SET_BOOSTER_5X

◆ ST7567_SET_BOOSTER_6X

◆ ST7567_SET_COLUMN_ADDRESS_LSB

◆ ST7567_SET_COLUMN_ADDRESS_LSB_MASK

◆ ST7567_SET_COLUMN_ADDRESS_MSB

◆ ST7567_SET_COLUMN_ADDRESS_MSB_MASK

◆ ST7567_SET_EV

◆ ST7567_SET_EV_MASK

◆ ST7567_SET_PAGE_ADDRESS

◆ ST7567_SET_PAGE_ADDRESS_MASK

◆ ST7567_SET_START_LINE

◆ ST7567_SET_START_LINE_MASK

◆ ST7567_TEST

◆ ST7567_TIMEOUT

◆ ST7567_WIDTH

◆ ST7567_X_ORIENT

◆ ST7567_Y_ORIENT

Function Documentation

◆ ST7567_DrawLine()

◆ ST7567_DrawPixel()

◆ ST7567_Fill()

◆ ST7567_GotoXY()

◆ ST7567_Init()

◆ ST7567_Putc()

◆ ST7567_Puts()

◆ ST7567_Reset()

◆ ST7567_SetBackLightState()

◆ ST7567_SetContrast()

◆ ST7567_SetPowerSaveMode()

◆ ST7567_ToggleInvert()