RT-Thread記錄（十八、SHT21與24C02軟件包）

1.2 檢查問題

上面使用 I2C 設備使能，一切看上去都是沒問題了：

我一開始很懵，這么簡單的操作我哪里會出問題了，想了很久，然后還搞不明白為什么初始化不會注冊i2c總線，最后還是得去看驅動代碼？

但是壓根沒有看到注冊總線的驅動函數……（后面發現并不是studio的問題，應該是自己很久以前誤操作，刪除了文件……）

………… 花了 …… 好多時間……最后我直接從以前的工程中復制了一份文件進來：

/*
 * Copyright (c) 2006-2018, RT-Thread Development Team
 *
 * SPDX-License-Identifier: Apache-2.0
 *
 * Change Logs:
 * Date           Author       Notes
 * 2018-11-08     balanceTWK   first version
 */

#include 
#include "drv_soft_i2c.h"
#include "drv_config.h"

#ifdef RT_USING_I2C

//#define DRV_DEBUG
#define LOG_TAG              "drv.i2c"
#include 

#if !defined(BSP_USING_I2C1) && !defined(BSP_USING_I2C2) && !defined(BSP_USING_I2C3) && !defined(BSP_USING_I2C4)
#error "Please define at least one BSP_USING_I2Cx"
/* this driver can be disabled at menuconfig → RT-Thread Components → Device Drivers */
#endif

static const struct stm32_soft_i2c_config soft_i2c_config[] =
{
#ifdef BSP_USING_I2C1
    I2C1_BUS_CONFIG,
#endif
#ifdef BSP_USING_I2C2
    I2C2_BUS_CONFIG,
#endif
#ifdef BSP_USING_I2C3
    I2C3_BUS_CONFIG,
#endif
#ifdef BSP_USING_I2C4
    I2C4_BUS_CONFIG,
#endif
};

static struct stm32_i2c i2c_obj[sizeof(soft_i2c_config) / sizeof(soft_i2c_config[0])];

/**
 * This function initializes the i2c pin.
 *
 * @param Stm32 i2c dirver class.
 */
static void stm32_i2c_gpio_init(struct stm32_i2c *i2c)
{
    struct stm32_soft_i2c_config* cfg = (struct stm32_soft_i2c_config*)i2c->ops.data;

    rt_pin_mode(cfg->scl, PIN_MODE_OUTPUT_OD);
    rt_pin_mode(cfg->sda, PIN_MODE_OUTPUT_OD);

    rt_pin_write(cfg->scl, PIN_HIGH);
    rt_pin_write(cfg->sda, PIN_HIGH);
}

/**
 * This function sets the sda pin.
 *
 * @param Stm32 config class.
 * @param The sda pin state.
 */
static void stm32_set_sda(void *data, rt_int32_t state)
{
    struct stm32_soft_i2c_config* cfg = (struct stm32_soft_i2c_config*)data;
    if (state)
    {
        rt_pin_write(cfg->sda, PIN_HIGH);
    }
    else
    {
        rt_pin_write(cfg->sda, PIN_LOW);
    }
}

/**
 * This function sets the scl pin.
 *
 * @param Stm32 config class.
 * @param The scl pin state.
 */
static void stm32_set_scl(void *data, rt_int32_t state)
{
    struct stm32_soft_i2c_config* cfg = (struct stm32_soft_i2c_config*)data;
    if (state)
    {
        rt_pin_write(cfg->scl, PIN_HIGH);
    }
    else
    {
        rt_pin_write(cfg->scl, PIN_LOW);
    }
}

/**
 * This function gets the sda pin state.
 *
 * @param The sda pin state.
 */
static rt_int32_t stm32_get_sda(void *data)
{
    struct stm32_soft_i2c_config* cfg = (struct stm32_soft_i2c_config*)data;
    return rt_pin_read(cfg->sda);
}

/**
 * This function gets the scl pin state.
 *
 * @param The scl pin state.
 */
static rt_int32_t stm32_get_scl(void *data)
{
    struct stm32_soft_i2c_config* cfg = (struct stm32_soft_i2c_config*)data;
    return rt_pin_read(cfg->scl);
}
/**
 * The time delay function.
 *
 * @param microseconds.
 */
static void stm32_udelay(rt_uint32_t us)
{
    rt_uint32_t ticks;
    rt_uint32_t told, tnow, tcnt = 0;
    rt_uint32_t reload = SysTick->LOAD;

    ticks = us * reload / (1000000 / RT_TICK_PER_SECOND);
    told = SysTick->VAL;
    while (1)
    {
        tnow = SysTick->VAL;
        if (tnow != told)
        {
            if (tnow < told)
            {
                tcnt += told - tnow;
            }
            else
            {
                tcnt += reload - tnow + told;
            }
            told = tnow;
            if (tcnt >= ticks)
            {
                break;
            }
        }
    }
}

static const struct rt_i2c_bit_ops stm32_bit_ops_default =
{
    .data     = RT_NULL,
    .set_sda  = stm32_set_sda,
    .set_scl  = stm32_set_scl,
    .get_sda  = stm32_get_sda,
    .get_scl  = stm32_get_scl,
    .udelay   = stm32_udelay,
    .delay_us = 1,
    .timeout  = 100
};

/**
 * if i2c is locked, this function will unlock it
 *
 * @param stm32 config class
 *
 * @return RT_EOK indicates successful unlock.
 */
static rt_err_t stm32_i2c_bus_unlock(const struct stm32_soft_i2c_config *cfg)
{
    rt_int32_t i = 0;

    if (PIN_LOW == rt_pin_read(cfg->sda))
    {
        while (i++ < 9)
        {
            rt_pin_write(cfg->scl, PIN_HIGH);
            stm32_udelay(100);
            rt_pin_write(cfg->scl, PIN_LOW);
            stm32_udelay(100);
        }
    }
    if (PIN_LOW == rt_pin_read(cfg->sda))
    {
        return -RT_ERROR;
    }

    return RT_EOK;
}

/* I2C initialization function */
int rt_hw_i2c_init(void)
{
    rt_size_t obj_num = sizeof(i2c_obj) / sizeof(struct stm32_i2c);
    rt_err_t result;

    for (int i = 0; i < obj_num; i++)
    {
        i2c_obj[i].ops = stm32_bit_ops_default;
        i2c_obj[i].ops.data = (void*)&soft_i2c_config[i];
        i2c_obj[i].i2c2_bus.priv = &i2c_obj[i].ops;
        stm32_i2c_gpio_init(&i2c_obj[i]);
        result = rt_i2c_bit_add_bus(&i2c_obj[i].i2c2_bus, soft_i2c_config[i].bus_name);
        RT_ASSERT(result == RT_EOK);
        stm32_i2c_bus_unlock(&soft_i2c_config[i]);
        
        LOG_D("software simulation %s init done, pin scl: %d, pin sda %d",
        soft_i2c_config[i].bus_name, 
        soft_i2c_config[i].scl, 
        soft_i2c_config[i].sda);
    }

    return RT_EOK;
}
INIT_BOARD_EXPORT(rt_hw_i2c_init);

#endif /* RT_USING_I2C */

然后就一切正常了：

最開始我以為是設置問題，當時陷入里面想不明白，隔了幾天回頭想想，好像是以前有人問我加載軟件包沒用，我自己測試了一下給了回復，但是當時還是 RT-Thread 記錄專欄剛開始，不需要用到軟件包，然后自己因為一些警告誤刪除了 這個文件 (灬? ?灬)…

到頭來想起來原來還是自己曾經的誤操作… 尷尬…… 這種問題確實在實際中會遇到……，所以提醒一下自己。

二、溫濕度傳感器軟件包

前面的莫名的問題太影響心情了，緩一緩希望接下來一切順利。

2.1 添加及基本測試

對于我們使用的溫濕度傳感器，原理圖上畫的是 HTU21D ，是和 sht21 pin to pin 的程序也一樣的溫濕度傳感器，我們在軟件包中心找到 sht2x 軟件包，如下圖：

軟件包并不需要過多的設置：

添加軟件包完成，保存后重新編譯工程燒錄，可以看到有 sht20 的指令：

溫濕度讀取測試：

2.2 程序中使用

上面我們通過命令行測試了軟件包，使用起來感覺特別簡單是不是，那么我們在程序中怎么調用呢？

從軟件包的說明文檔里面可以查看到他的操作API(只看我們測試用到的幾個)：

/*
根據總線名稱，自動初始化對應的 SHT20 設備
參數	描述
name	i2c 設備名稱
返回	描述
!= NULL	將返回 sht20 設備對象
= NULL	查找失敗
*/
sht20_device_t sht20_init(const char *i2c_bus_name)

/*
讀取溫度
參數	描述
dev	sht20 設備對象
返回	描述
!= 0.0	測量溫度值
=0.0	測量失敗
*/
float sht20_read_temperature(sht20_device_t dev)

/*
讀取濕度
參數	描述
dev	sht20設備對象
返回	描述
!= 0.0	測量濕度值
=0.0	測量失敗
*/
float sht20_read_humidity(sht20_device_t dev)

我們用圖文的方式說明一下，還是很簡單的：

測試結果：

三、EEPROM 軟件包

我們用的EEPROM 24C02，也有對應的軟件包，有了上面傳感器的例子，我們使用起來就很順手了。

3.1 添加及基本測試

我們在軟件包中心找到 at24cxx 軟件包，如下圖：

軟件包并不需要過多的設置：

添加軟件包完成，保存后重新編譯工程燒錄，可以看到有 at24cxx 的指令：

EEPROM讀取測試：

這個指令讀取有點小疑問，還不確定是從哪里開始讀，讀多少，也不知道從哪里開始寫，寫多少。
但是沒有關系，我們如果在程序中使用，是直接調用軟件包提供的 API。

3.2 程序中使用

從軟件包的說明文檔里面可以查看到他的操作API，或者直接找軟件包的文件：

這幾個函數比較簡單，從函數聲明都能知道其使用方法，我們用圖文的方式說明一下，首先是初始化：

接著是讀寫操作：

測試結果：

結語

本文應該是很簡單的軟件包使用測試，沒想到和上一篇文章一樣，測試起來都不是那么順利，各種坎坷 = =！

??
也正是說明不管東西有多簡單，在實際使用過程中，難免會遇到一些意想不到的問題，理論知識是我們的立根之本，但是實際的操作才能讓我們歷經洗禮！

??
RT-Thread 組件與軟件包部分使用的方式都差不多，我們暫時就更新這些，那么到目前為止 RT-Thread 專欄部分的內容也差不多可以完結了，有理論，有問題，有測試，有應用。

??
如果后期還有比較典型的應用，我會繼續把專欄完善，希望大家多多支持！謝謝！

審核編輯：湯梓紅