【Linux】一步一步学Linux——ifconfig命令(151)

00. 目录

文章目录

01. 命令概述

ifconfig命令的英文全称是“network interfaces configuring”，即用于配置和显示Linux内核中网络接口的网络参数。用ifconfig命令配置的网卡信息，在网卡重启后机器重启后，配置就不存在。要想将上述的配置信息永远的存的电脑里，那就要修改网卡的配置文件了。

02. 命令格式

ifconfig [接口]
ifconfig 接口 [aftype] options | address ...

  • 1
  • 2

03. 常用选项

interface
接口的名称。这通常是一个驱动程序名，后面跟着一个单元号，例如用于第一个以太网接口的eth0。

up
此标志将导致激活接口。如果将地址分配给接口，则会隐式指定该地址。

down
此标志导致关闭此接口的驱动程序。

[-]arp
启用或禁用在此接口上使用ARP协议。

[-]promisc
启用或禁用接口的混杂模式。如果选中，网络上的所有数据包都将由接口接收。

[-]allmulti
启用或禁用所有多播模式。如果选中，则接口将接收网络上的所有多播数据包。

metric N
此参数设置接口度量。它在GNU/Linux下不可用

mtu N
此参数设置接口的最大传输单元(MTU)。

dstaddr addr
为点对点链路(如PPP)设置远程IP地址.这个关键字现在已经过时了；使用pointopoint关键字代替。

netmask addr
设置此接口的IP网络掩码。此值默认为通常的A、B或C类网络掩码(从接口IP地址派生)，但可以设置为任何值。

add addr/prefixlen
向接口添加IPv 6地址

del addr/prefixlen
从接口中删除IPv 6地址

tunnel ::aa.bb.cc.dd
创建一个新的SIT(IPv6-in-IPv4)设备，通过隧道到达给定的目的地。

irq addr
设置此设备使用的中断行。并非所有设备都可以动态更改其IRQ设置。

io_addr addr
为该设备设置I/O空间中的起始地址

mem_start addr
设置此设备使用的共享内存的起始地址。只有少数几个设备需要这个

media type
设置设备要使用的物理端口或介质类型。并非所有设备都可以更改此设置，以及那些可以更改其支持的值的设备。典型的类型值是10 base 2(细以太网)、10 base T(双绞线10 Mbps以太网)、AUI(外收发信机)等。驱动的特殊介质类型可以用来告诉驱动对媒体进行自动感知。同样，并不是所有的驱动都能做到这一点。

[-]broadcast [addr]
如果地址参数给定，则为该接口设置协议广播地址。否则，设置(或清除)接口的IFF_BROADCAST标志。

[-]pointopoint [addr]
这个关键字启用了接口的点对点模式，这意味着它是两台机器之间的直接链接，没有其他人监听它。如果地址参数也给出了，就像过时的dstaddr关键字一样，设置链接另一端的协议地址。否则，设置或清除接口的IFF_POINTOPOINT标志。

hw class address
如果设备驱动程序支持此操作，则设置此接口的硬件地址。关键字后面必须跟着硬件类的名称和相当于硬件地址的可打印的ASCII。目前支持的硬件类包括ether (以太网)、ax25(AMPRAX.25)、ARCnet和netrom(AMPR NET/ROM)。

multicast
在接口上设置多播标志。这通常不应该需要，因为驱动程序本身设置正确的标志。

address
要分配给此接口的IP地址。

txqueuelen length
设置设备的传输队列的长度。对于具有高延迟(调制解调器链路，ISDN)的较慢设备，将其设置为小值是有用的，以防止快速批量传输过多地干扰诸如telnet之类的交互通信。


  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
  • 51
  • 52
  • 53
  • 54
  • 55
  • 56
  • 57
  • 58
  • 59
  • 60
  • 61
  • 62
  • 63
  • 64
  • 65
  • 66
  • 67
  • 68
  • 69

04. 参考示例

4.1 查看处于激活状态的网络接口信息

[root@localhost ~]# ifconfig  
ens33: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 172.16.0.76  netmask 255.255.254.0  broadcast 172.16.1.255
        inet6 fe80::16e5:9e6b:b4d5:68de  prefixlen 64  scopeid 0x20<link>
        ether 00:50:56:26:d8:88  txqueuelen 1000  (Ethernet)
        RX packets 6228371  bytes 1866155533 (1.7 GiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 12697  bytes 4930072 (4.7 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

lo: flags=73<UP,LOOPBACK,RUNNING>  mtu 65536
        inet 127.0.0.1  netmask 255.0.0.0
        inet6 ::1  prefixlen 128  scopeid 0x10<host>
        loop  txqueuelen 1000  (Local Loopback)
        RX packets 58611  bytes 3738994 (3.5 MiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 58611  bytes 3738994 (3.5 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

virbr0: flags=4099<UP,BROADCAST,MULTICAST>  mtu 1500
        inet 192.168.122.1  netmask 255.255.255.0  broadcast 192.168.122.255
        ether 52:54:00:d2:18:f4  txqueuelen 1000  (Ethernet)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

[root@localhost ~]# 


  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29

4.2 所有配置的网络接口，不论其是否激活

[root@localhost ~]# ifconfig  -a
ens33: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 172.16.0.76  netmask 255.255.254.0  broadcast 172.16.1.255
        inet6 fe80::16e5:9e6b:b4d5:68de  prefixlen 64  scopeid 0x20<link>
        ether 00:50:56:26:d8:88  txqueuelen 1000  (Ethernet)
        RX packets 6228561  bytes 1866208151 (1.7 GiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 12712  bytes 4933606 (4.7 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

lo: flags=73<UP,LOOPBACK,RUNNING>  mtu 65536
        inet 127.0.0.1  netmask 255.0.0.0
        inet6 ::1  prefixlen 128  scopeid 0x10<host>
        loop  txqueuelen 1000  (Local Loopback)
        RX packets 58623  bytes 3739714 (3.5 MiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 58623  bytes 3739714 (3.5 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

virbr0: flags=4099<UP,BROADCAST,MULTICAST>  mtu 1500
        inet 192.168.122.1  netmask 255.255.255.0  broadcast 192.168.122.255
        ether 52:54:00:d2:18:f4  txqueuelen 1000  (Ethernet)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

virbr0-nic: flags=4098<BROADCAST,MULTICAST>  mtu 1500
        ether 52:54:00:d2:18:f4  txqueuelen 1000  (Ethernet)
        RX packets 0  bytes 0 (0.0 B)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 0  bytes 0 (0.0 B)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

[root@localhost ~]# 

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35

4.3 显示ens33网卡信息


[root@localhost ~]# ifconfig  ens33
ens33: flags=4163<UP,BROADCAST,RUNNING,MULTICAST>  mtu 1500
        inet 172.16.0.76  netmask 255.255.254.0  broadcast 172.16.1.255
        inet6 fe80::16e5:9e6b:b4d5:68de  prefixlen 64  scopeid 0x20<link>
        ether 00:50:56:26:d8:88  txqueuelen 1000  (Ethernet)
        RX packets 6229282  bytes 1866403997 (1.7 GiB)
        RX errors 0  dropped 0  overruns 0  frame 0
        TX packets 12777  bytes 4946850 (4.7 MiB)
        TX errors 0  dropped 0 overruns 0  carrier 0  collisions 0

[root@localhost ~]# 

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12

4.4 关闭网卡

[root@localhost home]# ifconfig ens33 down
[root@localhost home]# 

  • 1
  • 2

4.5 启动网卡

[root@localhost home]# ifconfig ens33 up
[root@localhost home]# 

  • 1
  • 2

4.6 添加ipv6地址

[root@localhost ~]# ifconfig ens33 add 33ffe:3240:800:1005::2/64
[root@localhost ~]# 

  • 1
  • 2

4.7 删除ipv6地址

[root@localhost ~]# ifconfig ens33 del 33ffe:3240:800:1005::2/64
[root@localhost ~]# 

  • 1
  • 2

4.8 修改mac地址

[root@localhost ~]# ifconfig ens33 hw ether 00:50:56:26:d8:88
[root@localhost ~]# 

  • 1
  • 2

4.9 配置IP地址

[root@localhost ~]# ifconfig  ens33 172.16.0.76
[root@localhost ~]# 

  • 1
  • 2

4.10 配置IP地址的同时指定掩码

[root@localhost ~]# ifconfig  ens33 172.16.0.76 netmask 255.255.254.0
[root@localhost ~]# 

  • 1
  • 2

4.11 配置IP地址的同时指定掩码和广播地址

[deng@localhost ~]$ ifconfig ens33 172.16.0.76 netmask 255.255.254.0 broadcast 172.16.1.255


  • 1
  • 2

4.12 设置能通过的最大数据包大小为 1500 bytes

[root@localhost ~]# ifconfig  ens33 mtu 1500

  • 1

4.13 开启arp功能

[root@localhost ~]# ifconfig ens33 arp
[root@localhost ~]# 

  • 1
  • 2

4.14 关闭arp功能

[root@localhost ~]# ifconfig ens33 -arp
[root@localhost ~]# 

  • 1
  • 2

05. 总结

在这里插入图片描述

06. 附录

参考：【Linux】一步一步学Linux系列教程汇总

id="article_content" class="article_content clearfix"> id="content_views" class="markdown_views prism-atom-one-light">

概述

功能简介

I3C（Improved Inter Integrated Circuit）总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。

I3C是两线双向串行总线，针对多个传感器从设备进行了优化，并且一次只能由一个I3C主设备控制。相比于I2C，I3C总线拥有更高的速度、更低的功耗，支持带内中断、从设备热接入以及切换当前主设备，同时向后兼容I2C从设备。I3C增加了带内中断（In-Bind Interrupt）功能，支持I3C设备进行热接入操作，弥补了I2C总线需要额外增加中断线来完成中断的不足。I3C总线上允许同时存在I2C设备、I3C从设备和I3C次级主设备。

I3C接口定义了完成I3C传输的通用方法集合，包括：

  • I3C控制器管理：打开或关闭I3C控制器。
  • I3C控制器配置：获取或配置I3C控制器参数。
  • I3C消息传输：通过消息传输结构体数组进行自定义传输。
  • I3C带内中断：请求或释放带内中断。

基本概念

  • IBI（In-Band Interrupt）

带内中断。在SCL线没有启动信号时，I3C从设备可以通过拉低SDA线使主设备发出SCL启动信号，从而发出带内中断请求。若有多个从机同时发出中断请求，I3C主机则通过从机地址进行仲裁，低地址优先相应。

  • DAA（Dynamic Address Assignment）

动态地址分配。I3C支持对从设备地址进行动态分配从而避免地址冲突。在分配动态地址之前，连接到I3C总线上的每个I3C设备都应以两种方式之一来唯一标识：

1）设备可能有一个符合I2C规范的静态地址，主机可以使用此静态地址；

2）在任何情况下，设备均应具有48位的临时ID。 除非设备具有静态地址且主机使用静态地址，否则主机应使用此48位临时ID。

  • CCC（Common Command Code）

通用命令代码，所有I3C设备均支持CCC，可以直接将其传输到特定的I3C从设备，也可以同时传输到所有I3C从设备。

  • BCR（Bus Characteristic Register）

总线特性寄存器，每个连接到 I3C 总线的 I3C 设备都应具有相关的只读总线特性寄存器 （BCR），该寄存器描述了I3C兼容设备在动态地址分配和通用命令代码中的作用和功能。

  • DCR（Device Characteristic Register）

设备特性寄存器，连接到 I3C 总线的每个 I3C 设备都应具有相关的只读设备特性寄存器 (DCR)。 该寄存器描述了用于动态地址分配和通用命令代码的 I3C 兼容设备类型（例如，加速度计、陀螺仪等）。

运作机制

在HDF框架中，I3C模块接口适配模式采用统一服务模式，这需要一个设备服务来作为I3C模块的管理器，统一处理外部访问，这会在配置文件中有所体现。统一服务模式适合于同类型设备对象较多的情况，如I3C可能同时具备十几个控制器，采用独立服务模式需要配置更多的设备节点，且服务会占据内存资源。相反，采用统一服务模式可以使用一个设备服务作为管理器，统一处理所有同类型对象的外部访问（这会在配置文件中有所体现），实现便捷管理和节约资源的目的。

相比于I2C，I3C总线拥有更高的速度、更低的功耗，支持带内中断、从设备热接入以及切换当前主设备，同时向后兼容I2C从设备。一路I3C总线上，可以连接多个设备，这些设备可以是I2C从设备、I3C从设备和I3C次级主设备，但只能同时存在一个主设备，一般为控制器本身。

图 1 I3C物理连线示意图

约束与限制

I3C模块当前仅支持轻量和小型系统内核（LiteOS-A），不支持在用户态使用。

使用指导

场景介绍

I3C可连接单个或多个I3C、I2C从器件，它主要用于：

  • 与传感器通信，如陀螺仪、气压计或支持I3C协议的图像传感器等；

  • 通过软件或硬件协议转换，与其他接口（如 UART 串口等）的设备进行通信。

接口说明

I3C模块提供的主要接口如表1所示，具体API详见//drivers/hdf_core/framework/include/platform/i3c_if.h。

表 1 I3C驱动API接口功能介绍

class="table-box">
接口名接口描述
DevHandle I3cOpen(int16_t number)打开I3C控制器
void I3cClose(DevHandle handle)关闭I3C控制器
int32_t I3cTransfer(DevHandle handle, struct I3cMsg *msg, int16_t count, enum TransMode mode)自定义传输
int32_t I3cSetConfig(DevHandle handle, struct I3cConfig *config)配置I3C控制器
int32_t I3cGetConfig(DevHandle handle, struct I3cConfig *config)获取I3C控制器配置
int32_t I3cRequestIbi(DevHandle handle, uint16_t addr, I3cIbiFunc func, uint32_t payload)请求带内中断
int32_t I3cFreeIbi(DevHandle handle, uint16_t addr)释放带内中断

说明：
本文涉及的所有接口，仅限内核态使用，不支持在用户态使用。

开发步骤

I3C的使用流程如图2所示。

图 2 I3C使用流程图

打开I3C控制器

在进行I3C通信前，首先要调用I3cOpen打开I3C控制器。

DevHandle I3cOpen(int16_t number);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
  • 1

表 2 I3cOpen参数和返回值描述

class="table-box">
参数参数描述
numberint16_t类型，I3C控制器号
返回值返回值描述
NULL打开I3C控制器失败
控制器句柄打开的I3C控制器句柄

假设系统中存在8个I3C控制器，编号从0到7，以下示例代码为打开1号控制器：

DevHandle i3cHandle = NULL;  // I3C控制器句柄

// 打开I3C控制器
i3cHandle = I3cOpen(1);
if (i3cHandle == NULL) {
    HDF_LOGE("I3cOpen: i3c open fail.\n");
    return NULL;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
获取I3C控制器配置
int32_t I3cGetConfig(DevHandle handle, struct I3cConfig *config);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 3 I3cGetConfig参数和返回值描述

class="table-box">
参数参数描述
handleDevHandle类型，I3C控制器句柄
config结构体指针，I3C控制器配置
返回值返回值描述
HDF_SUCCESS获取成功
负数获取失败

获取I3C控制器配置示例：

struct I3cConfig config;

int32_t ret = I3cGetConfig(i3cHandle, &config);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("I3cGetConfig: get config fail, ret:%d", ret);
    return ret;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
配置I3C控制器
int32_t I3cSetConfig(DevHandle handle, struct I3cConfig *config);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 4 I3cSetConfig参数和返回值描述

class="table-box">
参数参数描述
handleDevHandle类型，I3C控制器句柄
config结构体指针，I3C控制器配置
返回值返回值描述
HDF_SUCCESS配置成功
负数配置失败

配置I3C控制器示例：

struct I3cConfig config;

config->busMode = I3C_BUS_HDR_MODE;
config->curMaster = NULL;
int32_t ret = I3cSetConfig(i3cHandle, &config);
if (ret != HDF_SUCCESS) {
    HDF_LOGE("I3cSetConfig: set config fail, ret:%d", ret);
    return ret;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
进行I3C通信

消息传输

int32_t I3cTransfer(DevHandle handle, struct I3cMsg *msgs, int16_t count, enum TransMode mode);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 5 I3cTransfer参数和返回值描述

class="table-box">
参数参数描述
handleDevHandle类型，I3C控制器句柄
msgs结构体指针，待传输数据的消息结构体数组
countint16_t类型，消息数组长度
mode枚举类型，传输模式，0：I2C模式；1：I3C模式；2：发送CCC
返回值返回值描述
正整数成功传输的消息结构体数目
负数执行失败

I3C传输消息类型为I3cMsg，每个传输消息结构体表示一次读或写，通过一个消息数组，可以执行若干次的读写组合操作。

int32_t ret;
uint8_t wbuff[2] = { 0x12, 0x13 };
uint8_t rbuff[2] = { 0 };
struct I3cMsg msgs[2];        // 自定义传输的消息结构体数组
msgs[0].buf = wbuff;          // 写入的数据
msgs[0].len = 2;              // 写入数据长度为2
msgs[0].addr = 0x3F;          // 写入设备地址为0x3F
msgs[0].flags = 0;            // 传输标记为0，默认为写
msgs[1].buf = rbuff;          // 要读取的数据
msgs[1].len = 2;              // 读取数据长度为2
msgs[1].addr = 0x3F;          // 读取设备地址为0x3F
msgs[1].flags = I3C_FLAG_READ // I3C_FLAG_READ置位
// 进行一次I2C模式自定义传输，传输的消息个数为2
ret = I3cTransfer(i3cHandle, msgs, 2, I2C_MODE);
if (ret != 2) {
    HDF_LOGE("I3cTransfer: transfer fail, ret:%d\n", ret);
    return HDF_FAILURE;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">

注意：

请求IBI（带内中断）
int32_t I3cRequestIbi(DevHandle handle, uint16_t addr, I3cIbiFunc func, uint32_t payload);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 6 I3cRequestIbi参数和返回值描述

class="table-box">
参数参数描述
handleDevHandle类型，I3C控制器句柄
addruint16_t类型，I3C设备地址
func函数指针，IBI回调函数
payloadIBI有效载荷
返回值返回值描述
HDF_SUCCESS请求成功
负数请求失败

请求带内中断示例：

static int32_t TestI3cIbiFunc(DevHandle handle, uint16_t addr, struct I3cIbiData data)
{
    (void)handle;
    (void)addr;
    HDF_LOGD("TestI3cIbiFunc: %.16s", (char *)data.buf);

    return HDF_SUCCESS;
}

int32_t I3cTestRequestIbi(void)
{
    DevHandle i3cHandle = NULL;
    int32_t ret;

    // 打开I3C控制器
    i3cHandle = I3cOpen(1);
    if (i3cHandle == NULL) {
        HDF_LOGE("I3cOpen: i3c open fail.\n");
        return;
    }
    ret = I3cRequestIbi(i3cHandle, 0x3F, TestI3cIbiFunc, 16);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("%s: Request IBI failed!", __func__);
        return ret;
    }

    I3cClose(i3cHandle);
    HDF_LOGD("I3cTestRequestIbi: done");

    return HDF_SUCCESS;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">
释放IBI（带内中断）
int32_t I3cFreeIbi(DevHandle handle, uint16_t addr);
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 7 I3cFreeIbi参数和返回值描述

class="table-box">
参数参数描述
handleDevHandle类型，I3C控制器句柄
addruint16_t类型，I3C设备地址
返回值返回值描述
HDF_SUCCESS释放成功
负数释放失败

释放带内中断示例：

I3cFreeIbi(i3cHandle, 0x3F); // 释放带内中断
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">
关闭I3C控制器

I3C通信完成之后，需要关闭I3C控制器，关闭函数如下所示：

void I3cClose(DevHandle handle); 
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

表 8 I3cClose参数和返回值描述

class="table-box">
参数参数描述
handleDevHandle类型，I3C控制器句柄

关闭I3C控制器实例：

I3cClose(i3cHandle); // 关闭I3C控制器
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}">

使用实例

本例程以操作Hi3516DV300开发板上的I3C虚拟设备为例，详细展示I3C接口的完整使用流程，基本硬件信息如下。

本例程进行简单的I3C传输，测试I3C通路是否正常。

示例如下：

#include "i3c_if.h"               // I3C标准接口头文件
#include "hdf_log.h"              // 标准日志打印头文件
#include "osal_io.h"              // 标准IO读写接口头文件
#include "osal_time.h"            // 标准延迟&睡眠接口头文件

// 定义一个表示设备的结构体，存储信息 
struct TestI3cDevice {
    uint16_t busNum;              // I3C总线号
    uint16_t addr;                // I3C设备地址 
    uint16_t regLen;              // 寄存器字节宽度 
    DevHandle i3cHandle;          // I3C控制器句柄 
};

// 基于I3cTransfer方法封装一个寄存器读写的辅助函数，通过flag表示读或写
static int32_t TestI3cReadWrite(struct TestI3cDevice *testDevice, unsigned int regAddr,
    unsigned char *regData, unsigned int dataLen, uint8_t flag)
{
    int index = 0;
    unsigned char regBuf[4] = {0};
    struct I3cMsg msgs[2] = {0};

    // 单双字节寄存器长度适配
    if (testDevice->regLen == 1) { 
        regBuf[index++] = regAddr & 0xFF;
    } else {
        regBuf[index++] = (regAddr >> 8) & 0xFF;
        regBuf[index++] = regAddr & 0xFF;
    }

    // 填充I3cMsg消息结构 
    msgs[0].addr = testDevice->addr;
    msgs[0].flags = 0;                               // 标记为0，表示写入
    msgs[0].len = testDevice->regLen;
    msgs[0].buf = regBuf;

    msgs[1].addr = testDevice->addr;
    msgs[1].flags = (flag == 1) ? I3C_FLAG_READ : 0; // 添加读标记位，表示读取
    msgs[1].len = dataLen;
    msgs[1].buf = regData;

    if (I3cTransfer(testDevice->i3cHandle, msgs, 2, I2C_MODE) != 2) {
        HDF_LOGE("TestI3cReadWrite: i3c transfer err.");
        return HDF_FAILURE;
    }
    return HDF_SUCCESS;
}

// 寄存器读函数
static inline int32_t TestI3cReadReg(struct TestI3cDevice *testDevice, unsigned int regAddr,
    unsigned char *regData, unsigned int dataLen)
{
    return TestI3cReadWrite(testDevice, regAddr, regData, dataLen, 1);
}

// 寄存器写函数
static inline int32_t TestI3cWriteReg(struct TestI3cDevice *testDevice, unsigned int regAddr,
    unsigned char *regData, unsigned int dataLen)
{
    return TestI3cReadWrite(testDevice, regAddr, regData, dataLen, 0);
}

// I3C例程总入口
static int32_t TestCaseI3c(void)
{
    int32_t ret;
    unsigned char bufWrite[7] = { 0xFF, 0xFF, 0xFF, 0xFF, 0xA, 0xB, 0xC };
    unsigned char bufRead[7] = {0};
    static struct TestI3cDevice testDevice;

    // 设备信息初始化
    testDevice.busNum = 18;
    testDevice.addr = 0x3F;
    testDevice.regLen = 2;
    testDevice.i3cHandle = NULL;

    // 打开I3C控制器 
    testDevice.i3cHandle = I3cOpen(testDevice.busNum);
    if (testDevice.i3cHandle == NULL) {
        HDF_LOGE("TestCaseI3c: open I3c:%u fail!", testDevice.busNum);
        return HDF_FAILURE;
    }

    // 向地址为0x3F的设备连续写7字节数据
    ret = TestI3cWriteReg(&testDevice, 0x3F, bufWrite, 7);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("TestCaseI3c: test i3c write reg fail, ret:%d", ret);
        I3cClose(testDevice.i3cHandle);
        return ret;
    }
    OsalMSleep(10);

    // 从地址为0x3F的设备连续读7字节数据
    ret = TestI3cReadReg(&testDevice, 0x3F, bufRead, 7);
    if (ret != HDF_SUCCESS) {
        HDF_LOGE("TestCaseI3c: test i3c read reg fail, ret:%d", ret);
        I3cClose(testDevice.i3cHandle);
        return ret;
    }
    HDF_LOGD("TestCaseI3c: test i3c write&read reg success!");
    HDF_LOGD("TestCaseI3c: function tests end.");
    // 访问完毕关闭I3C控制器
    I3cClose(testDevice.i3cHandle);

    return HDF_SUCCESS;
}
 class="hljs-button signin active" data-title="登录复制" data-report-click="{"spm":"1001.2101.3001.4334"}"> class="hide-preCode-box">

如果大家想更加深入的学习 OpenHarmony（鸿蒙南向） 开发的全栈内容，不妨可以参考以下相关学习文档进行学习，助你快速提升自己：

OpenHarmony 开发环境搭建：https://qr18.cn/CgxrRy

《OpenHarmony源码解析》：https://qr18.cn/CgxrRy

系统架构分析：https://qr18.cn/CgxrRy

OpenHarmony 设备开发学习手册：https://qr18.cn/CgxrRy

在这里插入图片描述

OpenHarmony面试题（内含参考答案）：https://qr18.cn/CgxrRy

写在最后

data-report-view="{"mod":"1585297308_001","spm":"1001.2101.3001.6548","dest":"https://blog.csdn.net/maniuT/article/details/141110941","extend1":"pc","ab":"new"}">> id="blogExtensionBox" style="width:400px;margin:auto;margin-top:12px" class="blog-extension-box"> class="blog_extension blog_extension_type2" id="blog_extension"> class="extension_official" data-report-click="{"spm":"1001.2101.3001.6471"}" data-report-view="{"spm":"1001.2101.3001.6471"}"> class="blog_extension_card_left"> class="blog_extension_card_cont"> 鸿蒙开发学习资料领取！！！ class="blog_extension_card_cont_r"> 微信名片
注：本文转载自blog.csdn.net的沧海一笑-dj的文章"https://blog.csdn.net/dengjin20104042056/article/details/99709841"。版权归原作者所有，此博客不拥有其著作权，亦不承担相应法律责任。如有侵权，请联系我们删除。
复制链接
复制链接
相关推荐
发表评论

评论记录：

未查询到任何数据！