1# I3C 2 3## 概述 <a name="1"></a> 4 5### 功能简介<a name="2"></a> 6 7I3C（Improved Inter Integrated Circuit）总线是由MIPI Alliance开发的一种简单、低成本的双向二线制同步串行总线。 8 9I3C是两线双向串行总线，针对多个传感器从设备进行了优化，并且一次只能由一个I3C主设备控制。相比于I2C，I3C总线拥有更高的速度、更低的功耗，支持带内中断、从设备热接入以及切换当前主设备，同时向后兼容I2C从设备。I3C增加了带内中断（In-Bind Interrupt）功能，支持I3C设备进行热接入操作，弥补了I2C总线需要额外增加中断线来完成中断的不足。I3C总线上允许同时存在I2C设备、I3C从设备和I3C次级主设备。 10 11### 基本概念<a name="3"></a> 12 13- IBI（In-Band Interrupt）：带内中断。 14 15 在SCL线没有启动信号时，I3C从设备可以通过拉低SDA线使主设备发出SCL启动信号，从而发出带内中断请求。若有多个从设备同时发出中断请求，I3C主设备则通过从设备地址进行仲裁，低地址优先相应。 16 17- DAA（Dynamic Address Assignment）：动态地址分配。 18 19 I3C支持对从设备地址进行动态分配从而避免地址冲突。在分配动态地址之前，连接到I3C总线上的每个I3C/I2C设备都应以两种方式之一来唯一标识： 20 21 - 设备可能有一个符合I2C规范的静态地址，主机可以使用此静态地址。 22 23 - 在任何情况下，I3C设备均应具有48位的临时ID。除非设备具有静态地址且主机使用静态地址，否则主机应使用此48位临时ID。 24 25- CCC（Common Command Code）：通用命令代码。 26 27 所有I3C设备均支持CCC，可以直接将其传输到特定的I3C从设备，也可以同时传输到所有I3C从设备。 28 29- BCR（Bus Characteristic Register）：总线特性寄存器。 30 31 每个连接到I3C总线的I3C设备都应具有相关的只读总线特性寄存器（BCR），该寄存器描述了I3C兼容设备在动态地址分配和通用命令代码中的作用和功能。 32 33- DCR（Device Characteristic Register）：设备特性寄存器。 34 35 连接到I3C总线的每个I3C设备都应具有相关的只读设备特性寄存器（DCR），该寄存器描述了用于动态地址分配和通用命令代码的I3C兼容设备类型（例如加速度计、陀螺仪等）。 36 37 38### 运作机制<a name="4"></a> 39 40在HDF框架中，同类型控制器对象较多时（可能同时存在十几个同类型控制器），如果采用独立服务模式则需要配置更多的设备节点，且相关服务会占据更多的内存资源。相反，采用统一服务模式可以使用一个设备服务作为管理器，统一处理所有同类型对象的外部访问（这会在配置文件中有所体现），实现便捷管理和节约资源的目的。I3C模块采用统一服务模式（如图1）。 41 42I3C模块各分层的作用为： 43 44- 接口层：提供打开设备，写入数据，关闭设备的能力。 45 46- 核心层：主要负责服务绑定、初始化以及释放管理器，并提供添加、删除以及获取控制器的能力。由于框架需要统一管理I3C总线上挂载的所有设备，因此还提供了添加、删除以及获取设备的能力，以及中断回调函数。 47 48- 适配层：由驱动适配者实现与硬件相关的具体功能，如控制器的初始化等。 49 50在统一模式下，所有的控制器都被核心层统一管理，并由核心层统一发布一个服务供接口层，因此这种模式下驱动无需再为每个控制器发布服务。 51 52**图 1** I3C统一服务模式结构图<a name="fig1"></a> 53 54 55 56### 约束与限制<a name="5"></a> 57 58I3C模块当前仅支持轻量和小型系统内核（LiteOS-A） 。 59 60## 开发指导 <a name="6"></a> 61 62### 场景介绍 <a name="7"></a> 63 64I3C可连接单个或多个I3C、I2C从器件，它主要用于： 65 66- 与传感器通信，如陀螺仪、气压计或支持I3C协议的图像传感器等。 67 68- 通过软件或硬件协议转换，与其他通信接口（如UART串口等）的设备进行通信。 69 70当驱动开发者需要将I3C设备适配到OpenHarmony时，需要进行I3C驱动适配，下文将介绍如何进行I3C驱动适配。 71 72### 接口说明 <a name="8"></a> 73 74为了保证上层在调用I3C接口时能够正确的操作硬件，核心层在//drivers/hdf_core/framework/support/platform/include/i3c/i3c_core.h中定义了以下钩子函数。驱动适配者需要在适配层实现这些函数的具体功能，并与这些钩子函数挂接，从而完成接口层与核心层的交互。 75 76I3cMethod定义： 77 78```c 79struct I3cMethod { 80 int32_t (*sendCccCmd)(struct I3cCntlr *cntlr, struct I3cCccCmd *ccc); 81 int32_t (*transfer)(struct I3cCntlr *cntlr, struct I3cMsg *msgs, int16_t count); 82 int32_t (*i2cTransfer)(struct I3cCntlr *cntlr, struct I3cMsg *msgs, int16_t count); 83 int32_t (*setConfig)(struct I3cCntlr *cntlr, struct I3cConfig *config); 84 int32_t (*getConfig)(struct I3cCntlr *cntlr, struct I3cConfig *config); 85 int32_t (*requestIbi)(struct I3cDevice *dev); 86 void (*freeIbi)(struct I3cDevice *dev); 87}; 88``` 89 90**表 1** I3cMethod结构体成员的钩子函数功能说明 91| 函数成员 | 入参 | 出参 | 返回值 | 功能 | 92| - | - | - | - | - | 93| sendCccCmd | **cntlr**：结构体指针，核心层I3C控制器<br />**ccc**：传入的通用命令代码结构体指针 | **ccc**：传出的通用命令代码结构体指针 | HDF_STATUS相关状态|发送CCC（Common command Code，即通用命令代码）| 94| Transfer | **cntlr**：结构体指针，核心层I3C控制器<br />**msgs**：结构体指针，用户消息<br />**count**：int16_t，消息数量 | **msgs**：结构体指针，用户消息 | HDF_STATUS相关状态 | 使用I3C模式传递用户消息 | 95|i2cTransfer | **cntlr**：结构体指针，核心层I3C控制器<br />**msgs**：结构体指针，用户消息<br />**count**：int16_t，消息数量 | **msgs**：结构体指针，用户消息 | HDF_STATUS相关状态 | 使用I2C模式传递用户消息 | 96| setConfig | **cntlr**：结构体指针，核心层I3C控制器<br />**config**：控制器配置参数| 无 | HDF_STATUS相关状态 | 设置I3C控制器配置参数 | 97| getConfig | **cntlr**：结构体指针，核心层I3C控制器 | **config**：控制器配置参数 | HDF_STATUS相关状态 | 获取I3C控制器配置参数 | 98| requestIbi | **device**：结构体指针，核心层I3C设备 | 无 | HDF_STATUS相关状态 | 为I3C设备请求IBI（In-Bind Interrupt，即带内中断） | 99| freeIbi | **device**：结构体指针，核心层I3C设备 | 无 | HDF_STATUS相关状态 | 释放IBI | 100 101### 开发步骤 <a name="9"></a> 102 103I3C模块适配包含以下五个步骤： 104 105- 实例化驱动入口 106 107 - 实例化HdfDriverEntry结构体成员。 108 109 - 调用HDF_INIT将HdfDriverEntry实例化对象注册到HDF框架中。 110 111- 配置属性文件 112 113 - 在device_info.hcs文件中添加deviceNode描述。 114 115 - 【可选】添加i3c_config.hcs器件属性文件。 116 117- 实例化I3C控制器对象 118 119 - 初始化I3cCntlr成员。 120 121 - 实例化I3cCntlr成员I3cMethod方法集合，其定义和成员函数说明见下文。 122 123- 注册中断处理子程序 124 125 为控制器注册中断处理程序，实现设备热接入和IBI（带内中断）功能。 126 127- 驱动调试 128 129 【可选】针对新增驱动程序，建议验证驱动基本功能，例如挂载后的测试用例是否成功，数据能否传输等。 130 131### 开发实例 132 133下方将以Hi3516DV300的虚拟驱动//drivers/hdf_core/framework/test/unittest/platform/virtual/i3c_virtual.c为示例，展示需要驱动适配者提供哪些内容来完整实现设备功能。 134 1351. 实例化驱动入口 136 驱动入口必须为HdfDriverEntry（在//drivers/hdf_core/framework/include/core/hdf_device_desc.h中定义）类型的全局变量，且moduleName要和device_info.hcs中保持一致。HDF框架会将所有加载的驱动的HdfDriverEntry对象首地址汇总，形成一个类似数组的段地址空间，方便上层调用。 137 138 一般在加载驱动时HDF会先调用Bind函数，再调用Init函数加载该驱动。当Init调用异常时，HDF框架会调用Release释放驱动资源并退出。 139 140 I3C驱动入口参考： 141 142 >  **说明：**<br> 143 > I3C控制器会出现很多个控制器挂接的情况，因而在HDF框架中首先会为此类型的控制器创建一个管理器对象，并同时对外发布一个管理器服务来统一处理外部访问。这样，用户需要打开某个控制器时，会先获取到管理器服务，然后管理器服务根据用户指定参数查找到指定控制器。 144 > 145 > I3C管理器服务的驱动由核心层实现，驱动适配者不需要关注这部分内容的实现，但在实现Init函数的时候需要调用核心层的I3cCntlrAdd函数，它会实现相应功能。 146 147 ```c 148 static struct HdfDriverEntry g_virtualI3cDriverEntry = { 149 .moduleVersion = 1, 150 .Init = VirtualI3cInit, 151 .Release = VirtualI3cRelease, 152 .moduleName = "virtual_i3c_driver", // 【必要且与hcs文件中的名字匹配】 153 }; 154 HDF_INIT(g_virtualI3cDriverEntry); // 调用HDF_INIT将驱动入口注册到HDF框架中 155 156 // 核心层i3c_core.c管理器服务的驱动入口 157 struct HdfDriverEntry g_i3cManagerEntry = { 158 .moduleVersion = 1, 159 .Init = I3cManagerInit, 160 .Release = I3cManagerRelease, 161 .moduleName = "HDF_PLATFORM_I3C_MANAGER", // 这与device_info.hcs文件中device0对应 162 }; 163 HDF_INIT(g_i3cManagerEntry); 164 ``` 165 1662. 配置属性文件 167 完成驱动入口注册之后，下一步请在//vendor/hisilicon/hispark_taurus/hdf_config/device_info/device_info.hcs文件中添加deviceNode信息，并在i3c_config.hcs中配置器件属性。deviceNode信息与驱动入口注册相关，器件属性值对于驱动适配者的驱动实现以及核心层I3cCntlr相关成员的默认值或限制范围有密切关系。 168 169 统一服务模式的特点是device_info.hcs文件中第一个设备节点必须为I3C管理器，其各项参数必须如表2设置： 170 171 **表 2** device_info.hcs节点参数说明 172 173 | 成员名 | 值 | 174 | -------- | -------- | 175 | policy | 驱动服务发布的策略，I3C管理器具体配置为0，表示驱动不需要发布服务 | 176 | priority | 驱动启动优先级（0-200），值越大优先级越低。I3C管理器具体配置为52 | 177 | permission | 驱动创建设备节点权限，I3C管理器具体配置为0664 | 178 | moduleName | 驱动名称，I3C管理器固定为HDF_PLATFORM_I3C_MANAGER | 179 | serviceName | 驱动对外发布服务的名称，I3C管理器服务名设置为HDF_PLATFORM_I3C_MANAGER | 180 | deviceMatchAttr | 驱动私有数据匹配的关键字，I3C管理器没有使用，可忽略 | 181 182 从第二个节点开始配置具体I3C控制器信息，此节点并不表示某一路I3C控制器，而是代表一个资源性质设备，用于描述一类I3C控制器的信息。本例只有一个I3C控制器，如有多个控制器，则需要在device_info.hcs文件增加deviceNode信息，以及在i3c_config文件中增加对应的器件属性。 183 184 - device_info.hcs配置参考 185 186 ```c 187 root { 188 device_i3c :: device { 189 device0 :: deviceNode { 190 policy = 0; 191 priority = 52; 192 permission = 0644; 193 serviceName = "HDF_PLATFORM_I3C_MANAGER"; 194 moduleName = "HDF_PLATFORM_I3C_MANAGER"; 195 } 196 } 197 i3c_virtual :: deviceNode { 198 policy = 0; // 等于0，不需要发布服务。 199 priority = 56; // 驱动启动优先级。 200 permission = 0644; // 驱动创建设备节点权限。 201 moduleName = "virtual_i3c_driver"; // 【必要】用于指定驱动名称，需要与期望的驱动Entry中的moduleName一致。 202 serviceName = "VIRTUAL_I3C_DRIVER"; // 【必要】驱动对外发布服务的名称，必须唯一。 203 deviceMatchAttr = "virtual_i3c"; // 【必要】用于配置控制器私有数据，要与i3c_config.hcs中对应控制器保持一致。 204 } // 具体的控制器信息在i3c_config.hcs中。 205 } 206 ``` 207 208 - i3c_config.hcs 配置参考 209 210 ```c 211 root { 212 platform { 213 i3c_config { 214 match_attr = "virtual_i3c"; // 【必要】需要和device_info.hcs中的deviceMatchAttr值一致 215 template i3c_controller { // 模板公共参数，继承该模板的节点如果使用模板中的默认值，则节点字段可以缺省。 216 busId = 0; // 【必要】i3c总线号 217 busMode = 0x0; // 总线模式，0x0：纯净；0x1：混合高速；0x2：混合受限；0x3：混合低速。 218 regBasePhy = 0x120b0000; // 【必要】物理基地址 219 regSize = 0xd1; // 【必要】寄存器位宽 220 IrqNum = 20; // 【必要】中断号 221 i3cMaxRate = 12900000; // 【可选】i3c模式最大时钟速率 222 i3cRate = 12500000; // 【可选】i3c模式时钟速率 223 i2cFmRate = 1000000; // 【可选】i2c FM模式时钟速率 224 i2cFmPlusRate = 400000; // 【可选】i2c FM+模式时钟速率 225 } 226 controller_0 :: i3c_controller { 227 busId = 18; 228 IrqNum = 20; 229 } 230 } 231 } 232 } 233 ``` 234 235 需要注意的是，新增i3c_config.hcs配置文件后，必须在对应的hdf.hcs文件中包含i3c_config.hcs所在路径信息，否则配置文件无法生效。 236 2373. 实例化I3C控制器对象 238 239 配置属性文件完成后，要以核心层I3cCntlr对象的初始化为核心，包括驱动适配者自定义结构体（传递参数和数据），实例化I3cCntlr成员I3cMethod（让用户可以通过接口来调用驱动底层函数）。 240 241 此步骤需要通过实现HdfDriverEntry成员函数（Bind，Init，Release）来完成。 242 243 I3cCntlr成员钩子函数结构体I3cMethod的实例化，I3cLockMethod钩子函数结构体本例未实现，若要实例化，可参考I2C驱动开发。 244 245 - 自定义结构体参考 246 247 >  **说明：**<br> 248 > 从驱动的角度看，自定义结构体是参数和数据的载体，而且i3c_config.hcs文件中的数值会被HDF读入并通过DeviceResourceIface来初始化结构体成员，其中一些重要数值也会传递给核心层I3cCntlr对象，例如设备号、总线号等。 249 250 ```c 251 struct VirtualI3cCntlr { 252 struct I3cCntlr cntlr; // 【必要】是核心层控制对象，具体描述见下面。 253 volatile unsigned char *regBase; // 【必要】寄存器基地址 254 uint32_t regBasePhy; // 【必要】寄存器物理基地址 255 uint32_t regSize; // 【必要】寄存器位宽 256 uint16_t busId; // 【必要】设备号 257 uint16_t busMode; 258 uint16_t IrqNum; 259 uint32_t i3cMaxRate; 260 uint32_t i3cRate; 261 uint32_t i2cFmRate; 262 uint32_t i2cFmPlusRate; 263 }; 264 265 // I3cCntlr是核心层控制器结构体，其中的成员在Init函数中被赋值。 266 struct I3cCntlr { 267 OsalSpinlock lock; 268 void *owner; 269 int16_t busId; 270 struct I3cConfig config; 271 uint16_t addrSlot[(I3C_ADDR_MAX + 1) / ADDRS_PER_UINT16]; 272 struct I3cIbiInfo *ibiSlot[I3C_IBI_MAX]; 273 const struct I3cMethod *ops; 274 const struct I3cLockMethod *lockOps; 275 void *priv; 276 }; 277 ``` 278 279 - Init函数开发参考 280 281 **入参：** 282 283 HdfDeviceObject是整个驱动对外提供的接口参数，具备HCS配置文件的信息。 284 285 **返回值：** 286 287 HDF_STATUS相关状态（表3为部分展示，如需使用其他状态，可参考//drivers/hdf_core/interfaces/inner_api/utils/hdf_base.h中HDF_STATUS定义）。 288 289 **表 3** HDF_STATUS相关状态说明 290 291 | 状态(值) | 问题描述 | 292 | -------- | -------- | 293 | HDF_ERR_INVALID_OBJECT | 控制器对象非法 | 294 | HDF_ERR_INVALID_PARAM | 参数非法 | 295 | HDF_ERR_MALLOC_FAIL | 内存分配失败 | 296 | HDF_ERR_IO | I/O错误 | 297 | HDF_SUCCESS | 传输成功 | 298 | HDF_FAILURE | 传输失败 | 299 300 **函数说明：** 301 302 初始化自定义结构体对象，初始化I3cCntlr成员，调用核心层I3cCntlrAdd函数。 303 304 ```c 305 static int32_t VirtualI3cParseAndInit(struct HdfDeviceObject *device, const struct DeviceResourceNode *node) 306 { 307 int32_t ret; 308 struct VirtualI3cCntlr *virtual = NULL; // 【必要】自定义结构体对象 309 (void)device; 310 311 virtual = (struct VirtualI3cCntlr *)OsalMemCalloc(sizeof(*virtual)); // 【必要】内存分配 312 if (virtual == NULL) { 313 HDF_LOGE("%s: Malloc virtual fail!", __func__); 314 return HDF_ERR_MALLOC_FAIL; 315 } 316 317 ret = VirtualI3cReadDrs(virtual, node); // 【必要】将i3c_config文件的默认值填充到结构体中，函数定义见下方 318 if (ret != HDF_SUCCESS) { 319 HDF_LOGE("%s: Read drs fail! ret:%d", __func__, ret); 320 goto __ERR__; 321 } 322 ...... 323 virtual->regBase = OsalIoRemap(virtual->regBasePhy, virtual->regSize); // 【必要】地址映射 324 ret = OsalRegisterIrq(hi35xx->softIrqNum, OSAL_IRQF_TRIGGER_NONE, I3cIbiHandle, "I3C", virtual); //【必要】注册中断程序 325 if (ret != HDF_SUCCESS) { 326 HDF_LOGE("%s: register irq failed!", __func__); 327 return ret; 328 } 329 ...... 330 VirtualI3cCntlrInit(virtual); // 【必要】I3C设备的初始化 331 virtual->cntlr.priv = (void *)node; // 【必要】存储设备属性 332 virtual->cntlr.busId = virtual->busId; // 【必要】初始化I3cCntlr成员 333 virtual->cntlr.ops = &g_method; // 【必要】I3cMethod的实例化对象的挂载 334 (void)OsalSpinInit(&virtual->spin); 335 ret = I3cCntlrAdd(&virtual->cntlr); // 【必要且重要】调用此函数将控制器添加至核心，返回成功信号后驱动才完全接入平台核心层。 336 if (ret != HDF_SUCCESS) { 337 HDF_LOGE("%s: add i3c controller failed! ret = %d", __func__, ret); 338 (void)OsalSpinDestroy(&virtual->spin); 339 goto __ERR__; 340 } 341 342 return HDF_SUCCESS; 343 __ERR__: // 若控制器添加失败，需要执行去初始化相关函数。 344 if (virtual != NULL) { 345 OsalMemFree(virtual); 346 virtual = NULL; 347 } 348 349 return ret; 350 } 351 352 static int32_t VirtualI3cInit(struct HdfDeviceObject *device) 353 { 354 int32_t ret; 355 const struct DeviceResourceNode *childNode = NULL; 356 357 if (device == NULL || device->property == NULL) { 358 HDF_LOGE("%s: device or property is NULL", __func__); 359 return HDF_ERR_INVALID_OBJECT; 360 } 361 362 DEV_RES_NODE_FOR_EACH_CHILD_NODE(device->property, childNode) { 363 ret = VirtualI3cParseAndInit(device, childNode); 364 if (ret != HDF_SUCCESS) { 365 break; 366 } 367 } 368 369 return ret; 370 } 371 372 static int32_t VirtualI3cReadDrs(struct VirtualI3cCntlr *virtual, const struct DeviceResourceNode *node) 373 { 374 struct DeviceResourceIface *drsOps = NULL; 375 376 // 获取drsOps方法 377 drsOps = DeviceResourceGetIfaceInstance(HDF_CONFIG_SOURCE); 378 if (drsOps == NULL || drsOps->GetUint32 == NULL || drsOps->GetUint16 == NULL) { 379 HDF_LOGE("%s: Invalid drs ops fail!", __func__); 380 return HDF_FAILURE; 381 } 382 // 将配置参数依次读出，并填充至结构体中 383 if (drsOps->GetUint16(node, "busId", &virtual->busId, 0) != HDF_SUCCESS) { 384 HDF_LOGE("%s: Read busId fail!", __func__); 385 return HDF_ERR_IO; 386 } 387 if (drsOps->GetUint16(node, "busMode", &virtual->busMode, 0) != HDF_SUCCESS) { 388 HDF_LOGE("%s: Read busMode fail!", __func__); 389 return HDF_ERR_IO; 390 } 391 if (drsOps->GetUint16(node, "IrqNum", &virtual->IrqNum, 0) != HDF_SUCCESS) { 392 HDF_LOGE("%s: Read IrqNum fail!", __func__); 393 return HDF_ERR_IO; 394 } 395 ...... 396 return HDF_SUCCESS; 397 } 398 ``` 399 400 - Release函数开发参考 401 402 **入参：** 403 404 HdfDeviceObject是整个驱动对外提供的接口参数，具备HCS配置文件的信息。 405 406 **返回值：** 407 408 无。 409 410 **函数说明：** 411 412 释放内存和删除控制器，该函数需要在驱动入口结构体中赋值给Release接口，当HDF框架调用Init函数初始化驱动失败时，可以调用Release释放驱动资源。 413 414 >  **说明：**<br> 415 > 所有强制转换获取相应对象的操作**前提**是在Init函数中具备对应赋值的操作。 416 417 ```c 418 static void VirtualI3cRemoveByNode(const struct DeviceResourceNode *node) 419 { 420 int32_t ret; 421 int16_t busId; 422 struct I3cCntlr *cntlr = NULL; 423 struct VirtualI3cCntlr *virtual = NULL; 424 struct DeviceResourceIface *drsOps = NULL; 425 426 drsOps = DeviceResourceGetIfaceInstance(HDF_CONFIG_SOURCE); 427 if (drsOps == NULL || drsOps->GetUint32 == NULL) { 428 HDF_LOGE("%s: invalid drs ops fail!", __func__); 429 return; 430 } 431 432 ret = drsOps->GetUint16(node, "busId", (uint16_t *)&busId, 0); 433 if (ret != HDF_SUCCESS) { 434 HDF_LOGE("%s: read busId fail!", __func__); 435 return; 436 } 437 ...... 438 // 可以调用I3cCntlrGet函数通过设备的cntlrNum获取I3cCntlr对象，以及调用I3cCntlrRemove函数来释放I3cCntlr对象的内容。 439 cntlr = I3cCntlrGet(busId); 440 if (cntlr != NULL && cntlr->priv == node) { 441 I3cCntlrPut(cntlr); 442 I3cCntlrRemove(cntlr); // 【必要】主要是从管理器驱动那边移除I3cCntlr对象 443 virtual = (struct VirtualI3cCntlr *)cntlr; // 【必要】通过强制转换获取自定义的对象并进行release操作 444 (void)OsalSpinDestroy(&virtual->spin); 445 OsalMemFree(virtual); 446 } 447 return; 448 } 449 450 static void VirtualI3cRelease(struct HdfDeviceObject *device) 451 { 452 const struct DeviceResourceNode *childNode = NULL; 453 454 HDF_LOGI("%s: enter", __func__); 455 456 if (device == NULL || device->property == NULL) { 457 HDF_LOGE("%s: device or property is NULL", __func__); 458 return; 459 } 460 ...... 461 // 遍历、解析i3c_config.hcs中的所有配置节点，并分别进行release操作 462 DEV_RES_NODE_FOR_EACH_CHILD_NODE(device->property, childNode) { 463 VirtualI3cRemoveByNode(childNode); //函数定义如上 464 } 465 } 466 ``` 467 4684. 注册中断处理子程序 469 470 在中断处理程序中通过判断中断产生的地址，实现热接入、IBI等操作。 471 472 ```c 473 static int32_t VirtualI3cReservedAddrWorker(struct VirtualI3cCntlr *virtual, uint16_t addr) 474 { 475 (void)virtual; 476 switch (addr) { 477 case I3C_HOT_JOIN_ADDR: 478 VirtualI3cHotJoin(virtual); 479 break; 480 case I3C_RESERVED_ADDR_7H3E: 481 case I3C_RESERVED_ADDR_7H5E: 482 case I3C_RESERVED_ADDR_7H6E: 483 case I3C_RESERVED_ADDR_7H76: 484 case I3C_RESERVED_ADDR_7H7A: 485 case I3C_RESERVED_ADDR_7H7C: 486 case I3C_RESERVED_ADDR_7H7F: 487 // 广播地址单比特错误的所有情形 488 HDF_LOGW("%s: broadcast Address single bit error!", __func__); 489 break; 490 default: 491 HDF_LOGD("%s: Reserved address which is not supported!", __func__); 492 break; 493 } 494 495 return HDF_SUCCESS; 496 } 497 498 static int32_t I3cIbiHandle(uint32_t irq, void *data) 499 { 500 struct VirtualI3cCntlr *virtual = NULL; 501 struct I3cDevice *device = NULL; 502 uint16_t ibiAddr; 503 char *testStr = "Hello I3C!"; 504 505 (void)irq; 506 if (data == NULL) { 507 HDF_LOGW("%s: data is NULL!", __func__); 508 return HDF_ERR_INVALID_PARAM; 509 } 510 virtual = (struct VirtualI3cCntlr *)data; 511 // 【必要】获取产生中断的地址，使用CHECK_RESERVED_ADDR宏判断该地址是否为I3C保留地址。 512 ibiAddr = VirtualI3cGetIbiAddr(); 513 if (CHECK_RESERVED_ADDR(ibiAddr) == I3C_ADDR_RESERVED) { 514 HDF_LOGD("%s: Calling VirtualI3cResAddrWorker...", __func__); 515 return VirtualI3cReservedAddrWorker(virtual, ibiAddr); 516 } else { 517 HDF_LOGD("%s: Calling I3cCntlrIbiCallback...", __func__); 518 device = GetDeviceByAddr(&virtual->cntlr, ibiAddr); 519 if (device == NULL) { 520 HDF_LOGE("func:%s device is NULL!",__func__); 521 return HDF_ERR_MALLOC_FAIL; 522 } 523 if (device->ibi->payload > VIRTUAL_I3C_TEST_STR_LEN) { 524 // 将字符串"Hello I3C!"放入IBI缓冲区内 525 *device->ibi->data = *testStr; 526 } 527 // 根据产生IBI的I3C设备调用IBI回调函数 528 return I3cCntlrIbiCallback(device); 529 } 530 531 return HDF_SUCCESS; 532 } 533 ``` 534 5355. 驱动调试 536 537 【可选】针对新增驱动程序，建议验证驱动基本功能，例如挂载后的测试用例是否成功，数据能否传输等。 538
