Pico如何使用C/C++选择哪个I2C控制器,以及SDA和SCL针脚

本文一开始讲述了解决方案,后面是我做的笔记,用来讲述我的发现流程和探究的 Pico I2C 代码结构。

前提知识

首先要说明一点:Pico 有两个 I2C,也就是两套 SDA 和 SCL。这点你可以在针脚图中名字看出,比如下图的 Pin 4 和 Pin 5是 I2C1 的,而默认的 Pin 6 和 Pin 7 是 I2C0 的。

Pico如何使用C/C++选择哪个I2C控制器,以及SDA和SCL针脚_第1张图片

默认情况下是只开启了第一个 I2C,也就是只有 I2C0 的针脚是可以使用的。如果这种情况下,你哪怕修改了针脚,但不是 I2C0 的,也是不会正常运行的。

如何选择哪个I2C控制器,以及SDA和SCL针脚

在设置之前声明三个变量或宏来方便开发。建议使用宏,这比较符合树莓派的开发风格:

#define I2C				i2c0
#define I2C_SDA_PIN 	4
#define I2C_SCL_PIN 	5

如果宏扩展出错,那么就使用变量。

然后初始化 I2C 的时候来设置使用哪个 I2C 控制器,以及哪个SDA和SCL针脚。下面是设置根据上面的设置,这里使用的是第一个 I2C 控制器,SDA 使用的是 GP4,SCL 使用的是 GP5,频率为1000000

i2c_init(I2C, 1000000);
gpio_set_function(I2C_SDA_PIN, GPIO_FUNC_I2C);
gpio_set_function(I2C_SCL_PIN, GPIO_FUNC_I2C);
gpio_pull_up(I2C_SDA_PIN);
gpio_pull_up(I2C_SCL_PIN);

由于有两个 I2C 控制器,那么可以同时使用两套SDASCL针脚,但是要注意必须是I2C0I2C1的针脚,不能是同一个控制器的。

发现历程(选读)

这部分不一定要看。这里记录一下我是怎么知道是这样处理的,顺道了解了一下代码结构和信息传递的流程,万一以后需要就不用花时间翻来翻去了。

第一次尝试

首先分析一下:要定义针脚就要知道针脚这个值是如何被利用的,这样就可以知道如何传递处理这个值了。

一般是在初始化的时候设置使用哪个I2C控制器以及SDA和SCL针脚,代码一般如下:

i2c_init(i2c_default, CLK);
gpio_set_function(PICO_DEFAULT_I2C_SDA_PIN, GPIO_FUNC_I2C);
gpio_set_function(PICO_DEFAULT_I2C_SCL_PIN, GPIO_FUNC_I2C);
gpio_pull_up(PICO_DEFAULT_I2C_SDA_PIN);
gpio_pull_up(PICO_DEFAULT_I2C_SCL_PIN);

研究《用C/C++修改I2C默认的SDA和SCL针脚》的时候,我知道了默认针脚是在pico.h中配置的的,相关值有三个:PICO_DEFAULT_I2CPICO_DEFAULT_I2C_SDA_PINPICO_DEFAULT_I2C_SCL_PIN,那么只要追溯这三个值就行。

但是这样不好找,引用太多了。所以我就尝试了从另一方面先入手:I2C 是通过i2c_init()函数初始化的,如下:

i2c_init(i2c_default, SSD1306_I2C_CLK);

我需要的只有第一个参数i2c_default,因为这个参数传递了一些信息,第二个参数uint baudrate是传递速率的,和针脚无关。

那么i2c_init()函数的内容是什么呢?知道这个才能知道i2c_default的类型是什么结构,以及内部进行了什么处理。

i2c_init()函数声明在pico-sdk/src/rp2_common/hardware_i2c/i2c.c中,函数参数列表如下:

uint i2c_init(i2c_inst_t *i2c, uint baudrate) {
    i2c_reset(i2c);
    i2c_unreset(i2c);
    i2c->restart_on_next = false;

    i2c->hw->enable = 0;

    ...
    
    // Re-sets i2c->hw->enable upon returning:
    return i2c_set_baudrate(i2c, baudrate);
}

那这个i2c_inst_t是个什么数据类型呢?我就继续找它。

pico-sdk/src/rp2_common/hardware_i2c/include/hardware/i2c.h的第 52 行可以看到它是i2c_inst结构体的重命名:

typedef struct i2c_inst i2c_inst_t;

那继续找结构体i2c_inst,这个结构体就在同一个文件里的第 135 行:

struct i2c_inst {
    i2c_hw_t *hw;
    bool restart_on_next;
};

终点还是第一个变量i2c_hw_t *hw,因为只有它可能会传递针脚的值,那就继续找i2c_hw_t是什么数据类型。

这个数据类型的声明在pico-sdk/src/rp2040/hardware_structs/include/hardware/structs/i2c.h中。换句话说,这个文件就是为i2c_hw_t结构体所准备的:

Pico如何使用C/C++选择哪个I2C控制器,以及SDA和SCL针脚_第2张图片

这个结构体存储了很多 I2C 的信息,但还是没找到针脚的信息,那么我就回到一开始在进行寻找。

第二次尝试

最开始我是寻找了i2c_init()的第一个参数的类型i2c_inst_t,收获不大。但是它的值我还没寻找,所以这次从参数值出发i2c_default,这个值是哪定义的呢?

在刚才发现i2c_inst_t声明和定义的pico-sdk/src/rp2_common/hardware_i2c/include/hardware/i2c.h头文件中发现了需要的东西(第 76 行):

#ifdef PICO_DEFAULT_I2C_INSTANCE
#define i2c_default PICO_DEFAULT_I2C_INSTANCE
#endif

这个PICO_DEFAULT_I2C_INSTANCE是什么呢?往上一瞅就能看到:

#if !defined(PICO_DEFAULT_I2C_INSTANCE) && defined(PICO_DEFAULT_I2C)
#define PICO_DEFAULT_I2C_INSTANCE (__CONCAT(i2c,PICO_DEFAULT_I2C))
#endif

在这里终于看到一个需要的值:PICO_DEFAULT_I2C,前文可知这个默认为0

这里的(__CONCAT(i2c,PICO_DEFAULT_I2C))是将i2cPICO_DEFAULT_I2C的值连接起来了,默认情况下也就是i2c0也就是说,参数i2c_default就是i2c0

这个技巧很不错,但是有些编译器用不了,比如我用 Clang x86_64-apple-darwin21.6.0 就无法扩展PICO_DEFAULT_I2C

再深入一些

但是这里的i2c0是什么呢?这是个什么类型的数据呢?

Pico如何使用C/C++选择哪个I2C控制器,以及SDA和SCL针脚_第3张图片

还是在pico-sdk/src/rp2_common/hardware_i2c/include/hardware/i2c.h头文件中(如上图)有这样一段:

#define i2c0 (&i2c0_inst) ///< Identifier for I2C HW Block 0
#define i2c1 (&i2c1_inst) ///< Identifier for I2C HW Block 1

可以看到i2c0i2c0_inst的地址,注释说这是I2C HW Block 0的标识符。从上面的

extern i2c_inst_t i2c0_inst;
extern i2c_inst_t i2c1_inst;

可以看到i2c0_insti2c1_inst是外部变量,类型是i2c_inst_t,这个类型之前我看到了定义的结构体:

struct i2c_inst {
    i2c_hw_t *hw;
    bool restart_on_next;
};

那这个i2c0_inst是在哪声明的?

这部分在pico-sdk/src/rp2_common/hardware_i2c/i2c.c中声明的:

i2c_inst_t i2c0_inst = {i2c0_hw, false};
i2c_inst_t i2c1_inst = {i2c1_hw, false};

这个i2c0_hw又是啥呢?在哪定义的呢?

这是在pico-sdk/src/rp2040/hardware_structs/include/hardware/structs/i2c.h中:

#define i2c0_hw ((i2c_hw_t *)I2C0_BASE)
#define i2c1_hw ((i2c_hw_t *)I2C1_BASE)

i2c0_hw表示((i2c_hw_t *)I2C0_BASE),意思是I2C0_BASE是个指向i2c_hw_t的指针,它的内容在pico-sdk/src/rp2040/hardware_regs/include/hardware/regs/addressmap.h中:

#define I2C0_BASE _u(0x40044000)
#define I2C1_BASE _u(0x40048000)

也就是说I2C0_BASE就是0x40044000,而i2c0_hw的地址就是0x40044000

补充一点,这里_()是无符号整数的意思,定义在pico-sdk/src/rp2040/hardware_regs/include/hardware/platform_defs

#ifndef _u
#ifdef __ASSEMBLER__
#define _u(x) x
#else
#define _u(x) x ## u
#endif
#endif

了解了蛮多知识,也希望能帮到有需要的人~

你可能感兴趣的:(目前无法分类的小探究,树莓派,pico,C/C++)