cryptoauthlib-sys 0.2.2

/**
 * \file
 * \brief  definitions for bit-banged I2C
 *
 * \copyright (c) 2015-2020 Microchip Technology Inc. and its subsidiaries.
 *
 * \page License
 *
 * Subject to your compliance with these terms, you may use Microchip software
 * and any derivatives exclusively with Microchip products. It is your
 * responsibility to comply with third party license terms applicable to your
 * use of third party software (including open source software) that may
 * accompany Microchip software.
 *
 * THIS SOFTWARE IS SUPPLIED BY MICROCHIP "AS IS". NO WARRANTIES, WHETHER
 * EXPRESS, IMPLIED OR STATUTORY, APPLY TO THIS SOFTWARE, INCLUDING ANY IMPLIED
 * WARRANTIES OF NON-INFRINGEMENT, MERCHANTABILITY, AND FITNESS FOR A
 * PARTICULAR PURPOSE. IN NO EVENT WILL MICROCHIP BE LIABLE FOR ANY INDIRECT,
 * SPECIAL, PUNITIVE, INCIDENTAL OR CONSEQUENTIAL LOSS, DAMAGE, COST OR EXPENSE
 * OF ANY KIND WHATSOEVER RELATED TO THE SOFTWARE, HOWEVER CAUSED, EVEN IF
 * MICROCHIP HAS BEEN ADVISED OF THE POSSIBILITY OR THE DAMAGES ARE
 * FORESEEABLE. TO THE FULLEST EXTENT ALLOWED BY LAW, MICROCHIP'S TOTAL
 * LIABILITY ON ALL CLAIMS IN ANY WAY RELATED TO THIS SOFTWARE WILL NOT EXCEED
 * THE AMOUNT OF FEES, IF ANY, THAT YOU HAVE PAID DIRECTLY TO MICROCHIP FOR
 * THIS SOFTWARE.
 */

#ifndef I2C_BITBANG_SAMD21_H_
#define I2C_BITBANG_SAMD21_H_

#include "atca_status.h"
#include <delay.h>


#define MAX_I2C_BUSES   18       //The MAX_I2C_BUSES is the number of free pins in samd21 xplained pro


typedef struct
{
    uint8_t pin_sda[MAX_I2C_BUSES];
    uint8_t pin_scl[MAX_I2C_BUSES];
} I2CBuses;

extern I2CBuses i2c_buses_default;

extern uint8_t pin_sda;
extern uint8_t pin_scl;

#   define I2C_ENABLE()         {  struct port_config pin_conf; \
                                   port_get_config_defaults(&pin_conf); \
                                   pin_conf.direction  = PORT_PIN_DIR_OUTPUT_WTH_READBACK; \
                                   port_pin_set_config(pin_sda, &pin_conf); \
                                   pin_conf.direction  = PORT_PIN_DIR_OUTPUT; \
                                   port_pin_set_config(pin_scl, &pin_conf); }
#   define I2C_DISABLE()         {  struct port_config pin_conf; \
                                    port_get_config_defaults(&pin_conf); \
                                    pin_conf.direction  = PORT_PIN_DIR_INPUT; \
                                    pin_conf.input_pull = PORT_PIN_PULL_UP; \
                                    port_pin_set_config(pin_sda, &pin_conf); \
                                    port_pin_set_config(pin_scl, &pin_conf); }
#   define I2C_CLOCK_LOW()       port_pin_set_output_level(pin_scl, false)
#   define I2C_CLOCK_HIGH()      port_pin_set_output_level(pin_scl, true)
#   define I2C_DATA_LOW()        port_pin_set_output_level(pin_sda, false)
#   define I2C_DATA_HIGH()       port_pin_set_output_level(pin_sda, true)
#   define I2C_DATA_IN()         port_pin_get_input_level(pin_sda)
#   define I2C_SET_OUTPUT()      {  struct port_config pin_conf; \
                                    port_get_config_defaults(&pin_conf); \
                                    pin_conf.direction  = PORT_PIN_DIR_OUTPUT_WTH_READBACK; \
                                    port_pin_set_config(pin_sda, &pin_conf); }
#   define I2C_SET_OUTPUT_HIGH() { I2C_SET_OUTPUT(); I2C_DATA_HIGH(); }
#   define I2C_SET_OUTPUT_LOW()  { I2C_SET_OUTPUT(); I2C_DATA_LOW(); }
#   define I2C_SET_INPUT()       {  struct port_config pin_conf; \
                                    port_get_config_defaults(&pin_conf); \
                                    pin_conf.direction  = PORT_PIN_DIR_INPUT; \
                                    port_pin_set_config(pin_sda, &pin_conf); }
#   define DISABLE_INTERRUPT()   cpu_irq_disable()
#   define ENABLE_INTERRUPT()    cpu_irq_enable()


#define I2C_CLOCK_DELAY_WRITE_LOW()  delay_us(1)
#define I2C_CLOCK_DELAY_WRITE_HIGH() delay_us(1)
#define I2C_CLOCK_DELAY_READ_LOW()   delay_us(1)
#define I2C_CLOCK_DELAY_READ_HIGH()  delay_us(1)
#define I2C_CLOCK_DELAY_SEND_ACK()   delay_us(1)
//! This delay is inserted to make the Start and Stop hold time at least 250 ns.
#define I2C_HOLD_DELAY()    delay_us(1)




//! loop count when waiting for an acknowledgment
#define I2C_ACK_TIMEOUT                 (4)


/**
 * \brief Set I2C data and clock pin.
 *        Other functions will use these pins.
 *
 * \param[in] sda  definition of GPIO pin to be used as data pin
 * \param[in] scl  definition of GPIO pin to be used as clock pin
 */
void i2c_set_pin(uint8_t sda, uint8_t scl);


/**
 * \brief  Assigns the logical bus number for discovering the devices
 *
 *
 * \param[in]  i2c_bitbang_buses         The logical bus numbers are assigned to the variables.
 * \param[in]  max_buses                 Maximum number of bus used for discovering.
 */

void i2c_discover_buses(int i2c_bitbang_buses[], int max_buses);

/**
 * \brief Configure GPIO pins for I2C clock and data as output.
 */
void i2c_enable(void);

/**
 * \brief Configure GPIO pins for I2C clock and data as input.
 */
void i2c_disable(void);


/**
 * \brief Send a START condition.
 */
void i2c_send_start(void);

/**
 * \brief Send an ACK or NACK (after receive).
 *
 * \param[in] ack  0: NACK, else: ACK
 */
void i2c_send_ack(uint8_t ack);

/**
 * \brief Send a STOP condition.
 */
void i2c_send_stop(void);

/**
 * \brief Send a Wake Token.
 */
void i2c_send_wake_token(void);

/**
 * \brief Send one byte.
 *
 * \param[in] i2c_byte  byte to write
 *
 * \return ATCA_STATUS
 */
ATCA_STATUS i2c_send_byte(uint8_t i2c_byte);

/**
 * \brief Send a number of bytes.
 *
 * \param[in] count  number of bytes to send
 * \param[in] data   pointer to buffer containing bytes to send
 *
 * \return ATCA_STATUS
 */
ATCA_STATUS i2c_send_bytes(uint8_t count, uint8_t *data);

/**
 * \brief Receive one byte (MSB first).
 *
 * \param[in] ack  0:NACK, else:ACK
 *
 * \return Number of bytes received
 */
uint8_t i2c_receive_one_byte(uint8_t ack);

/**
 * \brief Receive one byte and send ACK.
 *
 * \param[out] data  pointer to received byte
 */
void i2c_receive_byte(uint8_t *data);

/**
 * \brief Receive a number of bytes.
 *
 * \param[out] data   pointer to receive buffer
 * \param[in]  count  number of bytes to receive
 */
void i2c_receive_bytes(uint8_t count, uint8_t *data);

#endif /* I2C_BITBANG_SAMD21_H_ */