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

feat:

Browse Source
This commit is contained in:
Alexey Zholtikov
2025-12-31 13:16:23 +03:00
parent 8534bb505a
commit 3620b54406
11 changed files with 666 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

0
.gitignore vendored Normal file → Executable file
View File

2
CMakeLists.txt Normal file → Executable file
View File

@@ -1 +1 @@
idf_component_register(SRCS "main.c" INCLUDE_DIRS "include")
idf_component_register(SRCS "zh_mcp23s17.c" INCLUDE_DIRS "include" REQUIRES driver esp_event zh_vector)

0
LICENSE Normal file → Executable file
View File

BIN
MCP23S17 datasheet.pdf Executable file
View File

Binary file not shown.

37
README.md Normal file → Executable file
View File

@@ -1,3 +1,36 @@
# esp_component_template
#include "zh_mcp23s17.h"
esp_component_template
#define SPI_HOST (SPI_HOST_MAX - 1)
spi_device_handle_t mcp23s17_handle = NULL;
// To speed up transfers, every SPI transfer sends a bunch of lines. This define specifies how many. More means more memory use,
// but less overhead for setting up / finishing transfers. Make sure 240 is dividable by this.
#define PARALLEL_LINES 16
void app_main(void)
{
esp_err_t ret;
spi_device_handle_t spi;
spi_bus_config_t buscfg = {
.miso_io_num = 25,
.mosi_io_num = 23,
.sclk_io_num = 19,
.quadwp_io_num = -1,
.quadhd_io_num = -1,
.max_transfer_sz = 16 * 320 * 2 + 8};
spi_device_interface_config_t devcfg = {
.clock_speed_hz = 10 * 1000 * 1000, // Clock out at 10 MHz
.mode = 0, // SPI mode 0
.spics_io_num = 22, // CS pin
.queue_size = 7, // We want to be able to queue 7 transactions at a time
// .pre_cb = lcd_spi_pre_transfer_callback, // Specify pre-transfer callback to handle D/C line
};
// Initialize the SPI bus
ret = spi_bus_initialize(SPI_HOST, &buscfg, SPI_DMA_CH_AUTO);
ESP_ERROR_CHECK(ret);
// Attach the LCD to the SPI bus
ret = spi_bus_add_device(SPI_HOST, &devcfg, &mcp23s17_handle);
ESP_ERROR_CHECK(ret);
}

0
component.mk
View File

0
include/main.h
View File

242
include/zh_mcp23s17.h Executable file
View File

@@ -0,0 +1,242 @@
/**
* @file zh_mcp23s17.h
*/
#pragma once
#include "esp_log.h"
#include "driver/gpio.h"
#include "driver/spi_master.h"
#include "freertos/FreeRTOS.h"
#include "freertos/task.h"
#include "esp_event.h"
#include "zh_vector.h"
#define ZH_MCP23S17_GPIO_OUTPUT false
#define ZH_MCP23S17_GPIO_INPUT true
#define ZH_MCP23S17_GPIO_LOW false
#define ZH_MCP23S17_GPIO_HIGH true
/**
* @brief MCP23S17 expander initial default values.
*/
#define ZH_MCP23S17_INIT_CONFIG_DEFAULT() \
{ \
.task_priority = 1, \
.stack_size = configMINIMAL_STACK_SIZE, \
.gpa0_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpa1_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpa2_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpa3_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpa4_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpa5_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpa6_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpa7_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpb0_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpb1_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpb2_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpb3_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpb4_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpb5_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpb6_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.gpb7_gpio_work_mode = ZH_MCP23S17_GPIO_OUTPUT, \
.cs_gpio = GPIO_NUM_MAX, \
.interrupt_gpio = GPIO_NUM_MAX}
#ifdef __cplusplus
extern "C"
{
#endif
extern TaskHandle_t zh_mcp23s17; /*!< Unique task handle. */
/**
* @brief Enumeration of MCP23S17 expander GPIO.
*/
typedef enum
{
ZH_MCP23S17_GPIO_NUM_GPA0 = 0,
ZH_MCP23S17_GPIO_NUM_GPA1,
ZH_MCP23S17_GPIO_NUM_GPA2,
ZH_MCP23S17_GPIO_NUM_GPA3,
ZH_MCP23S17_GPIO_NUM_GPA4,
ZH_MCP23S17_GPIO_NUM_GPA5,
ZH_MCP23S17_GPIO_NUM_GPA6,
ZH_MCP23S17_GPIO_NUM_GPA7,
ZH_MCP23S17_GPIO_NUM_GPB0,
ZH_MCP23S17_GPIO_NUM_GPB1,
ZH_MCP23S17_GPIO_NUM_GPB2,
ZH_MCP23S17_GPIO_NUM_GPB3,
ZH_MCP23S17_GPIO_NUM_GPB4,
ZH_MCP23S17_GPIO_NUM_GPB5,
ZH_MCP23S17_GPIO_NUM_GPB6,
ZH_MCP23S17_GPIO_NUM_GPB7,
ZH_MCP23S17_GPIO_NUM_MAX
} zh_mcp23s17_gpio_num_t;
/**
* @brief Structure for initial initialization of MCP23S17 expander.
*/
typedef struct
{
uint8_t task_priority; /*!< Task priority for the MCP23S17 expander isr processing. @note Minimum value is 1. */
uint16_t stack_size; /*!< Stack size for task for the MCP23S17 expander isr processing processing. @note The minimum size is configMINIMAL_STACK_SIZE. */
uint8_t cs_gpio; /*!< CS GPIO. */
bool gpa0_gpio_work_mode; /*!< Expander GPIO GPAO work mode. */
bool gpa1_gpio_work_mode; /*!< Expander GPIO GPA1 work mode. */
bool gpa2_gpio_work_mode; /*!< Expander GPIO GPA2 work mode. */
bool gpa3_gpio_work_mode; /*!< Expander GPIO GPA3 work mode. */
bool gpa4_gpio_work_mode; /*!< Expander GPIO GPA4 work mode. */
bool gpa5_gpio_work_mode; /*!< Expander GPIO GPA5 work mode. */
bool gpa6_gpio_work_mode; /*!< Expander GPIO GPA6 work mode. */
bool gpa7_gpio_work_mode; /*!< Expander GPIO GPA7 work mode. */
bool gpb0_gpio_work_mode; /*!< Expander GPIO GPBO work mode. */
bool gpb1_gpio_work_mode; /*!< Expander GPIO GPB1 work mode. */
bool gpb2_gpio_work_mode; /*!< Expander GPIO GPB2 work mode. */
bool gpb3_gpio_work_mode; /*!< Expander GPIO GPB3 work mode. */
bool gpb4_gpio_work_mode; /*!< Expander GPIO GPB4 work mode. */
bool gpb5_gpio_work_mode; /*!< Expander GPIO GPB5 work mode. */
bool gpb6_gpio_work_mode; /*!< Expander GPIO GPB6 work mode. */
bool gpb7_gpio_work_mode; /*!< Expander GPIO GPB7 work mode. */
uint8_t interrupt_gpio; /*!< Interrupt GPIO. @attention Must be same for all MCP23S17 expanders. */
uint8_t spi_host; /*!< SPI host. @attention Must be same for all MCP23S17 expanders. */
} zh_mcp23s17_init_config_t;
/**
* @brief MCP23S17 expander handle.
*/
typedef struct
{
uint8_t cs_gpio; /*!< CS GPIO. */
uint16_t gpio_work_mode; /*!< Expander GPIO's work mode. */
uint16_t gpio_status; /*!< Expander GPIO's status. */
bool is_initialized; /*!< Expander initialization flag. */
spi_device_handle_t spi_handle; /*!< Unique SPI device handle. */
void *system; /*!< System pointer for use in another components. */
} zh_mcp23s17_handle_t;
/**
* @brief Structure for error statistics storage.
*/
typedef struct
{
uint32_t spi_driver_error; /*!< Number of SPI driver error. */
uint32_t event_post_error; /*!< Number of event post error. */
uint32_t vector_error; /*!< Number of vector error. */
uint32_t queue_overflow_error; /*!< Number of queue overflow error. */
uint32_t min_stack_size; /*!< Minimum free stack size. */
} zh_mcp23s17_stats_t;
ESP_EVENT_DECLARE_BASE(ZH_MCP23S17);
/**
* @brief Structure for sending data to the event handler when cause an interrupt.
*
* @note Should be used with ZH_MCP23S17 event base.
*/
typedef struct
{
uint8_t cs_gpio; /*!< The CS GPIO of MCP23S17 expander that caused the interrupt. */
uint8_t gpio_number; /*!< The GPIO that caused the interrupt. */
bool gpio_level; /*!< The GPIO level that caused the interrupt. */
} zh_mcp23s17_event_on_isr_t;
/**
* @brief Initialize MCP23S17 expander.
*
* @param[in] config Pointer to MCP23S17 initialized configuration structure. Can point to a temporary variable.
* @param[out] handle Pointer to unique MCP23S17 handle.
*
* @attention SPI driver must be initialized first.
*
* @note Before initialize the expander recommend initialize zh_mcp23s17_init_config_t structure with default values.
*
* @code zh_mcp23s17_init_config_t config = ZH_MCP23S17_INIT_CONFIG_DEFAULT() @endcode
*
* @return ESP_OK if success or an error code otherwise.
*/
esp_err_t zh_mcp23s17_init(const zh_mcp23s17_init_config_t *config, zh_mcp23s17_handle_t *handle);
// /**
// * @brief Deinitialize PCF8574 expander.
// *
// * @param[in] handle Pointer to unique PCF8574 handle.
// *
// * @return ESP_OK if success or an error code otherwise.
// */
// esp_err_t zh_pcf8574_deinit(zh_pcf8574_handle_t *handle);
// /**
// * @brief Read PCF8574 all GPIO's status.
// *
// * @param[in] handle Pointer to unique PCF8574 handle.
// * @param[out] reg Pointer to GPIO's status.
// *
// * @note For input GPIO's status will be 1 (HIGH) always.
// *
// * @return ESP_OK if success or an error code otherwise.
// */
// esp_err_t zh_pcf8574_read(zh_pcf8574_handle_t *handle, uint8_t *reg);
// /**
// * @brief Set PCF8574 all GPIO's status.
// *
// * @param[in] handle Pointer to unique PCF8574 handle.
// * @param[in] reg GPIO's status.
// *
// * @attention Only the GPIO outputs are affected.
// *
// * @return ESP_OK if success or an error code otherwise.
// */
// esp_err_t zh_pcf8574_write(zh_pcf8574_handle_t *handle, uint8_t reg);
// /**
// * @brief Reset (set to initial) PCF8574 all GPIO's.
// *
// * @param[in] handle Pointer to unique PCF8574 handle.
// *
// * @return ESP_OK if success or an error code otherwise.
// */
// esp_err_t zh_pcf8574_reset(zh_pcf8574_handle_t *handle);
// /**
// * @brief Read PCF8574 GPIO status.
// *
// * @param[in] handle Pointer to unique PCF8574 handle.
// * @param[in] gpio GPIO number.
// * @param[out] status Pointer to GPIO status (true - HIGH, false - LOW).
// *
// * @note For input GPIO's status will be 1 (HIGH) always.
// *
// * @return ESP_OK if success or an error code otherwise.
// */
// esp_err_t zh_pcf8574_read_gpio(zh_pcf8574_handle_t *handle, ZH_MCP23S17_GPIO_num_t gpio, bool *status);
// /**
// * @brief Set PCF8574 GPIO status.
// *
// * @param[in] handle Pointer to unique PCF8574 handle.
// * @param[in] gpio GPIO number.
// * @param[in] status GPIO status (true - HIGH, false - LOW).
// *
// * @attention Only the GPIO output is affected.
// *
// * @return ESP_OK if success or an error code otherwise.
// */
// esp_err_t zh_pcf8574_write_gpio(zh_pcf8574_handle_t *handle, ZH_MCP23S17_GPIO_num_t gpio, bool status);
// /**
// * @brief Get error statistics.
// *
// * @return Pointer to the statistics structure.
// */
// const zh_pcf8574_stats_t *zh_pcf8574_get_stats(void);
// /**
// * @brief Reset error statistics.
// */
// void zh_pcf8574_reset_stats(void);
#ifdef __cplusplus
}
#endif

0
main.c
View File

1
version.txt Normal file → Executable file
View File

@@ -0,0 +1 @@
1.0.0

387
zh_mcp23s17.c Executable file
View File

@@ -0,0 +1,387 @@
#include "zh_mcp23s17.h"
static const char *TAG = "mcp23s17";
#define ZH_LOGI(msg, ...) ESP_LOGI(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_ERROR_CHECK(cond, err, cleanup, msg, ...) \
if (!(cond)) \
{ \
ZH_LOGE(msg, err, ##__VA_ARGS__); \
cleanup; \
return err; \
}
TaskHandle_t zh_mcp23s17 = NULL;
static SemaphoreHandle_t _interrupt_semaphore = NULL;
static uint8_t _interrupt_gpio = GPIO_NUM_MAX;
static uint8_t _spi_matrix[3] = {0};
static const uint8_t _gpio_matrix[8] = {0x01, 0x02, 0x04, 0x08, 0x10, 0x20, 0x40, 0x80};
static bool _is_prev_gpio_isr_service = false;
static zh_mcp23s17_stats_t _stats = {0};
static zh_vector_t _vector = {0};
static esp_err_t _zh_mcp23s17_validate_config(const zh_mcp23s17_init_config_t *config);
static esp_err_t _zh_mcp23s17_gpio_init(const zh_mcp23s17_init_config_t *config, zh_mcp23s17_handle_t *handle);
static esp_err_t _zh_mcp23s17_spi_init(const zh_mcp23s17_init_config_t *config, zh_mcp23s17_handle_t *handle);
static esp_err_t _zh_mcp23s17_resources_init(const zh_mcp23s17_init_config_t *config);
static esp_err_t _zh_mcp23s17_task_init(const zh_mcp23s17_init_config_t *config);
static void _zh_mcp23s17_isr_handler(void *arg);
static void _zh_mcp23s17_isr_processing_task(void *pvParameter);
static esp_err_t _zh_mcp23s17_read_register(zh_mcp23s17_handle_t *handle, uint16_t *reg);
static esp_err_t _zh_mcp23s17_write_register(zh_mcp23s17_handle_t *handle, uint16_t reg);
ESP_EVENT_DEFINE_BASE(ZH_MCP23S17);
esp_err_t zh_mcp23s17_init(const zh_mcp23s17_init_config_t *config, zh_mcp23s17_handle_t *handle)
{
ZH_LOGI("MCP23S17 initialization started.");
ZH_ERROR_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, NULL, "MCP23S17 initialization failed. Invalid argument.");
ZH_ERROR_CHECK(handle->is_initialized == false, ESP_ERR_INVALID_STATE, NULL, "MCP23S17 initialization failed. MCP23S17 is already initialized.");
esp_err_t err = _zh_mcp23s17_validate_config(config);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "MCP23S17 initialization failed. Initial configuration check failed.");
err = _zh_mcp23s17_i2c_init(config, handle);
ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "MCP23S17 initialization failed. Failed to add I2C device.");
// err = _zh_mcp23s17_write_register(handle, handle->gpio_work_mode);
// ZH_ERROR_CHECK(err == ESP_OK, err, i2c_master_bus_rm_device(handle->dev_handle), "MCP23S17 initialization failed. Failed extender initial GPIO setup.");
// if (config->interrupt_gpio < GPIO_NUM_MAX && handle->gpio_work_mode != 0)
// {
// err = _zh_mcp23s17_gpio_init(config, handle);
// ZH_ERROR_CHECK(err == ESP_OK, err, i2c_master_bus_rm_device(handle->dev_handle), "MCP23S17 initialization failed. Interrupt GPIO initialization failed.");
// err = _zh_mcp23s17_resources_init(config);
// if (_is_prev_gpio_isr_service == true)
// {
// ZH_ERROR_CHECK(err == ESP_OK, err, i2c_master_bus_rm_device(handle->dev_handle); gpio_isr_handler_remove((gpio_num_t)config->interrupt_gpio);
// gpio_reset_pin((gpio_num_t)config->interrupt_gpio); zh_vector_free(&_vector), "MCP23S17 initialization failed. Resources initialization failed.");
// }
// else
// {
// ZH_ERROR_CHECK(err == ESP_OK, err, i2c_master_bus_rm_device(handle->dev_handle); gpio_isr_handler_remove((gpio_num_t)config->interrupt_gpio);
// gpio_uninstall_isr_service(); gpio_reset_pin((gpio_num_t)config->interrupt_gpio); zh_vector_free(&_vector), "MCP23S17 initialization failed. Resources initialization failed.");
// }
// err = _zh_mcp23s17_task_init(config);
// if (_is_prev_gpio_isr_service == true)
// {
// ZH_ERROR_CHECK(err == ESP_OK, err, i2c_master_bus_rm_device(handle->dev_handle); gpio_isr_handler_remove((gpio_num_t)config->interrupt_gpio);
// gpio_reset_pin((gpio_num_t)config->interrupt_gpio); zh_vector_free(&_vector); vSemaphoreDelete(_interrupt_semaphore), "MCP23S17 initialization failed. Task initialization failed.");
// }
// else
// {
// ZH_ERROR_CHECK(err == ESP_OK, err, i2c_master_bus_rm_device(handle->dev_handle); gpio_isr_handler_remove((gpio_num_t)config->interrupt_gpio);
// gpio_uninstall_isr_service(); gpio_reset_pin((gpio_num_t)config->interrupt_gpio); zh_vector_free(&_vector); vSemaphoreDelete(_interrupt_semaphore), "MCP23S17 initialization failed. Task initialization failed.");
// }
// }
// handle->is_initialized = true;
// for (uint8_t i = 0; i < sizeof(_i2c_matrix); ++i)
// {
// if (_i2c_matrix[i] == 0)
// {
// _i2c_matrix[i] = handle->i2c_address;
// break;
// }
// }
ZH_LOGI("MCP23S17 initialization completed successfully.");
return ESP_OK;
}
// esp_err_t zh_MCP23S17_deinit(zh_MCP23S17_handle_t *handle)
// {
// ZH_LOGI("MCP23S17 deinitialization started.");
// ZH_ERROR_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, NULL, "MCP23S17 deinitialization failed. Invalid argument.");
// ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_INVALID_STATE, NULL, "MCP23S17 deinitialization failed. MCP23S17 not initialized.");
// if (_interrupt_gpio < GPIO_NUM_MAX && handle->gpio_work_mode != 0)
// {
// for (uint16_t i = 0; i < zh_vector_get_size(&_vector); ++i)
// {
// zh_MCP23S17_handle_t *temp_handle = zh_vector_get_item(&_vector, i);
// if (handle->i2c_address == temp_handle->i2c_address)
// {
// zh_vector_delete_item(&_vector, i);
// break;
// }
// }
// if (zh_vector_get_size(&_vector) == 0)
// {
// gpio_isr_handler_remove((gpio_num_t)_interrupt_gpio);
// gpio_reset_pin((gpio_num_t)_interrupt_gpio);
// zh_vector_free(&_vector);
// vSemaphoreDelete(_interrupt_semaphore);
// vTaskDelete(zh_MCP23S17);
// if (_is_prev_gpio_isr_service == false)
// {
// gpio_uninstall_isr_service();
// }
// _interrupt_gpio = GPIO_NUM_MAX;
// }
// }
// i2c_master_bus_rm_device(handle->dev_handle);
// handle->is_initialized = false;
// for (uint8_t i = 0; i < sizeof(_i2c_matrix); ++i)
// {
// if (_i2c_matrix[i] == handle->i2c_address)
// {
// _i2c_matrix[i] = 0;
// break;
// }
// }
// ZH_LOGI("MCP23S17 deinitialization completed successfully.");
// return ESP_OK;
// }
// esp_err_t zh_MCP23S17_read(zh_MCP23S17_handle_t *handle, uint8_t *reg)
// {
// ZH_LOGI("MCP23S17 read register started.");
// ZH_ERROR_CHECK(handle != NULL && reg != NULL, ESP_ERR_INVALID_ARG, NULL, "MCP23S17 read register failed. Invalid argument.");
// ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_NOT_FOUND, NULL, "MCP23S17 read register failed. MCP23S17 not initialized.");
// esp_err_t err = _zh_mcp23s17_read_register(handle, reg);
// ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "MCP23S17 read register failed.");
// ZH_LOGI("MCP23S17 read register completed successfully.");
// return ESP_OK;
// }
// esp_err_t zh_MCP23S17_write(zh_MCP23S17_handle_t *handle, uint8_t reg)
// {
// ZH_LOGI("MCP23S17 write register started.");
// ZH_ERROR_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, NULL, "MCP23S17 write register failed. Invalid argument.");
// ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_NOT_FOUND, NULL, "MCP23S17 write register failed. MCP23S17 not initialized.");
// esp_err_t err = _zh_mcp23s17_write_register(handle, (reg | handle->gpio_work_mode));
// ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "MCP23S17 write register failed.");
// ZH_LOGI("MCP23S17 write register completed successfully.");
// return ESP_OK;
// }
// esp_err_t zh_MCP23S17_reset(zh_MCP23S17_handle_t *handle)
// {
// ZH_LOGI("MCP23S17 reset register started.");
// ZH_ERROR_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, NULL, "MCP23S17 reset register failed. Invalid argument.");
// ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_NOT_FOUND, NULL, "MCP23S17 reset register failed. MCP23S17 not initialized.");
// esp_err_t err = _zh_mcp23s17_write_register(handle, handle->gpio_work_mode);
// ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "MCP23S17 reset register failed.");
// ZH_LOGI("MCP23S17 reset register completed successfully.");
// return ESP_OK;
// }
// esp_err_t zh_MCP23S17_read_gpio(zh_MCP23S17_handle_t *handle, zh_MCP23S17_gpio_num_t gpio, bool *status) // -V2008
// {
// ZH_LOGI("MCP23S17 read GPIO started.");
// ZH_ERROR_CHECK(handle != NULL && status != NULL, ESP_ERR_INVALID_ARG, NULL, "MCP23S17 read GPIO failed. Invalid argument.");
// ZH_ERROR_CHECK(gpio >= ZH_MCP23S17_GPIO_NUM_P0 && gpio < ZH_MCP23S17_GPIO_NUM_MAX, ESP_FAIL, NULL, "MCP23S17 read GPIO failed. Invalid GPIO number.")
// ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_NOT_FOUND, NULL, "MCP23S17 read GPIO failed. MCP23S17 not initialized.");
// uint8_t gpio_temp = _gpio_matrix[gpio];
// uint8_t reg_temp = 0;
// esp_err_t err = _zh_mcp23s17_read_register(handle, &reg_temp);
// ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "MCP23S17 read GPIO failed.");
// *status = ((reg_temp & gpio_temp) ? 1 : 0);
// ZH_LOGI("MCP23S17 read GPIO completed successfully.");
// return ESP_OK;
// }
// esp_err_t zh_MCP23S17_write_gpio(zh_MCP23S17_handle_t *handle, zh_MCP23S17_gpio_num_t gpio, bool status) // -V2008
// {
// ZH_LOGI("MCP23S17 write GPIO started.");
// ZH_ERROR_CHECK(handle != NULL, ESP_ERR_INVALID_ARG, NULL, "MCP23S17 write GPIO failed. Invalid argument.");
// ZH_ERROR_CHECK(gpio >= ZH_MCP23S17_GPIO_NUM_P0 && gpio < ZH_MCP23S17_GPIO_NUM_MAX, ESP_FAIL, NULL, "MCP23S17 write GPIO failed. Invalid GPIO number.")
// ZH_ERROR_CHECK(handle->is_initialized == true, ESP_ERR_NOT_FOUND, NULL, "MCP23S17 write GPIO failed. MCP23S17 not initialized.");
// uint8_t gpio_temp = _gpio_matrix[gpio];
// esp_err_t err = ESP_OK;
// if (status == true)
// {
// err = _zh_mcp23s17_write_register(handle, handle->gpio_status | handle->gpio_work_mode | gpio_temp);
// }
// else
// {
// err = _zh_mcp23s17_write_register(handle, (handle->gpio_status ^ gpio_temp) | handle->gpio_work_mode);
// }
// ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "MCP23S17 write GPIO failed.");
// ZH_LOGI("MCP23S17 write GPIO completed successfully.");
// return ESP_OK;
// }
// const zh_MCP23S17_stats_t *zh_MCP23S17_get_stats(void)
// {
// return &_stats;
// }
// void zh_MCP23S17_reset_stats(void)
// {
// ZH_LOGI("Error statistic reset started.");
// _stats.i2c_driver_error = 0;
// _stats.event_post_error = 0;
// _stats.vector_error = 0;
// _stats.queue_overflow_error = 0;
// _stats.min_stack_size = 0;
// ZH_LOGI("Error statistic reset successfully.");
// }
// static esp_err_t _zh_mcp23s17_validate_config(const zh_mcp23s17_init_config_t *config)
// {
// ZH_ERROR_CHECK(config != NULL, ESP_ERR_INVALID_ARG, NULL, "Initial config is NULL.");
// ZH_ERROR_CHECK((config->i2c_address >= 0x20 && config->i2c_address <= 0x27) || (config->i2c_address >= 0x38 && config->i2c_address <= 0x3F), ESP_ERR_INVALID_ARG, NULL, "Invalid I2C address.");
// ZH_ERROR_CHECK(config->task_priority >= 1 && config->stack_size >= configMINIMAL_STACK_SIZE, ESP_ERR_INVALID_ARG, NULL, "Invalid task settings.");
// ZH_ERROR_CHECK(config->interrupt_gpio <= GPIO_NUM_MAX, ESP_ERR_INVALID_ARG, NULL, "Invalid GPIO number.");
// ZH_ERROR_CHECK(config->i2c_handle != NULL, ESP_ERR_INVALID_ARG, NULL, "Invalid I2C handle.");
// for (uint8_t i = 0; i < sizeof(_i2c_matrix); ++i)
// {
// ZH_ERROR_CHECK(config->i2c_address != _i2c_matrix[i], ESP_ERR_INVALID_ARG, NULL, "I2C address already present.");
// }
// return ESP_OK;
// }
// static esp_err_t _zh_mcp23s17_gpio_init(const zh_mcp23s17_init_config_t *config, zh_mcp23s17_handle_t *handle)
// {
// if (_interrupt_gpio != GPIO_NUM_MAX)
// {
// esp_err_t err = zh_vector_push_back(&_vector, handle);
// ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "Failed add item to vector.")
// return ESP_OK;
// }
// esp_err_t err = zh_vector_init(&_vector, sizeof(zh_mcp23s17_handle_t));
// ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "Failed create vector.")
// err = zh_vector_push_back(&_vector, handle);
// ZH_ERROR_CHECK(err == ESP_OK, err, zh_vector_free(&_vector), "Failed add item to vector.")
// gpio_config_t interrupt_gpio_config = {
// .intr_type = GPIO_INTR_NEGEDGE,
// .mode = GPIO_MODE_INPUT,
// .pin_bit_mask = (1ULL << config->interrupt_gpio),
// .pull_down_en = GPIO_PULLDOWN_DISABLE,
// .pull_up_en = GPIO_PULLUP_ENABLE,
// };
// err = gpio_config(&interrupt_gpio_config);
// ZH_ERROR_CHECK(err == ESP_OK, err, zh_vector_free(&_vector), "GPIO configuration failed.")
// err = gpio_install_isr_service(ESP_INTR_FLAG_LOWMED);
// ZH_ERROR_CHECK(err == ESP_OK || err == ESP_ERR_INVALID_STATE, err, gpio_reset_pin((gpio_num_t)config->interrupt_gpio); zh_vector_free(&_vector), "Failed install isr service.")
// if (err == ESP_ERR_INVALID_STATE)
// {
// _is_prev_gpio_isr_service = true;
// }
// err = gpio_isr_handler_add((gpio_num_t)config->interrupt_gpio, _zh_mcp23s17_isr_handler, NULL);
// if (_is_prev_gpio_isr_service == true)
// {
// ZH_ERROR_CHECK(err == ESP_OK, err, gpio_reset_pin((gpio_num_t)config->interrupt_gpio); zh_vector_free(&_vector), "Failed add isr handler.")
// }
// else
// {
// ZH_ERROR_CHECK(err == ESP_OK, err, gpio_uninstall_isr_service(); gpio_reset_pin((gpio_num_t)config->interrupt_gpio); zh_vector_free(&_vector), "Failed add isr handler.")
// }
// _interrupt_gpio = config->interrupt_gpio;
// return ESP_OK;
// }
// static esp_err_t _zh_mcp23s17_i2c_init(const zh_mcp23s17_init_config_t *config, zh_mcp23s17_handle_t *handle)
// {
// i2c_device_config_t MCP23S17_config = {
// .dev_addr_length = I2C_ADDR_BIT_LEN_7,
// .device_address = config->i2c_address,
// .scl_speed_hz = 100000,
// };
// i2c_master_dev_handle_t _dev_handle = NULL;
// esp_err_t err = i2c_master_bus_add_device(config->i2c_handle, &MCP23S17_config, &_dev_handle);
// ZH_ERROR_CHECK(err == ESP_OK, err, NULL, "Failed to add I2C device.");
// err = i2c_master_probe(config->i2c_handle, config->i2c_address, 1000 / portTICK_PERIOD_MS);
// ZH_ERROR_CHECK(err == ESP_OK, err, i2c_master_bus_rm_device(_dev_handle), "Expander not connected or not responding.");
// handle->dev_handle = _dev_handle;
// handle->gpio_work_mode = (config->p7_gpio_work_mode << 7) | (config->p6_gpio_work_mode << 6) | (config->p5_gpio_work_mode << 5) |
// (config->p4_gpio_work_mode << 4) | (config->p3_gpio_work_mode << 3) | (config->p2_gpio_work_mode << 2) |
// (config->p1_gpio_work_mode << 1) | (config->p0_gpio_work_mode << 0);
// handle->gpio_status = handle->gpio_work_mode;
// handle->i2c_address = config->i2c_address;
// return ESP_OK;
// }
static esp_err_t _zh_mcp23s17_resources_init(const zh_mcp23s17_init_config_t *config)
{
_interrupt_semaphore = xSemaphoreCreateBinary();
ZH_ERROR_CHECK(_interrupt_semaphore != NULL, ESP_ERR_NO_MEM, NULL, "Failed to create semaphore.")
return ESP_OK;
}
static esp_err_t _zh_mcp23s17_task_init(const zh_mcp23s17_init_config_t *config)
{
BaseType_t err = xTaskCreatePinnedToCore(&_zh_mcp23s17_isr_processing_task, "zh_mcp23s17_isr_processing_task", config->stack_size, NULL, config->task_priority, &zh_mcp23s17, tskNO_AFFINITY);
ZH_ERROR_CHECK(err == pdPASS, err, NULL, "Failed to create isr processing task.")
return ESP_OK;
}
static void IRAM_ATTR _zh_mcp23s17_isr_handler(void *arg)
{
BaseType_t xHigherPriorityTaskWoken = pdFALSE;
if (xSemaphoreGiveFromISR(_interrupt_semaphore, &xHigherPriorityTaskWoken) != pdTRUE)
{
++_stats.queue_overflow_error;
}
if (xHigherPriorityTaskWoken == pdTRUE)
{
portYIELD_FROM_ISR();
};
}
// static void IRAM_ATTR _zh_mcp23s17_isr_processing_task(void *pvParameter)
// {
// for (;;)
// {
// xSemaphoreTake(_interrupt_semaphore, portMAX_DELAY);
// for (uint16_t i = 0; i < zh_vector_get_size(&_vector); ++i)
// {
// zh_MCP23S17_handle_t *handle = zh_vector_get_item(&_vector, i);
// if (handle == NULL)
// {
// ++_stats.vector_error;
// ZH_LOGE("MCP23S17 isr processing failed. Failed to get vector item data.", ESP_FAIL);
// continue;
// }
// zh_MCP23S17_event_on_isr_t event = {0};
// event.i2c_address = handle->i2c_address;
// event.gpio_number = 0xFF;
// uint8_t old_reg = handle->gpio_status;
// uint8_t new_reg = 0;
// esp_err_t err = _zh_mcp23s17_read_register(handle, &new_reg);
// if (err != ESP_OK)
// {
// ZH_LOGE("MCP23S17 isr processing failed. Failed to read expander register.", err);
// continue;
// }
// for (uint8_t j = 0; j <= 7; ++j)
// {
// if ((handle->gpio_work_mode & _gpio_matrix[j]) != 0)
// {
// if ((old_reg & _gpio_matrix[j]) != (new_reg & _gpio_matrix[j]))
// {
// event.gpio_number = j;
// event.gpio_level = new_reg & _gpio_matrix[j];
// }
// }
// }
// if (event.gpio_number != 0xFF)
// {
// err = esp_event_post(ZH_MCP23S17, 0, &event, sizeof(event), 1000 / portTICK_PERIOD_MS);
// if (err != ESP_OK)
// {
// ++_stats.event_post_error;
// ZH_LOGE("MCP23S17 isr processing failed. Failed to post interrupt event.", err);
// continue;
// }
// }
// }
// _stats.min_stack_size = (uint32_t)uxTaskGetStackHighWaterMark(NULL);
// }
// vTaskDelete(NULL);
// }
// static esp_err_t _zh_mcp23s17_read_register(zh_mcp23s17_handle_t *handle, uint8_t *reg)
// {
// // esp_err_t err = i2c_master_receive(handle->dev_handle, &handle->gpio_status, sizeof(handle->gpio_status), 1000 / portTICK_PERIOD_MS);
// // ZH_ERROR_CHECK(err == ESP_OK, err, ++_stats.i2c_driver_error, "I2C driver error.");
// // *reg = handle->gpio_status;
// return ESP_OK;
// }
// static esp_err_t _zh_mcp23s17_write_register(zh_mcp23s17_handle_t *handle, uint8_t reg)
// {
// // esp_err_t err = i2c_master_transmit(handle->dev_handle, &reg, sizeof(reg), 1000 / portTICK_PERIOD_MS);
// // ZH_ERROR_CHECK(err == ESP_OK, err, ++_stats.i2c_driver_error, "I2C driver error.");
// // handle->gpio_status = reg;
// return ESP_OK;
// }