OLED Software/Hardware TWI (I2C) Control Macros

Macros for abstracting OLED TWI (I2C) communication interface. More...

Macros
#define	TWI_SOFT_HEADER   _STR(../hal/OLED_HAL_PLATFORM/twi_soft/twi_soft.h)
#define	OLED_START(MODE)
#define	OLED_STOP()
#define	OLED_DATA()

Detailed Description

Macros for abstracting OLED TWI (I2C) communication interface.

These macros provide a unified interface for starting, stopping, and sending data over the TWI bus to the OLED display, abstracting the use of either software-based or hardware-based TWI implementations.

Note

When OLED_USE_SOFT_TWI is defined, the macros use software TWI functions; otherwise, hardware TWI is used.

Individual macros:

• OLED_START(MODE): Initiates a TWI start condition and sends the OLED’s I2C address with the specified mode (MODE indicates read or write) to begin communication.
• OLED_STOP(): Sends a TWI stop condition to end communication and then inserts a delay (OLED_IDLE_TIME_US) to allow the OLED sufficient processing time before the next communication.
• OLED_DATA(): Sends the control byte indicating that the following bytes will be data (pixel or graphic data) to the OLED display, rather than commands.

This abstraction simplifies OLED communication by hiding the underlying method, enabling easy switching between hardware and software TWI implementations without changing higher-level code.

Macro Definition Documentation

OLED_DATA

#define OLED_DATA

(

)

Value:

(twi_soft_set(OLED_CONTROL_DATA))

OLED_START

#define OLED_START

(

MODE

)

Value:

{ twi_soft_start(); twi_soft_address(OLED_ADDRESS, MODE); }

OLED_STOP

#define OLED_STOP

(

)

Value:

{ twi_soft_stop(); _delay_us(OLED_IDLE_TIME_US); }

TWI_SOFT_HEADER

#define TWI_SOFT_HEADER   _STR(../hal/OLED_HAL_PLATFORM/twi_soft/twi_soft.h)