5 Commits

7 changed files with 22 additions and 21 deletions

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
@@ -59,9 +62,9 @@ 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); // For ESP8266 first enable "Component config -> Log output -> Enable log set level" via menuconfig.
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); // For ESP8266 first enable "Component config -> Log output -> Enable log set level" via menuconfig.
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); // For ESP8266 first enable "Component config -> Log output -> Enable log set level" via menuconfig.
#ifdef CONFIG_IDF_TARGET_ESP8266 #ifdef CONFIG_IDF_TARGET_ESP8266
i2c_config_t i2c_config = { i2c_config_t i2c_config = {
.mode = I2C_MODE_MASTER, .mode = I2C_MODE_MASTER,
@@ -96,7 +99,7 @@ void app_main(void)
for (;;) for (;;)
{ {
zh_160x_set_cursor(&lcd_160x_handle, 0, 0); zh_160x_set_cursor(&lcd_160x_handle, 0, 0);
zh_160x_print_char(&lcd_160x_handle, "LCD 1602A"); zh_160x_print_char(&lcd_160x_handle, "LCD 160X");
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);

View File

View File

@@ -1,9 +1,13 @@
/**
* @file zh_160x_i2c.h
*/
#pragma once #pragma once
#include "zh_pcf8574.h" #include "zh_pcf8574.h"
#define ZH_LCD_16X2 1 #define ZH_LCD_16X2 1 /*!< LCD size 16x2. */
#define ZH_LCD_16X4 0 #define ZH_LCD_16X4 0 /*!< LCD size 16x3. */
#ifdef __cplusplus #ifdef __cplusplus
extern "C" extern "C"
@@ -33,7 +37,7 @@ extern "C"
* @brief Sets the cursor to a specific position on the LCD. * @brief Sets the cursor to a specific position on the LCD.
* *
* @param[in] handle Pointer to unique PCF8574 handle. * @param[in] handle Pointer to unique PCF8574 handle.
* @param[in] row The row number (0 or 1). * @param[in] row The row number.
* @param[in] col The column number (015). * @param[in] col The column number (015).
* *
* @return ESP_OK if success or an error code otherwise. * @return ESP_OK if success or an error code otherwise.
@@ -75,7 +79,7 @@ extern "C"
* @brief Displays a progress bar on a specific row of the LCD. * @brief Displays a progress bar on a specific row of the LCD.
* *
* @param[in] handle Pointer to unique PCF8574 handle. * @param[in] handle Pointer to unique PCF8574 handle.
* @param[in] row The row number (0 or 1). * @param[in] row The row number.
* @param[in] progress The progress percentage (0100). * @param[in] progress The progress percentage (0100).
* *
* @return ESP_OK if success or an error code otherwise. * @return ESP_OK if success or an error code otherwise.
@@ -86,7 +90,7 @@ extern "C"
* @brief Clears a specific row on the LCD. * @brief Clears a specific row on the LCD.
* *
* @param[in] handle Pointer to unique PCF8574 handle. * @param[in] handle Pointer to unique PCF8574 handle.
* @param[in] row The row number (0 or 1). * @param[in] row The row number.
* *
* @return ESP_OK if success or an error code otherwise. * @return ESP_OK if success or an error code otherwise.
*/ */

View File

@@ -1 +1 @@
3.0.0 4.0.0

View File

@@ -14,17 +14,11 @@ static const char *TAG = "zh_160x_i2c";
return err; \ return err; \
} }
#ifdef CONFIG_IDF_TARGET_ESP8266
#define esp_delay_us(x) os_delay_us(x)
#else
#define esp_delay_us(x) esp_rom_delay_us(x)
#endif
#define LCD_160X_PULSE \ #define LCD_160X_PULSE \
zh_pcf8574_write_gpio(handle, 2, true); \ zh_pcf8574_write_gpio(handle, 2, true); \
esp_delay_us(300); \ esp_rom_delay_us(500); \
zh_pcf8574_write_gpio(handle, 2, false); \ zh_pcf8574_write_gpio(handle, 2, false); \
esp_delay_us(400); esp_rom_delay_us(500);
static void _zh_160x_lcd_init(zh_pcf8574_handle_t *handle); 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_command(zh_pcf8574_handle_t *handle, uint8_t command);