aw9523.h

Go to the documentation of this file.

 
#pragma once
 
#include <stdbool.h>
#include <stdint.h>
 
#include "driver/i2c_types.h"
#include "esp_err.h"
 
//
// Constants
//

typedef enum {
  AW9523_I2C_ADDR_AD0_GND_AD1_GND = 0x58, 
  AW9523_I2C_ADDR_AD0_VCC_AD1_GND = 0x59, 
  AW9523_I2C_ADDR_AD0_GND_AD1_VCC = 0x5A, 
  AW9523_I2C_ADDR_AD0_VCC_AD1_VCC = 0x5B  
} aw9523_i2c_addr_t;

#define AW9523_ID 0x23

typedef i2c_master_dev_handle_t aw9523_t;

typedef enum {
  AW9523_REG_GPIO_INPUT_P0 = 0x00, 
  AW9523_REG_GPIO_INPUT_P1 = 0x01, 
  AW9523_REG_GPIO_OUTPUT_P0 = 0x02, 
  AW9523_REG_GPIO_OUTPUT_P1 = 0x03, 
  AW9523_REG_GPIO_DIR_P0 = 0x04,    
  AW9523_REG_GPIO_DIR_P1 = 0x05,    
  AW9523_REG_GPIO_INTERRUPT_P0 = 0x06, 
  AW9523_REG_GPIO_INTERRUPT_P1 = 0x07, 
  AW9523_REG_ID = 0x10,                
  AW9523_REG_CONTROL = 0x11,           
  AW9523_REG_MODE_P0 = 0x12, 
  AW9523_REG_MODE_P1 = 0x13, 
  AW9523_REG_SOFT_RESET = 0x7F 
} aw9523_reg_addr_t;

typedef uint8_t aw9523_reg_value_t;

typedef enum {
  AW9523_PIN_GPIO_OUTPUT = 0, 
  AW9523_PIN_GPIO_INPUT = 1,  
  AW9523_PIN_LED = 2          
} aw9523_pin_mode_t;

typedef aw9523_pin_mode_t aw9523_pins_mode_t[16];

typedef uint8_t aw9523_pin_num_t;

typedef bool aw9523_pin_data_digital_t;

typedef aw9523_pin_data_digital_t aw9523_pins_data_digital_t[16];

typedef enum {
  AW9523_PIN_INTERRUPT_MODE_ENABLE = 0b0,  
  AW9523_PIN_INTERRUPT_MODE_DISABLE = 0b1, 
} aw9523_pin_interrupt_mode_t;

typedef aw9523_pin_interrupt_mode_t aw9523_pins_interrupt_mode_t[16];

typedef enum {
  AW9523_GPIO_OUTPUT_MODE_OPEN_DRAIN = 0b0, 
  AW9523_GPIO_OUTPUT_MODE_PUSH_PULL = 0b1   
} aw9523_gpio_output_mode_t;

typedef enum {
  AW9523_LED_MAX_mA_37 = 0x0, 
  AW9523_LED_MAX_mA_27_75 = 0x1, 
  AW9523_LED_MAX_mA_18_5 = 0x2, 
  AW9523_LED_MAX_mA_9_25 = 0x3  
} aw9523_led_max_current_t;
 
//
// Functions
//

esp_err_t aw9523_read_reg(const aw9523_t* dev, const aw9523_reg_addr_t reg,
                          aw9523_reg_value_t* value);

esp_err_t aw9523_write_reg(const aw9523_t* dev, const aw9523_reg_addr_t reg,
                           const aw9523_reg_value_t value);

esp_err_t aw9523_init(const i2c_master_bus_handle_t* bus_handle,
                      const aw9523_i2c_addr_t address, aw9523_t* dev);

esp_err_t aw9523_set_pins(const aw9523_t* dev,
                          const aw9523_pins_mode_t* pins_mode);

esp_err_t aw9523_set_pin(const aw9523_t* dev, const aw9523_pin_num_t pin,
                         const aw9523_pin_mode_t pin_mode);

esp_err_t aw9523_gpio_read_pins(const aw9523_t* dev,
                                aw9523_pins_data_digital_t* pins_data);

esp_err_t aw9523_gpio_read_pin(const aw9523_t* dev, const aw9523_pin_num_t pin,
                               const aw9523_pin_mode_t pin_mode,
                               aw9523_pin_data_digital_t* data);

esp_err_t aw9523_gpio_write_pins(const aw9523_t* dev,
                                 const aw9523_pins_data_digital_t* data);

esp_err_t aw9523_gpio_write_pin(const aw9523_t* dev, const aw9523_pin_num_t pin,
                                const aw9523_pin_data_digital_t data);

esp_err_t aw9523_set_gpio_interrupt_pins(
    const aw9523_t* dev,
    const aw9523_pins_interrupt_mode_t* pins_interrupt_mode);

esp_err_t aw9523_set_gpio_interrupt_pin(
    const aw9523_t* dev, const aw9523_pin_num_t pin,
    const aw9523_pin_interrupt_mode_t pin_interrupt_mode);

esp_err_t aw9523_set_gpio_output_mode_p0(
    const aw9523_t* dev, const aw9523_gpio_output_mode_t gpio_output_mode);

esp_err_t aw9523_set_led_max_current(
    const aw9523_t* dev, const aw9523_led_max_current_t max_current);

esp_err_t aw9523_set_led_brightness(const aw9523_t* dev,
                                    const aw9523_pin_num_t pin,
                                    const aw9523_reg_value_t brightness);

esp_err_t aw9523_soft_reset(const aw9523_t* dev);

esp_err_t aw9523_destroy(aw9523_t* dev);