esp_components/zh_160x_i2c
1
1
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Compare commits

base: esp_components:f1ce1febc85a06a6c19dcc0ff90d339a06c5e66c
Branches Tags
esp_components:main esp_components:dev
esp_components:v4.0.0 esp_components:v3.0.1 esp_components:v3.0.0 esp_components:v2.0.0 esp_components:v1.0.2 esp_components:v1.0.1 esp_components:v1.0.0
...
compare: esp_components:c7f8a0f449d879cfed5771ea8286c0174e7b3b29
Branches Tags
esp_components:dev esp_components:main
esp_components:v4.0.0 esp_components:v3.0.1 esp_components:v3.0.0 esp_components:v2.0.0 esp_components:v1.0.2 esp_components:v1.0.1 esp_components:v1.0.0

4 Commits
f1ce1febc8 ... c7f8a0f449

Author SHA1 Message Date
Alexey Zholtikov
c7f8a0f449 refactor: refactored by pvs-studio 2025-12-28 22:13:29 +03:00
Alexey Zholtikov
41c706d4bb doc: updated example 2025-12-28 22:02:47 +03:00
Alexey Zholtikov
dc1f2ed526 perf: updated error checks 2025-12-28 22:00:15 +03:00
Alexey Zholtikov
f7ba65e55c feat!: removed esp8266 support 2025-12-28 20:58:35 +03:00
6 changed files with 152 additions and 135 deletions
Expand all files Collapse all files

0
ds/Liquid crystal display module 1602A.pdf → 1602A datasheet.pdf
View File

0
ds/Liquid crystal display module 1604A.pdf → 1604A datasheet.pdf
View File

57
README.md
View File

@@ -1,9 +1,12 @@
# ESP32 ESP-IDF and ESP8266 RTOS SDK component for liquid crystal display module 1602(4)A via I2C connection (PCF8574) # ESP32 ESP-IDF component for liquid crystal display module 1602(4)A via I2C connection (PCF8574(A))
## Tested on ## Tested on
1. [ESP8266 RTOS_SDK v3.4](https://docs.espressif.com/projects/esp8266-rtos-sdk/en/latest/index.html#) 1. [ESP32 ESP-IDF v5.5.1](https://docs.espressif.com/projects/esp-idf/en/v5.5.1/esp32/index.html)
2. [ESP32 ESP-IDF v5.4](https://docs.espressif.com/projects/esp-idf/en/release-v5.4/esp32/index.html)
## SAST Tools
[PVS-Studio](https://pvs-studio.com/pvs-studio/?utm_source=website&utm_medium=github&utm_campaign=open_source) - static analyzer for C, C++, C#, and Java code.
## Features ## Features
@@ -51,48 +54,29 @@ One LCD on bus:
#define I2C_PORT (I2C_NUM_MAX - 1) #define I2C_PORT (I2C_NUM_MAX - 1)
#ifndef CONFIG_IDF_TARGET_ESP8266
i2c_master_bus_handle_t i2c_bus_handle = NULL; i2c_master_bus_handle_t i2c_bus_handle = NULL;
#endif
zh_pcf8574_handle_t lcd_160x_handle = {0}; zh_pcf8574_handle_t lcd_160x_handle = {0};
void app_main(void) void app_main(void)
{ {
esp_log_level_set("zh_160x_i2c", ESP_LOG_NONE); // For ESP8266 first enable "Component config -> Log output -> Enable log set level" via menuconfig. esp_log_level_set("zh_160x_i2c", ESP_LOG_ERROR);
esp_log_level_set("zh_pcf8574", ESP_LOG_NONE); // For ESP8266 first enable "Component config -> Log output -> Enable log set level" via menuconfig. esp_log_level_set("zh_pcf8574", ESP_LOG_ERROR);
esp_log_level_set("zh_vector", ESP_LOG_NONE); // For ESP8266 first enable "Component config -> Log output -> Enable log set level" via menuconfig. esp_log_level_set("zh_vector", ESP_LOG_ERROR);
#ifdef CONFIG_IDF_TARGET_ESP8266
i2c_config_t i2c_config = {
.mode = I2C_MODE_MASTER,
.sda_io_num = GPIO_NUM_4, // In accordance with used chip.
.sda_pullup_en = GPIO_PULLUP_ENABLE,
.scl_io_num = GPIO_NUM_5, // In accordance with used chip.
.scl_pullup_en = GPIO_PULLUP_ENABLE,
};
i2c_driver_install(I2C_PORT, i2c_config.mode);
i2c_param_config(I2C_PORT, &i2c_config);
#else
i2c_master_bus_config_t i2c_bus_config = { i2c_master_bus_config_t i2c_bus_config = {
.clk_source = I2C_CLK_SRC_DEFAULT, .clk_source = I2C_CLK_SRC_DEFAULT,
.i2c_port = I2C_PORT, .i2c_port = I2C_PORT,
.scl_io_num = GPIO_NUM_22, // In accordance with used chip. .scl_io_num = GPIO_NUM_22,
.sda_io_num = GPIO_NUM_21, // In accordance with used chip. .sda_io_num = GPIO_NUM_21,
.glitch_ignore_cnt = 7, .glitch_ignore_cnt = 7,
.flags.enable_internal_pullup = true, .flags.enable_internal_pullup = true,
}; };
i2c_new_master_bus(&i2c_bus_config, &i2c_bus_handle); i2c_new_master_bus(&i2c_bus_config, &i2c_bus_handle);
#endif zh_pcf8574_init_config_t config = ZH_PCF8574_INIT_CONFIG_DEFAULT();
zh_pcf8574_init_config_t pcf8574_init_config = ZH_PCF8574_INIT_CONFIG_DEFAULT(); config.i2c_handle = i2c_bus_handle;
#ifdef CONFIG_IDF_TARGET_ESP8266 config.i2c_address = 0x27;
pcf8574_init_config.i2c_port = I2C_PORT; zh_pcf8574_init(&config, &lcd_160x_handle);
#else zh_160x_init(&lcd_160x_handle, ZH_LCD_16X2);
pcf8574_init_config.i2c_handle = i2c_bus_handle;
#endif
pcf8574_init_config.i2c_address = 0x27;
zh_pcf8574_init(&pcf8574_init_config, &lcd_160x_handle);
zh_160x_init(&lcd_160x_handle, ZH_LCD_16X2); // For LCD 16X2.
// zh_160x_init(&lcd_160x_handle, ZH_LCD_16X4); // For LCD 16X4.
for (;;) for (;;)
{ {
zh_160x_set_cursor(&lcd_160x_handle, 0, 0); zh_160x_set_cursor(&lcd_160x_handle, 0, 0);
@@ -100,17 +84,14 @@ void app_main(void)
zh_160x_set_cursor(&lcd_160x_handle, 1, 0); zh_160x_set_cursor(&lcd_160x_handle, 1, 0);
zh_160x_print_char(&lcd_160x_handle, "Hello World!"); zh_160x_print_char(&lcd_160x_handle, "Hello World!");
vTaskDelay(5000 / portTICK_PERIOD_MS); vTaskDelay(5000 / portTICK_PERIOD_MS);
zh_160x_set_cursor(&lcd_160x_handle, 0, 0); // For LCD 16X2. zh_160x_set_cursor(&lcd_160x_handle, 0, 0);
// zh_160x_set_cursor(&lcd_160x_handle, 2, 0); // For LCD 16X4.
zh_160x_print_char(&lcd_160x_handle, "Progress: "); zh_160x_print_char(&lcd_160x_handle, "Progress: ");
for (uint8_t i = 0; i <= 100; ++i) for (uint8_t i = 0; i <= 100; ++i)
{ {
zh_160x_set_cursor(&lcd_160x_handle, 0, 10); // For LCD 16X2. zh_160x_set_cursor(&lcd_160x_handle, 0, 10);
// zh_160x_set_cursor(&lcd_160x_handle, 2, 10); // For LCD 16X4.
zh_160x_print_int(&lcd_160x_handle, i); zh_160x_print_int(&lcd_160x_handle, i);
zh_160x_print_char(&lcd_160x_handle, "%"); zh_160x_print_char(&lcd_160x_handle, "%");
zh_160x_print_progress_bar(&lcd_160x_handle, 1, i); // For LCD 16X2. zh_160x_print_progress_bar(&lcd_160x_handle, 1, i);
// zh_160x_print_progress_bar(&lcd_160x_handle, 3, i); // For LCD 16X4.
vTaskDelay(100 / portTICK_PERIOD_MS); vTaskDelay(100 / portTICK_PERIOD_MS);
} }
vTaskDelay(5000 / portTICK_PERIOD_MS); vTaskDelay(5000 / portTICK_PERIOD_MS);

0
component.mk
View File

2
version.txt
View File

@@ -1 +1 @@
3.0.1 4.0.0

228
zh_160x_i2c.c
View File

@@ -2,174 +2,210 @@
static const char *TAG = "zh_160x_i2c"; static const char *TAG = "zh_160x_i2c";
#define ZH_160X_I2C_LOGI(msg, ...) ESP_LOGI(TAG, msg, ##__VA_ARGS__) #define ZH_LOGI(msg, ...) ESP_LOGI(TAG, msg, ##__VA_ARGS__)
#define ZH_160X_I2C_LOGW(msg, ...) ESP_LOGW(TAG, msg, ##__VA_ARGS__) #define ZH_LOGE(msg, err, ...) ESP_LOGE(TAG, "[%s:%d:%s] " msg, __FILE__, __LINE__, esp_err_to_name(err), ##__VA_ARGS__)
#define ZH_160X_I2C_LOGE(msg, ...) ESP_LOGE(TAG, msg, ##__VA_ARGS__)
#define ZH_160X_I2C_LOGE_ERR(msg, err, ...) ESP_LOGE(TAG, "[%s:%d:%s] " msg, __FILE__, __LINE__, esp_err_to_name(err), ##__VA_ARGS__)
#define ZH_160X_I2C_CHECK(cond, err, msg, ...) \ #define ZH_ERROR_CHECK(cond, err, cleanup, msg, ...) \
if (!(cond)) \ if (!(cond)) \
{ \ { \
ZH_160X_I2C_LOGE_ERR(msg, err); \ ZH_LOGE(msg, err, ##__VA_ARGS__); \
return err; \ cleanup; \
return err; \
} }
#ifdef CONFIG_IDF_TARGET_ESP8266 static esp_err_t _zh_160x_lcd_init(zh_pcf8574_handle_t *handle);
#define esp_delay_us(x) os_delay_us(x) static esp_err_t _zh_160x_send_command(zh_pcf8574_handle_t *handle, uint8_t command);
#else static esp_err_t _zh_160x_send_data(zh_pcf8574_handle_t *handle, uint8_t data);
#define esp_delay_us(x) esp_rom_delay_us(x) static esp_err_t _zh_160x_pulse(zh_pcf8574_handle_t *handle);
#endif
#define LCD_160X_PULSE \
zh_pcf8574_write_gpio(handle, 2, true); \
esp_delay_us(500); \
zh_pcf8574_write_gpio(handle, 2, false); \
esp_delay_us(500);
static void _zh_160x_lcd_init(zh_pcf8574_handle_t *handle);
static void _zh_160x_send_command(zh_pcf8574_handle_t *handle, uint8_t command);
static void _zh_160x_send_data(zh_pcf8574_handle_t *handle, uint8_t data);
esp_err_t zh_160x_init(zh_pcf8574_handle_t *handle, bool size) esp_err_t zh_160x_init(zh_pcf8574_handle_t *handle, bool size)
{ {
ZH_160X_I2C_LOGI("160X initialization started."); ZH_LOGI("160X initialization started.");
ZH_160X_I2C_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, "160X initialization failed. Invalid argument."); ZH_ERROR_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, NULL, "160X initialization failed. Invalid argument.");
ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X initialization failed. PCF8574 not initialized."); ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, NULL, "160X initialization failed. PCF8574 not initialized.");
handle->system = heap_caps_calloc(1, sizeof(uint8_t), MALLOC_CAP_8BIT); handle->system = heap_caps_calloc(1, sizeof(uint8_t), MALLOC_CAP_8BIT);
ZH_160X_I2C_CHECK(handle->system != NULL, ESP_ERR_INVALID_ARG, "160X initialization failed. Memory allocation fail."); ZH_ERROR_CHECK(handle->system != NULL, ESP_ERR_INVALID_ARG, NULL, "160X initialization failed. Memory allocation fail.");
*(uint8_t *)handle->system = size; *(uint8_t *)handle->system = size;
_zh_160x_lcd_init(handle); esp_err_t err = _zh_160x_lcd_init(handle);
ZH_160X_I2C_LOGI("160X initialization completed successfully."); ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X initialization failed. PCF8574 error.");
ZH_LOGI("160X initialization completed successfully.");
return ESP_OK; return ESP_OK;
} }
esp_err_t zh_160x_lcd_clear(zh_pcf8574_handle_t *handle) esp_err_t zh_160x_lcd_clear(zh_pcf8574_handle_t *handle)
{ {
ZH_160X_I2C_LOGI("160X display cleaning started."); ZH_LOGI("160X display cleaning started.");
ZH_160X_I2C_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, "160X display cleaning failed. Invalid argument."); ZH_ERROR_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, NULL, "160X display cleaning failed. Invalid argument.");
ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X display cleaning failed. PCF8574 not initialized."); ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, NULL, "160X display cleaning failed. PCF8574 not initialized.");
_zh_160x_send_command(handle, 0x01); esp_err_t err = _zh_160x_send_command(handle, 0x01);
ZH_160X_I2C_LOGI("160X display cleaning completed successfully."); ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X display cleaning failed. PCF8574 error.");
ZH_LOGI("160X display cleaning completed successfully.");
return ESP_OK; return ESP_OK;
} }
esp_err_t zh_160x_set_cursor(zh_pcf8574_handle_t *handle, uint8_t row, uint8_t col) esp_err_t zh_160x_set_cursor(zh_pcf8574_handle_t *handle, uint8_t row, uint8_t col)
{ {
ZH_160X_I2C_LOGI("160X set cursor started."); ZH_LOGI("160X set cursor started.");
ZH_160X_I2C_CHECK(row < ((*(uint8_t *)handle->system == ZH_LCD_16X2) ? 2 : 4) && col < 16 && handle != NULL, ESP_ERR_INVALID_ARG, "160X set cursor failed. Invalid argument."); ZH_ERROR_CHECK(handle != NULL && row < ((*(uint8_t *)handle->system == ZH_LCD_16X2) ? 2 : 4) && col < 16, ESP_ERR_INVALID_ARG, NULL, "160X set cursor failed. Invalid argument.");
ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X set cursor failed. PCF8574 not initialized."); ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, NULL, "160X set cursor failed. PCF8574 not initialized.");
_zh_160x_send_command(handle, 0x80 | ((row == 0) ? col : (row == 1) ? (0x40 + col) esp_err_t err = _zh_160x_send_command(handle, 0x80 | ((row == 0) ? col : (row == 1) ? (0x40 + col)
: (row == 2) ? (0x10 + col) : (row == 2) ? (0x10 + col)
: (0x50 + col))); : (0x50 + col)));
ZH_160X_I2C_LOGI("160X set cursor completed successfully."); ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X set cursor failed. PCF8574 error.");
ZH_LOGI("160X set cursor completed successfully.");
return ESP_OK; return ESP_OK;
} }
esp_err_t zh_160x_print_char(zh_pcf8574_handle_t *handle, const char *str) esp_err_t zh_160x_print_char(zh_pcf8574_handle_t *handle, const char *str)
{ {
ZH_160X_I2C_LOGI("160X print char started."); ZH_LOGI("160X print char started.");
ZH_160X_I2C_CHECK(str != NULL && handle != NULL, ESP_ERR_INVALID_ARG, "160X print char failed. Invalid argument."); ZH_ERROR_CHECK(str != NULL && handle != NULL, ESP_ERR_INVALID_ARG, NULL, "160X print char failed. Invalid argument.");
ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X print char failed. PCF8574 not initialized."); ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, NULL, "160X print char failed. PCF8574 not initialized.");
while (*str != 0) while (*str != 0)
{ {
_zh_160x_send_data(handle, (uint8_t)*str++); esp_err_t err = _zh_160x_send_data(handle, (uint8_t)*str++);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X print char failed. PCF8574 error.");
} }
ZH_160X_I2C_LOGI("160X print char completed successfully."); ZH_LOGI("160X print char completed successfully.");
return ESP_OK; return ESP_OK;
} }
esp_err_t zh_160x_print_int(zh_pcf8574_handle_t *handle, int num) esp_err_t zh_160x_print_int(zh_pcf8574_handle_t *handle, int num)
{ {
ZH_160X_I2C_LOGI("160X print int started."); ZH_LOGI("160X print int started.");
ZH_160X_I2C_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, "160X print int failed. Invalid argument."); ZH_ERROR_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, NULL, "160X print int failed. Invalid argument.");
ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X print int failed. PCF8574 not initialized."); ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, NULL, "160X print int failed. PCF8574 not initialized.");
char buffer[12]; char buffer[12];
sprintf(buffer, "%d", num); sprintf(buffer, "%d", num);
zh_160x_print_char(handle, buffer); esp_err_t err = zh_160x_print_char(handle, buffer);
ZH_160X_I2C_LOGI("160X print int completed successfully."); ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X print int failed. PCF8574 error.");
ZH_LOGI("160X print int completed successfully.");
return ESP_OK; return ESP_OK;
} }
esp_err_t zh_160x_print_float(zh_pcf8574_handle_t *handle, float num, uint8_t precision) esp_err_t zh_160x_print_float(zh_pcf8574_handle_t *handle, float num, uint8_t precision)
{ {
ZH_160X_I2C_LOGI("160X print float started."); ZH_LOGI("160X print float started.");
ZH_160X_I2C_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, "160X print float failed. Invalid argument."); ZH_ERROR_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, NULL, "160X print float failed. Invalid argument.");
ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X print float failed. PCF8574 not initialized."); ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, NULL, "160X print float failed. PCF8574 not initialized.");
char buffer[16]; char buffer[16];
sprintf(buffer, "%.*f", precision, num); sprintf(buffer, "%.*f", precision, num);
zh_160x_print_char(handle, buffer); esp_err_t err = zh_160x_print_char(handle, buffer);
ZH_160X_I2C_LOGI("160X print float completed successfully."); ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X print float failed. PCF8574 error.");
ZH_LOGI("160X print float completed successfully.");
return ESP_OK; return ESP_OK;
} }
esp_err_t zh_160x_print_progress_bar(zh_pcf8574_handle_t *handle, uint8_t row, uint8_t progress) esp_err_t zh_160x_print_progress_bar(zh_pcf8574_handle_t *handle, uint8_t row, uint8_t progress)
{ {
ZH_160X_I2C_LOGI("160X print progress bar started."); ZH_LOGI("160X print progress bar started.");
ZH_160X_I2C_CHECK(row < ((*(uint8_t *)handle->system == ZH_LCD_16X2) ? 2 : 4) && progress <= 100 && handle != NULL, ESP_ERR_INVALID_ARG, "160X print progress bar failed. Invalid argument."); ZH_ERROR_CHECK(handle != NULL && row < ((*(uint8_t *)handle->system == ZH_LCD_16X2) ? 2 : 4) && progress <= 100, ESP_ERR_INVALID_ARG, NULL, "160X print progress bar failed. Invalid argument.");
ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X print progress bar failed. PCF8574 not initialized."); ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, NULL, "160X print progress bar failed. PCF8574 not initialized.");
uint8_t blocks = (progress * 16) / 100; uint8_t blocks = (progress * 16) / 100;
zh_160x_set_cursor(handle, row, 0); esp_err_t err = zh_160x_set_cursor(handle, row, 0);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X print progress bar failed. PCF8574 error.");
for (uint8_t i = 0; i < 16; ++i) for (uint8_t i = 0; i < 16; ++i)
{ {
if (i < blocks) if (i < blocks)
{ {
zh_160x_print_char(handle, "\xFF"); err = zh_160x_print_char(handle, "\xFF");
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X print progress bar failed. PCF8574 error.");
} }
else else
{ {
zh_160x_print_char(handle, " "); err = zh_160x_print_char(handle, " ");
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X print progress bar failed. PCF8574 error.");
} }
} }
ZH_160X_I2C_LOGI("160X print progress bar completed successfully."); ZH_LOGI("160X print progress bar completed successfully.");
return ESP_OK; return ESP_OK;
} }
esp_err_t zh_160x_clear_row(zh_pcf8574_handle_t *handle, uint8_t row) esp_err_t zh_160x_clear_row(zh_pcf8574_handle_t *handle, uint8_t row)
{ {
ZH_160X_I2C_LOGI("160X clear row started."); ZH_LOGI("160X clear row started.");
ZH_160X_I2C_CHECK(row < ((*(uint8_t *)handle->system == ZH_LCD_16X2) ? 2 : 4) && handle != NULL, ESP_ERR_INVALID_ARG, "160X clear row failed. Invalid argument."); ZH_ERROR_CHECK(handle != NULL && row < ((*(uint8_t *)handle->system == ZH_LCD_16X2) ? 2 : 4), ESP_ERR_INVALID_ARG, NULL, "160X clear row failed. Invalid argument.");
ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X clear row failed. PCF8574 not initialized."); ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, NULL, "160X clear row failed. PCF8574 not initialized.");
zh_160x_set_cursor(handle, row, 0); esp_err_t err = zh_160x_set_cursor(handle, row, 0);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X clear row failed. PCF8574 error.");
for (uint8_t i = 0; i < 16; ++i) for (uint8_t i = 0; i < 16; ++i)
{ {
zh_160x_print_char(handle, " "); err = zh_160x_print_char(handle, " ");
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X clear row failed. PCF8574 error.");
} }
zh_160x_set_cursor(handle, row, 0); err = zh_160x_set_cursor(handle, row, 0);
ZH_160X_I2C_LOGI("160X clear row completed successfully."); ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "160X clear row failed. PCF8574 error.");
ZH_LOGI("160X clear row completed successfully.");
return ESP_OK; return ESP_OK;
} }
static void _zh_160x_lcd_init(zh_pcf8574_handle_t *handle) static esp_err_t _zh_160x_lcd_init(zh_pcf8574_handle_t *handle)
{ {
vTaskDelay(20 / portTICK_PERIOD_MS); vTaskDelay(20 / portTICK_PERIOD_MS);
zh_pcf8574_write(handle, 0x30); esp_err_t err = zh_pcf8574_write(handle, 0x30);
LCD_160X_PULSE; ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
zh_pcf8574_write(handle, 0x30); err = _zh_160x_pulse(handle);
LCD_160X_PULSE; ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
zh_pcf8574_write(handle, 0x30); err = zh_pcf8574_write(handle, 0x30);
LCD_160X_PULSE; ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
zh_pcf8574_write(handle, 0x20); err = _zh_160x_pulse(handle);
LCD_160X_PULSE; ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
_zh_160x_send_command(handle, 0x28); err = zh_pcf8574_write(handle, 0x30);
_zh_160x_send_command(handle, 0x28); ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
_zh_160x_send_command(handle, 0x28); err = _zh_160x_pulse(handle);
_zh_160x_send_command(handle, 0x0C); ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
_zh_160x_send_command(handle, 0x01); err = zh_pcf8574_write(handle, 0x20);
_zh_160x_send_command(handle, 0x06); ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = _zh_160x_pulse(handle);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = _zh_160x_send_command(handle, 0x28);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = _zh_160x_send_command(handle, 0x28);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = _zh_160x_send_command(handle, 0x28);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = _zh_160x_send_command(handle, 0x0C);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = _zh_160x_send_command(handle, 0x01);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = _zh_160x_send_command(handle, 0x06);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
return ESP_OK;
} }
static void _zh_160x_send_command(zh_pcf8574_handle_t *handle, uint8_t command) static esp_err_t _zh_160x_send_command(zh_pcf8574_handle_t *handle, uint8_t command)
{ {
zh_pcf8574_write(handle, (command & 0xF0) | 0x08); esp_err_t err = zh_pcf8574_write(handle, (command & 0xF0) | 0x08);
LCD_160X_PULSE; ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
zh_pcf8574_write(handle, (command << 4) | 0x08); err = _zh_160x_pulse(handle);
LCD_160X_PULSE; ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = zh_pcf8574_write(handle, (command << 4) | 0x08);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = _zh_160x_pulse(handle);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
return ESP_OK;
} }
static void _zh_160x_send_data(zh_pcf8574_handle_t *handle, uint8_t data) static esp_err_t _zh_160x_send_data(zh_pcf8574_handle_t *handle, uint8_t data)
{ {
zh_pcf8574_write(handle, (data & 0xF0) | 0x09); esp_err_t err = zh_pcf8574_write(handle, (data & 0xF0) | 0x09);
LCD_160X_PULSE; ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
zh_pcf8574_write(handle, (data << 4) | 0x09); err = _zh_160x_pulse(handle);
LCD_160X_PULSE; ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = zh_pcf8574_write(handle, (data << 4) | 0x09);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
err = _zh_160x_pulse(handle);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
return ESP_OK;
}
static esp_err_t _zh_160x_pulse(zh_pcf8574_handle_t *handle)
{
esp_err_t err = zh_pcf8574_write_gpio(handle, 2, true);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
vTaskDelay(1 / portTICK_PERIOD_MS);
err = zh_pcf8574_write_gpio(handle, 2, false);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "PCF8574 error.");
vTaskDelay(1 / portTICK_PERIOD_MS);
return ESP_OK;
} }