i2c.h

 
/*
    Cribbed from the Castor & Pollux Gemini firmware:
    https://github.com/wntrblm/Castor_and_Pollux/
    Copyright (c) 2021 Alethea Katherine Flowers.
    Published under the standard MIT License.
    Full text available at: https://opensource.org/licenses/MIT
*/
 
#pragma once
 
/* Routines for interacting with I2C devices. */
 
#include <stdint.h>
#include <stdbool.h>
#include <stddef.h>
 
typedef enum {
    I2C_RESULT_SUCCESS = 0,
    I2C_RESULT_ERR_ADDR_NACK = -1,
    I2C_RESULT_ERR_BUSSTATE = -2,
    I2C_RESULT_ERR_BUSERR = -3,
    I2C_RESULT_ERR_DATA_NACK = -4,
} i2c_result_t;
 
void i2c_init(void);
 
void i2c_enable(void);
 
bool i2c_is_enabled(void);
 
i2c_result_t i2c_write(uint8_t address, uint8_t* data, size_t len);
 
i2c_result_t i2c_read(uint8_t address, uint8_t* data, size_t len);
 
void i2c_disable(void);
 
void i2c_init_instance(uint8_t sercom, uint32_t baud);
 
void i2c_enable_instance(uint8_t sercom);
 
bool i2c_is_enabled_instance(uint8_t sercom);
 
i2c_result_t i2c_write_instance(uint8_t sercom, uint8_t address, uint8_t* data, size_t len);
 
i2c_result_t i2c_read_instance(uint8_t sercom, uint8_t address, uint8_t* data, size_t len);
 
void i2c_disable_instance(uint8_t sercom);