I2C Functions

Functions
void	sd_i2c1_init (void)
	I2C1 Initialization Initialize low-level hardware peripheral and set device handle. More...
void	sd_i2c2_init (void)
	I2C2 Initialization Initialize low-level hardware peripheral and set device handle. More...
void	HAL_I2C_MspInit (I2C_HandleTypeDef *hi2c)
void	HAL_I2C_MspDeInit (I2C_HandleTypeDef *hi2c)
enum sd_i2c_err	sd_i2C_set_chan (struct sd_i2c_dev *dev, uint8_t chan)
	Set I2C channel Set I2C channel (more than one channel may be specified) to broadcast messages. More...
enum sd_i2c_err	sd_i2c_en_chan (struct sd_i2c_dev *dev, uint8_t chan)
	Enable I2C channel Enable an I2C channel without altering previously configured channels. More than one channel may be specified. More...
enum sd_i2c_err	sd_i2c_dis_chan (struct sd_i2c_dev *dev, uint8_t chan)
	Disable I2C channel Disable an I2C channel without altering previously configured channels. More than one channel may be specified. More...
static enum sd_i2c_err	sd_i2c_dev_init (struct sd_i2c_dev *dev, I2C_HandleTypeDef *hi2c)
	Initialize I2C channel Initialize I2C channel with a peripheral handle and set the device as ready. More...

Detailed Description

Function Documentation

HAL_I2C_MspInit()

void HAL_I2C_MspInit

(

I2C_HandleTypeDef *

hi2c

)

#include <Src/sd_i2c.c>

I2C1 GPIO Configuration

Pin/Port	Signal -——
PB8	SCL
PB9	SDA

I2C2 GPIO Configuration

Pin/Port	Signal ----—
PB10	SCL
PB11	SDA

{
    GPIO_InitTypeDef GPIO_InitStruct;
    if (hi2c->Instance==I2C1) {
        GPIO_InitStruct.Pin = SMB_I2C_SCL_Pin|SMB_I2C_SDA_Pin;
        GPIO_InitStruct.Mode = GPIO_MODE_AF_OD;
        GPIO_InitStruct.Pull = GPIO_PULLUP;
        GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;
        GPIO_InitStruct.Alternate = GPIO_AF1_I2C1;
        HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

        /* Peripheral clock enable */
        __I2C1_CLK_ENABLE();
    } else if (hi2c->Instance==I2C2) {
        GPIO_InitStruct.Pin = CRYPTO_I2C_SCL_Pin|CRYPTO_I2C_SDA_Pin;
        GPIO_InitStruct.Mode = GPIO_MODE_AF_OD;
        GPIO_InitStruct.Pull = GPIO_PULLUP;
        GPIO_InitStruct.Speed = GPIO_SPEED_HIGH;
        GPIO_InitStruct.Alternate = GPIO_AF1_I2C2;
        HAL_GPIO_Init(GPIOB, &GPIO_InitStruct);

        /* Peripheral clock enable */
        __I2C2_CLK_ENABLE();
    }
}

sd_i2c1_init()

void sd_i2c1_init

(

void

)

#include <Src/sd_i2c.c>

I2C1 Initialization Initialize low-level hardware peripheral and set device handle.

Configure Analog filter

{
    hi2c1.Instance = I2C1;
    hi2c1.Init.Timing = 0x20303E5D;
    hi2c1.Init.OwnAddress1 = 0;
    hi2c1.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
    hi2c1.Init.DualAddressMode = I2C_DUALADDRESS_DISABLED;
    hi2c1.Init.OwnAddress2 = 0;
    hi2c1.Init.OwnAddress2Masks = I2C_OA2_NOMASK;
    hi2c1.Init.GeneralCallMode = I2C_GENERALCALL_DISABLED;
    hi2c1.Init.NoStretchMode = I2C_NOSTRETCH_DISABLED;
    HAL_I2C_Init(&hi2c1);

    HAL_I2CEx_AnalogFilter_Config(&hi2c1, I2C_ANALOGFILTER_ENABLED);
    
    /* Initialize I2C device */
    sd_i2c_dev_init(&i2c1_dev, &hi2c1);
}

sd_i2c2_init()

void sd_i2c2_init

(

void

)

#include <Src/sd_i2c.c>

I2C2 Initialization Initialize low-level hardware peripheral and set device handle.

Configure Analog filter

{
    hi2c2.Instance = I2C2;
    hi2c2.Init.Timing = 0x20303E5D;
    hi2c2.Init.OwnAddress1 = 0;
    hi2c2.Init.AddressingMode = I2C_ADDRESSINGMODE_7BIT;
    hi2c2.Init.DualAddressMode = I2C_DUALADDRESS_DISABLED;
    hi2c2.Init.OwnAddress2 = 0;
    hi2c2.Init.OwnAddress2Masks = I2C_OA2_NOMASK;
    hi2c2.Init.GeneralCallMode = I2C_GENERALCALL_DISABLED;
    hi2c2.Init.NoStretchMode = I2C_NOSTRETCH_DISABLED;
    HAL_I2C_Init(&hi2c2);

    HAL_I2CEx_AnalogFilter_Config(&hi2c2, I2C_ANALOGFILTER_ENABLED);
    
    /* Initialize I2C device */
    sd_i2c_dev_init(&i2c2_dev, &hi2c2);
}

sd_i2c_dev_init()

enum sd_i2c_err sd_i2c_dev_init ( struct sd_i2c_dev *  dev, I2C_HandleTypeDef *  hi2c  )

static

#include <Src/sd_i2c.c>

Initialize I2C channel Initialize I2C channel with a peripheral handle and set the device as ready.

Parameters

dev	I2C device to initialize
hi2c	I2C device handle to use

Return values

SD_I2C_SUCCESS

on success, error state otherwise

{
    memset(dev, 0, sizeof(struct sd_i2c_dev));
    
    dev->i2c = hi2c;
    dev->state = SD_I2C_READY;
    
    return SD_I2C_SUCCESS;
}

sd_i2c_dis_chan()

enum sd_i2c_err sd_i2c_dis_chan	(	struct sd_i2c_dev *	dev,
		uint8_t	chan
	)

#include <Src/sd_i2c.c>

Disable I2C channel Disable an I2C channel without altering previously configured channels. More than one channel may be specified.

Parameters

dev	I2C device to configure
chan	Channel to disable on the I2C switch

Return values

SD_I2C_SUCCESS

on success, error state otherwise

{
    sd_i2c_chan &= ~(chan);
    
    if (HAL_I2C_Master_Transmit(dev->i2c, SD_I2C_SWITCH_ADDR, &sd_i2c_chan, 1, 1000) != HAL_OK)
        return SD_I2C_ERROR;
    
    return SD_I2C_SUCCESS;
}

sd_i2c_en_chan()

enum sd_i2c_err sd_i2c_en_chan	(	struct sd_i2c_dev *	dev,
		uint8_t	chan
	)

#include <Src/sd_i2c.c>

Enable I2C channel Enable an I2C channel without altering previously configured channels. More than one channel may be specified.

Parameters

dev	I2C device to configure
chan	Channel to enable on the I2C switch

Return values

SD_I2C_SUCCESS

on success, error state otherwise

{
    sd_i2c_chan |= chan;
    
    if (HAL_I2C_Master_Transmit(dev->i2c, SD_I2C_SWITCH_ADDR, &sd_i2c_chan, 1, 1000) != HAL_OK)
        return SD_I2C_ERROR;
    
    return SD_I2C_SUCCESS;
}

sd_i2C_set_chan()

enum sd_i2c_err sd_i2C_set_chan	(	struct sd_i2c_dev *	dev,
		uint8_t	chan
	)

#include <Src/sd_i2c.c>

Set I2C channel Set I2C channel (more than one channel may be specified) to broadcast messages.

Parameters

dev	I2C device to configure
chan	Channel(s) to set on the I2C switch

Return values

SD_I2C_SUCCESS

on success, error state otherwise

{
    sd_i2c_chan = chan;
    
    /* Set the output state of the switch */
    if (HAL_I2C_Master_Transmit(dev->i2c, SD_I2C_SWITCH_ADDR, &sd_i2c_chan, 1, 1000) != HAL_OK)
        return SD_I2C_ERROR;

    return SD_I2C_SUCCESS;
}