alex/SSD1306
1
0
Fork 0
mirror of https://github.com/Matiasus/SSD1306.git synced 2024-10-03 18:18:46 -04:00
Code Issues Actions Packages Projects Releases Wiki Activity

Merge pull request #4 from Matiasus/readme-edits

Browse Source 
Add files via upload
This commit is contained in:
Marián 2020-10-27 13:07:14 +01:00 committed by GitHub
commit 2e87e9ccb8
No known key found for this signature in database
GPG Key ID: 4AEE18F83AFDEB23
2 changed files with 416 additions and 27 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

338
lib/ssd1306.c
View File

@ -96,53 +96,63 @@
/** @array Init command */
const uint8_t INIT_SSD1306[] PROGMEM = {
// number of initializers
16,
17,
// 0xAE = Set Display OFF
// -----------------------------------
0, SSD1306_DISPLAY_OFF,
// 0xA8
1, SSD1306_SET_MUX_RATIO, 0x3F,
// 0x20 = Set Memory Addressing Mode
// -----------------------------------
// 0x00 - Horizontal Addressing Mode
// 0x01 - Vertical Addressing Mode
// 0x02 - Page Addressing Mode (RESET)
1, SSD1306_MEMORY_ADDR_MODE, 0x00,
// 0x21 = Set Column Address
// -----------------------------------
// 0x00 - Start Column Address
// 0xFF - End Column Address
2, SSD1306_SET_COLUMN_ADDR, START_COLUMN_ADDR, END_COLUMN_ADDR,
// 0x22 = Set Page Address
// -----------------------------------
// 0x00 - Start Column Address
// 0x07 - End Column Address
2, SSD1306_SET_PAGE_ADDR, START_PAGE_ADDR, END_PAGE_ADDR,
1, SSD1306_SET_MUX_RATIO, 0x3F,
1, SSD1306_DISPLAY_OFFSET, 0x00,
// 0x40
0, SSD1306_SET_START_LINE,
// 0xA0
0, SSD1306_SEG_REMAP,
// 0xC0
0, SSD1306_COM_SCAN_DIR,
1, SSD1306_COM_PIN_CONF, 0x02,
1, SSD1306_SET_CONTRAST, 0xaF,
// 0xD3
1, SSD1306_DISPLAY_OFFSET, 0x00,
// 0xA0 / remap 0xA1
0, SSD1306_SEG_REMAP_OP,
// 0xC0 / remap 0xC8
0, SSD1306_COM_SCAN_DIR_OP,
// 0xDA
1, SSD1306_COM_PIN_CONF, 0x12,
// 0x81
1, SSD1306_SET_CONTRAST, 0x7F,
// 0xA4
0, SSD1306_DIS_ENT_DISP_ON,
// 0xA6
0, SSD1306_DIS_NORMAL,
// 0xD5
1, SSD1306_SET_OSC_FREQ, 0x80,
// 0xD9, 1st Period = higher value less blinking
1, SSD1306_SET_PRECHARGE, 0xc2,
// Set V COMH Deselect, reset value 0x22 = 0,77xUcc
1, SSD1306_VCOM_DESELECT, 0x20,
// 0x8D
1, SSD1306_SET_CHAR_REG, 0x14,
// 0xAF = Set Display ON
// -----------------------------------
0, SSD1306_DISPLAY_ON
// 0, SSD1306_DISPLAY_ON
};
// @var set area
volatile unsigned int set_area = (END_PAGE_ADDR - START_PAGE_ADDR + 1) * (END_COLUMN_ADDR - START_COLUMN_ADDR + 1);
// @var global - set area
unsigned int set_area = (END_PAGE_ADDR - START_PAGE_ADDR + 1) * (END_COLUMN_ADDR - START_COLUMN_ADDR + 1);
// @var global - cache index column
unsigned short int indexCol = START_COLUMN_ADDR;
// @var global - cache index page
unsigned short int indexPage = START_PAGE_ADDR;
/**
* @desc SSD1306 Init
@ -285,6 +295,108 @@ char SSD1306_Send_Command(char command)
return SSD1306_SUCCESS;
}
/**
* @desc SSD1306 Normal Colors
*
* @param void
*
* @return char
*/
char SSD1306_NormalScreen(void)
{
// init status
char status = INIT_STATUS;
// TWI: start & SLAW
// -------------------------
status = SSD1306_Send_StartAndSLAW();
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// send command
// -------------------------
status = SSD1306_Send_Command(SSD1306_DIS_NORMAL);
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// success
return SSD1306_SUCCESS;
}
/**
* @desc SSD1306 Inverse Colors
*
* @param void
*
* @return char
*/
char SSD1306_InverseScreen(void)
{
// init status
char status = INIT_STATUS;
// TWI: start & SLAW
// -------------------------
status = SSD1306_Send_StartAndSLAW();
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// send command
// -------------------------
status = SSD1306_Send_Command(SSD1306_DIS_INVERSE);
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// success
return SSD1306_SUCCESS;
}
/**
* @desc SSD1306 Update Screen
*
* @param void
*
* @return char
*/
char SSD1306_UpdateScreen(void)
{
// init status
char status = INIT_STATUS;
// TWI: start & SLAW
// -------------------------
status = SSD1306_Send_StartAndSLAW();
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// send command
// -------------------------
status = SSD1306_Send_Command(SSD1306_DISPLAY_ON);
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// success
return SSD1306_SUCCESS;
}
/**
* @desc SSD1306 Send Command
*
@ -292,7 +404,7 @@ char SSD1306_Send_Command(char command)
*
* @return char
*/
char SSD1306_ClearScreen(void)
char SSD1306_ClearScreen(char color)
{
// init status
char status = INIT_STATUS;
@ -319,7 +431,7 @@ char SSD1306_ClearScreen(void)
// -------------------------
while (set_area--) {
// send null data
status = TWI_MT_Send_Data(0x00);
status = TWI_MT_Send_Data(color);
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
@ -382,6 +494,8 @@ char SSD1306_SetPosition(char x, char y)
// error
return status;
}
// update column index
indexCol = x;
// SET PAGE address
// ***************************************************
@ -409,6 +523,8 @@ char SSD1306_SetPosition(char x, char y)
// error
return status;
}
// update column index
indexPage = y;
// stop TWI
TWI_Stop();
@ -417,6 +533,42 @@ char SSD1306_SetPosition(char x, char y)
return SSD1306_SUCCESS;
}
/**
* @desc SSD1306 Check Text Poisition
*
* @param char
* @param char
*
* @return char
*/
char SSD1306_UpdTxtPosition(void)
{
// init status
char status = INIT_STATUS;
// check end column position
unsigned short int x = indexCol+CHARS_COLS_LENGTH+1;
// check position
if ((x > END_COLUMN_ADDR) && (indexPage > (END_PAGE_ADDR-1))) {
// return out of range
return SSD1306_ERROR;
// if x out reach end but page in range
} else if ((x > END_COLUMN_ADDR) && (indexPage < END_PAGE_ADDR)) {
// update - column
indexCol = 0;
// update - page
indexPage = indexPage+1;
// update - null col, increment page
status = SSD1306_SetPosition(indexCol, indexPage);
// request
if (SSD1306_SUCCESS != status) {
// error
return status;
}
}
// success
return SSD1306_SUCCESS;
}
/**
* @desc Draw character
*
@ -431,6 +583,12 @@ char SSD1306_DrawChar(char character)
// init status
char status = INIT_STATUS;
// update text position
if (SSD1306_UpdTxtPosition() != SSD1306_SUCCESS) {
// error
return SSD1306_ERROR;
}
// TWI: start & SLAW
// -------------------------
status = SSD1306_Send_StartAndSLAW();
@ -460,7 +618,7 @@ char SSD1306_DrawChar(char character)
// error
return status;
}
// decrement
// increment
idxCol++;
}
@ -473,6 +631,116 @@ char SSD1306_DrawChar(char character)
return status;
}
// increment global index col
indexCol = indexCol + CHARS_COLS_LENGTH + 1;
// stop TWI
TWI_Stop();
// success
return SSD1306_SUCCESS;
}
/**
* @desc Send 1 Byte of data
*
* @param char
*
* @return void
*/
char SSD1306_SendByte(char data)
{
// init status
char status = INIT_STATUS;
// TWI: start & SLAW
// -------------------------
status = SSD1306_Send_StartAndSLAW();
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// control byte data stream
// -------------------------
status = TWI_MT_Send_Data(SSD1306_DATA_STREAM);
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// send byte of data
// -------------------------
status = TWI_MT_Send_Data(data);
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// increment global index col
indexCol = indexCol + 1;
// stop TWI
TWI_Stop();
// success
return SSD1306_SUCCESS;
}
/**
* @desc Send Bytes
*
* @param char
* @param char
*
* @return void
*/
char SSD1306_SendBytes(char data, char length)
{
// index
unsigned short int i = 0;
// init status
char status = INIT_STATUS;
// TWI: start & SLAW
// -------------------------
status = SSD1306_Send_StartAndSLAW();
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// control byte data stream
// -------------------------
status = TWI_MT_Send_Data(SSD1306_DATA_STREAM);
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// loop through data
while (i++ < length) {
// draw line only within 1 page
if (indexCol < MAX_X) {
// send byte of data
// -------------------------
status = TWI_MT_Send_Data(data);
// request - start TWI
if (SSD1306_SUCCESS != status) {
// error
return status;
}
// increment global index col
indexCol = indexCol + 1;
} else {
// end loop
break;
}
}
// stop TWI
TWI_Stop();
@ -508,3 +776,35 @@ char SSD1306_DrawString(char *str)
// success
return SSD1306_SUCCESS;
}
/**
* @desc Draw pixel
*
* @param char
* @param char
*
* @return void
*/
char SSD1306_DrawLineHorizontal(char x, char y, char len)
{
char page = 0;
char pixel = 0;
if ((x > MAX_X) && (y > MAX_Y)) {
// out of range
return SSD1306_ERROR;
}
// y/8
page = y / 8;
// which pixel
pixel |= 1 << (y % 8);
// send position
SSD1306_SetPosition(x, page);
// draw pixel
SSD1306_SendBytes(pixel, len);
// success
return SSD1306_SUCCESS;
}

103
lib/ssd1306.h
View File

@ -17,7 +17,8 @@
#ifndef __SSD1306_H__
#define __SSD1306_H__
#define SSD1306_SUCCESS 0
#define SSD1306_SUCCESS 0
#define SSD1306_ERROR 1
// Address definition
// -----------------------------------
@ -35,6 +36,7 @@
#define SSD1306_DISPLAY_ON 0xAF
#define SSD1306_DISPLAY_OFF 0xAE
#define SSD1306_DIS_ENT_DISP_ON 0xA4
#define SSD1306_DIS_IGNORE_RAM 0xA5
#define SSD1306_DIS_NORMAL 0xA6
#define SSD1306_DIS_INVERSE 0xA7
#define SSD1306_DEACT_SCROLL 0x2E
@ -46,16 +48,19 @@
#define SSD1306_SEG_REMAP 0xA0
#define SSD1306_SEG_REMAP_OP 0xA1
#define SSD1306_COM_SCAN_DIR 0xC0
#define SSD1306_COM_SCAN_DIR_OP 0xC0
#define SSD1306_COM_SCAN_DIR_OP 0xC8
#define SSD1306_COM_PIN_CONF 0xDA
#define SSD1306_SET_CONTRAST 0x81
#define SSD1306_SET_OSC_FREQ 0xD5
#define SSD1306_SET_CHAR_REG 0x8D
#define SSD1306_SET_PRECHARGE 0xD9
#define SSD1306_VCOM_DESELECT 0xDB
// Characters definition
// -----------------------------------
// number of columns for chars
#define CHARS_COLS_LENGTH 5
// #define CHARS_COLS_LENGTH 5
// Clear Color
// -----------------------------------
@ -71,8 +76,17 @@
#define END_PAGE_ADDR 7
#define START_COLUMN_ADDR 0
#define END_COLUMN_ADDR 127
#define MAX_X END_COLUMN_ADDR
#define MAX_Y (END_PAGE_ADDR+1)*8
// @var set area
volatile unsigned int set_area;
unsigned int set_area;
// cache index column
unsigned short int indexCol;
// cache index page
unsigned short int indexPage;
/**
* @desc SSD1306 Init
@ -104,17 +118,44 @@
/**
* @desc SSD1306 Clear Screen
*
* @param char
*
* @return char
*/
char SSD1306_ClearScreen(char);
/**
* @desc SSD1306 Normal Colors
*
* @param void
*
* @return char
*/
char SSD1306_ClearScreen(void);
char SSD1306_NormalScreen(void);
/**
* @desc SSD1306 Inverse Colors
*
* @param void
*
* @return char
*/
char SSD1306_InverseScreen(void);
/**
* @desc SSD1306 Check Text Poisition
*
* @param void
*
* @return char
*/
char SSD1306_UpdTxtPosition(void);
/**
* @desc SSD1306 Set Position
*
* @param char
* @param char
* @param char -> column
* @param char -> page
*
* @return char
*/
@ -138,4 +179,52 @@
*/
char SSD1306_DrawString(char *);
/**
* @desc SSD1306 Update Screen
*
* @param void
*
* @return char
*/
char SSD1306_UpdateScreen(void);
/**
* @desc Update index
*
* @param char
*
* @return void
*/
void SSD1306_UpdateIndexes(char);
/**
* @desc Draw line horizontal
*
* @param char
* @param char
*
* @return void
*/
char SSD1306_DrawLineHorizontal(char, char, char);
/**
* @desc Send 1 Byte of data
*
* @param char
*
* @return void
*/
char SSD1306_SendByte(char);
/**
* @desc Send Bytes
*
* @param char
* @param char
*
* @return void
*/
char SSD1306_SendBytes(char, char);
#endif