driver ssd1306 header file More...

#include <stdint.h>
#include <stdio.h>
#include <string.h>

Include dependency graph for driver_ssd1306.h:

This graph shows which files directly or indirectly include this file:

Data Structures
struct	ssd1306_handle_s
	ssd1306 handle structure definition More...
struct	ssd1306_info_s
	ssd1306 information structure definition More...

Macros
#define	DRIVER_SSD1306_LINK_INIT(HANDLE, STRUCTURE)
	initialize ssd1306_handle_t structure
#define	DRIVER_SSD1306_LINK_IIC_INIT(HANDLE, FUC)
	link iic_init function
#define	DRIVER_SSD1306_LINK_IIC_DEINIT(HANDLE, FUC)
	link iic_deinit function
#define	DRIVER_SSD1306_LINK_IIC_WRITE(HANDLE, FUC)
	link iic_write function
#define	DRIVER_SSD1306_LINK_SPI_INIT(HANDLE, FUC)
	link spi_init function
#define	DRIVER_SSD1306_LINK_SPI_DEINIT(HANDLE, FUC)
	link spi_deinit function
#define	DRIVER_SSD1306_LINK_SPI_WRITE_COMMAND(HANDLE, FUC)
	link spi_write_cmd function
#define	DRIVER_SSD1306_LINK_SPI_COMMAND_DATA_GPIO_INIT(HANDLE, FUC)
	link spi_cmd_data_gpio_init function
#define	DRIVER_SSD1306_LINK_SPI_COMMAND_DATA_GPIO_DEINIT(HANDLE, FUC)
	link spi_cmd_data_gpio_deinit function
#define	DRIVER_SSD1306_LINK_SPI_COMMAND_DATA_GPIO_WRITE(HANDLE, FUC)
	link spi_cmd_data_gpio_write function
#define	DRIVER_SSD1306_LINK_RESET_GPIO_INIT(HANDLE, FUC)
	link reset_gpio_init function
#define	DRIVER_SSD1306_LINK_RESET_GPIO_DEINIT(HANDLE, FUC)
	link reset_gpio_deinit function
#define	DRIVER_SSD1306_LINK_RESET_GPIO_WRITE(HANDLE, FUC)
	link reset_gpio_write function
#define	DRIVER_SSD1306_LINK_DELAY_MS(HANDLE, FUC)
	link delay_ms function
#define	DRIVER_SSD1306_LINK_DEBUG_PRINT(HANDLE, FUC)
	link debug_print function

Typedefs
typedef struct ssd1306_handle_s	ssd1306_handle_t
	ssd1306 handle structure definition
typedef struct ssd1306_info_s	ssd1306_info_t
	ssd1306 information structure definition

Enumerations
enum	ssd1306_interface_t { SSD1306_INTERFACE_IIC = 0x00 , SSD1306_INTERFACE_SPI = 0x01 }
	ssd1306 interface enumeration definition More...
enum	ssd1306_address_t { SSD1306_ADDR_SA0_0 = 0x78 , SSD1306_ADDR_SA0_1 = 0x7A }
	ssd1306 address pin enumeration definition More...
enum	ssd1306_memory_addressing_mode_t { SSD1306_MEMORY_ADDRESSING_MODE_HORIZONTAL = 0x00 , SSD1306_MEMORY_ADDRESSING_MODE_VERTICAL = 0x01 , SSD1306_MEMORY_ADDRESSING_MODE_PAGE = 0x02 }
	ssd1306 memory addressing mode enumeration definition More...
enum	ssd1306_fade_blinking_mode_t { SSD1306_FADE_BLINKING_MODE_DISABLE = 0x00 , SSD1306_FADE_BLINKING_MODE_FADE_OUT = 0x02 , SSD1306_FADE_BLINKING_MODE_BLINKING = 0x03 }
	ssd1306 fade blinking mode enumeration definition More...
enum	ssd1306_scroll_frame_t { SSD1306_SCROLL_FRAME_2 = 0x07 , SSD1306_SCROLL_FRAME_3 = 0x04 , SSD1306_SCROLL_FRAME_4 = 0x05 , SSD1306_SCROLL_FRAME_5 = 0x00 , SSD1306_SCROLL_FRAME_25 = 0x06 , SSD1306_SCROLL_FRAME_64 = 0x01 , SSD1306_SCROLL_FRAME_128 = 0x02 , SSD1306_SCROLL_FRAME_256 = 0x03 }
	ssd1306 scroll frame enumeration definition More...
enum	ssd1306_charge_pump_t { SSD1306_CHARGE_PUMP_DISABLE = 0x00 , SSD1306_CHARGE_PUMP_ENABLE = 0x01 }
	ssd1306 charge pump enumeration definition More...
enum	ssd1306_segment_column_remap_t { SSD1306_SEGMENT_COLUMN_ADDRESS_0 = 0x00 , SSD1306_SEGMENT_COLUMN_ADDRESS_127 = 0x01 }
	ssd1306 segment column remap enumeration definition More...
enum	ssd1306_entire_display_t { SSD1306_ENTIRE_DISPLAY_OFF = 0x00 , SSD1306_ENTIRE_DISPLAY_ON = 0x01 }
	ssd1306 entire display enumeration definition More...
enum	ssd1306_display_mode_t { SSD1306_DISPLAY_MODE_NORMAL = 0x00 , SSD1306_DISPLAY_MODE_INVERSE = 0x01 }
	ssd1306 display mode enumeration definition More...
enum	ssd1306_display_t { SSD1306_DISPLAY_OFF = 0x00 , SSD1306_DISPLAY_ON = 0x01 }
	ssd1306 display enumeration definition More...
enum	ssd1306_scan_direction_t { SSD1306_SCAN_DIRECTION_COM0_START = 0x00 , SSD1306_SCAN_DIRECTION_COMN_1_START = 0x01 }
	ssd1306 scan direction enumeration definition More...
enum	ssd1306_zoom_in_t { SSD1306_ZOOM_IN_DISABLE = 0x00 , SSD1306_ZOOM_IN_ENABLE = 0x01 }
	ssd1306 zoom in enumeration definition More...
enum	ssd1306_pin_conf_t { SSD1306_PIN_CONF_SEQUENTIAL = 0x00 , SSD1306_PIN_CONF_ALTERNATIVE = 0x01 }
	ssd1306 pin conf enumeration definition More...
enum	ssd1306_left_right_remap_t { SSD1306_LEFT_RIGHT_REMAP_DISABLE = 0x00 , SSD1306_LEFT_RIGHT_REMAP_ENABLE = 0x01 }
	ssd1306 left right remap enumeration definition More...
enum	ssd1306_deselect_level_t { SSD1306_DESELECT_LEVEL_0P65 = 0x00 , SSD1306_DESELECT_LEVEL_0P77 = 0x02 , SSD1306_DESELECT_LEVEL_0P83 = 0x03 }
	ssd1306 deselect level enumeration definition More...
enum	ssd1306_font_t { SSD1306_FONT_12 = 0x0C , SSD1306_FONT_16 = 0x10 , SSD1306_FONT_24 = 0x18 }
	ssd1306 font enumeration definition More...

Functions
uint8_t	ssd1306_info (ssd1306_info_t *info)
	get chip's information
uint8_t	ssd1306_set_interface (ssd1306_handle_t *handle, ssd1306_interface_t interface)
	set the chip interface
uint8_t	ssd1306_get_interface (ssd1306_handle_t handle, ssd1306_interface_t interface)
	get the chip interface
uint8_t	ssd1306_set_addr_pin (ssd1306_handle_t *handle, ssd1306_address_t addr_pin)
	set the chip iic address
uint8_t	ssd1306_get_addr_pin (ssd1306_handle_t handle, ssd1306_address_t addr_pin)
	get the chip iic address
uint8_t	ssd1306_init (ssd1306_handle_t *handle)
	initialize the chip
uint8_t	ssd1306_deinit (ssd1306_handle_t *handle)
	close the chip
uint8_t	ssd1306_clear (ssd1306_handle_t *handle)
	clear the screen
uint8_t	ssd1306_gram_update (ssd1306_handle_t *handle)
	update the gram data
uint8_t	ssd1306_write_point (ssd1306_handle_t *handle, uint8_t x, uint8_t y, uint8_t data)
	write a point
uint8_t	ssd1306_read_point (ssd1306_handle_t handle, uint8_t x, uint8_t y, uint8_t data)
	read a point
uint8_t	ssd1306_gram_write_point (ssd1306_handle_t *handle, uint8_t x, uint8_t y, uint8_t data)
	write a point in the gram
uint8_t	ssd1306_gram_read_point (ssd1306_handle_t handle, uint8_t x, uint8_t y, uint8_t data)
	read a point from the gram
uint8_t	ssd1306_gram_write_string (ssd1306_handle_t handle, uint8_t x, uint8_t y, char str, uint16_t len, uint8_t color, ssd1306_font_t font)
	draw a string in the gram
uint8_t	ssd1306_gram_fill_rect (ssd1306_handle_t *handle, uint8_t left, uint8_t top, uint8_t right, uint8_t bottom, uint8_t color)
	fill a rectangle in the gram
uint8_t	ssd1306_gram_draw_picture (ssd1306_handle_t handle, uint8_t left, uint8_t top, uint8_t right, uint8_t bottom, uint8_t img)
	draw a picture in the gram
uint8_t	ssd1306_set_low_column_start_address (ssd1306_handle_t *handle, uint8_t addr)
	set the low column start address
uint8_t	ssd1306_set_high_column_start_address (ssd1306_handle_t *handle, uint8_t addr)
	set the high column start address
uint8_t	ssd1306_set_memory_addressing_mode (ssd1306_handle_t *handle, ssd1306_memory_addressing_mode_t mode)
	set the memory addressing mode
uint8_t	ssd1306_set_column_address_range (ssd1306_handle_t *handle, uint8_t start_addr, uint8_t end_addr)
	set the column address range
uint8_t	ssd1306_set_page_address_range (ssd1306_handle_t *handle, uint8_t start_addr, uint8_t end_addr)
	set the page address range
uint8_t	ssd1306_set_fade_blinking_mode (ssd1306_handle_t *handle, ssd1306_fade_blinking_mode_t mode, uint8_t frames)
	set the fade blinking mode
uint8_t	ssd1306_set_right_horizontal_scroll (ssd1306_handle_t *handle, uint8_t start_page_addr, uint8_t end_page_addr, ssd1306_scroll_frame_t frames)
	set the right horizontal scroll
uint8_t	ssd1306_set_left_horizontal_scroll (ssd1306_handle_t *handle, uint8_t start_page_addr, uint8_t end_page_addr, ssd1306_scroll_frame_t frames)
	set the left horizontal scroll
uint8_t	ssd1306_set_vertical_right_horizontal_scroll (ssd1306_handle_t *handle, uint8_t start_page_addr, uint8_t end_page_addr, uint8_t rows, ssd1306_scroll_frame_t frames)
	set the vertical right horizontal scroll
uint8_t	ssd1306_set_vertical_left_horizontal_scroll (ssd1306_handle_t *handle, uint8_t start_page_addr, uint8_t end_page_addr, uint8_t rows, ssd1306_scroll_frame_t frames)
	set the vertical left horizontal scroll
uint8_t	ssd1306_deactivate_scroll (ssd1306_handle_t *handle)
	deactivate the scroll
uint8_t	ssd1306_activate_scroll (ssd1306_handle_t *handle)
	activate the scroll
uint8_t	ssd1306_set_display_start_line (ssd1306_handle_t *handle, uint8_t l)
	set the display start line
uint8_t	ssd1306_set_contrast (ssd1306_handle_t *handle, uint8_t contrast)
	set the display contrast
uint8_t	ssd1306_set_charge_pump (ssd1306_handle_t *handle, ssd1306_charge_pump_t enable)
	enable or disable the charge pump
uint8_t	ssd1306_set_segment_remap (ssd1306_handle_t *handle, ssd1306_segment_column_remap_t remap)
	set the segment remap
uint8_t	ssd1306_set_vertical_scroll_area (ssd1306_handle_t *handle, uint8_t start_row, uint8_t end_row)
	set the vertical scroll area
uint8_t	ssd1306_set_entire_display (ssd1306_handle_t *handle, ssd1306_entire_display_t enable)
	enable or disable the entire display
uint8_t	ssd1306_set_display_mode (ssd1306_handle_t *handle, ssd1306_display_mode_t mode)
	set the display mode
uint8_t	ssd1306_set_multiplex_ratio (ssd1306_handle_t *handle, uint8_t multiplex)
	set the multiplex ratio
uint8_t	ssd1306_set_display (ssd1306_handle_t *handle, ssd1306_display_t on_off)
	enable or disable the display
uint8_t	ssd1306_set_page_address (ssd1306_handle_t *handle, uint8_t addr)
	set the page address
uint8_t	ssd1306_set_scan_direction (ssd1306_handle_t *handle, ssd1306_scan_direction_t dir)
	set the scan direction
uint8_t	ssd1306_set_display_offset (ssd1306_handle_t *handle, uint8_t offset)
	set the display offset
uint8_t	ssd1306_set_display_clock (ssd1306_handle_t *handle, uint8_t oscillator_frequency, uint8_t clock_divide)
	set the display clock
uint8_t	ssd1306_set_zoom_in (ssd1306_handle_t *handle, ssd1306_zoom_in_t zoom)
	set the display zoom in
uint8_t	ssd1306_set_precharge_period (ssd1306_handle_t *handle, uint8_t phase1_period, uint8_t phase2_period)
	set the pre charge period
uint8_t	ssd1306_set_com_pins_hardware_conf (ssd1306_handle_t *handle, ssd1306_pin_conf_t conf, ssd1306_left_right_remap_t remap)
	set the hardware com pins
uint8_t	ssd1306_set_deselect_level (ssd1306_handle_t *handle, ssd1306_deselect_level_t level)
	set the deselect level
uint8_t	ssd1306_write_cmd (ssd1306_handle_t handle, uint8_t buf, uint8_t len)
	write the register command
uint8_t	ssd1306_write_data (ssd1306_handle_t handle, uint8_t buf, uint8_t len)
	write the register data

Detailed Description

driver ssd1306 header file

The MIT License (MIT)

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Version: 2.0.0

Author: Shifeng Li

Date: 2021-03-30

history

Date	Version	Author	Description
2021/03/30	2.0	Shifeng Li	format the code
2020/12/10	1.0	Shifeng Li	first upload

Definition in file driver_ssd1306.h.

Data Structures

Macros

Typedefs

Enumerations

Functions

Detailed Description

history