4 Commits

Author SHA1 Message Date
72e80282a9 fix: pulse duration 2025-11-30 22:37:52 +03:00
faec97f6a6 doc: changed example 2025-06-15 14:14:27 +03:00
168315bb26 doc: changed function description 2025-06-14 17:54:31 +03:00
467030c97f feat!: support new version of zh_pcf8574 2025-06-07 09:22:10 +03:00
4 changed files with 13 additions and 11 deletions

View File

@@ -96,7 +96,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

@@ -33,7 +33,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 +75,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 +86,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 @@
2.0.0 3.0.1

View File

@@ -22,9 +22,9 @@ static const char *TAG = "zh_160x_i2c";
#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_delay_us(500); \
zh_pcf8574_write_gpio(handle, 2, false); \ zh_pcf8574_write_gpio(handle, 2, false); \
esp_delay_us(400); esp_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);
@@ -35,7 +35,9 @@ esp_err_t zh_160x_init(zh_pcf8574_handle_t *handle, bool size)
ZH_160X_I2C_LOGI("160X initialization started."); ZH_160X_I2C_LOGI("160X initialization started.");
ZH_160X_I2C_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, "160X initialization failed. Invalid argument."); ZH_160X_I2C_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, "160X initialization failed. Invalid argument.");
ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X initialization failed. PCF8574 not initialized."); ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X initialization failed. PCF8574 not initialized.");
handle->system = size; 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.");
*(uint8_t *)handle->system = size;
_zh_160x_lcd_init(handle); _zh_160x_lcd_init(handle);
ZH_160X_I2C_LOGI("160X initialization completed successfully."); ZH_160X_I2C_LOGI("160X initialization completed successfully.");
return ESP_OK; return ESP_OK;
@@ -54,7 +56,7 @@ esp_err_t zh_160x_lcd_clear(zh_pcf8574_handle_t *handle)
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_160X_I2C_LOGI("160X set cursor started.");
ZH_160X_I2C_CHECK(row < ((handle->system == ZH_LCD_16X2) ? 2 : 4) && col < 16 && handle != NULL, ESP_ERR_INVALID_ARG, "160X set cursor failed. Invalid argument."); 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_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X set cursor failed. PCF8574 not initialized."); ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X set cursor failed. PCF8574 not initialized.");
_zh_160x_send_command(handle, 0x80 | ((row == 0) ? col : (row == 1) ? (0x40 + col) _zh_160x_send_command(handle, 0x80 | ((row == 0) ? col : (row == 1) ? (0x40 + col)
: (row == 2) ? (0x10 + col) : (row == 2) ? (0x10 + col)
@@ -103,7 +105,7 @@ esp_err_t zh_160x_print_float(zh_pcf8574_handle_t *handle, float num, uint8_t pr
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_160X_I2C_LOGI("160X print progress bar started.");
ZH_160X_I2C_CHECK(row < ((handle->system == ZH_LCD_16X2) ? 2 : 4) && progress <= 100 && handle != NULL, ESP_ERR_INVALID_ARG, "160X print progress bar failed. Invalid argument."); 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_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X print progress bar failed. PCF8574 not initialized."); ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "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); zh_160x_set_cursor(handle, row, 0);
@@ -125,7 +127,7 @@ esp_err_t zh_160x_print_progress_bar(zh_pcf8574_handle_t *handle, uint8_t row, u
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_160X_I2C_LOGI("160X clear row started.");
ZH_160X_I2C_CHECK(row < ((handle->system == ZH_LCD_16X2) ? 2 : 4) && handle != NULL, ESP_ERR_INVALID_ARG, "160X clear row failed. Invalid argument."); 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_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X clear row failed. PCF8574 not initialized."); ZH_160X_I2C_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, "160X clear row failed. PCF8574 not initialized.");
zh_160x_set_cursor(handle, row, 0); zh_160x_set_cursor(handle, row, 0);
for (uint8_t i = 0; i < 16; ++i) for (uint8_t i = 0; i < 16; ++i)